LU-14 utils: allow formatting OST without VIRGIN flag

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

diff --git a/lustre/doc/mkfs.lustre.8 b/lustre/doc/mkfs.lustre.8
index a891bf3..865448b 100644 (file)
--- a/lustre/doc/mkfs.lustre.8
+++ b/lustre/doc/mkfs.lustre.8
@@ -1,5 +1,8 @@
 .\" -*- nroff -*-
-.\" Copyright 2008 by Sun Microsystems.  All Rights Reserved.
+.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
+.\"
+.\" Copyright (c) 2011, 2012, Intel Corporation.
+.\"
 .\" This file may be copied under the terms of the GNU Public License.
 .\"
 .TH mkfs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
@@ -47,6 +50,11 @@ Only print what would be done; does not affect the disk
 .TP
 .BI \--failnode= nid,...  
 Set the NID(s) of a failover partner. This option can be repeated as desired.
+Cannot be used with --servicenode.
+.TP
+.BI \--servicenode= nid,....
+Set the NID(s) of all service partner. This option treats all nodes as equal
+service nodes. Cannot be used with --failnode.
 .TP
 .BI \--fsname= filesystem_name  
 The Lustre filesystem this service will be part of.  The maximum
@@ -59,7 +67,17 @@ Force a particular OST or MDT index
 Format options for the backing fs. For example, ext3 options could be set here.
 .TP
 .BI \--mountfsoptions= opts
-Set permanent mount options, equivalent to setting in /etc/fstab
+Set the mount options that will be used when mounting the backing fs.
+WARNING: unlike earlier versions of \fBmkfs.lustre\fR, this version completely
+replaces the default mount options with those specified on the command line,
+issuing a warning on stderr if any of the default mount options are omitted.
+The defaults for \fIldiskfs\fR are
+OST: \fIerrors=remount-ro,mballoc,extents\fR;
+MGS/MDT: \fIerrors=remount-ro,user_xattr\fR.
+\fBDO NOT\fR alter the default mount options unless you know what you are doing.
+.TP
+.BI \--network= net,...
+Network(s) to restrict this ost/mdt to. This option can be repeated as desired.
 .TP
 .BI \--mgsnode= nid,...  
 Set the NID(s) of the MGS node, required for all targets other than the MGS.
@@ -93,7 +111,14 @@ Return errors instead of waiting for recovery
 Print less information.
 .TP
 .BI \--reformat 
-Reformat an existing Lustre disk
+Reformat an existing Lustre disk as a new target
+.TP
+.BI \--replace
+Used to initialize a target with the same
+.I --index
+as a previously used target if the old target was permanently lost for
+some reason (e.g. multiple disk failure or massive corruption).  This
+avoids having the target try to register as a new target with the MGS.
 .TP
 .BI \--stripe-count-hint= stripes
 Used for optizing MDT inode size
@@ -115,15 +140,11 @@ Standalone MGS on e.g. node cfs22
 .B mkfs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
 MDT for filesystem 'myfs1' on any node, using the above MGS
 
-.SH BUGS
-Please report all bugs to Sun Microsystems via http://bugzilla.lustre.org/
 .SH AVAILABILITY
 .B mkfs.lustre
 is part of the 
 .BR Lustre (7) 
-filesystem package and is available from Sun Microsystems via
-.br
-http://downloads.lustre.org/
+filesystem package.
 .SH SEE ALSO
 .BR lustre (7),
 .BR mount.lustre (8),