mdadm-0.7.2

[thirdparty/mdadm.git] / md.man

MD(4)                                                       MD(4)



N\bNA\bAM\bME\bE
       md - Multiple Device driver aka Linux Software Raid

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
       /\b/d\bde\bev\bv/\b/m\bmd\bd_\bn
       /\b/d\bde\bev\bv/\b/m\bmd\bd/\b/_\bn

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
       The  m\bmd\bd  driver  provides virtual devices that are created
       from one or more  independant  underlying  devices.   This
       array  of devices often contains redundancy, and hence the
       acronym RAID which stands for a Redundant Array  of  Inde-
       pendant Devices.

       m\bmd\bd support RAID levels 1 (mirroring) 4 (striped array with
       parity device) and 5 (striped array with distributed  par-
       ity  information.   If  a  single  underlying device fails
       while using one of these level, the array will continue to
       function.

       m\bmd\bd  also  supports a number of pseudo RAID (non-redundant)
       configuations  including  RAID0  (striped  array),  LINEAR
       (catenated array) and MULTIPATH (a set of different inter-
       faces to the same device).


   M\bMD\bD S\bSU\bUP\bPE\bER\bR B\bBL\bLO\bOC\bCK\bK
       With the exception of Legacy Arrays described below,  each
       device  that is incorportated into an MD array has a _\bs_\bu_\bp_\be_\br
       _\bb_\bl_\bo_\bc_\bk  written  towards  the  end  of  the  device.   This
       superblock  records  information  about  the structure and
       state of the array so that the array can be  reliably  re-
       assembled after a shutdown.

       The  superblock  is  4K  long  and  is  written into a 64K
       aligned block that starts at least 64K and less than  128K
       from the end of the device (i.e. to get the address of the
       superblock round the size of the device down to a multiple
       of 64K and then subtract 64K).  The available size of each
       device is the amount of space before the super  block,  so
       between 64K and 128K is lost when a device in incorporated
       into an MD array.

       The superblock contains, among other things:

       LEVEL  The manner in which the devices are  arranged  into
              the array (linear, raid0, raid1, raid4, raid5, mul-
              tipath).

       UUID   a 128 bit Universally Unique Identifier that  iden-
              tifies the array that this device is part of.


   L\bLE\bEG\bGA\bAC\bCY\bY A\bAR\bRR\bRA\bAY\bYS\bS
       Early  versions of the m\bmd\bd driver only supported Linear and
       Raid0 configurations and so did not use an  MD  superblock
       (as  there is not state that needs to be recorded).  While
       it is strongly recommended that all newly  created  arrays
       utilise  a  superblock to help ensure that they are assem-
       bled properly, the m\bmd\bd driver still supports legacy  linear
       and raid0 md arrays that do not have a superblock.


   L\bLI\bIN\bNE\bEA\bAR\bR
       A  linear  array  simply  catenates the available space on
       each drive together to form one large virtual drive.

       One advantage of this arrangement  over  the  more  common
       RAID0 arrangement is that the array may be reconfigured at
       a later time with an extra drive and so the array is  made
       bigger  without  disturbing the data that is on the array.
       However this cannot be done on a live array.




   R\bRA\bAI\bID\bD0\b0
       A RAID0 array (which has zero redundancy) is also known as
       a striped array.

   R\bRA\bAI\bID\bD1\b1
   R\bRA\bAI\bID\bD4\b4
   R\bRA\bAI\bID\bD5\b5
   M\bMU\bUT\bTI\bIP\bPA\bAT\bTH\bH
   R\bRE\bEB\bBU\bUI\bIL\bLD\bD/\b/R\bRE\bES\bSY\bYN\bNC\bC
F\bFI\bIL\bLE\bES\bS
       /\b/p\bpr\bro\boc\bc/\b/m\bmd\bds\bst\bta\bat\bt
              Contains  information about the status of currently
              running array.

       /\b/p\bpr\bro\boc\bc/\b/s\bsy\bys\bs/\b/d\bde\bev\bv/\b/r\bra\bai\bid\bd/\b/s\bsp\bpe\bee\bed\bd_\b_l\bli\bim\bmi\bit\bt_\b_m\bmi\bin\bn
              A readable and writable file that reflects the cur-
              rent  goal rebuild speed for times when non-rebuild
              activity is current on an array.  The speed  is  in
              Kibibytes per second, and is a per-device rate, not
              a per-array rate (which means that  an  array  with
              more  disc  will  shuffle  more  data  for  a given
              speed).   The default is 100.


       /\b/p\bpr\bro\boc\bc/\b/s\bsy\bys\bs/\b/d\bde\bev\bv/\b/r\bra\bai\bid\bd/\b/s\bsp\bpe\bee\bed\bd_\b_l\bli\bim\bmi\bit\bt_\b_m\bma\bax\bx
              A readable and writable file that reflects the cur-
              rent  goal  rebuild  speed  for  times when no non-
              rebuild activity  is  current  on  an  array.   The
              default is 100,000.


S\bSE\bEE\bE A\bAL\bLS\bSO\bO
       m\bmd\bda\bad\bdm\bm(8), m\bmk\bkr\bra\bai\bid\bd(8).



                                                            MD(4)