diff options
Diffstat (limited to 'ReadMe.c')
-rw-r--r-- | ReadMe.c | 105 |
1 files changed, 55 insertions, 50 deletions
@@ -28,10 +28,10 @@ #include "mdadm.h" #ifndef VERSION -#define VERSION "4.0" +#define VERSION "4.1-rc1" #endif #ifndef VERS_DATE -#define VERS_DATE "2017-01-09" +#define VERS_DATE "2018-03-22" #endif char Version[] = "mdadm - v" VERSION " - " VERS_DATE "\n"; @@ -78,11 +78,11 @@ char Version[] = "mdadm - v" VERSION " - " VERS_DATE "\n"; * found, it is started. */ -char short_options[]="-ABCDEFGIQhVXYWZ:vqbc:i:l:p:m:n:x:u:c:d:z:U:N:sarfRSow1tye:"; +char short_options[]="-ABCDEFGIQhVXYWZ:vqbc:i:l:p:m:n:x:u:c:d:z:U:N:sarfRSow1tye:k:"; char short_bitmap_options[]= - "-ABCDEFGIQhVXYWZ:vqb:c:i:l:p:m:n:x:u:c:d:z:U:N:sarfRSow1tye:"; + "-ABCDEFGIQhVXYWZ:vqb:c:i:l:p:m:n:x:u:c:d:z:U:N:sarfRSow1tye:k:"; char short_bitmap_auto_options[]= - "-ABCDEFGIQhVXYWZ:vqb:c:i:l:p:m:n:x:u:c:d:z:U:N:sa:rfRSow1tye:"; + "-ABCDEFGIQhVXYWZ:vqb:c:i:l:p:m:n:x:u:c:d:z:U:N:sa:rfRSow1tye:k:"; struct option long_options[] = { {"manage", 0, 0, ManageOpt}, @@ -148,6 +148,7 @@ struct option long_options[] = { {"nodes",1, 0, Nodes}, /* also for --assemble */ {"home-cluster",1, 0, ClusterName}, {"write-journal",1, 0, WriteJournal}, + {"consistency-policy", 1, 0, 'k'}, /* For assemble */ {"uuid", 1, 0, 'u'}, @@ -341,7 +342,7 @@ char OptionHelp[] = */ char Help_create[] = -"Usage: mdadm --create device -chunk=X --level=Y --raid-devices=Z devices\n" +"Usage: mdadm --create device --chunk=X --level=Y --raid-devices=Z devices\n" "\n" " This usage will initialise a new md array, associate some\n" " devices with it, and activate the array. In order to create an\n" @@ -362,27 +363,29 @@ char Help_create[] = " other levels.\n" "\n" " Options that are valid with --create (-C) are:\n" -" --bitmap= : Create a bitmap for the array with the given filename\n" -" : or an internal bitmap is 'internal' is given\n" -" --chunk= -c : chunk size in kibibytes\n" -" --rounding= : rounding factor for linear array (==chunk size)\n" -" --level= -l : raid level: 0,1,4,5,6,10,linear,multipath and synonyms\n" -" --parity= -p : raid5/6 parity algorithm: {left,right}-{,a}symmetric\n" -" --layout= : same as --parity, for RAID10: [fno]NN \n" -" --raid-devices= -n : number of active devices in array\n" -" --spare-devices= -x: number of spare (eXtra) devices in initial array\n" -" --size= -z : Size (in K) of each drive in RAID1/4/5/6/10 - optional\n" -" --data-offset= : Space to leave between start of device and start\n" -" : of array data.\n" -" --force -f : Honour devices as listed on command line. Don't\n" -" : insert a missing drive for RAID5.\n" -" --run -R : insist of running the array even if not all\n" -" : devices are present or some look odd.\n" -" --readonly -o : start the array readonly - not supported yet.\n" -" --name= -N : Textual name for array - max 32 characters\n" -" --bitmap-chunk= : bitmap chunksize in Kilobytes.\n" -" --delay= -d : bitmap update delay in seconds.\n" -" --write-journal= : Specify journal device for RAID-4/5/6 array\n" +" --bitmap= -b : Create a bitmap for the array with the given filename\n" +" : or an internal bitmap if 'internal' is given\n" +" --chunk= -c : chunk size in kibibytes\n" +" --rounding= : rounding factor for linear array (==chunk size)\n" +" --level= -l : raid level: 0,1,4,5,6,10,linear,multipath and synonyms\n" +" --parity= -p : raid5/6 parity algorithm: {left,right}-{,a}symmetric\n" +" --layout= : same as --parity, for RAID10: [fno]NN \n" +" --raid-devices= -n : number of active devices in array\n" +" --spare-devices= -x : number of spare (eXtra) devices in initial array\n" +" --size= -z : Size (in K) of each drive in RAID1/4/5/6/10 - optional\n" +" --data-offset= : Space to leave between start of device and start\n" +" : of array data.\n" +" --force -f : Honour devices as listed on command line. Don't\n" +" : insert a missing drive for RAID5.\n" +" --run -R : insist of running the array even if not all\n" +" : devices are present or some look odd.\n" +" --readonly -o : start the array readonly - not supported yet.\n" +" --name= -N : Textual name for array - max 32 characters\n" +" --bitmap-chunk= : bitmap chunksize in Kilobytes.\n" +" --delay= -d : bitmap update delay in seconds.\n" +" --write-journal= : Specify journal device for RAID-4/5/6 array\n" +" --consistency-policy= : Specify the policy that determines how the array\n" +" -k : maintains consistency in case of unexpected shutdown.\n" "\n" ; @@ -556,28 +559,30 @@ char Help_grow[] = "reconfiguration.\n" "\n" "Options that are valid with the grow (-G --grow) mode are:\n" -" --level= -l : Tell mdadm what level to convert the array to.\n" -" --layout= -p : For a FAULTY array, set/change the error mode.\n" -" : for other arrays, update the layout\n" -" --size= -z : Change the active size of devices in an array.\n" -" : This is useful if all devices have been replaced\n" -" : with larger devices. Value is in Kilobytes, or\n" -" : the special word 'max' meaning 'as large as possible'.\n" -" --assume-clean : When increasing the --size, this flag will avoid\n" -" : a resync of the new space\n" -" --chunk= -c : Change the chunksize of the array\n" -" --raid-devices= -n : Change the number of active devices in an array.\n" -" --add= -a : Add listed devices as part of reshape. This is\n" -" : needed for resizing a RAID0 which cannot have\n" -" : spares already present.\n" -" --bitmap= -b : Add or remove a write-intent bitmap.\n" -" --backup-file= file : A file on a different device to store data for a\n" -" : short time while increasing raid-devices on a\n" -" : RAID4/5/6 array. Also needed throughout a reshape\n" -" : when changing parameters other than raid-devices\n" -" --array-size= -Z : Change visible size of array. This does not change\n" -" : any data on the device, and is not stable across restarts.\n" -" --data-offset= : Location on device to move start of data to.\n" +" --level= -l : Tell mdadm what level to convert the array to.\n" +" --layout= -p : For a FAULTY array, set/change the error mode.\n" +" : for other arrays, update the layout\n" +" --size= -z : Change the active size of devices in an array.\n" +" : This is useful if all devices have been replaced\n" +" : with larger devices. Value is in Kilobytes, or\n" +" : the special word 'max' meaning 'as large as possible'.\n" +" --assume-clean : When increasing the --size, this flag will avoid\n" +" : a resync of the new space\n" +" --chunk= -c : Change the chunksize of the array\n" +" --raid-devices= -n : Change the number of active devices in an array.\n" +" --add= -a : Add listed devices as part of reshape. This is\n" +" : needed for resizing a RAID0 which cannot have\n" +" : spares already present.\n" +" --bitmap= -b : Add or remove a write-intent bitmap.\n" +" --backup-file= file : A file on a different device to store data for a\n" +" : short time while increasing raid-devices on a\n" +" : RAID4/5/6 array. Also needed throughout a reshape\n" +" : when changing parameters other than raid-devices\n" +" --array-size= -Z : Change visible size of array. This does not change any\n" +" : data on the device, and is not stable across restarts.\n" +" --data-offset= : Location on device to move start of data to.\n" +" --consistency-policy= : Change the consistency policy of an active array.\n" +" -k : Currently works only for PPL with RAID5.\n" ; char Help_incr[] = @@ -604,7 +609,7 @@ char Help_incr[] = ; char Help_config[] = -"The /etc/mdadm/mdadm.conf config file:\n\n" +"The /etc/mdadm.conf config file:\n\n" " The config file contains, apart from blank lines and comment lines that\n" " start with a hash(#), array lines, device lines, and various\n" " configuration lines.\n" |