iscsi-swp

1 iscsi-swp iscsi-swp: get/set software write protect

iscsi-swp

Utility to get/set software write protect on an iSCSI LUN

    		iscsi-swp [ OPTIONS ] <ISCSI-PORTAL>

    		iscsi-ls
    		-i --initiator-name=<IQN>
    		-s --swp {on|off}
    		-d --debug=<INTEGER>
    		-? --help
    		--usage

## DESCRIPTION

iscsi-swp is a utility to get or set the software write protect on an iSCSI LUN.

## 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

Port is the TCP port on the target to connect to. Default is 3260.

## 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 --swp {on|off}

- By default iscsi-swp will only print the current setting of the software write protect bit. By using this argument iscsi-swp will also try to set/clear the flag on the target LUN.

      iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1
      SWP:0

      iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1 --swp on
      SWP:0
      Turning SWP ON

      iscsi-swp iscsi://127.0.0.1/iqn.ronnie.test/1 --swp off
      SWP:0
      Turning SWP OFF

-d --debug=<INTEGER>

- Debug level.

-? --help

- Display basic help text.

--usage

- Display basic usage text.

## SEE ALSO

iscsi-inq(1), iscsi-ls(1)