1iscsi_ifaces_get(3)               API Manual               iscsi_ifaces_get(3)
2
3
4

NAME

6       iscsi_ifaces_get - Retrieve all iSCSI interfaces.
7

SYNOPSIS

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

ARGUMENTS

13       ctx         Pointer of 'struct  iscsi_context'.   If  this  pointer  is
14                   NULL, your program will be terminated by assert.
15
16       ifaces      Output  pointer  of 'struct iscsi_iface' pointer array. Its
17                   memory should  be  freed  by  iscsi_ifaces_free.   If  this
18                   pointer is NULL, your program will be terminated by assert.
19
20       iface_count Output pointer of uint32_t. Will store the size of
21

DESCRIPTION

23       Retrieves   all   iSCSI  interfaces.  For  the  properties  of  'struct
24       iscsi_iface', please refer to the  functions  defined  in  'libopenisc‐
25       siusr_iface.h'  file.   The returned results contains default iSCSI in‐
26       terfaces(iser  and  iscsi_tcp)  and  iSCSI  interfaces  configured   in
27       "/etc/iscsi/ifaces/".   Illegal  configuration file will be skipped and
28       warned.  To generate iSCSI interface configuration when  new  card  in‐
29       stalled, please use iscsi_default_iface_setup.
30

RETURN

32       int. Valid error codes are:
33
34       * LIBISCSI_OK
35
36       * LIBISCSI_ERR_BUG
37
38       * LIBISCSI_ERR_NOMEM
39
40       * LIBISCSI_ERR_ACCESS
41
42       * LIBISCSI_ERR_SYSFS_LOOKUP
43
44       Error number could be converted to string by iscsi_strerror.
45
46
47
48July 2023                      iscsi_ifaces_get            iscsi_ifaces_get(3)
Impressum