Default to --auto=yes
[thirdparty/mdadm.git] / ChangeLog
1 Changes Prior to this release
2     -   Fixed UUID printing in "--detail --brief" for version1 metadata.
3     -   --update=resync did exactly the wrong thing for version1 metadata.
4         It caused a resync to not happen, rather than to happen.
5     -   Allow --assemble --force to mark a raid6 clean when it has two
6         missing devices (which is needed else if won't assemble.
7         Without this fix it would only assemble if one or zero
8         missing devices.
9     -   Support --update=devicesize for cases where the underlying device
10         can change size.
11     -   Default to --auto=yes so the array devices with 'standard' names
12         get created automatically, as this is almost always what is wanted.
13
14 Changes Prior to 2.5.6 release
15     -   Fix bug which meant "bitmap=xxx" in mdadm.conf was not handled
16         properly.
17     -   Documentation updates.
18     -   Fix bug that caused infinite loop when doing auto-assembly,
19         in certain cases where arrays couldn't be assembled.
20
21 Changes Prior to 2.5.5 release
22     -   Don't #include linux/blkpg.h as that isn't safe.  Just
23         include the content literally.
24     -   Reduce maximum bitmap usage when working with bitmap files,
25         so that a only single-page allocations are made, even on
26         64bit hosts with 4K pages.
27     -   Close stray fd in mdassemble so that it can assemble stacked
28         devices
29     -   If mdassemble finds an array already assembled, it marks it
30         read-write.
31     -   Remove error in md_open if array is already active.  This isn't
32         needed and gets in the ways if an array was created e.g. in
33         initramfs, but device doesn't yet exist in /dev.
34     -   When --assemble --scan is run, if all arrays that could be found
35         have already been started, don't report an error.
36     -   Fix a couple of bugs related to raid10 and the new 'offset' layout.
37     -   Improve error message when a wrong '--update' option is given.
38
39 Changes Prior to 2.5.4 release
40     -   When creating devices in /dev/md/ create matching symlinks
41         from /dev.  e.g. /dev/md0 -> /dev/md/0.
42         Allow this to be disabled in mdadm.conf or on command line.
43     -   Fix some endian-ness issues with version-1 superblocks (affects
44         bigendian only).
45     -   Fix endian problem with 'bitmap' metadata
46     -   Allow a number (of partitions) after the 'yes' option to --auto=
47         This is particularly useful in the 'create' line in mdadm.conf.
48     -   Remove partitions from any whole device that is made part of
49         an md array.  This is a work-around for annoying messages
50         when the first block on some drive accidentally looks like a
51         partition table.
52
53 Changes Prior to 2.5.3 release
54     -   Document v0.91 superblocks in md.4
55     -   Make GPL explicit in man pages.
56     -   Fix recent breakage of starting degraded arrays.
57     -   Tidyup automatic name choice for v-1 arrays:
58           /dev/md_d0 now becomes '0', not '_d0'.
59
60 Changes Prior to 2.5.2 release
61     -   Fix problem with compiling with gcc-2 compilers
62     -   Fix compile problem of post-incrmenting a variable in a macro arg.
63     -   Stop map_dev from returning [0:0], as that breaks things.
64     -   Add 'Array Slot' line to --examine for version-1 superblocks
65         to make it a bit easier to see what is happening.
66     -   Work around bug in --add handling for  version-1 superblocks
67         in 2.6.17 (and prior).
68     -   Make -assemble a bit more resilient to finding strange
69         information in superblocks.
70     -   Don't claim newly added spares are InSync!! (don't know why that
71         code was ever in there)
72     -   Work better when no 'ftw' is available, and check to see
73         if current uclibc provides ftw.
74     -   Never use /etc/mdadm.conf if --config file is given (previously
75         some code used one, some used the other).
76
77 Changes Prior to 2.5.1 release
78     -   Various fixes for gcc warnings
79     -   uclibc warnings
80     -   Makefile improvements for static linking/intalling
81     -   Makefile uninstall target
82     -   Really fix return status of --examine
83     -   Typos
84     -   Byteorder stuff (again)
85     -   Don't try to create devices with --manage or --grow
86     -   allow default metadata (superblock) type to be specified
87         in mdadm.conf
88     -   Get --stop to list devices stopped but honour --quiet
89     -   remove libssl dependency
90     -   Avoid some misdetection of overlapping partitions
91     -   Fix memory leak in --monitor mode
92
93 Changes Prior to 2.5 release
94     -   Support 'mailfrom' line in mdadm.conf so the From: line in alert
95         emails can be explicitly set.
96     -   Arrange that SparesMissing (which is similar in import to
97         DegradedArray) generates an Email.
98     -   Assume "DEVICE partitions" if no DEVICE line is given.
99     -   Support new 'offset' layout for raid10.
100     -   When creating a bitmap file, choose a chunksize to limit number
101         of bitmap chunks to 2 million.  More than this can cause kmalloc
102         failure.
103     -   New 'CREATE' line in mdadm.conf for defaults such as owner, group,
104         mode and auto-flag
105     -   --detail checks if array has been started or not and includes that
106         in report.
107     -   When using --update=uuid on an array with a bitmap, update the
108         bitmap's uuid too.
109     -   Add a copy of /proc/mdstat to the mail message sent by mdadm
110         --monitor.
111     -   New flag --no-degraded to avoid starting arrays if there are
112         fewer devices available than last time the array was started.
113         This is only needed with --scan, as with --scan, that behaviour
114         is the default.
115     -   Support for 'homehost' concept.  This is a fairly major update.
116         It includes a configfile option and a command line option for
117         specifying a homehost, records that host in the superblock,
118         and reports the homehost where possible.
119     -   Support for Auto Assembly.  "mdadm -As" will, if provided with
120         the name of a homehost, try to assemble all arrays it can find
121         that were created for that homehost.  See man pages for more details.
122
123 Changes Prior to 2.4.1 release
124     -   Honour --write-mostly when adding to an array without persistent
125         superblocks.
126     -   Fix alignment problem in version-1 superblocks.
127         NOTE: This is an incompatable change affecting raid5 reshape.
128         If you want to reshape a raid5 using version-1 superblocks,
129         use 2.6.17-rc2 or later, and mdadm-2.4.1 or later.
130
131 Changes Prior to 2.4 release
132     -   Rewrite 'reshape' support including performing a backup
133         of the critical region for a raid5 growth, and restoring that
134         backup after a crash.
135     -   Put a 'canary' at each end of the backup so a corruption
136         can be more easily detected.
137     -   Remove useless 'ident' arguement from ->getinfo_super method.
138     -   Support --backup-file for backing-up critical section during
139         growth.
140     -   Erase old superblocks (of different versions) when creating new
141         array.
142     -   Allow --monitor to work with arrays with >28 devices
143     -   Report reshape information in --detail
144     -   Handle symlinks in /dev better
145     -   Fix mess in --detail output which a device is missing.
146     -   Manpage tidyup
147     -   Support 'bitmap=' in mdadm.conf for auto-assembling arrays with
148         write-intent bitmaps in separate files.
149     -   Updates to md.4 man page including section on RESTRIPING and SYSFS
150
151 Changes Prior to 2.3.1 release
152     -   Fixed -O2 compile so I could make and RPM.
153     -   Type cast number to be printed %llu so it compiles on 64bit
154         machines. (Thanks Luca).
155     -   Stop using asm/byteorder.h - to make Redhat happy :-(
156     -   Require bitmap files to have a '/' in their name.
157     -   Error-check a few syscalls - code from SuSE package.
158
159 Changes Prior to 2.3 release
160     -   Try /etc/mdadm/mdadm.conf if /etc/mdadm.conf doesn't exist.
161         This provided compatability for Debian.
162     -   Fixed for version-1 superblock:
163          report chunksize for raid6 and raid10
164          make sure device size used is a multiple of chunksize
165     -   Fix "--assemble --scan" crash.
166     -   Fix completely failure to create array on ppc64
167     -   Fix memcmp in place of memcpy
168     -   A few minor improvements to online help
169     -   Clean up usage of 'long long' for used-size of devices, so
170         that it is possible to create a raid1 of 7TB devices!
171     -   Make internal bitmaps work on 7TB raid1 arrays.
172     -   Provide error message if --examine doesn't find any superblock.
173     -   Report 'reshape' status in --examine - this depends on kernel
174         patches that are not yet finalised.
175     -   Report bitmap status in --detail and --examine
176     -   Default to v1 superblocks instead of v0.90 if the array
177         is too big for 0.90 to handle.
178     -   Sort the output of "mdadm --detail --scan" so that it is
179         in a suitable order for assembling arrays. i.e. components come
180         before an array that they are part of.
181     -   Print size of large reiserfs array properly went warning of
182         possible confilcts.
183
184 Changes Prior to 2.2 release
185     -   Assorted bug fixes
186     -   Support write-intent-bitmaps on raid10
187     -   Support little-endian (Rather than hostendian) bitmaps.
188     -   Return correct error code from 'mdadm -S'
189     -   Remove extra blank line from 'mdadm -Eb' output.
190     -   Improve option parsing so that -a and -b do not have
191         optional arguements: the arg is either required or not
192         depending on context.
193     -   Allow scanning of devices listed in /proc/partitions even
194         if they don't appear in /dev.
195     -   Support --assume-clean in --create mode as well as --build
196     -   Add support for --monitor to report to syslog: -y or --syslog.
197         Thanks to Ross Vandegrift
198     -   --monitor now reports which device failed in a 'Fail' message
199            This broke with 2.6
200     -   Improve chance of array starting properly after a crash.
201         mdadm was insisting the event numbers were identical, but this
202         isn't needed, and is a problem if the crash was while the metadata
203         was being updated.
204     -   Support --update==uuid
205     -   Added README.initramfs and mkinitramfs to help people use an
206         initram for starting md arrays at boot.
207
208 Changes Prior to 2.1 release
209     -   Fix assembling of raid10 array when devices are missing.
210           mdadm now correctly detects if a array is workable or not
211           depending on which devices are present, and so will correctly
212           handle "--assemble --force"  if multiple devices have failed.
213     -   Report raid10 layout in --examine output.
214     -   Fix assembling of arrays that use the version-1 superblock and
215           have spares.  Previously the spares would be ignored.
216     -   Fix bug so that multiple drives can be re-added at once.
217     -   Fix problem with hot-adding a bitmap to version-1-superblock
218           arrays.
219
220 Changes Prior to 2.0
221     -   Support assembling from byte-swapped superblocks
222         metadata type "0.swap" and --update=byteorder
223     -   write-mostly and write-behind support for raid1.
224     -   Support --name= and 'name=' config entry for identifying
225         arrays be name.
226     -   RAID10 in man pages.
227     -   Lot of minor manpage updates
228
229 Changes Prior to 2.0-devel-3 release
230     -   Assorted fixes for multiple bugs...
231     -   Add test suite
232         
233 Changes Prior to 1.12.0 release
234   Several of these are backported from the Debian package
235     -   Don't use 'lstat' to check for blockdevices, use stat.
236     -   Document --size=max option for --grow
237     -   Document SparesMissing event and DeviceDisappeared/WrongLevel
238     -   --stop --scan repeatly cycles until no more progress can be made
239         so that stack devices are stopped properly
240     -   Minor type rationalisation for ident->uuid - now always 'int[]'
241     -   Fix type in online help for --grow (was -F, now -G)
242     -   Allow --auto command line option to set default auto=
243         value when running "--assemble --scan".  Previously
244         --auto was ignored if --scan was given
245     -   Fix a few type casts
246     -   Fix parsing of /dev/md/N in is_standard
247     -   Fix rounding errors in human_size()
248     -   Fix silly example in mdadm.conf-examples
249     -   When finding a /dev name for a device, prefer shorter names
250     -   Suppress listing of devices= in --brief output of -D or -E,
251         unless -v is given (-vv gives the old behaviour with -Dsv).
252         This is because the device list can change and so is not a
253         stable aspect of the array
254     -   Allow --force with --grow so '-Gfn1' works (on raid1)
255     -   Replace sprintf calls with snprintf (to quiet diet-libc)
256     -   Add man page for mdassemble
257     -   Fix compilation with tinyc
258         
259 Changes Prior to 1.11.0 release
260     -   Fix embarassing bug which causes --add to always fail.
261
262 Changes Prior to 1.10.0 release
263     -   Fix bug with --config=partitions
264     -   Open sub-devices with O_EXCL to detect if already in use
265     -   Make sure superblock updates are flushed directly to disk.
266         
267 Changes Prior to 2.0-devel-1 release
268     -   Support for version-1 superblock.  See --metadata option.
269     -   Support for bitmap based intent logging.
270     -   Minor fixes.
271         
272 Changes Prior to 1.9.0 release
273     -   Fix rpm build problem (stray %)
274     -   Minor manpage updates
275     -   Change "dirty" status to "active" as it was confusing people.
276     -   --assemble --auto recognises 'standard' name and insists on using
277         the appropriate major/minor number for them.
278     -   Remove underscore from partition names, so partitions of
279         "foo" are "foo1", "foo2" etc (unchanged) and partitions of
280         "f00" are "f00p1", "f00p2" etc rather than "f00_p1"...
281     -   Use "major", "minor", "makedev" macros instead of
282         "MAJOR", "MINOR", "MKDEV" so that large device numbers work
283         on 2.6 (providing you have glibc 2.3.3 or later).
284     -   Add some missing closes of open file descriptors.
285     -   Reread /proc/partition for every array assembled when using
286         it to find devices, rather than only once.
287     -   Make "mdadm -Ss" stop stacked devices properly, by reversing the
288         order in which arrays are stopped.
289     -   Improve some error messages.
290     -   Allow device name to appear before first option, so e.g.
291         mdadm /dev/md0 -A /dev/sd[ab]
292         works.
293     -   Assume '-Q' if just a device is given, rather than being silent.
294     -   Change "dirty" status to "active" as it was confusing people.
295         
296 Changes Prior to 1.8.0 release
297     -   Makefile cleanup from  Luca Berra <bluca@comedia.it>
298     -   --pid-file (-i) to set a pid file to use with --monitor --daemonise
299     -   Fix typo in mdadm man page
300     -   Fix coredump when "-s" used with no config file present.
301     -   Support new "faulty" personality which can inject synthetic
302         faults. (Not in kernel.org yet at 1Nov2004)
303     -   Support raid0/linear on devices > 2 Terabytes
304     -   Make sure raid6 resyncs when created with one missing device
305
306 Changes Prior to 1.7.0 release
307     -   Support "--grow --add" to add a device to a linear array, if the
308         kernel supports it.  Not documented yet.
309     -   Restore support for uclibc which was broken recently.
310     -   Several improvements to the output of --detail, including
311         reporting "resyncing" or "recovering" in the state.
312     -   Close filedescriptor at end of --detail (exit would have closed it
313         anyway, so this isn't abig deal).
314     -   Report "Sync checkpoint" in --examine output if appropriate.
315     -   Add --update=resync for --assemble mode to for a resync when the
316         array is assembled.
317     -   Add support for "raid10", which is under development in 2.6.
318         Not documented yet.
319     -   --monitor now reads spare-group and spares info from config file
320         even when names of arrays to scan are given on the command line
321         
322 Changes Prior to 1.6.0 release
323     -   Device name given in -Eb is determined by examining /dev rather
324         than assuming /dev/md%d
325     -   Fix bug in --monitor where an array could be held open an so
326         could not be stopped without killing mdadm.
327     -   Add --grow mode.  Currently only --size and --raid-disks can be
328         changed. Both require kernel support which, at the time of
329         writing, is not in a release kernel yet.
330     -   Don't print out "errors" or "no-errors" in -D and -E, as the bit
331         is never set or used.
332     -   Use md event notification in 2.6.??? to make --monitor mode
333         respond instantly to events.
334     -   Add --auto= option and auto= configfile entry to tell mdadm to
335         create device files as needed.  This is particularly useful
336         with partitioned arrays where the major device number can change.
337     -   When generating --brief listing, if the standard name doesn't
338         exist, search /dev for one rather than using a temp name.
339     -   Allow --build to build raid1 and multipath arrays.
340     -   Add "--assume-clean" for Create and Build, particularly for raid1
341         Note: this is dangerous. Only use it if you are certain.
342     -   Fix bug so that Rebuild status monitoring works again.
343     -   Add "degraded" and "recovering" options to the "Status:"
344         entry for --detail
345
346 Changes Prior to 1.5.0 release
347     -   new commands "mdassemble" which is a stripped-down equivalent of
348         "mdadm -As", that can be compiled with dietlibc.
349         Thanks to Luca Berra <bluca@comedia.it>.
350         It can be using in an initramfs or initrd.
351     -   Fix compiling error with BLKGETSIZE64 and some signed/unsigned
352         comparison warnings.
353     -   Add Rebuild Status (% complete) to --detail output.
354     -   Support "--monitor --test" which will generate a test alert
355         for each array once, to test notification paths.
356     -   Generate RebuildFinished event when rebuild finishes.
357     -   Support for raid6 as found in 2.6.2 - thanks to
358         H. Peter Anvin  <hpa@zytor.com>
359     -   Support partitioned md arrays with a different major number and
360         naming scheme (md_dX in /proc/mdstat, /dev/md/dXpY in /dev).
361         
362 Changes Prior to 1.4.0 release
363     -   Document fact that creating a raid5 array really creates a
364         degraded array with a spare.    
365     -   Add "spares=" tag to config file and generate it wit --detail and
366         --examine
367     -   Add "SparesMissing" event when --monitor first sees an array and
368         it doesn't have the enough spare devices.
369     -   Add --update=summaries for --assemble to update summary
370         information in superblock, and correct other inconsistancies in
371         the superblock.
372     -   Add --test option to --detail to set a meaningful exit status.
373         
374 Changes Prior to 1.3.0 release
375     -   Make 'size' and unsigned long in Create to allow creation of
376         larger arrays.
377     -   Explicitly flag spare devices as 'spare' in --detail and --examine
378         output.  Previously they simply had no flags lists.
379     -   Make MailCmd (for monitor) configurable in Makefile, and default
380         to "/usr/sbin/sendmail -t". Also split out the warning related
381         flags into CWFLAGS for easier build configurability.
382     -   Minor bugfix in Manage code.
383     -   --monitor now notices and reports degraded arrays at startup using
384         "DegradedArray" event, and also has a --oneshot option to only
385         report DegradedArrays, and then exit.
386     -   Small man-page clarification w.r.t. raid levels and raid4 in
387         particular.
388     -   Disallow creation of arrays with only one device as this is
389         probably a mistake.  --force will override this check.
390     -   Correct some misleading documentation in the "mdadm --create --help"
391         message.
392     -   Ignore chunksize if raid1 or multipath.
393     -   Explicit statement in man page that raid-disks cannot be changed
394         after array is created.
395     -   Improve message when attempting to start an array with
396         insufficient devices.  Instead of required the array to be full,
397         we only require it has as many active devices as last time.
398         
399 Changes Prior to 1.2.0 release
400     -   Fix bug where --daemonise required an argument.
401     -   In --assemble --verbose, print appropriate message if device is
402         not in devices= list
403     -   Updated mdadm.conf.5 to reflect fact that device= takes wildcards
404     -   Typos:  componenet -> component
405     -   Reduce size of "--help" message put excess into "--help-options"
406     -   Fix bug introduced when MD_SB_DISKS dependancy removed, and which
407         caused spares not be assembled properly.
408     -   Print appropriate message if --monitor --scan decides not to
409         monitor anything.
410 Changes Prior to 1.1.0 release
411     -   add --deamonise flag for --monitor - forks and prints pid to stdout
412     -   Fix bug so we REALLY clear dirty flag with -Af
413     -   -Db now prints a 'devices=' word for each array.
414     -   "mdadm -A /dev/md0" will get info from configfile, even without scan
415     -   When assembling multipath arrays, ignore devices which are flagged
416         as having errors.
417     -   take --super-minor=dev  to mean "use the minor number of the mddev
418         being assembled.
419     -   take --config=none to mean "completely ignore config file"
420     -   Make --monitor require --scan or a device list.
421 Changes Prior to 1.0.9 release
422     -   Documentation updates including kernel parameters documented
423         in md.4
424     -   --assemble --force for raid4/5 will mark clean, needed for 2.5
425     -   --detail prints out the events counter as well
426     -   flush device before reading superblock to be sure to get
427         current data
428     -   added mdadm.static target to makefile for static linking
429     -   --monitor was ignoring  /dev/md0 due to off-by-one error
430     -   Fix assorted typos
431     -   Fix printing of Gibibytes - calc was wrong.
432     -   Fix printing of Array Size in --detail when very big.
433     -   --monitor no longer tries to work for raid0 or linear as these
434         have nothing to be monitored.
435     -   The word 'partitions' on a DEVICE line will cause all partitions
436         listed in /proc/partitions to be considered
437     -   If the config file is called 'partitions' then it will be treated
438         as though it contained exactly 'device partitions' so e.g.
439           mdadm -Ebsc partitions
440         will find all raid partitions easily.   
441     -   successfully assemble multipath devices by ignoring raid_disk
442         value from superblock (it is always the same).
443     -   --assemble not tied to MD_SB_DISKS limit quite so much
444     -   Support compiling with tcc
445     -   Support compiling with uclibc - just skip scan of /dev
446     -   Add --update= option for Assemble mode.  Either sparc2.2
447         or super-minor updates are possible.  See mdadm.8
448         
449 Changes Prior to 1.0.1 release
450     -   Round off MB/GiB etc values instead of round down.
451     -   Add --sparc2.2 option to examine to shift superblock around
452         and --sparc2.2update to rewrite the superblock
453     -   Fix assorted typos in online help
454         
455 Changes Prior to 1.0.0 release
456     -   Allow --config with Misc mode (for --examine --scan)
457     -   Add $(CXFLAGS) to end of CFLAGS in makefile
458     -   When making an N disk raid5 array, the Nth drive
459         is moved to the end of the array as a spare rather than
460         being shifted up one place.  This means that when the
461         kernel builds onto the last spare and inserts it,
462         the devices will be in the expected order.
463     -   Man page improvements
464 Changes Prior to 0.8.2 release
465     -   Correct spelling of persist[ae]nce/persist[ae]nt.
466     -   Change "disk" to "device" in options and config file
467     -   convert array size to "long long" *before* shift-left in -D and -Q
468         
469 Changes Prior to 0.8.1 release
470     -   Add "INSTALL" file.
471     -   Fix some "i" variables that were not being set properly
472     -   Initialise minsize and maxsize so that compilers don't complain.
473     -   Tidy up Makefile and mdadm.spec installations
474     -   Add "multipath" to documentation of valid levels
475         
476 Changes Prior to 0.8 release
477     -   Fix another bug in Assemble.c due to confusing 'i' with 'j'
478     -   Minimal, untested, support for multipath
479     -   re-write of argument parsing to have more coherent modes,
480     -   add --query,-Q option
481     -   Update mdadm.8 to reflect arg processing change and --query
482     -   Change "long" to "unsigned long" for device sizes
483     -   Handle "mailaddr" and "program" lines in config file for follow/scan mode.
484     -   --follow --scan will exit if no program or mail found
485     -   Add MAILADDR and PROGRAM to mdadm.conf-example
486     -   Spell check man pages
487     -   consistently use "component devices" instead of "subdevices"
488     -   Make -Wall -Werror really work and fix lots of errors.
489     -   --detail and --stop can have --scan which chooses devices from /proc/mdstat
490     -   --monitor detects 20% changes in resync, failed spares,
491         disappearing arrays,
492     -   --monitor --scan will automatically add any devices found in /proc/mdstat
493     -   --monitor will move spares between arrays with same spare-group if necessary
494     -   Documentation for Monitor Mode
495     -   --query notes if the array containing the given device is active or not
496     -   Finished md.4 man page.
497         
498 Changes Prior to 0.7.2 release
499     -   mdadm.spec updates and ifdef BLKGETSIZE64 from  Luca Berra -- bluca@comedia.it
500     -   more mdadm.spec updates from  Gregory Leblanc <gleblanc@linuxweasel.com>
501     -   make directory for mdadm.conf configurable in Makefile
502     -   Finished mdadm.conf.5.  Removed details of conf file from
503         mdadm.8 leaving a reference to mdadm.conf.5.
504     -   Fix bug in Assemble.c, thanks to Junaid Rizvi <domdev@sat.net.pk>
505     -   Get --assemble --force to make sure old major/minor numbers are
506         consistant, as md.c worries about this :-(
507         
508         
509 Changes Prior to 0.7.1 release
510     -   update mdadm.spec
511     -   use BLKGETSIZE64 if available for array size
512     -   give human readable as GiB/MiB and GB and MB, with 2 decimal point precision
513     -   Only warn about size variation for raid1/4/5.
514     -   Started md.4 man page
515     -   Started mdadm.conf.5 man page
516         
517 Changes Prior to 0.7 release    
518
519     -   Fix makefile to install binary at /sbin and not /sbin/sbin
520         Also install man page.
521     -   Add --zero-superblock based on --destroywithextremeprejudice
522         from Dale Stephenson <steph@snapserver.com>
523     -   change name to mdadm.  It is palandromic, and much nicer to pronouce.
524         
525 Changes Prior to 0.6 release
526
527     -   Remove the limit on the number of device names that can be
528         given on the command line.
529     -   Fix bug in --assemble --force where it would only update a
530         single superblock.
531     -   Fix bogus printing of big numbers not being block devices
532         when given names of devices that don't exist.
533     -   When --assemble --force, consider superblocks with an event
534         count that is 1 behind as out-of-date.  Normally they are
535         considered up-to-date (as the kernel assumes this too).
536     -   When marking drives as not-failed in the superblock,
537         we also mark them as ACTIVE and SYNC.
538     -   Don't start arrays for which not all drives are available unless:
539          --scan   which implies that all drives were found automatically
540          --run    which means the user knows what they want
541          --force  which means that we are fixing something broken
542     -   Make sure all device numbers passed as 3rd arg of ioctl
543         are passed as unsigned lock, so that it works on SPARC
544     -   If HOT_ADD_DISK failes for -a, then only try ADD_NEW_DISK
545         if we cannot read from the array, i.e. if the array is
546         not started yet.
547     -   man page update
548     -   Taught Examine to handle --scan. It examines all devices listed
549         on DEVICE lines in the config file.
550     -   Added --brief (-b) flag for Examine and Detail to print out
551         and mdctl.conf compatible description with uuid=, level=,
552         disks= and  - for Examine - devices=
553         --examine --brief collects all devices the make the one array and
554         list them as one entry.
555     -   Added level= and disks= options to ARRAY lines in config files
556         so --brief output could be used as-is.
557     -   Make parity style ({left,right}-{,a}symmetric) consistantly use -,
558         never _.
559     -   Add "Array Size" to --detail output
560     -   Change "Size" to "Device Size" and exclude from Detail of arrays
561         that do not have a consistent device size.
562     -   Add Human readable MiB or GiB value on size lines of Detail and Examine
563     -   --assemble --scan  doesn't complain about active drives
564     -   require number of spares given in -x to be listed.
565     -   Made --build actually work.
566 Changes Prior to 0.5 release
567
568   --assemble:
569      spare drives are handled properly.
570
571      --force can be used to recover from 2-drive failures on RAID5
572      If you belive that /dev/hda1 /dev/hdb1 /dev/hdc1 /dev/hdd1 should
573      make a raid5 array, but it has experienced multiple failures and
574      wont start, then
575
576        mdctl --assemble --force /dev/md0 /dev/hd[abcd]1
577
578      Should update the superblock on the newest failed drive and
579      restart the array in degraded mode.  You should then remove the
580      remaining failed drive and re-add it (if you are happy that it
581      might work).
582
583      Ofcourse whenever you have a 2-drive failure, you have a risk
584      of corruption in data that hasn't be changed for a long time.  So
585      this doesn't give you your array back all nice and happy, but it
586      does allow you to recover data that might not be corrupt.
587
588      More flexibility in identifying a RAID array in the mdctl.conf
589      e.g.
590          array /dev/md4  super-minor=4
591
592       assembles /dev/md4 from all devices found that have a raid
593       superblock that says the minor number of the array is 4.
594       If the blocks with the right minor number do not all have the
595       same UUID, an error is flags and no assembly happens.
596
597         array /dev/md3  devices=/dev/hd[abc]2
598
599       Assembles /dev/md3 drom /dev/hda2 /dev/hdb2 and/dev/hdc2.  All
600       devices must exist and have raid superblock with the same uuid.
601
602       If two identity specifiers are used, only devices that match all
603       of them are considered, so
604
605         array /dev/md2 devices=/dev/hd?2 super-minor=2
606
607       will assemble /dev/md2 using all /dev/hd?2 devices which have a
608       raid superblock with minor number 2.
609
610   --create:
611       When listing devices for --create, the word "missing" can be
612       used to indicate that the respective slot does not have a
613       working drive currently.  This is similar to the "failed-disk"
614       directive in mkraid/raidtab.
615       e.g.
616          mdctl --create --level=5 -raid-disks=4 --spare-disks=2
617                  /dev/md0 /dev/sda /dev/sdb missing /dev/sdc /dev/sdd  /dev/sde
618
619       will create a raid5 array with the third slot empty, and two
620       spares.
621
622       By default, raid5 arrays are created with the last slot empty
623       and drive listed for the last slot added as a spare.  If a
624       "missing" slot is given, or if --force is given, then --create
625       does exactly what you ask and doesn't try to be clever.
626
627
628    --follow / --monitor:
629
630       This is a new mode.  I couldn't stop my self from picking a name
631       starting with F (as current modes start A,B,C,D,E) but I
632       relented and provided an alternate name that is somewhat more
633       meaningful.
634
635       In this mode, mdctl does not exit, but runs continuously and
636       periodically polls all the md devices to see if they have had
637       any interested state change.
638       The changes that it currently notices are:
639            Fail      -  an active disc fails
640            FailSpare -  a spare, that was presumably being build, fails
641            ActiveSpare - a spare becomes active, presumably after a rebuild.
642
643       Options:
644          --mail mailaddress  - send Email on any Fail* event
645          --program program   - run the program on any event.
646                    Args are: eventname mddevice subdevice(if-known)
647          --delay  seconds    - change from the default 60second pause
648                                between polls.
649
650       I plan to add functionality to this mode to allow sharing of
651       spare drives. If an array is marks "spare-group=fred", and it
652       has a failed drive and no spares, and if some other array is
653       also "spare-group=fred" and it has no failed drives, but does
654       have a spare drive that is big enough, the spare will be moved
655       to the first array.
656
657   I also have the idea of adding a --grow mode which will re-organise
658   the data on an N disk raid0/4/5 array to be on an N+M disk array.
659   I have no concrete plans for this though.
660
661   I got rid of the "v" in the archive file name, and include the
662   version number in the directory created by the archive.
663
664   There is now a man page and mdctl.spec (for rpm) thanks to
665   Danilo Godec <danci@agenda.si>.
666
667   Ofcourse, the man page is now out of date and despite being based on
668   the --help output, is not wholy correct.  After I get --follow
669   working properly, I plan to revise the various documentation and/or
670   the code to make sure the two match.