NAME

       iscsi_ifaces_get - Retrieve all iSCSI interfaces.

SYNOPSIS

       int iscsi_ifaces_get (struct iscsi_context *ctx, struct iscsi_iface ***ifaces, uint32_t *iface_count);

ARGUMENTS

       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

DESCRIPTION

       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.

RETURN

       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.

July 2025                                       iscsi_ifaces_get                             iscsi_ifaces_get(3)