---
name: "iscsi-swp"
section: "1"
platform: "linux"
package: "libiscsi"
version: "1.20.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/iscsi-swp"
---

# iscsi-swp(1)

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

## 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=\<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-inq/1.md), [iscsi-ls(1)](/iscsi-ls/1.md) **http://github.com/sahlberg/libiscsi**