b=20805 rate limit D_NETERR messages

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

diff --git a/lustre/doc/tunefs.lustre.8 b/lustre/doc/tunefs.lustre.8
index ec1c46b..a795720 100644 (file)
--- a/lustre/doc/tunefs.lustre.8
+++ b/lustre/doc/tunefs.lustre.8
@@ -8,7 +8,7 @@ tunefs.lustre \- modify the Lustre configuration information on a disk
 .SH SYNOPSIS
 .br
 .B tunefs.lustre
-[options] 
+[options]
 .I device
 .br
 .SH DESCRIPTION
@@ -33,22 +33,29 @@ Only print what would be done; does not affect the disk
 .BI \--erase-params
 Remove all previous parameter info
 .TP
-.BI \--failnode= nid,...  
+.BI \--failnode= nid,...
 Set the NID(s) of a failover partner. This option can be repeated as desired.
 .TP
-.BI \--fsname= filesystem_name  
+.BI \--fsname= filesystem_name
 The Lustre filesystem this service will be part of.  Default is 'lustre'
 .TP
 .BI \--index= index
-Force a particular OST or MDT index 
+Force a particular OST or MDT index
 .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 \fBtunefs.lustre\fR,  this version
+completely replaces the existing 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 ldiskfs  are
+OST: \fIerrors=remount-ro,mballoc,extents\fR;
+MGS/MDT: \fIerrors=remount-ro,iopen_nopriv,user_xattr\fR.
+\fBDO NOT\fR alter the default mount options unless you know what you are doing.
 .TP
 .BI \--mgs
 Add a configuration management service to this target
 .TP
-.BI \--mgsnode= nid,...  
+.BI \--mgsnode= nid,...
 Set the NID(s) of the MGS node, required for all targets other than the MGS.
 .TP
 .BI \--nomgs
@@ -64,7 +71,7 @@ Print more information.
 Erase all config logs for the filesystem that this MDT is part of, and
 regenerate them.  This is very dangerous.  All clients and servers should
 be stopped.
-All targets must then be restarted to regenerate the logs.  
+All targets must then be restarted to regenerate the logs.
 No clients should be started until all targets have restarted.
 In general this should be executed on the MDT only, not the OSTs.
 
@@ -78,7 +85,7 @@ since they should all be contacting the same MGS.)
 Add a failover NID location for this target
 .TP
 .B tunefs.lustre --mgs --mdt --fsname=testfs /dev/sda
-Upgrade an old 1.4.X Lustre MDT to 1.6. The new filesystem name is "testfs". 
+Upgrade an old 1.4.X Lustre MDT to 1.6. The new filesystem name is "testfs".
 .TP
 .B tunefs.lustre --writeconf --mgs --mdt --fsname=testfs /dev/sda1
 Upgrade an old 1.4.X Lustre MDT to 1.6, and start with brand-new 1.6
@@ -88,8 +95,8 @@ configuration logs. All old servers and clients must be stopped.
 Please report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
 .SH AVAILABILITY
 .B tunefs.lustre
-is part of the 
-.BR Lustre (7) 
+is part of the
+.BR Lustre (7)
 filesystem package and is available from Sun Microsystems, Inc via
 .br
 http://downloads.lustre.org