iscsi\_ifaces\_get(3) API Manual iscsi\_ifaces\_get(3)

# [NAME](#NAME)

iscsi\_ifaces\_get - Retrieve all iSCSI interfaces.

# [SYNOPSIS](#SYNOPSIS)

**int iscsi\_ifaces\_get** **(struct iscsi\_context \*ctx,** **struct iscsi\_iface \*\*\*ifaces,** **uint32\_t \*iface\_count);**

# [ARGUMENTS](#ARGUMENTS)

[ctx](#ctx)

Pointer of 'struct iscsi\_context'. If this pointer is NULL, your program will be terminated by assert.

[ifaces](#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](#iface_count)

Output pointer of uint32\_t. Will store the size of

# [DESCRIPTION](#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](#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**.

iscsi\_ifaces\_get October 2026

---

Document: iscsi_ifaces_get(3) from open-iscsi 2.1.13-r4 (Chainguard OS)
Source: https://github.com/open-iscsi/open-iscsi