1iscsi_ifaces_get(3) API Manual iscsi_ifaces_get(3)
2
3
4
6 iscsi_ifaces_get - Retrieve all iSCSI interfaces.
7
9 int iscsi_ifaces_get (struct iscsi_context *ctx, struct iscsi_iface
10 ***ifaces, uint32_t *iface_count);
11
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
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
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)