ISCSI-INQ(1)

💖 iscsi-inq — the manual page, but make it a group chat 💖

okay bestie, gather round, because today we're learning about iscsi-inq, a lil utility from the iscsi-inq corner of the manual-verse (it's filed under section 1, for the record 🎀). she requests INQUIRY data from an iSCSI LUN and honestly? she ate. no cap. 💅

✨ NAME ✨

iscsi-inq — a utility to request INQUIRY data from an iSCSI LUN 🦋

🌸 SYNOPSIS 🌸

like, here's the shape of it:

iscsi-inq [ OPTIONS ] <ISCSI-URL>

and also, the fully spelled-out version, so you know exactly which flags exist and nothing is a mystery:

iscsi-inq [-i --initiator-name=<IQN>] [-e --evpd=<INTEGER>]
          [-c --pagecode=<INTEGER>] [-d --debug=<INTEGER>] [-? --help]
          [--usage] [<ISCSI-URL>]

👑 DESCRIPTION 👑

so basically: iscsi-inq is a utility to request INQUIRY data from an iSCSI LUN. that's the whole job. she asks, the LUN answers. iconic behaviour. ✨

🌈 ISCSI URL FORMAT 🌈

the iSCSI URL format is, drumroll please:

'iscsi://[<username>[%<password>]@]<host>[:<port>]/<target-iqn-name>/<lun>'

username and password are only required if the target requires CHAP authentication — so if your target is chill, you can skip them. and if you'd rather not type them into the URL at all, you can optionally hand them over via the environment variables LIBISCSI_CHAP_USERNAME and LIBISCSI_CHAP_PASSWORD. lowkey convenient. 🫶

host can be a hostname, an IPv4 address, or an IPv6 address. she's flexible like that. examples:

iscsi://192.0.2.1/iqn.ronnie.test/1
iscsi://[2001:DB8::1]:3261/iqn.ronnie.test/1
iscsi://ronnie%password@iscsi.example.com/iqn.ronnie.test/1

port is the TCP port on the target you're connecting to. default is 3260.

target-iqn-name is the iqn name of the target. heads up: one iSCSI portal can have multiple targets defined, so if you're not sure which ones are out there, use iscsi-ls to list all the targets available on one specific portal. 🧚

lun is the LUN number you want the INQUIRY data for. periodt.

💅 OPTIONS 💅

• -i, --initiator-name=<IQN> — this specifies the initiator-name that iscsi-inq will use when logging in to the target. the default name is iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-inq, but you can use this argument to override it. when do you actually need this? mainly in cases where the target is configured with access-control to only allow discovery logins from known initiator-names. so if you're getting rejected, this might be your girl. 💜
• -e, --evpd=<INTEGER> — by default iscsi-inq will display the standard inquiry data. specify evpd as 1 to display extended VPD pages instead. that's the switch. 🌸
• -c, --pagecode=<INTEGER> — this argument specifies which VPD page to display when evpd is requested. the default is 0x00, which represents SUPPORTED VPD PAGES. ✨

real talk: this argument can only be used when evpd is set to 1. don't try it otherwise, bestie, she's not gonna play. 😭

• -d, --debug=<INTEGER> — debug level. turn it up if you wanna see the ✨inner workings✨.
• -?, --help — display basic help text. the classic. 🙈
• --usage — display basic usage text. slightly different from help, and yes, both exist. 💀

🎀 EXAMPLES 🎀

wanna print the standard INQUIRY page? say less:

iscsi-inq iscsi://192.0.2.1/iqn.ronnie.test/1

wanna list the available pages? here:

iscsi-inq -e 1 iscsi://192.0.2.1/iqn.ronnie.test/1

wanna show one specific page? okay main character:

iscsi-inq -e 1 -c 0x80 iscsi://192.0.2.1/iqn.ronnie.test/1

🦋 SEE ALSO 🦋

• iscsi-ls(1)
• http://github.com/sahlberg/libiscsi

go forth and inquire, bestie. you've got this. 🔥

iscsi-inq 🌸 03/22/2014 🌸 that's the page, that's the date, that's the vibe. mwah. 💖✨👑