iscsi_ifaces_get − Retrieve all iSCSI interfaces.
int iscsi_ifaces_get (struct iscsi_context *ctx, struct iscsi_iface ***ifaces, uint32_t *iface_count);
ctx |
Pointer of ’struct iscsi_context’. If this pointer is NULL, your program will be terminated by assert. | ||
ifaces |
Output pointer of ’struct iscsi_iface’ pointer array. Its memory should be freed by iscsi_ifaces_free. If this pointer is NULL, your program will be terminated by assert. | ||
iface_count |
Output pointer of uint32_t. Will store the size of |
Retrieves all iSCSI interfaces. For the properties of ’struct iscsi_iface’, please refer to the functions defined in ’libopeniscsiusr_iface.h’ file. The returned results contains default iSCSI interfaces(iser and iscsi_tcp) and iSCSI interfaces configured in "/etc/iscsi/ifaces/". Illegal configuration file will be skipped and warned. To generate iSCSI interface configuration when new card installed, please use iscsi_default_iface_setup.
int. Valid error codes are:
* LIBISCSI_OK
* LIBISCSI_ERR_BUG
* LIBISCSI_ERR_NOMEM
* LIBISCSI_ERR_ACCESS
* LIBISCSI_ERR_SYSFS_LOOKUP
Error number could be converted to string by iscsi_strerror.