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

NAME

6       iscsi_iface_get - Retrieve specified iSCSI interface.
7

SYNOPSIS

9       int iscsi_iface_get (struct iscsi_context *ctx, const char *iface_name,
10       struct iscsi_iface **iface);
11

ARGUMENTS

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

DESCRIPTION

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

RETURN

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)
Impressum