iscsi_iface_get - Man Page
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.