---
name: "iscsi_nodes_get"
section: "3"
platform: "linux"
package: "open-iscsi"
version: "2.1.13-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/iscsi_nodes_get"
---

# iscsi\_nodes\_get(3)

Retrieve all iSCSI nodes.

## NAME

iscsi\_nodes\_get - Retrieve all iSCSI nodes.

## SYNOPSIS

**int iscsi\_nodes\_get** **(struct iscsi\_context \****ctx***,** **struct iscsi\_node \*\*\****nodes***,** **uint32\_t \****node\_count***);**

## ARGUMENTS

- ctx

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

- nodes

  Output pointer of 'struct iscsi\_node' pointer array. Its memory should be freed by **iscsi\_nodes\_free**. If this pointer is NULL, your program will be terminated by assert.

- node\_count

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

## DESCRIPTION

Retrieves all iSCSI nodes. For the properties of 'struct iscsi\_node', please refer to the functions defined in 'libopeniscsiusr\_node.h' file. The returned results contains iSCSI nodes configured in "/etc/iscsi/nodes/". Illegal configuration file will be skipped and warned. The returned 'struct iscsi\_node' pointer array is sorted by target name, connection address, connection port and interface.

## RETURN

int. Valid error codes are:

\* LIBISCSI\_OK

\* LIBISCSI\_ERR\_BUG

\* LIBISCSI\_ERR\_NOMEM

\* LIBISCSI\_ERR\_ACCESS

\* LIBISCSI\_ERR\_SYSFS\_LOOKUP

\* LIBISCSI\_ERR\_IDBM

Error number could be converted to string by **iscsi\_strerror**.