← Back to branch summary

~xnox/ubuntu/natty/mdadm/natty-proposed

« back to all changes in this revision

Viewing changes to .pc/debian/conffile-location.diff/mdadm.conf.5

  • Committer: Dmitrijs Ledkovs
  • Author(s): martin f. krafft
  • Date: 2009-11-06 10:06:03 UTC
  • mto: This revision was merged to the branch mainline in revision 55.
  • Revision ID: dmitrijs.ledkovs@canonical.com-20091106100603-q9s0evnzd106mrzt
Tags: 3.0.3-2
http://bugs.debian.org/541396
* Bumped Standards-Version to 3.8.3 without having to make changes.
* Fixed init dependencies of mdadm daemon init.d script; thanks Petter
  Reinholdtsen (closes: #541396).
* Switched source package to v3-quilt format.

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/debian/conffile-location.diff/mdadm.conf.5
 
1
.\" Copyright Neil Brown and others.
 
2
.\"   This program is free software; you can redistribute it and/or modify
 
3
.\"   it under the terms of the GNU General Public License as published by
 
4
.\"   the Free Software Foundation; either version 2 of the License, or
 
5
.\"   (at your option) any later version.
 
6
.\" See file COPYING in distribution for details.
 
7
.TH MDADM.CONF 5
 
8
.SH NAME
 
9
mdadm.conf \- configuration for management of Software RAID with mdadm
 
10
.SH SYNOPSIS
 
11
/etc/mdadm.conf
 
12
.SH DESCRIPTION
 
13
.PP
 
14
.I mdadm
 
15
is a tool for creating, managing, and monitoring RAID devices using the
 
16
.B md
 
17
driver in Linux.
 
18
.PP
 
19
Some common tasks, such as assembling all arrays, can be simplified
 
20
by describing the devices and arrays in this configuration file.
 
21
 
 
22
.SS SYNTAX
 
23
The file should be seen as a collection of words separated by white
 
24
space (space, tab, or newline).
 
25
Any word that beings with a hash sign (#) starts a comment and that
 
26
word together with the remainder of the line is ignored.
 
27
 
 
28
Any line that starts with white space (space or tab) is treated as
 
29
though it were a continuation of the previous line.
 
30
 
 
31
Empty lines are ignored, but otherwise each (non continuation) line
 
32
must start with a keyword as listed below.  The keywords are case
 
33
insensitive and can be abbreviated to 3 characters.
 
34
 
 
35
The keywords are:
 
36
.TP
 
37
.B DEVICE
 
38
A
 
39
.B device
 
40
line lists the devices (whole devices or partitions) that might contain
 
41
a component of an MD array.  When looking for the components of an
 
42
array,
 
43
.I mdadm
 
44
will scan these devices (or any devices listed on the command line).
 
45
 
 
46
The
 
47
.B device
 
48
line may contain a number of different devices (separated by spaces)
 
49
and each device name can contain wild cards as defined by
 
50
.BR glob (7).
 
51
 
 
52
Also, there may be several device lines present in the file.
 
53
 
 
54
Alternatively, a
 
55
.B device
 
56
line can contain either of both of the  words
 
57
.B containers
 
58
and
 
59
.BR partitions .
 
60
The word
 
61
.B containers
 
62
will cause
 
63
.I mdadm
 
64
to look for assembled CONTAINER arrays and included them as a source
 
65
for assembling further arrays.
 
66
 
 
67
The word
 
68
.I partitions
 
69
will cause
 
70
.I mdadm
 
71
to read
 
72
.I /proc/partitions
 
73
and include all devices and partitions found therein.
 
74
.I mdadm
 
75
does not use the names from
 
76
.I /proc/partitions
 
77
but only the major and minor device numbers.  It scans
 
78
.I /dev
 
79
to find the name that matches the numbers.
 
80
 
 
81
If no DEVICE line is present, then "DEVICE partitions containers" is assumed.
 
82
 
 
83
For example:
 
84
.IP
 
85
DEVICE /dev/hda* /dev/hdc*
 
86
.br
 
87
DEV    /dev/sd*
 
88
.br
 
89
DEVICE /dev/disk/by-path/pci*
 
90
.br
 
91
DEVICE partitions
 
92
 
 
93
.TP
 
94
.B ARRAY
 
95
The ARRAY lines identify actual arrays.  The second word on the line
 
96
may be the name of the device where the array is normally
 
97
assembled, such as
 
98
.B /dev/md1
 
99
or
 
100
.BR /dev/md/backup .
 
101
If the name does not start with a slash
 
102
.RB (' / '),
 
103
it is treated as being in
 
104
.BR /dev/md/ .
 
105
Alternately the word
 
106
.B <ignore>
 
107
(complete with angle brackets) can be given in which case any array
 
108
which matches the rest of the line will never be automatically assembled.
 
109
If no device name is given,
 
110
.I mdadm
 
111
will use various heuristics to determine an appropriate name.
 
112
 
 
113
Subsequent words identify the array, or identify the array as a member
 
114
of a group. If multiple identities are given,
 
115
then a component device must match ALL identities to be considered a
 
116
match.  Each identity word has a tag, and equals sign, and some value.
 
117
The tags are:
 
118
.RS 4
 
119
.TP
 
120
.B uuid=
 
121
The value should be a 128 bit uuid in hexadecimal, with punctuation
 
122
interspersed if desired.  This must match the uuid stored in the
 
123
superblock.
 
124
.TP
 
125
.B name=
 
126
The value should be a simple textual name as was given to
 
127
.I mdadm
 
128
when the array was created.  This must match the name stored in the
 
129
superblock on a device for that device to be included in the array.
 
130
Not all superblock formats support names.
 
131
.TP
 
132
.B super\-minor=
 
133
The value is an integer which indicates the minor number that was
 
134
stored in the superblock when the array was created. When an array is
 
135
created as /dev/mdX, then the minor number X is stored.
 
136
.TP
 
137
.B devices=
 
138
The value is a comma separated list of device names or device name
 
139
patterns.
 
140
Only devices with names which match one entry in the list will be used
 
141
to assemble the array.  Note that the devices 
 
142
listed there must also be listed on a DEVICE line.
 
143
.TP
 
144
.B level=
 
145
The value is a raid level.  This is not normally used to
 
146
identify an array, but is supported so that the output of
 
147
 
 
148
.B "mdadm \-\-examine \-\-scan"
 
149
 
 
150
can be use directly in the configuration file.
 
151
.TP
 
152
.B num\-devices=
 
153
The value is the number of devices in a complete active array.  As with
 
154
.B level=
 
155
this is mainly for compatibility with the output of
 
156
 
 
157
.BR "mdadm \-\-examine \-\-scan" .
 
158
 
 
159
.TP
 
160
.B spares=
 
161
The value is a number of spare devices to expect the array to have.
 
162
The sole use of this keyword and value is as follows:
 
163
.B mdadm \-\-monitor
 
164
will report an array if it is found to have fewer than this number of
 
165
spares when
 
166
.B \-\-monitor
 
167
starts or when
 
168
.B \-\-oneshot
 
169
is used.
 
170
 
 
171
.TP
 
172
.B spare\-group=
 
173
The value is a textual name for a group of arrays.  All arrays with
 
174
the same
 
175
.B spare\-group
 
176
name are considered to be part of the same group.  The significance of
 
177
a group of arrays is that
 
178
.I mdadm
 
179
will, when monitoring the arrays, move a spare drive from one array in
 
180
a group to another array in that group if the first array had a failed
 
181
or missing drive but no spare.
 
182
 
 
183
.TP
 
184
.B auto=
 
185
This option is rarely needed with mdadm-3.0, particularly if use with
 
186
the Linux kernel v2.6.28 or later.
 
187
It tells
 
188
.I mdadm
 
189
whether to use partitionable array or non-partitionable arrays and,
 
190
in the absence of
 
191
.IR udev ,
 
192
how many partition devices to create.  From 2.6.28 all md array
 
193
devices are partitionable, hence this option is not needed.
 
194
 
 
195
The value of this option can be "yes" or "md" to indicate that a
 
196
traditional, non-partitionable md array should be created, or "mdp",
 
197
"part" or "partition" to indicate that a partitionable md array (only
 
198
available in linux 2.6 and later) should be used.  This later set can
 
199
also have a number appended to indicate how many partitions to create
 
200
device files for, e.g.
 
201
.BR auto=mdp5 .
 
202
The default is 4.
 
203
 
 
204
.TP
 
205
.B bitmap=
 
206
The option specifies a file in which a write-intent bitmap should be
 
207
found.  When assembling the array,
 
208
.I mdadm
 
209
will provide this file to the
 
210
.B md
 
211
driver as the bitmap file.  This has the same function as the
 
212
.B \-\-bitmap\-file
 
213
option to
 
214
.BR \-\-assemble .
 
215
 
 
216
.TP
 
217
.B metadata=
 
218
Specify the metadata format that the array has.  This is mainly
 
219
recognised for comparability with the output of
 
220
.BR "mdadm \-Es" .
 
221
 
 
222
.TP
 
223
.B container=
 
224
Specify that this array is a member array of some container.  The
 
225
value given can be either a path name in /dev, or a UUID of the
 
226
container array.
 
227
 
 
228
.TP
 
229
.B member=
 
230
Specify that this array is a member array of some container.  Each
 
231
type of container has some way to enumerate member arrays, often a
 
232
simple sequence number.  The value identifies which member of a
 
233
container the array is.  It will usually accompany a "container=" word.
 
234
.RE
 
235
 
 
236
.TP
 
237
.B MAILADDR
 
238
The
 
239
.B mailaddr
 
240
line gives an E-mail address that alerts should be
 
241
sent to when
 
242
.I mdadm
 
243
is running in
 
244
.B \-\-monitor
 
245
mode (and was given the
 
246
.B \-\-scan
 
247
option).  There should only be one
 
248
.B MAILADDR
 
249
line and it should have only one address.
 
250
 
 
251
 
 
252
.TP
 
253
.B MAILFROM
 
254
The
 
255
.B mailfrom
 
256
line (which can only be abbreviated to at least 5 characters) gives an
 
257
address to appear in the "From" address for alert mails.  This can be
 
258
useful if you want to explicitly set a domain, as the default from
 
259
address is "root" with no domain.  All words on this line are
 
260
catenated with spaces to form the address.
 
261
 
 
262
Note that this value cannot be set via the
 
263
.I mdadm
 
264
commandline.  It is only settable via the config file.
 
265
 
 
266
.TP
 
267
.B PROGRAM
 
268
The
 
269
.B program
 
270
line gives the name of a program to be run when
 
271
.B "mdadm \-\-monitor"
 
272
detects potentially interesting events on any of the arrays that it
 
273
is monitoring.  This program gets run with two or three arguments, they
 
274
being the Event, the md device, and possibly the related component
 
275
device.
 
276
 
 
277
There should only be one
 
278
.B program
 
279
line and it should be give only one program.
 
280
 
 
281
 
 
282
.TP
 
283
.B CREATE
 
284
The
 
285
.B create
 
286
line gives default values to be used when creating arrays and device entries for
 
287
arrays.
 
288
These include:
 
289
 
 
290
.RS 4
 
291
.TP
 
292
.B owner=
 
293
.TP
 
294
.B group=
 
295
These can give user/group ids or names to use instead of system
 
296
defaults (root/wheel or root/disk).
 
297
.TP
 
298
.B mode=
 
299
An octal file mode such as 0660 can be given to override the default
 
300
of 0600.
 
301
.TP
 
302
.B auto=
 
303
This corresponds to the
 
304
.B \-\-auto
 
305
flag to mdadm.  Give
 
306
.BR yes ,
 
307
.BR md ,
 
308
.BR mdp ,
 
309
.B part
 
310
\(em possibly followed by a number of partitions \(em to indicate how
 
311
missing device entries should be created.
 
312
 
 
313
.TP
 
314
.B metadata=
 
315
The name of the metadata format to use if none is explicitly given.
 
316
This can be useful to impose a system-wide default of version-1 superblocks.
 
317
 
 
318
.TP
 
319
.B symlinks=no
 
320
Normally when creating devices in
 
321
.B /dev/md/
 
322
.I mdadm
 
323
will create a matching symlink from
 
324
.B /dev/
 
325
with a name starting
 
326
.B md
 
327
or
 
328
.BR md_ .
 
329
Give
 
330
.B symlinks=no
 
331
to suppress this symlink creation.
 
332
.RE
 
333
 
 
334
.TP
 
335
.B HOMEHOST
 
336
The
 
337
.B homehost
 
338
line gives a default value for the
 
339
.B --homehost=
 
340
option to mdadm.  There should normally be only one other word on the line.
 
341
It should either be a host name, or one of the special words
 
342
.B <system>
 
343
and
 
344
.BR <ignore> .
 
345
If
 
346
.B <system>
 
347
is given, then the
 
348
.BR gethostname ( 2 )
 
349
systemcall is used to get the host name.
 
350
 
 
351
If
 
352
.B <ignore>
 
353
is given, then a flag is set so that when arrays are being
 
354
auto-assembled the checking of the recorded
 
355
.I homehost
 
356
is disabled.
 
357
If
 
358
.B <ignore>
 
359
is given it is also possible to give an explicit name which will be
 
360
used when creating arrays.  This is the only case when there can be
 
361
more that one other word on the
 
362
.B HOMEHOST
 
363
line.
 
364
 
 
365
When arrays are created, this host name will be stored in the
 
366
metadata.  When arrays are assembled using auto-assembly, arrays which
 
367
do not record the correct homehost name in their metadata will be
 
368
assembled using a "foreign" name.  A "foreign" name alway ends with a
 
369
digit string preceded by an underscore to differentiate it
 
370
from any possible local name. e.g.
 
371
.B /dev/md/1_1
 
372
or
 
373
.BR /dev/md/home_0 .
 
374
.TP
 
375
.B AUTO
 
376
A list of names of metadata format can be given, each preceded by a
 
377
plus or minus sign.  Also the word
 
378
.I all
 
379
preceded by plus or minus is allowed and is usually last.
 
380
 
 
381
When
 
382
.I mdadm
 
383
is auto-assembling an array, with via
 
384
.I --assemble
 
385
or
 
386
.I --incremental
 
387
and it finds metadata of a given type, it checks that metadata type
 
388
against those listed in this line.  The first match wins, where
 
389
.I all
 
390
matches anything.
 
391
If a match is found that was preceded by a plus sign, the auto
 
392
assembly is allowed.  If the match was preceded by a minus sign, the
 
393
auto assembly is disallowed.  If no match is found, the auto assembly
 
394
is allowed.
 
395
 
 
396
This can be used to disable all auto-assembly (so that only arrays
 
397
explicitly listed in mdadm.conf or on the command line are assembled),
 
398
or to disable assembly of certain metadata types which might be
 
399
handled by other software.
 
400
 
 
401
The known metadata types are
 
402
.BR 0.90 ,
 
403
.BR 1.x ,
 
404
.BR ddf ,
 
405
.BR imsm .
 
406
 
 
407
.SH EXAMPLE
 
408
DEVICE /dev/sd[bcdjkl]1
 
409
.br
 
410
DEVICE /dev/hda1 /dev/hdb1
 
411
 
 
412
# /dev/md0 is known by its UUID.
 
413
.br
 
414
ARRAY /dev/md0 UUID=3aaa0122:29827cfa:5331ad66:ca767371
 
415
.br
 
416
# /dev/md1 contains all devices with a minor number of
 
417
.br
 
418
#   1 in the superblock.
 
419
.br
 
420
ARRAY /dev/md1 superminor=1
 
421
.br
 
422
# /dev/md2 is made from precisely these two devices
 
423
.br
 
424
ARRAY /dev/md2 devices=/dev/hda1,/dev/hdb1
 
425
 
 
426
# /dev/md4 and /dev/md5 are a spare-group and spares
 
427
.br
 
428
#  can be moved between them
 
429
.br
 
430
ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df
 
431
.br
 
432
           spare\-group=group1
 
433
.br
 
434
ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977
 
435
.br
 
436
           spare\-group=group1
 
437
.br
 
438
# /dev/md/home is created if need to be a partitionable md array
 
439
.br
 
440
# any spare device number is allocated.
 
441
.br
 
442
ARRAY /dev/md/home UUID=9187a482:5dde19d9:eea3cc4a:d646ab8b
 
443
.br
 
444
           auto=part
 
445
 
 
446
MAILADDR root@mydomain.tld
 
447
.br
 
448
PROGRAM /usr/sbin/handle\-mdadm\-events
 
449
.br
 
450
CREATE group=system mode=0640 auto=part\-8
 
451
.br
 
452
HOMEHOST <system>
 
453
.br
 
454
AUTO +1.x -all
 
455
 
 
456
.SH SEE ALSO
 
457
.BR mdadm (8),
 
458
.BR md (4).
 
459