Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
ISCSI-SWP(1)		  iscsi-swp: get/set software w 	    ISCSI-SWP(1)

NAME
     iscsi-swp - Utility to get/set software write protect on an iSCSI LUN

SYNOPSIS
     iscsi-swp [ OPTIONS ] <ISCSI-PORTAL>

     iscsi-ls [-i --initiator-name=<IQN>] [-s --swp {on|off}] [-d --debug=<INTE-
	      GER>] [-? --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 authen-
     tication.	Optionally you can specify the username and password via the en-
     vironment variables LIBISCSI_CHAP_USERNAME and LIBISCSI_CHAP_PASSWORD.

     Host can be specified either as a hostname, an IPv4 address or an IPv6  ad-
     dress. 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  soft-
	 ware  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) http://github.com/sahlberg/libiscsi

iscsi-swp			   03/22/2014			    ISCSI-SWP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=iscsi-swp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help