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>

                                             APR 2022                  ISCSI_GEN_INITIATORNAME(8)