util: make env checking more generic

[thirdparty/mdadm.git] / mdadm.8

diff --git a/mdadm.8 b/mdadm.8
index ab659fcb02c40d0ed8d2867310b454a52d38c509..9f62b012a6f7990101c9add4796e71dcac2390d5 100644 (file)
--- a/mdadm.8
+++ b/mdadm.8
@@ -5,7 +5,7 @@
 .\"   the Free Software Foundation; either version 2 of the License, or
 .\"   (at your option) any later version.
 .\" See file COPYING in distribution for details.
-.TH MDADM 8 "" v2.6.7
+.TH MDADM 8 "" v3.0-devel1
 .SH NAME
 mdadm \- manage MD devices
 .I aka
@@ -905,6 +905,17 @@ the system to be marked as failed.  It can then be removed.
 same as
 .BR \-\-fail .
 
+.TP
+.BR \-\-write\-mostly
+Subsequent devices that are added or re-added will have the 'write-mostly'
+flag set.  This is only valid for RAID! and means that the 'md' driver
+will avoid reading from these devices if possible.
+.TP
+.BR \-\-readwrite
+Subsequent devices that are added or re-added will have the 'write-mostly'
+flag cleared.
+
+
 .P
 Each of these options require that the first device listed is the array
 to be acted upon, and the remainder are component devices to be added,
@@ -1016,9 +1027,16 @@ listed, otherwise it will return failure.
 
 .TP
 .BR \-\-wait\-clean
-For each md device given, wait for the array to be marked clean before
-returning.  For native arrays this returns immediately as the kernel
-handles dirty-clean transistions at shutdown.  
+For each md device given, arrange for the array to be marked clean as
+soon as possible.  Also, quiesce resync so that the monitor for external
+metadata arrays (mdmon) has an opportunity to checkpoint the resync
+position.
+.I mdadm
+will return with success if the array uses external metadata and we
+successfully waited.  For native arrays this returns immediately as the
+kernel handles both dirty-clean transitions and resync checkpointing in
+the kernel at shutdown.  No action is taken if safe-mode handling is
+disabled.
 
 .SH For Incremental Assembly mode:
 .TP
@@ -2131,11 +2149,8 @@ configuration file at all.
 .SH SEE ALSO
 For further information on mdadm usage, MD and the various levels of
 RAID, see:
-
 .IP
-.UR http://linux-raid.osdl.org/
-http://linux\-raid.osdl.org/
-.UE
+.B http://linux\-raid.osdl.org/
 .PP
 (based upon Jakob \(/Ostergaard's Software\-RAID.HOWTO)
 .\".PP
@@ -2156,9 +2171,9 @@ The latest version of
 .I mdadm
 should always be available from
 .IP
-.UR http://www.kernel.org/pub/linux/utils/raid/mdadm/
-http://www.kernel.org/pub/linux/utils/raid/mdadm/
-.UE
+.B http://www.kernel.org/pub/linux/utils/raid/mdadm/
+.PP
+Related man pages:
 .PP
 .IR mdadm.conf (5),
 .IR md (4).