1iscsi_iface_get(3) API Manual iscsi_iface_get(3)
2
3
4
6 iscsi_iface_get - Retrieve specified iSCSI interface.
7
9 int iscsi_iface_get (struct iscsi_context *ctx, const char *iface_name,
10 struct iscsi_iface **iface);
11
13 ctx Pointer of 'struct iscsi_context'. If this pointer is
14 NULL, your program will be terminated by assert.
15
16 iface_name String. Name of iSCSI interface. Also the file name of con‐
17 figuration file "/etc/iscsi/iface/<iface_name>". If this
18 pointer is NULL or empty string, your program will be ter‐
19 minated by assert.
20
21 iface Output pointer of 'struct iscsi_iface'. Its memory should
22 be freed by iscsi_iface_free. If this pointer is NULL,
23 your program will be terminated by assert.
24
26 Retrieves specified iSCSI interfaces by reading configuration from
27 "/etc/iscsi/iface/<iface_name>". To generate iSCSI interface configu‐
28 ration when new card installed, please use iscsi_default_iface_setup.
29 Illegal configuration file will be treated as error LIBISCSI_ERR_IDBM.
30 Configuration file not found will be treated as error LIBISCSI_ERR_IN‐
31 VAL.
32
34 int. Valid error codes are:
35
36 * LIBISCSI_OK
37
38 * LIBISCSI_ERR_BUG
39
40 * LIBISCSI_ERR_NOMEM
41
42 * LIBISCSI_ERR_ACCESS
43
44 * LIBISCSI_ERR_SYSFS_LOOKUP
45
46 * LIBISCSI_ERR_IDBM
47
48 Error number could be converted to string by iscsi_strerror.
49
50
51
52July 2023 iscsi_iface_get iscsi_iface_get(3)