diff options
| author | Lee Duncan <lduncan@suse.com> | 2022-03-25 07:54:18 -0700 |
|---|---|---|
| committer | Lee Duncan <lduncan@suse.com> | 2022-03-25 07:54:18 -0700 |
| commit | 9a2d2f2cf391c707a98204d488c3cb3e58cdab00 (patch) | |
| tree | b96c83ff4479e16f9032dcabf4435270f2ca6a9d /doc/iscsi-gen-initiatorname.8.template | |
| parent | 89df67cd154d43c9b8361880fbd0d94175ff65a1 (diff) | |
| download | open-iscsi-9a2d2f2cf391c707a98204d488c3cb3e58cdab00.tar.gz | |
Make DB and ISCSIHOME directories configurable.
This commit adds two new top-level build options: one
for the "home" directory for open-iscsi called "HOMEDIR",
and one for the "database" directory, called "DBROOT". One can
now override the defaults of "/etc/iscsi" for either or
both of these directories on the make command line.
The README and man pages are updated with details about
these new options.
Some Makefile cleanup/repair was done as well. Installation
of the initiatorname.iscsi file, was moved out of the top-level
Makefile into the etc subdirectory, and installation of man
ages moved from the top-level Makefile to the doc subdirectory.
Also, this fixes some issues from commit fd14dd8316b1 ("Clean
p Makefile build system."), which incorrectly changed the DESTDIR
ariable in the Makefiles. This current commit also fixes the
top-level variable names for moving DBROOT and HOMEDIR.
Diffstat (limited to 'doc/iscsi-gen-initiatorname.8.template')
| -rw-r--r-- | doc/iscsi-gen-initiatorname.8.template | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/iscsi-gen-initiatorname.8.template b/doc/iscsi-gen-initiatorname.8.template new file mode 100644 index 0000000..e10a4ac --- /dev/null +++ b/doc/iscsi-gen-initiatorname.8.template @@ -0,0 +1,36 @@ +.TH ISCSI_GEN_INITIATORNAME 8 "Dec 2021" "" "Linux Administrator's Manual" +.SH NAME +iscsi-gen-initiatorname \- smart iSCSI initiator name generation tool +.SH SYNOPSIS +.BI iscsi-gen-initiatorname +[OPTIONS] +.SH "DESCRIPTION" +.B iscsi-gen-initiatorname +generates a unique iSCSI node name on every invocation. If +iBFT is in use, the iBFT-registered initiator name will be used. +.P +If there is an existing initiator name, it will not be overwritten +unless the \fB-f\fP option is supplied. +.SH OPTIONS +.TP +.BI [-h] +Display a help message and exit. +.TP +.BI [-f] +Force overwrite of existing initiator name, if present. +.TP +.BI [-p] \fIIQN-PREFIX\fP +Use \fIIQN-PREFIX\fP as the prefix to the IQN generated, +instead of the default of \fBiqn.1996-04.de.suse:01\fP. +.SH FILES +.TP +@HOMEDIR@/initiatorname.iscsi +The file containing the initiator name. Do not edit manually. +.SH "SEE ALSO" +.BR iscsi-iname (8) +.SH AUTHORS +Open-iSCSI project <http://www.open-iscsi.com/> +.br +Hannes Reinecke <hare@suse.de> +.br +Lee Duncan <lduncan@suse.com> |