NAME¶

iscsi-gen-initiatorname - smart iSCSI initiator name generation tool

SYNOPSIS¶

iscsi-gen-initiatorname [OPTIONS]

DESCRIPTION¶

iscsi-gen-initiatorname generates an iSCSI Initiator Name in the initiatorname.iscsi file. It is an error to try to overwrite an existing Initiator Name, unless the -f (force) option is supplied.

The Initiator Name will be taken from the kernel command line, if present (from the rd.initiatorname parameter), else from the iBFT subsystem (if present in sysfs), else it will be generated using the iscsi-iname command.

It is an error if both the kernel command-line Initiator Name and the iBFT Initiator Name are both set, and they are different. it is also an error to try to write over an Initiator Name file if it read-only, or to create one if its directory is not writable.

You must be root to run this command.

OPTIONS¶

[-h]

Display a help message and exit.

[-f]

Force overwrite of existing initiator name, if present.

[-p]IQN-PREFIX

Use IQN-PREFIX as the prefix to the IQN generated, instead of the default of iqn.1996-04.de.suse:01.

FILES¶

/etc/iscsi/initiatorname.iscsi

The file containing the initiator name. Do not edit manually.

SEE ALSO¶

iscsi-iname(8)

AUTHORS¶

Open-iSCSI project <http://www.open-iscsi.com/>
Hannes Reinecke <hare@suse.de>
Lee Duncan <lduncan@suse.com>