ISCSI-SWP(1)

💖 ISCSI-SWP 💖

okay so bestie, welcome to iscsi-swp(1) — the iscsi-swp: get/set software w page, no cap. it's the lil utility that peeks at (or flips!) the software write protect bit on an iSCSI LUN. lowkey iconic, highkey useful. let's go 🦋

✨ 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]

yes, the second line really does say iscsi-ls, and yes, i am copying it exactly character for character because that is simply what the page says. not my business, not my problem, we stay in our lane 💅

✨ DESCRIPTION ✨

iscsi-swp is a utility to get or set the software write protect on an iSCSI LUN. that's the whole gig. short, sweet, serves 💖

🌈 ISCSI PORTAL URL FORMAT 🌈

the 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, bestie:

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. periodt.

✨ 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. iykyk 🔥

• -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) — and http://github.com/sahlberg/libiscsi 🧚

🎀 bye bestie 🎀

that's the whole page, you ate it. this was iscsi-swp from the iscsi-swp source, dated 03/22/2014 — go forth and protect those writes (or don't, your call, --swp off exists for a reason). 💜 ✨ 💅