ISCSI-MD5SUM(1)

✨ ISCSI-MD5SUM(1) ✨

okay so bestie, welcome to iscsi-md5sum(1) — the little utility that does the absolute most with MD5 💅 it's part of the iSCSI crew and it's here to hash a chunk of your LUN for you. no cap.

🌸 NAME 🌸

iscsi-md5sum — utility to calculate the MD5 value of an iSCSI LUN at range [LBAm, LBAn)

🎀 SYNOPSIS 🎀

iscsi-md5sum [ OPTIONS ] <ISCSI-PORTAL>

iscsi-md5sum [-i --initiator-name=<IQN>] [-o --offset] [-l --length]
             [-d --debug] [-? --help] [--usage]

🦋 DESCRIPTION 🦋

so iscsi-md5sum is literally a utility that calculates the MD5 value of an iSCSI LUN at range [LBAm, LBAn). that's it, that's the whole vibe. it's giving "trust but verify" ✨

💖 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, fr fr. optionally you can specify the username and password via the environment variables LIBISCSI_CHAP_USERNAME and LIBISCSI_CHAP_PASSWORD instead — your call, bestie 🫶

host can be specified either as a hostname, an IPv4 address or an IPv6 address. examples, since we love a visual:

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. iconic default behavior ngl 👑

🌈 OPTIONS 🌈

• -i, --initiator-name=<IQN> — this specifies the initiator-name that iscsi-md5sum will use when logging in to the target.

the default name is 'iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-md5sum' but you can use this argument to override it. this is mainly needed for cases where the target is configured with access-control to only allow discovery logins from known initiator-names. like, it's the bouncer checking the guest list and your IQN is your name on it 💅

• -o, --offset — byte offset into the target from which to start calculating. the provided value must be aligned to the target sector size. the default value is zero.
• -l, --length — the number of bytes to calculate (counting from the starting point). the provided value must be aligned to the target sector size. if the specified value extends past the end of the device, iscsi-md5sum will stop at the device size boundary. the default value extends to the end of the device. she knows when to stop, periodt 🛑
• -d, --debug — print debug information. when things get weird, this is your bestie 🔍
• -?, --help — display basic help text.
• --usage — display basic usage text.

👑 AUTHOR 👑

zhenwei pi <pizhenwei@bytedance.com>

💜 SEE ALSO 💜

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

and that's the whole page, bestie!! 🎀✨ this one is iscsi-md5sum, dated 10/25/2023, and the manual name is ISCSI-MD5SUM(1) — go forth and hash responsibly, ily 💖