X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=ReadMe.c;h=4d871e9d3c0e27a88750326535361154318d1d7f;hb=20dc76d15b40c17b4ccdc3d6283af8ecb513707f;hp=def75ec6c802f8a9575f63cc6aa4e93625a0dbd1;hpb=40c9a66a5c1a89d621daa2184888e66952b06a71;p=thirdparty%2Fmdadm.git diff --git a/ReadMe.c b/ReadMe.c index def75ec6..4d871e9d 100644 --- a/ReadMe.c +++ b/ReadMe.c @@ -1,7 +1,8 @@ /* * mdadm - manage Linux "md" devices aka RAID arrays. * - * Copyright (C) 2001-2012 Neil Brown + * Copyright (C) 2001-2016 Neil Brown + * Copyright (C) 2016-2017 Jes Sorensen * * * This program is free software; you can redistribute it and/or modify @@ -20,11 +21,19 @@ * * Author: Neil Brown * Email: + * Maintainer: Jes Sorensen + * Email: */ #include "mdadm.h" -char Version[] = Name " - v3.2.5 - 18th May 2012\n"; +#ifndef VERSION +#define VERSION "4.0" +#endif +#ifndef VERS_DATE +#define VERS_DATE "2017-01-09" +#endif +char Version[] = "mdadm - v" VERSION " - " VERS_DATE "\n"; /* * File: ReadMe.c @@ -69,11 +78,11 @@ char Version[] = Name " - v3.2.5 - 18th May 2012\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}, @@ -95,6 +104,10 @@ struct option long_options[] = { {"update-subarray", 1, 0, UpdateSubarray}, {"udev-rules", 2, 0, UdevRules}, {"offroot", 0, 0, OffRootOpt}, + {"examine-badblocks", 0, 0, ExamineBB}, + + {"dump", 1, 0, Dump}, + {"restore", 1, 0, Restore}, /* synonyms */ {"monitor", 0, 0, 'F'}, @@ -126,10 +139,16 @@ struct option long_options[] = { {"bitmap-chunk", 1, 0, BitmapChunk}, {"write-behind", 2, 0, WriteBehind}, {"write-mostly",0, 0, WriteMostly}, + {"failfast", 0, 0, FailFast}, + {"nofailfast",0, 0, NoFailFast}, {"re-add", 0, 0, ReAdd}, {"homehost", 1, 0, HomeHost}, {"symlinks", 1, 0, Symlinks}, {"data-offset",1, 0, DataOffset}, + {"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'}, @@ -143,9 +162,13 @@ struct option long_options[] = { /* Management */ {"add", 0, 0, Add}, + {"add-spare", 0, 0, AddSpare}, + {"add-journal", 0, 0, AddJournal}, {"remove", 0, 0, Remove}, {"fail", 0, 0, Fail}, {"set-faulty",0, 0, Fail}, + {"replace", 0, 0, Replace}, + {"with", 0, 0, With}, {"run", 0, 0, 'R'}, {"stop", 0, 0, 'S'}, {"readonly", 0, 0, 'o'}, @@ -153,6 +176,8 @@ struct option long_options[] = { {"no-degraded",0,0, NoDegraded }, {"wait", 0, 0, WaitOpt}, {"wait-clean", 0, 0, Waitclean }, + {"action", 1, 0, Action }, + {"cluster-confirm", 0, 0, ClusterConfirm}, /* For Detail/Examine */ {"brief", 0, 0, Brief}, @@ -249,16 +274,13 @@ char OptionHelp[] = " --detail -D : Display details of an array\n" " --examine -E : Examine superblock on an array component\n" " --examine-bitmap -X: Display the detail of a bitmap file\n" +" --examine-badblocks: Display list of known bad blocks on device\n" " --monitor -F : monitor (follow) some arrays\n" " --grow -G : resize/ reshape and array\n" " --incremental -I : add/remove a single device to/from an array as appropriate\n" " --query -Q : Display general information about how a\n" " device relates to the md driver\n" " --auto-detect : Start arrays auto-detected by the kernel\n" -" --offroot : Set first character of argv[0] to @ to indicate the\n" -" application was launched from initrd/initramfs and\n" -" should not be shutdown by systemd as part of the\n" -" regular shutdown process.\n" ; /* "\n" @@ -309,6 +331,7 @@ char OptionHelp[] = " --remove -r : remove subsequent devices\n" " --fail -f : mark subsequent devices as faulty\n" " --set-faulty : same as --fail\n" +" --replace : mark a device for replacement\n" " --run -R : start a partially built array\n" " --stop -S : deactivate array, releasing all resources\n" " --readonly -o : mark array as readonly\n" @@ -319,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" @@ -340,26 +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" +" --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" ; @@ -462,6 +488,10 @@ char Help_manage[] = " --remove -r : remove subsequent devices, which must not be active\n" " --fail -f : mark subsequent devices a faulty\n" " --set-faulty : same as --fail\n" +" --replace : mark device(s) to be replaced by spares. Once\n" +" : replacement completes, device will be marked faulty\n" +" --with : Indicate which spare a previous '--replace' should\n" +" : prefer to use\n" " --run -R : start a partially built array\n" " --stop -S : deactivate array, releasing all resources\n" " --readonly -o : mark array as readonly\n" @@ -483,6 +513,7 @@ char Help_misc[] = " --detail-platform : Display hardware/firmware details\n" " --examine -E : Examine superblock on an array component\n" " --examine-bitmap -X: Display contents of a bitmap file\n" +" --examine-badblocks: Display list of known bad blocks on device\n" " --zero-superblock : erase the MD superblock from a device.\n" " --run -R : start a partially built array\n" " --stop -S : deactivate array, releasing all resources\n" @@ -490,6 +521,7 @@ char Help_misc[] = " --readwrite -w : mark array as readwrite\n" " --test -t : exit status 0 if ok, 1 if degrade, 2 if dead, 4 if missing\n" " --wait -W : wait for resync/rebuild/recovery to finish\n" +" --action= : initiate or abort ('idle' or 'frozen') a 'check' or 'repair'.\n" ; char Help_monitor[] = @@ -527,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[] =