NAME

       iscsi_iface_get - Retrieve specified iSCSI interface.

SYNOPSIS

       int iscsi_iface_get (struct iscsi_context *ctx, const char *iface_name, struct iscsi_iface
       **iface);

ARGUMENTS

       ctx         Pointer of 'struct iscsi_context'.  If this pointer is NULL, your program will
                   be terminated by assert.

       iface_name  String.  Name  of  iSCSI  interface.  Also the file name of configuration file
                   "/etc/iscsi/iface/<iface_name>".  If this pointer is  NULL  or  empty  string,
                   your program will be terminated by assert.

       iface       Output  pointer  of  'struct  iscsi_iface'.  Its  memory  should  be  freed by
                   iscsi_iface_free.  If this pointer is NULL, your program will be terminated by
                   assert.

DESCRIPTION

       Retrieves     specified     iSCSI     interfaces    by    reading    configuration    from
       "/etc/iscsi/iface/<iface_name>".  To generate iSCSI interface configuration when new  card
       installed,  please  use  iscsi_default_iface_setup.   Illegal  configuration  file will be
       treated as error LIBISCSI_ERR_IDBM.  Configuration file not found will be treated as error
       LIBISCSI_ERR_INVAL.

RETURN

       int. Valid error codes are:

       * LIBISCSI_OK

       * LIBISCSI_ERR_BUG

       * LIBISCSI_ERR_NOMEM

       * LIBISCSI_ERR_ACCESS

       * LIBISCSI_ERR_SYSFS_LOOKUP

       * LIBISCSI_ERR_IDBM

       Error number could be converted to string by iscsi_strerror.