From 3c7efacb7d4b9a54f0c1e24a50bb1099612e3e5b Mon Sep 17 00:00:00 2001 From: Namhyung Kim Date: Wed, 22 Jun 2011 01:19:03 +0900 Subject: mdadm.8: move description of --add under Grow mode It is supposed to be under Grow mode. Since Create/Build/Grow modes use common options and '-a' is already used for '--auto' in Create/ Build modes, describe it to avoid confusion. Signed-off-by: NeilBrown --- mdadm.8.in | 49 +++++++++++++++++++++++++++---------------------- 1 file changed, 27 insertions(+), 22 deletions(-) diff --git a/mdadm.8.in b/mdadm.8.in index 44accc0..d56cd98 100644 --- a/mdadm.8.in +++ b/mdadm.8.in @@ -811,6 +811,11 @@ number, and there is no entry in /dev for that number and with a non-standard name. Names that are not in 'standard' format are only allowed in "/dev/md/". +This is meaningful with +.B \-\-create +or +.BR \-\-build . + .ig XX .\".TP .\".BR \-\-symlink = no @@ -835,6 +840,28 @@ allowed in "/dev/md/". .\" .XX +.TP +.BR \-a ", " "\-\-add" +This option can be used in Grow mode in two cases. + +If the target array is a Linear array, then +.B \-\-add +can be used to add one or more devices to the array. They +are simply catenated on to the end of the array. Once added, the +devices cannot be removed. + +If the +.B \-\-raid\-disks +option is being used to increase the number of devices in an array, +then +.B \-\-add +can be used to add some extra devices to be included in the array. +In most cases this is not needed as the extra devices can be added as +spares first, and then the number of raid-disks can be changed. +However for RAID0, it is not possible to add spares. So to increase +the number of devices in a RAID0, it is necessary to set the new +number of devices, and to add the new devices, in the same command. + .SH For assemble: .TP @@ -911,28 +938,6 @@ not as reliable as you would like. .BR \-a ", " "\-\-auto{=no,yes,md,mdp,part}" See this option under Create and Build options. -.TP -.BR \-a ", " "\-\-add" -This option can be used in Grow mode in two cases. - -If the target array is a Linear array, then -.B \-\-add -can be used to add one or more devices to the array. They -are simply catenated on to the end of the array. Once added, the -devices cannot be removed. - -If the -.B \-\-raid\-disks -option is being used to increase the number of devices in an array, -then -.B \-\-add -can be used to add some extra devices to be included in the array. -In most cases this is not needed as the extra devices can be added as -spares first, and then the number of raid-disks can be changed. -However for RAID0, it is not possible to add spares. So to increase -the number of devices in a RAID0, it is necessary to set the new -number of devices, and to add the new devices, in the same command. - .TP .BR \-b ", " \-\-bitmap= Specify the bitmap file that was given when the array was created. If -- cgit v1.2.1