table of contents
ISCSI-LS(1) | iscsi-ls: list iSCSI targets | ISCSI-LS(1) |
NAME¶
iscsi-ls - Utility to list iSCSI targets and LUNsSYNOPSIS¶
iscsi-ls [ OPTIONS ] <ISCSI-PORTAL>
iscsi-ls [-i --initiator-name=<IQN>]
[-s --show-luns] [-d --debug=<INTEGER>] [-? --help]
[--usage]
DESCRIPTION¶
iscsi-ls is a utility to list all targets and LUNs for an iSCSI portal.ISCSI PORTAL URL FORMAT¶
iSCSI portal format is 'iscsi://[<username>[%<password>]@]<host>[:<port>]' Username and password are only required if the target requires CHAP authentication. Optionally you can specify the username and password via the environment variables LIBISCSI_CHAP_USERNAME and LIBISCSI_CHAP_PASSWORD. Host can be specified either as a hostname, an IPv4 address or an IPv6 address. Examples:iscsi://192.0.2.1 iscsi://[2001:DB8::1]:3261 iscsi://ronnie%password@iscsi.example.com
OPTIONS¶
-i --initiator-name=<IQN>This specifies the initiator-name that iscsi-ls will use
when logging in to the target.
The default name is 'iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-ls' but you
can use this argument to override this. This is mainly needed for cases where
the target is configured with access-control to only allow discovery logins
from known initiator-names.
-s --show-luns
In addition to listing all the targets at the specified
portal also list all the LUNs and their types on each discovered target.
In order to display the type of LUN iscsi-ls need to be able to perform a normal
login on the targets. If the target is using access-control you will need to
specify an initiator-name that allows normal logins to the target.
-d --debug=<INTEGER>
Debug level.
-? --help
Display basic help text.
--usage
Display basic usage text.
SEE ALSO¶
iscsi-inq(1) http://github.com/sahlberg/libiscsi03/24/2014 | iscsi-ls |