NAME¶

iscsi_nodes_get - Retrieve all iSCSI nodes.

SYNOPSIS¶

int iscsi_nodes_get (struct iscsi_context *ctx, struct iscsi_node ***nodes, uint32_t *node_count);

ARGUMENTS¶

ctx

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

nodes

Output pointer of 'struct iscsi_node' pointer array. Its memory should be freed by iscsi_nodes_free. If this pointer is NULL, your program will be terminated by assert.

node_count

Output pointer of uint32_t. Will store the size of

DESCRIPTION¶

Retrieves all iSCSI nodes. For the properties of 'struct iscsi_node', please refer to the functions defined in 'libopeniscsiusr_node.h' file. The returned results contains iSCSI nodes configured in "/etc/iscsi/nodes/". Illegal configuration file will be skipped and warned. The returned 'struct iscsi_node' pointer array is sorted by target name, connection address, connection port and interface.

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.