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