From 87eb4fabe316461cd1ad1600d41a81cd29882961 Mon Sep 17 00:00:00 2001 From: NeilBrown Date: Tue, 1 Feb 2011 15:06:44 +1100 Subject: Various man page fixes. Signed-off-by: NeilBrown --- mdadm.8.in | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) (limited to 'mdadm.8.in') diff --git a/mdadm.8.in b/mdadm.8.in index 4b82fdcc..6b5017f1 100644 --- a/mdadm.8.in +++ b/mdadm.8.in @@ -1332,8 +1332,13 @@ not a name in .TP .BR \-\-path= -Only used with \-\-fail. Allows the failed device to be automatically replaced -by a new device without metadata if it appears at specified path. +Only used with \-\-fail. The 'path' given will be recorded so that if +a new device appears at the same location it can be automatically +added to the same array. This allows the failed device to be +automatically replaced by a new device without metadata if it appears +at specified path. This option is normally only set by a +.I udev +script. .SH For Monitor mode: .TP @@ -1408,15 +1413,11 @@ message do get through successfully. .TP .BR \-\-no\-sharing -Allows to run monitoring without moving spares between arrays. +This inhibits the functionality for moving spares between arrays. Only one monitoring process started with .B \-\-scan -is allowed. -Any subsequent call of -.B mdadm \-F \-\-scan -must also use -.B \-\-no\-sharing -option. +but without this flag is allowed, otherwise the two could interfere +with each other. .SH ASSEMBLE MODE @@ -1819,7 +1820,7 @@ or .B \-\-scan will cause the output to be less detailed and the format to be suitable for inclusion in -.BR /etc/mdadm.conf . +.BR mdadm.conf . The exit status of .I mdadm will normally be 0 unless @@ -1896,7 +1897,7 @@ or is given, then multiple devices that are components of the one array are grouped together and reported in a single entry suitable for inclusion in -.BR /etc/mdadm.conf . +.BR mdadm.conf . Having .B \-\-scan @@ -2150,7 +2151,7 @@ the original array. If the spare group for a degraded array is not defined, .I mdadm will look at the rules of spare migration specified by POLICY lines in -.B /etc/mdadm.conf +.B mdadm.conf and then follow similar steps as above if a matching spare is found. .SH GROW MODE @@ -2335,8 +2336,8 @@ adds the device to the array and conditionally starts the array. Note that .I mdadm -will always add devices to an array which were previously working -(active or spare) parts of that array. The support for automatic +will normally only add devices to an array which were previously working +(active or spare) parts of that array. The support for automatic inclusion of a new drive as a spare in some array requires a configuration through POLICY in config file. @@ -2671,7 +2672,9 @@ avoid conflicted between multiple arrays that have the same name. If .I mdadm can reasonably determine that the array really is meant for this host, either by a hostname in the metadata, or by the presence of the array -in /etc/mdadm.conf, then it will leave off the suffix if possible. +in +.BR mdadm.conf , +then it will leave off the suffix if possible. Also if the homehost is specified as .B .I mdadm -- cgit v1.2.3