OS Manuals

/usr/bin/iscsiadm

iSCSI initiator tools and daemon

From open-iscsi 2.1.13-r4 (enterprise-packages), captured 2026-11-08 by running iscsiadm --help (exit 0) · terse output. permalink

iscsiadm -m discoverydb [-hV] [-d debug_level] [-P printlevel] [-t type -p ip:port -I ifaceN ... [-Dl]] | [[-p ip:port -t type] [-o operation] [-n name] [-v value] [-lD]]
iscsiadm -m discovery [-hV] [-d debug_level] [-P printlevel] [-t type -p ip:port -I ifaceN ... [-l]] | [[-p ip:port] [-l | -D]] [-W]
iscsiadm -m node [-hV] [-d debug_level] [-P printlevel] [-L all,manual,automatic,onboot] [-W] [-U all,manual,automatic,onboot] [-S] [[-T targetname -p ip:port -I ifaceN] [-l | -u | -R | -s]] [[-o operation ] [-n name] [-v value]]
iscsiadm -m session [-hV] [-d debug_level] [-P printlevel] [-r sessionid | sysfsdir [-R | -u | -s] [-o operation] [-n name] [-v value]]
iscsiadm -m iface [-hV] [-d debug_level] [-P printlevel] [-I ifacename | -H hostno|MAC] [[-o operation ] [-n name] [-v value]] [-C ping [-a ip] [-b packetsize] [-c count] [-i interval]]
iscsiadm -m fw [-d debug_level] [-l] [-W] [[-n name] [-v value]]
iscsiadm -m host [-P printlevel] [-H hostno|MAC] [[-C chap [-x chap_tbl_idx]] | [-C flashnode [-A portal_type] [-x flashnode_idx]] | [-C stats]] [[-o operation] [-n name] [-v value]]
iscsiadm -k priority
Options (24)
OptionDescriptionSource
-a, --ip ipaddripaddr can be IPv4 or IPv6.man
-b, --packetsize packetsizeSpecify the ping packetsize.man
-c, --count countcount specifies the number of ping iterations.man
-C, --submode opSpecify the submode for mode.man
-d, --debug debug_levelprint debugging information.man
-h, --helpdisplay help text and exitman
-i, --interval intervalinterval specifies the delay between two ping iterations.man
-D, --discoverDiscover targets using the discovery record with the recid matching the the discovery type and portal passed in.man
-l, --loginFor node and fw modes, login to a specified record.man
-WIn node, discovery, or fw (firmware) mode, do not wait for a response from the target(s).man
-m, --mode opspecify the mode.man
-n, --name nameIn node mode, specify a field name in a record.man
-o, --op opSpecifies a database operator op.man
-P, --print printlevelIf in node mode print nodes in tree format.man
-T, --targetname targetnameUse target targetname.man
-r, --sid sidUse session ID sid.man
-R, --rescanIn session mode, if sid is also passed in, rescan the session.man
-s, --statsDisplay session statistics.man
-S, --showWhen displaying records, do not hide masked values, such as the CHAP secret (password).man
-t, --type typetype must be sendtargets (or abbreviated as st), isns (if enabled), or fw.man
-u, --logoutLogout for the specified record.man
-v, --value valueSpecify a value for use with the update operator, or for firmware login mode.man
-V, --versionDisplay version and exit.man
-x, --index indexSpecify the index of the entity to operate on.man
Exit status (33) from the manual page
0ISCSI_SUCCESS - command executed successfully.
1ISCSI_ERR - generic error code.
2ISCSI_ERR_SESS_NOT_FOUND - session could not be found.
3ISCSI_ERR_NOMEM - could not allocate resource for operation.
4ISCSI_ERR_TRANS - connect problem caused operation to fail.
5ISCSI_ERR_LOGIN - generic iSCSI login failure.
6ISCSI_ERR_IDBM - error accessing/managing iSCSI DB.
7ISCSI_ERR_INVAL - invalid argument.
8ISCSI_ERR_TRANS_TIMEOUT - connection timer expired while trying to connect.
9ISCSI_ERR_INTERNAL - generic internal iscsid/kernel failure.
10ISCSI_ERR_LOGOUT - iSCSI logout failed.
11ISCSI_ERR_PDU_TIMEOUT - iSCSI PDU timed out.
12ISCSI_ERR_TRANS_NOT_FOUND - iSCSI transport module not loaded in kernel or iscsid.
13ISCSI_ERR_ACCESS - did not have proper OS permissions to access iscsid or execute iscsiadm command.
14ISCSI_ERR_TRANS_CAPS - transport module did not support operation.
15ISCSI_ERR_SESS_EXISTS - session is logged in.
16ISCSI_ERR_INVALID_MGMT_REQ - invalid IPC MGMT request.
17ISCSI_ERR_ISNS_UNAVAILABLE - iSNS service is not supported.
18ISCSI_ERR_ISCSID_COMM_ERR - a read/write to iscsid failed.
19ISCSI_ERR_FATAL_LOGIN - fatal iSCSI login error.
20ISCSI_ERR_ISCSID_NOTCONN - could not connect to iscsid.
21ISCSI_ERR_NO_OBJS_FOUND - no records/targets/sessions/portals found to execute operation on.
22ISCSI_ERR_SYSFS_LOOKUP - could not lookup object in sysfs.
23ISCSI_ERR_HOST_NOT_FOUND - could not lookup host.
24ISCSI_ERR_LOGIN_AUTH_FAILED - login failed due to authorization failure.
25ISCSI_ERR_ISNS_QUERY - iSNS query failure.
26ISCSI_ERR_ISNS_REG_FAILED - iSNS registration/deregistration failed.
27ISCSI_ERR_OP_NOT_SUPP - operation not support
28ISCSI_ERR_BUSY - device or resource in use
29ISCSI_ERR_AGAIN - operation failed, but retrying later may succeed
30ISCSI_ERR_UNKNOWN_DISCOVERY_TYPE - unknown discovery type
31ISCSI_ERR_CHILD_TERMINATED - child process terminated
32ISCSI_ERR_SESSION_NOT_CONNECTED - session likely not connected

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.