tgt-setup-lun - Man Page

Helper script that creates a target, adds a device to the target, and defines initiators that can connect to the target

Synopsis

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

Description

Creates a target according to the supplied target_name​. tgtd must be running​. 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​. The target name must be unique​.

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

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

See Also

targets​.conf(5), tgtd(8), tgtadm(8), tgtimg(8), tgt-admin(8)​. https://github.com/fujita/tgt

Reporting Bugs

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

Info

08/18/2026