1ISCSI-SWP(1) iscsi-swp: get/set software w ISCSI-SWP(1)
2
3
4
6 iscsi-swp - Utility to get/set software write protect on an iSCSI LUN
7
9 iscsi-swp [ OPTIONS ] <ISCSI-PORTAL>
10
11 iscsi-ls [-i --initiator-name=<IQN>] [-s --swp {on|off}]
12 [-d --debug=<INTEGER>] [-? --help] [--usage]
13
15 iscsi-swp is a utility to get or set the software write protect on an
16 iSCSI LUN.
17
19 iSCSI portal format is
20 'iscsi://[<username>[%<password>]@]<host>[:<port>]'
21
22 Username and password are only required if the target requires CHAP
23 authentication. Optionally you can specify the username and password
24 via the environment variables LIBISCSI_CHAP_USERNAME and
25 LIBISCSI_CHAP_PASSWORD.
26
27 Host can be specified either as a hostname, an IPv4 address or an IPv6
28 address. Examples:
29
30 iscsi://192.0.2.1
31 iscsi://[2001:DB8::1]:3261
32 iscsi://ronnie%password@iscsi.example.com
33
34
35 Port is the TCP port on the target to connect to. Default is 3260.
36
38 -i --initiator-name=<IQN>
39 This specifies the initiator-name that iscsi-ls will use when
40 logging in to the target.
41
42 The default name is
43 'iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-ls' but you can use
44 this argument to override this. This is mainly needed for cases
45 where the target is configured with access-control to only allow
46 discovery logins from known initiator-names.
47
48 -s --swp {on|off}
49 By default iscsi-swp will only print the current setting of the
50 software write protect bit. By using this argument iscsi-swp will
51 also try to set/clear the flag on the target LUN.
52
53 iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1
54 SWP:0
55
56 iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1 --swp on
57 SWP:0
58 Turning SWP ON
59
60 iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1 --swp off
61 SWP:0
62 Turning SWP OFF
63
64
65 -d --debug=<INTEGER>
66 Debug level.
67
68 -? --help
69 Display basic help text.
70
71 --usage
72 Display basic usage text.
73
75 iscsi-inq(1), iscsi-ls(1) http://github.com/sahlberg/libiscsi
76
77
78
79iscsi-swp 03/22/2014 ISCSI-SWP(1)