Whamcloud - gitweb
LU-4862 doc: Update lctl man page for LFSCK phase 2
[fs/lustre-release.git] / lustre / doc / lctl.8
index 0e87c83..a9bc9a0 100644 (file)
@@ -190,12 +190,19 @@ When -N specified, add '/', '@' or '=' for directories, symlinks and writeable f
 .br
 lctl "get_param -NF" is equivalent to "list_param -F".
 .TP
-.BI set_param " [-n] <parameter=value ...>"
+.BI set_param " [-n] [-P] [-d] <parameter=value ...>"
 Set the value of Lustre or LNET parameter.
 .br
 .B -n
 Disable printing of the key name when printing values.
 .br
+.B -P
+Set the parameter permanently, filesystem-wide.
+This parameters are only visible to 2.5.0 and later clients, older clients will not see these parameters.
+.br
+.B -d
+Remove the permanent setting (only with -P option)
+.br
 .B Examples:
 .br
 .B
@@ -211,6 +218,10 @@ Disable printing of the key name when printing values.
   0
 .br
   20
+.br
+.B
+# lctl set_param -P osc.*.max_dirty_mb=32
+.br
 .TP
 .BI conf_param " [-d] <device|fsname>.<parameter>=<value>"
 Set a permanent configuration parameter for any device via the MGS.  This
@@ -282,53 +293,75 @@ will not be purged beyond any registered users' set point. (See lfs changelog_cl
 .BI changelog_deregister " <id>"
 Unregister an existing changelog user.  If the user's "clear" record number
 is the minimum for the device, changelog records will be purged until the
-next minimum.  
+next minimum.
 .PP
 .SS LFSCK
 An on-line Lustre consistency check and repair tool.
 .TP
-.B lfsck_start \fR<-M | --device MDT_device>
+.B lfsck_start \fR<-M | --device [MDT,OST]_device>
      \fR[-e | --error <error_handle>]
      \fR[-h | --help]
      \fR[-n | --dryrun <switch>]
      \fR[-r | --reset]
      \fR[-s | --speed <speed_limit>]
+     \fR[-A | --all]
      \fR[-t | --type <lfsck_type[,lfsck_type...]>]
+     \fR[-w | --windows <win_size>]
+     \fR[-o | --orphan]
 .br
-Start LFSCK on the specified MDT device with specified parameters.
+Start LFSCK on the specified MDT or OST device with specified parameters.
 .TP
-  -M, --device <MDT_device>
-The MDT device to check.
+  -M, --device <MDT,OST_device>
+The MDT or OST device to start LFSCK/scrub on.
 .TP
   -e, --error <error_handle>
 With error_handle as 'abort' LFSCK will stop if a repair is impossible. If no
 value is specified, the saved value will be used if resuming from a checkpoint.
-Otherwise the default behavior is to 'continue' if a rapair is impossible.
+Otherwise the default behavior is to 'continue' if a repair is impossible.
 .TP
   -h, --help
 Show this help.
 .TP
   -n, --dryrun <on|off>
-Perform a trial run with no changes made.
+Perform a trial run with no changes made. Default is 'off'
 .TP
   -r, --reset
-Set the current position of LFSCK progress to the beginning of the specified
-MDT.
+Set the current position of object iteration to the beginning of the specified
+MDT. By default the iterator will resume scanning from the last checkpoint
+(saved periodically by LFSCK) provided it is available.
 .TP
   -s, --speed <speed_limit>
 Set the upper limit of LFSCK processing in objects per second. If no value is
 specified the saved value is used (if resuming from a check point). Otherwise
 the default value of 0 is used. 0 means run as fast as possible.
 .TP
+  -A, --all
+Start LFSCK on all devices.
+.TP
   -t, --type <lfsck_type[,lfsck_type...]>
-Specify the type of LFSCK to execute. By default, OI Scrub is executed.
-Alternative types include FID-in-dirent and linkEA (namespace).
+The type of LFSCK checking/repair to execute. By default, the LFSCK
+component(s) which ran last time and did not finish or the component(s)
+corresponding to some known system inconsistency, will be started. Anytime
+LFSCK is triggered on an ldiskfs MDT or OST, the OI Scrub is executed.
+Alternative types include FID-in-dirent and linkEA (namespace) and MDT-OST
+inconsistency (layout).
+.TP
+  -w, --windows
+The window size for async requests pipeline.
+.TP
+  -o, --orphan
+Handle orphan objects, such as orphan OST-objects for layout LFSCK.
+.TP
+.B lfsck_stop  \fR<-M | --device [MDT,OST]_device>
+     \fR[-A | --all]
+     \fR[-h | --help]
+Stop LFSCK on the specified MDT or OST device.
 .TP
-.B lfsck_stop  \fR<-M | --device MDT_device> [-h | --help]
-Stop LFSCK on the specified MDT device.
+  -M, --device <[MDT,OST]_device>
+The MDT or OST device to stop LFSCK/scrub on.
 .TP
-  -M, --device <MDT_device>
-The MDT device.
+  -A, --all
+Stop LFSCK on all devices.
 .TP
   -h, --help
 Show this help.