TGT-SETUP-LUN(8)

📦
version 1.0.98 · 13 versions
, in alpine 3.24, arch rolling

🌸 TGT-SETUP-LUN(8) — bestie, this is the manual page for tgt-setup-lun 🌸

hiii okay so this is TGT-SETUP-LUN(8), aka the manual page for tgt-setup-lun in section 8, and the header manual tag is literally [FIXME: manual]. We're folding that in right here so nothing gets lost, bestie 💖

🎀 NAME 🎀

  • tgt-setup-lun — a helper script that creates a target, adds a device to the target, and defines initiators that can connect to the target.

✨ SYNOPSIS ✨

The whole summoning spell is:

tgt-setup-lun -d <device> -n <targetname> [-b <bsname>] [-t <transport>]
              [-C <control_port>] [initiator_IP...] [-h]

🦋 DESCRIPTION 🦋

So it creates a target according to the supplied target_name. Important vibe check: tgtd must be running. No cap, that's non-negotiable.

The format of the default IQN generated from the target name is:

iqn.2001-04.com.<hostname>-<target_name>

…or a complete IQN may be given. Either way, the target name must be unique — literally unique, okay? Don't be out here reusing names 💅

The script then adds the requested device to the target. If specific IP addresses are defined, it adds them to the list of allowed initiators for that target. If no IP addresses is defined, it defines that the target accepts any initiator. That's the whole plot 🫶

bestie, tgtd must be running. Like, actually running. The script is not gonna manifest it out of vibes ✨

🌈 EXAMPLES 🌈

Create a target that uses /dev/sdb1 and allows connections only from 192.168.10.81:

tgt-setup-lun -d /dev/sdb1 -n my_target 192.168.10.81

Create a target that uses /dev/sdb1 and allows connections only from 192.168.10.81 and 192.168.10.82:

tgt-setup-lun -d /dev/sdb1 -n my_target 192.168.10.81 192.168.10.82

Create a target that uses /dev/sdb1 and allows connections from any initiator:

tgt-setup-lun -d /dev/sdb1 -n my_target

Display help:

tgt-setup-lun -h

👑 AUTHOR 👑

Written by Erez Zilber. Shoutout to Erez, iconic behavior ✨

🧚 SEE ALSO 🧚

💀 REPORTING BUGS 💀

Report bugs to <stgt@vger.kernel.org>.

Copyright � Voltaire Ltd. 2008.

mwah 💋 final sign-off cuteness: source/version is [FIXME: source], date is 11/01/2026, and the manual name is TGT-SETUP-LUN(8). bye bestie, go slay your targets 🫶🎀

📦 where this page comes from