-mdctl(8) mdctl(8)
+mdadm(8) mdadm(8)
N\bNA\bAM\bME\bE
- mdctl - manage MD devices _\ba_\bk_\ba Linux Software Raid.
+ mdadm - manage MD devices _\ba_\bk_\ba Linux Software Raid.
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
- m\bmd\bdc\bct\btl\bl _\b[_\bm_\bo_\bd_\be_\b] _\b<_\br_\ba_\bi_\bd_\bd_\be_\bv_\bi_\bc_\be_\b> _\b[_\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b] _\b<_\bs_\bu_\bb_\bd_\be_\bv_\bi_\bc_\be_\bs_\b>
+ m\bmd\bda\bad\bdm\bm _\b[_\bm_\bo_\bd_\be_\b] _\b<_\br_\ba_\bi_\bd_\bd_\be_\bv_\bi_\bc_\be_\b> _\b[_\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b] _\b<_\bs_\bu_\bb_\bd_\be_\bv_\bi_\bc_\be_\bs_\b>
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
ing), R\bRA\bAI\bID\bD1\b1 (mirroring), R\bRA\bAI\bID\bD4\b4 and R\bRA\bAI\bID\bD5\b5.\b.
Recent kernels (2002) also support a mode known as M\bMU\bUL\bLT\bTI\bI-\b-
- P\bPA\bAT\bTH\bH. m\bmd\bdc\bct\btl\bl does not support MULTIPATH as yet.
+ P\bPA\bAT\bTH\bH. m\bmd\bda\bad\bdm\bm does not support MULTIPATH as yet.
- m\bmd\bdc\bct\btl\bl is a program that can be used to create and manage
+ m\bmd\bda\bad\bdm\bm is a program that can be used to create and manage
MD devices. As such it provides a similar set of func-
tionality to the r\bra\bai\bid\bdt\bto\boo\bol\bls\bs packages. The key differences
- between m\bmd\bdc\bct\btl\bl and r\bra\bai\bid\bdt\bto\boo\bol\bls\bs are:
+ between m\bmd\bda\bad\bdm\bm and r\bra\bai\bid\bdt\bto\boo\bol\bls\bs are:
- +\bo m\bmd\bdc\bct\btl\bl is a single program and not a collection of pro-
+ +\bo m\bmd\bda\bad\bdm\bm is a single program and not a collection of pro-
grams.
- +\bo m\bmd\bdc\bct\btl\bl can perform (almost) all of its functions with-
- out having a configuration file. Also mdctl helps
+ +\bo m\bmd\bda\bad\bdm\bm can perform (almost) all of its functions with-
+ out having a configuration file. Also mdadm helps
with management of the configuration file.
- +\bo m\bmd\bdc\bct\btl\bl can provide information about your arrays
+ +\bo m\bmd\bda\bad\bdm\bm can provide information about your arrays
(through Detail and Examine) that r\bra\bai\bid\bdt\bto\boo\bol\bls\bs cannot.
- +\bo r\bra\bai\bid\bdt\bto\boo\bol\bls\bs can manage MULTIPATH devices which m\bmd\bdc\bct\btl\bl
+ +\bo r\bra\bai\bid\bdt\bto\boo\bol\bls\bs can manage MULTIPATH devices which m\bmd\bda\bad\bdm\bm
cannot yet manage.
M\bMO\bOD\bDE\bES\bS
- mdctl has 7 major modes of operation:
+ mdadm has 7 major modes of operation:
A\bAs\bss\bse\bem\bmb\bbl\ble\be
Assemble the parts of a previously created array
into an active array. Components can be explicitly
- given or can be searched for. m\bmd\bdc\bct\btl\bl checks that
+ given or can be searched for. m\bmd\bda\bad\bdm\bm checks that
the components do form a bona fide array, and can,
on request, fiddle superblock information so as to
assemble a faulty array.
This mode can also be used to examine a large num-
ber of devices and to print out a summary of the
arrays found in a format suitable for the
- m\bmd\bdc\bct\btl\bl.\b.c\bco\bon\bnf\bf configuration file.
+ m\bmd\bda\bad\bdm\bm.\b.c\bco\bon\bnf\bf configuration file.
F\bFo\bol\bll\blo\bow\bw o\bor\br M\bMo\bon\bni\bit\bto\bor\br
-\b-V\bV, -\b--\b-v\bve\ber\brs\bsi\bio\bon\bn
- Print version information for mdctl.
+ Print version information for mdadm.
-\b-v\bv, -\b--\b-v\bve\ber\brb\bbo\bos\bse\be
-\b-c\bc, -\b--\b-c\bco\bon\bnf\bfi\big\bg=\b=
- config file. Default is /\b/e\bet\btc\bc/\b/m\bmd\bdc\bct\btl\bl.\b.c\bco\bon\bnf\bf.
+ config file. Default is /\b/e\bet\btc\bc/\b/m\bmd\bda\bad\bdm\bm.\b.c\bco\bon\bnf\bf.
-\b-s\bs, -\b--\b-s\bsc\bca\ban\bn
A\bAS\bSS\bSE\bEM\bMB\bBL\bLY\bY M\bMO\bOD\bDE\bE
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-a\bas\bss\bse\bem\bmb\bbl\ble\be _\bd_\be_\bv_\bi_\bc_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b._\b._\b.
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-a\bas\bss\bse\bem\bmb\bbl\ble\be _\bd_\be_\bv_\bi_\bc_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b._\b._\b.
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-a\bas\bss\bse\bem\bmb\bbl\ble\be -\b--\b-s\bsc\bca\ban\bn _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b._\b._\b.
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-a\bas\bss\bse\bem\bmb\bbl\ble\be -\b--\b-s\bsc\bca\ban\bn _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b._\b._\b.
This usage assembles one or more raid arrays from pre-
- existing components. For each array, mdctl needs to know
+ existing components. For each array, mdadm needs to know
the md device, the identity of the array, and a number of
sub devices. These can be found in a number of ways.
The md device is either given before -\b--\b-s\bsc\bca\ban\bn or is found
from the config file. In the latter case, multiple md
- devices can be started with a single mdctl command.
+ devices can be started with a single mdadm command.
The identity can be given with the -\b--\b-u\buu\bui\bid\bd option, with the
-\b--\b-s\bsu\bup\bpe\ber\br-\b-m\bmi\bin\bno\bor\br option, can be found in in the config file,
The config file is only used if explicitly named with
-\b--\b-c\bco\bon\bnf\bfi\big\bg or requested with -\b--\b-s\bsc\bca\ban\bn.\b. In the later case,
- /\b/e\bet\btc\bc/\b/m\bmd\bdc\bct\btl\bl.\b.c\bco\bon\bnf\bf is used.
+ /\b/e\bet\btc\bc/\b/m\bmd\bda\bad\bdm\bm.\b.c\bco\bon\bnf\bf is used.
If -\b--\b-s\bsc\bca\ban\bn is not given, then the config file will only be
used to find the identity of md arrays.
B\bBU\bUI\bIL\bLD\bD M\bMO\bOD\bDE\bE
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-b\bbu\bui\bil\bld\bd _\bd_\be_\bv_\bi_\bc_\be -\b--\b-c\bch\bhu\bun\bnk\bk=\b=_\bX -\b--\b-l\ble\bev\bve\bel\bl=\b=_\bY -\b--\b-r\bra\bai\bid\bd-\b-
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-b\bbu\bui\bil\bld\bd _\bd_\be_\bv_\bi_\bc_\be -\b--\b-c\bch\bhu\bun\bnk\bk=\b=_\bX -\b--\b-l\ble\bev\bve\bel\bl=\b=_\bY -\b--\b-r\bra\bai\bid\bd-\b-
d\bdi\bis\bsk\bks\bs=\b=_\bZ _\bd_\be_\bv_\bi_\bc_\be_\bs
C\bCR\bRE\bEA\bAT\bTE\bE M\bMO\bOD\bDE\bE
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-c\bcr\bre\bea\bat\bte\be _\bd_\be_\bv_\bi_\bc_\be -\b--\b-c\bch\bhu\bun\bnk\bk=\b=_\bX -\b--\b-l\ble\bev\bve\bel\bl=\b=_\bY
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-c\bcr\bre\bea\bat\bte\be _\bd_\be_\bv_\bi_\bc_\be -\b--\b-c\bch\bhu\bun\bnk\bk=\b=_\bX -\b--\b-l\ble\bev\bve\bel\bl=\b=_\bY
-\b--\b-r\bra\bai\bid\bd-\b-d\bdi\bis\bsk\bks\bs=\b=_\bZ _\bd_\be_\bv_\bi_\bc_\be_\bs
D\bDE\bET\bTA\bAI\bIL\bL M\bMO\bOD\bDE\bE
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-d\bde\bet\bta\bai\bil\bl [-\b--\b-b\bbr\bri\bie\bef\bf] _\bd_\be_\bv_\bi_\bc_\be _\b._\b._\b.
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-d\bde\bet\bta\bai\bil\bl [-\b--\b-b\bbr\bri\bie\bef\bf] _\bd_\be_\bv_\bi_\bc_\be _\b._\b._\b.
This usage sill print out the details of the given array
including a list of component devices. To determine names
- for the devices, m\bmd\bdc\bct\btl\bl searches /\b/d\bde\bev\bv for device files with
+ for the devices, m\bmd\bda\bad\bdm\bm searches /\b/d\bde\bev\bv for device files with
the right major and minor numbers.
- With -\b--\b-b\bbr\bri\bie\bef\bf m\bmd\bdc\bct\btl\bl prints a single line that identifies
+ With -\b--\b-b\bbr\bri\bie\bef\bf m\bmd\bda\bad\bdm\bm prints a single line that identifies
the level, number of disks, and UUID of the array. This
- line is suitable for inclusion in /\b/e\bet\btc\bc/\b/m\bmd\bdc\bct\btl\bl.\b.c\bco\bon\bnf\bf.
+ line is suitable for inclusion in /\b/e\bet\btc\bc/\b/m\bmd\bda\bad\bdm\bm.\b.c\bco\bon\bnf\bf.
E\bEX\bXA\bAM\bMI\bIN\bNE\bE M\bMO\bOD\bDE\bE
- Usage: m\bmd\bdc\bct\btl\bl -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be [-\b--\b-s\bsc\bca\ban\bn] [-\b--\b-b\bbr\bri\bie\bef\bf] _\bd_\be_\bv_\bi_\bc_\be _\b._\b._\b.
+ Usage: m\bmd\bda\bad\bdm\bm -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be [-\b--\b-s\bsc\bca\ban\bn] [-\b--\b-b\bbr\bri\bie\bef\bf] _\bd_\be_\bv_\bi_\bc_\be _\b._\b._\b.
This usage will examine some block devices to see if that
have a valid RAID superblock on them. The information in
tion file are checked. -\b--\b-s\bsc\bca\ban\bn implies -\b--\b-b\bbr\bri\bie\bef\bf but this
implication can be countered by specifying -\b--\b-v\bve\ber\brb\bbo\bos\bse\be.
- With -\b--\b-b\bbr\bri\bie\bef\bf m\bmd\bdc\bct\btl\bl will output an config file entry of
+ With -\b--\b-b\bbr\bri\bie\bef\bf m\bmd\bda\bad\bdm\bm will output an config file entry of
each distinct array that was found. This entry will list
the UUID, the raid level, and a list of the individual
devices on which a superblock for that array was found.
This output will by syntactically suitable for inclusion
in the configuration file, but should N\bNO\bOT\bT be used blindly.
Often the array description that you want in the configu-
- ration file is much less specific than that given by m\bmd\bdc\bct\btl\bl
+ ration file is much less specific than that given by m\bmd\bda\bad\bdm\bm
-\b-B\bBs\bs. For example, you normally do not want to list the
devices, particularly if they are SCSI devices.
/\b/p\bpr\bro\boc\bc/\b/m\bmd\bds\bst\bta\bat\bt
If you're using the /\b/p\bpr\bro\boc\bc filesystem, /\b/p\bpr\bro\boc\bc/\b/m\bmd\bds\bst\bta\bat\bt gives
you informations about md devices status. This file is
- not currently used by m\bmd\bdc\bct\btl\bl.
+ not currently used by m\bmd\bda\bad\bdm\bm.
- /\b/e\bet\btc\bc/\b/m\bmd\bdc\bct\btl\bl.\b.c\bco\bon\bnf\bf
+ /\b/e\bet\btc\bc/\b/m\bmd\bda\bad\bdm\bm.\b.c\bco\bon\bnf\bf
The config file is line oriented with, as usual, blank
lines and lines beginning with a hash (or pound sign or
sharp or number sign, whichever you like to call it)
The DEVICE lines usually come first. All remaining words
on the line are treated as names of devices, possibly con-
taining wild cards (see _\bg_\bl_\bo_\bb(7)). These list all the
- devices that m\bmd\bdc\bct\btl\bl is allowed to scan when looking for
+ devices that m\bmd\bda\bad\bdm\bm is allowed to scan when looking for
devices with RAID superblocks. Each line can contain mul-
tiple device names, and there can be multiple DEVICE
lines. For example:
l\ble\bev\bve\bel\bl=\b= The value is a raid level. This is normally used
to identify an array, but is supported so that the
- output of m\bmd\bdc\bct\btl\bl -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be -\b--\b-s\bsc\bca\ban\bn can be use
+ output of m\bmd\bda\bad\bdm\bm -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be -\b--\b-s\bsc\bca\ban\bn can be use
directly in the configuration file.
d\bdi\bis\bsk\bks\bs=\b= The value is the number of disks in a complete
active array. As with l\ble\bev\bve\bel\bl=\b= this is mainly for
- compatibility with the output of m\bmd\bdc\bct\btl\bl -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be
+ compatibility with the output of m\bmd\bda\bad\bdm\bm -\b--\b-e\bex\bxa\bam\bmi\bin\bne\be
-\b--\b-s\bsc\bca\ban\bn.
- mdctl(8)
+ mdadm(8)