1ISCSI-LS(1)              iscsi-ls: list iSCSI targets              ISCSI-LS(1)
2
3
4

NAME

6       iscsi-ls - Utility to list iSCSI targets and LUNs
7

SYNOPSIS

9       iscsi-ls [ OPTIONS ] <ISCSI-PORTAL>
10
11       iscsi-ls [-i --initiator-name=<IQN>] [-s --show-luns]
12                [-d --debug=<INTEGER>] [-? --help] [--usage]
13

DESCRIPTION

15       iscsi-ls is a utility to list all targets and LUNs for an iSCSI portal.
16

ISCSI PORTAL URL FORMAT

18       iSCSI portal format is
19       'iscsi://[<username>[%<password>]@]<host>[:<port>]'
20
21       Username and password are only required if the target requires CHAP
22       authentication. Optionally you can specify the username and password
23       via the environment variables LIBISCSI_CHAP_USERNAME and
24       LIBISCSI_CHAP_PASSWORD.
25
26       Host can be specified either as a hostname, an IPv4 address or an IPv6
27       address. Examples:
28
29                iscsi://192.0.2.1
30                iscsi://[2001:DB8::1]:3261
31                iscsi://ronnie%password@iscsi.example.com
32
33
34       Port is the TCP port on the target to connect to. Default is 3260.
35

OPTIONS

37       -i --initiator-name=<IQN>
38           This specifies the initiator-name that iscsi-ls will use when
39           logging in to the target.
40
41           The default name is
42           'iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-ls' but you can use
43           this argument to override this. This is mainly needed for cases
44           where the target is configured with access-control to only allow
45           discovery logins from known initiator-names.
46
47       -s --show-luns
48           In addition to listing all the targets at the specified portal also
49           list all the LUNs and their types on each discovered target.
50
51           In order to display the type of LUN iscsi-ls need to be able to
52           perform a normal login on the targets. If the target is using
53           access-control you will need to specify an initiator-name that
54           allows normal logins to the target.
55
56       -d --debug=<INTEGER>
57           Debug level.
58
59       -? --help
60           Display basic help text.
61
62       --usage
63           Display basic usage text.
64

SEE ALSO

66       iscsi-inq(1) http://github.com/sahlberg/libiscsi
67
68
69
70iscsi-ls                          03/24/2014                       ISCSI-LS(1)
Impressum