LU-9752 man: Reference zgenhostid instead of genhostid

[fs/lustre-release.git] / lustre / doc / mkfs.lustre.8

diff --git a/lustre/doc/mkfs.lustre.8 b/lustre/doc/mkfs.lustre.8
index 9f0bc47..9b2245c 100644 (file)
--- a/lustre/doc/mkfs.lustre.8
+++ b/lustre/doc/mkfs.lustre.8
@@ -1,7 +1,7 @@
 .\" -*- nroff -*-
 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
 .\"
-.\" Copyright (c) 2011, 2014, Intel Corporation.
+.\" Copyright (c) 2011, 2016, Intel Corporation.
 .\"
 .\" This file may be copied under the terms of the GNU Public License.
 .\"
@@ -111,7 +111,7 @@ Set permanent parameter
 .I key
 to value
 .IR value .
-This option can be repeated as desired.  Typical options might include:
+This option can be repeated as desired. Typical options might include:
 .RS
 .I \--param sys.timeout=40
 .RS
@@ -147,12 +147,30 @@ avoids having the target try to register as a new target with the MGS.
 .BI \--stripe-count-hint= stripes
 Used for optizing MDT inode size
 .TP
+.BI \--force-nohostid
+Ignore unset hostid for ZFS import protection. To set hostid either set
+spl_hostid parameter for spl.ko or set /etc/hostid, see zgenhostid(8).  To
+populate the spl_hostid parameter, spl.ko must be (re)loaded after /etc/hostid is
+created.
+
+.TP
 .BI \--verbose
 Print more information.
 .TP
 .BI \--version
 Output build version of the mkfs.lustre utiltiy.
 
+.SH NID
+A Lustre network identifier (NID) is used to uniquely identify a Lustre network
+endpoint by node ID and network type. The format of the NID is:
+\fInetwork_id@network_type\fR.
+If a node has multiple network interfaces, it may have multiple NIDs, which must
+all be identified so other nodes can choose the NID that is appropriate for
+their network interfaces. Typically, NIDs are specified in a list delimited by
+commas (,). However, when failover nodes are specified, the NIDs are delimited
+by a colon (:) or by repeating a keyword such as \fI--mgsnode=\fR or
+\fI--servicenode=\fR.
+
 .SH EXAMPLES
 .TP
 .B mkfs.lustre --fsname=testfs --index=0 --mdt --mgs /dev/sda1
@@ -161,6 +179,13 @@ Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21
 .B mkfs.lustre --fsname=testfs --index=0 --ost --mgsnode=cfs21@tcp0 /dev/sdb
 OST for filesystem 'testfs' on any node using the above MGS.
 .TP
+.B mkfs.lustre --fsname=testfs --index=0 --mdt --mgs --servicenode=cfs21@tcp0,cfs21ib@o2ib0 --servicenode=cfs22@tcp0,cfs22ib@o2ib0 /dev/sda1
+Combined MGS and MDT for filesystem 'testfs' on failover pair cfs21 and cfs22.
+.TP
+.B mkfs.lustre --fsname=testfs --index=0 --ost --mgsnode=cfs21@tcp0,cfs21ib@o2ib0:cfs22@tcp0,cfs22ib@o2ib0 --failnode=cfs24@tcp0,cfs24ib@o2ib0 /dev/sdb
+OST for filesystem 'testfs' using the above MGS and having a failover partner
+cfs24.
+.TP
 .B mkfs.lustre --mgs /dev/sda1
 Standalone MGS on e.g. node cfs22
 .TP