← Back to branch summary

~ubuntu-branches/ubuntu/precise/mdadm/precise-updates

« back to all changes in this revision

Viewing changes to .pc/debian/conffile-location.diff/mdadm.8.in

  • Committer: Package Import Robot
  • Author(s): Clint Byrum
  • Date: 2012-02-09 16:53:02 UTC
  • mfrom: (1.1.27 sid)
  • Revision ID: package-import@ubuntu.com-20120209165302-bs4cfosmhoga2rpt
Tags: 3.2.3-2ubuntu1
https://launchpad.net/bugs/920324
* Merge from Debian testing. (LP: #920324)  Remaining changes:
  - Call checks in local-premount to avoid race condition with udev
    and opening a degraded array.
  - d/initramfs/mdadm-functions: Record in /run when boot-degraded 
    question has been asked so that it is only asked once
  - pass --test to mdadm to enable result codes for degraded arrays. 
  - Build udeb with -O2 on ppc64, working around a link error.
  - debian/control: we need udev and util-linux in the right version. We
    also remove the build dependency from quilt and docbook-to-man as both
    are not used in Ubuntus mdadm.
  - debian/initramfs/hook: kept the Ubuntus version for handling the absence
    of active raid arrays in <initramfs>/etc/mdadm/mdadm.conf
  - debian/initramfs/script.local-top.DEBIAN, debian/mdadm-startall,
    debian/mdadm.raid.DEBIAN: removed. udev does its job now instead.
  - debian/mdadm-startall.sgml, debian/mdadm-startall.8: documentation of
    unused startall script
  - debian/mdadm.config, debian/mdadm.postinst - let udev do the handling
    instead. Resolved merge conflict by keeping Ubuntu's version.
  - debian/mdadm.postinst, debian/mdadm.config, initramfs/init-premount:
    boot-degraded enablement; maintain udev starting of RAID devices;
    init-premount hook script for the initramfs, to provide information at
    boot
  - debian/mkconf.in is the older mkconf. Kept the Ubuntu version.
  - debian/rules: Kept Ubuntus version for installing apport hooks, not
    installing un-used startall script and for adding a udev rule
    corresponding to mdadm.
  - debian/install-rc, check.d/_numbers, check.d/root_on_raid: Ubuntu partman
    installer changes
  - debian/presubj: Dropped this unused bug reporting file. Instead use
    source_mdadm.py act as an apport hook for bug handling.
  - rename debian/mdadm.vol_id.udev to debian/mdadm.mdadm-blkid.udev so that
    the rules file ends up with a more reasonable name
  - d/p/debian-changes-3.1.4-1+8efb9d1ubuntu4: mdadm udev rule
    incrementally adds mdadm member when detected. Starting such an
    array in degraded mode is possible by mdadm -IRs. Using mdadm
    -ARs without stopping the array first does nothing when no
    mdarray-unassociated device is available. Using mdadm -IRs to
    start a previously partially assembled array through incremental
    mode. Keeping the mdadm -ARs for assembling arrays which were for
    some reason not assembled through incremental mode (i.e through
    mdadm's udev rule).

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/debian/conffile-location.diff/mdadm.8.in
5
5
.\"   the Free Software Foundation; either version 2 of the License, or
6
6
.\"   (at your option) any later version.
7
7
.\" See file COPYING in distribution for details.
8
 
.TH MDADM 8 "" v3.2.2
 
8
.TH MDADM 8 "" v3.2.3
9
9
.SH NAME
10
10
mdadm \- manage MD devices
11
11
.I aka
336
336
recovery operation can be checkpointed and restarted.  The different
337
337
sub-versions store the superblock at different locations on the
338
338
device, either at the end (for 1.0), at the start (for 1.1) or 4K from
339
 
the start (for 1.2).  "1" is equivalent to "1.0".
 
339
the start (for 1.2).  "1" is equivalent to "1.2" (the commonly
 
340
preferred 1.x format).
340
341
'if '{DEFAULT_METADATA}'1.2'  "default" is equivalent to "1.2".
341
342
.IP ddf
342
343
Use the "Industry Standard" DDF (Disk Data Format) format defined by
418
419
A suffix of 'M' or 'G' can be given to indicate Megabytes or
419
420
Gigabytes respectively.
420
421
 
 
422
Sometimes a replacement drive can be a little smaller than the
 
423
original drives though this should be minimised by IDEMA standards.
 
424
Such a replacement drive will be rejected by
 
425
.IR md .
 
426
To guard against this it can be useful to set the initial size
 
427
slightly smaller than the smaller device with the aim that it will
 
428
still be larger than any replacement.
 
429
 
421
430
This value can be set with
422
431
.B \-\-grow
423
 
for RAID level 1/4/5/6.  If the array was created with a size smaller
424
 
than the currently active drives, the extra space can be accessed
425
 
using
 
432
for RAID level 1/4/5/6 though
 
433
.B CONTAINER
 
434
based arrays such as those with IMSM metadata may not be able to
 
435
support this.
 
436
If the array was created with a size smaller than the currently
 
437
active drives, the extra space can be accessed using
426
438
.BR \-\-grow .
427
439
The size can be given as
428
440
.B max
440
452
.B "\-\-grow \-\-size="
441
453
command.
442
454
 
443
 
This value can not be used with
 
455
This value cannot be used when creating a
444
456
.B CONTAINER
445
 
metadata such as DDF and IMSM.
 
457
such as with DDF and IMSM metadata, though it perfectly valid when
 
458
creating an array inside a container.
446
459
 
447
460
.TP
448
461
.BR \-Z ", " \-\-array\-size=
706
719
When an array is resized to a larger size with
707
720
.B "\-\-grow \-\-size="
708
721
the new space is normally resynced in that same way that the whole
709
 
array is resynced at creation.  From Linux version 2.6.40,
 
722
array is resynced at creation.  From Linux version 3.0,
710
723
.B \-\-assume\-clean
711
724
can be used with that command to avoid the automatic resync.
712
725
 
721
734
being reshaped.
722
735
 
723
736
.TP
 
737
.BR \-\-continue
 
738
This option is complementary to the
 
739
.B \-\-freeze-reshape
 
740
option for assembly. It is needed when
 
741
.B \-\-grow
 
742
operation is interrupted and it is not restarted automatically due to
 
743
.B \-\-freeze-reshape
 
744
usage during array assembly.  This option is used together with
 
745
.BR \-G
 
746
, (
 
747
.BR \-\-grow
 
748
) command and device for a pending reshape to be continued.
 
749
All parameters required for reshape continuation will be read from array metadata.
 
750
If initial
 
751
.BR \-\-grow
 
752
command had required
 
753
.BR \-\-backup\-file=
 
754
option to be set, continuation option will require to have exactly the same
 
755
backup file given as well.
 
756
.IP
 
757
Any other parameter passed together with
 
758
.BR \-\-continue
 
759
option will be ignored.
 
760
 
 
761
.TP
724
762
.BR \-N ", " \-\-name=
725
763
Set a
726
764
.B name
811
849
non-standard name.  Names that are not in 'standard' format are only
812
850
allowed in "/dev/md/".
813
851
 
 
852
This is meaningful with
 
853
.B \-\-create
 
854
or
 
855
.BR \-\-build .
 
856
 
814
857
.ig XX
815
858
.\".TP
816
859
.\".BR \-\-symlink = no
835
878
.\"
836
879
.XX
837
880
 
 
881
.TP
 
882
.BR \-a ", " "\-\-add"
 
883
This option can be used in Grow mode in two cases.
 
884
 
 
885
If the target array is a Linear array, then
 
886
.B \-\-add
 
887
can be used to add one or more devices to the array.  They
 
888
are simply catenated on to the end of the array.  Once added, the
 
889
devices cannot be removed.
 
890
 
 
891
If the
 
892
.B \-\-raid\-disks
 
893
option is being used to increase the number of devices in an array,
 
894
then
 
895
.B \-\-add
 
896
can be used to add some extra devices to be included in the array.
 
897
In most cases this is not needed as the extra devices can be added as
 
898
spares first, and then the number of raid-disks can be changed.
 
899
However for RAID0, it is not possible to add spares.  So to increase
 
900
the number of devices in a RAID0, it is necessary to set the new
 
901
number of devices, and to add the new devices, in the same command.
 
902
 
838
903
.SH For assemble:
839
904
 
840
905
.TP
912
977
See this option under Create and Build options.
913
978
 
914
979
.TP
915
 
.BR \-a ", " "\-\-add"
916
 
This option can be used in Grow mode in two cases.
917
 
 
918
 
If the target array is a Linear array, then
919
 
.B \-\-add
920
 
can be used to add one or more devices to the array.  They
921
 
are simply catenated on to the end of the array.  Once added, the
922
 
devices cannot be removed.
923
 
 
924
 
If the
925
 
.B \-\-raid\-disks
926
 
option is being used to increase the number of devices in an array,
927
 
then
928
 
.B \-\-add
929
 
can be used to add some extra devices to be included in the array.
930
 
In most cases this is not needed as the extra devices can be added as
931
 
spares first, and then the number of raid-disks can be changed.
932
 
However for RAID0, it is not possible to add spares.  So to increase
933
 
the number of devices in a RAID0, it is necessary to set the new
934
 
number of devices, and to add the new devices, in the same command.
935
 
 
936
 
.TP
937
980
.BR \-b ", " \-\-bitmap=
938
981
Specify the bitmap file that was given when the array was created.  If
939
982
an array has an
1078
1121
corrupt in some way so that assembling the array normally fails.  It
1079
1122
will cause any internal bitmap to be ignored.
1080
1123
 
 
1124
.TP
 
1125
.BR \-\-freeze\-reshape
 
1126
Option is intended to be used in start-up scripts during initrd boot phase.
 
1127
When array under reshape is assembled during initrd phase, this option
 
1128
stops reshape after reshape critical section is being restored. This happens
 
1129
before file system pivot operation and avoids loss of file system context.
 
1130
Losing file system context would cause reshape to be broken.
 
1131
 
 
1132
Reshape can be continued later using the
 
1133
.B \-\-continue
 
1134
option for the grow command.
 
1135
 
1081
1136
.SH For Manage mode:
1082
1137
 
1083
1138
.TP
1491
1546
In the second usage example, all devices listed are treated as md
1492
1547
devices and assembly is attempted.
1493
1548
In the third (where no devices are listed) all md devices that are
1494
 
listed in the configuration file are assembled.  If not arrays are
 
1549
listed in the configuration file are assembled.  If no arrays are
1495
1550
described by the configuration file, then any arrays that
1496
1551
can be found on unused devices will be assembled.
1497
1552
 
1600
1655
will first attempt to assemble all the arrays listed in the config
1601
1656
file.
1602
1657
 
1603
 
In no array at listed in the config (other than those marked
 
1658
If no arrays are listed in the config (other than those marked
1604
1659
.BR <ignore> )
1605
1660
it will look through the available devices for possible arrays and
1606
1661
will try to assemble anything that it finds.  Arrays which are tagged
2200
2255
.IP \(bu 4
2201
2256
increase or decrease the "raid\-devices" attribute of RAID0, RAID1, RAID4,
2202
2257
RAID5, and RAID6.
2203
 
.IP \bu 4
 
2258
.IP \(bu 4
2204
2259
change the chunk-size and layout of RAID0, RAID4, RAID5 and RAID6.
2205
 
.IP \bu 4
 
2260
.IP \(bu 4
2206
2261
convert between RAID1 and RAID5, between RAID5 and RAID6, between
2207
 
RAID0, RAID5, and RAID5, and between RAID0 and RAID10 (in the near-2 mode).
 
2262
RAID0, RAID4, and RAID5, and between RAID0 and RAID10 (in the near-2 mode).
2208
2263
.IP \(bu 4
2209
2264
add a write-intent bitmap to any array which supports these bitmaps, or
2210
2265
remove a write-intent bitmap from such an array.
2211
2266
.PP
2212
2267
 
2213
 
Using GROW on containers is currently only support for Intel's IMSM
 
2268
Using GROW on containers is currently supported only for Intel's IMSM
2214
2269
container format.  The number of devices in a container can be
2215
2270
increased - which affects all arrays in the container - or an array
2216
2271
in a container can be converted between levels where those levels are
2217
2272
supported by the container, and the conversion is on of those listed
2218
 
above.
 
2273
above.  Resizing arrays in an IMSM container with
 
2274
.B "--grow --size"
 
2275
is not yet supported.
2219
2276
 
2220
2277
Grow functionality (e.g. expand a number of raid devices) for Intel's
2221
2278
IMSM container format has an experimental status. It is guarded by the
2250
2307
are synchronised.
2251
2308
 
2252
2309
Note that when an array changes size, any filesystem that may be
2253
 
stored in the array will not automatically grow for shrink to use or
 
2310
stored in the array will not automatically grow or shrink to use or
2254
2311
vacate the space.  The
2255
2312
filesystem will need to be explicitly told to use the extra space
2256
2313
after growing, or to reduce its size
2259
2316
 
2260
2317
Also the size of an array cannot be changed while it has an active
2261
2318
bitmap.  If an array has a bitmap, it must be removed before the size
2262
 
can be changed. Once the change it complete a new bitmap can be created.
 
2319
can be changed. Once the change is complete a new bitmap can be created.
2263
2320
 
2264
2321
.SS RAID\-DEVICES CHANGES
2265
2322
 
2435
2492
line.
2436
2493
 
2437
2494
.IP +
2438
 
Does the device have a valid md superblock.  If a specific metadata
2439
 
version is request with
 
2495
Does the device have a valid md superblock?  If a specific metadata
 
2496
version is requested with
2440
2497
.B \-\-metadata
2441
2498
or
2442
2499
.B \-e
2467
2524
current host, the device will be rejected.
2468
2525
..
2469
2526
 
 
2527
.PP
2470
2528
.I mdadm
2471
2529
keeps a list of arrays that it has partially assembled in
2472
2530
.B /var/run/mdadm/map
2639
2697
Any devices which are components of /dev/md4 will be marked as faulty
2640
2698
and then remove from the array.
2641
2699
 
2642
 
.B "  mdadm --grow /dev/md4 --level=6 --backup-file=/root/backup-md4
 
2700
.B "  mdadm --grow /dev/md4 --level=6 --backup-file=/root/backup-md4"
2643
2701
.br
2644
2702
The array
2645
2703
.B /dev/md4
2787
2845
For further information on mdadm usage, MD and the various levels of
2788
2846
RAID, see:
2789
2847
.IP
2790
 
.B http://linux\-raid.osdl.org/
 
2848
.B http://raid.wiki.kernel.org/
2791
2849
.PP
2792
2850
(based upon Jakob \(/Ostergaard's Software\-RAID.HOWTO)
2793
2851
.\".PP