~ubuntu-branches/ubuntu/quantal/mdadm/quantal-proposed

« back to all changes in this revision

Viewing changes to mdadm.conf.5

  • Committer: Package Import Robot
  • Author(s): Scott James Remnant
  • Date: 2007-07-11 10:31:39 UTC
  • mfrom: (1.1.6)
  • mto: (1.4.1 experimental)
  • mto: This revision was merged to the branch mainline in revision 25.
  • Revision ID: package-import@ubuntu.com-20070711103139-ih7oxwxsal9ndbej
Tags: upstream-2.6.2
ImportĀ upstreamĀ versionĀ 2.6.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
59
59
.I mdadm
60
60
to read
61
61
.I /proc/partitions
62
 
and include all devices and partitions found there-in.
 
62
and include all devices and partitions found therein.
63
63
.I mdadm
64
64
does not use the names from
65
65
.I /proc/partitions
103
103
.I mdadm
104
104
when the array was created.  This must match the name stored in the
105
105
superblock on a device for that device to be included in the array.
106
 
Not all superblock-formats support names.
 
106
Not all superblock formats support names.
107
107
.TP
108
 
.B super-minor=
 
108
.B super\-minor=
109
109
The value is an integer which indicates the minor number that was
110
110
stored in the superblock when the array was created. When an array is
111
111
created as /dev/mdX, then the minor number X is stored.
121
121
The value is a raid level.  This is not normally used to
122
122
identify an array, but is supported so that the output of
123
123
 
124
 
.B "mdadm --examine --scan"
 
124
.B "mdadm \-\-examine \-\-scan"
125
125
 
126
126
can be use directly in the configuration file.
127
127
.TP
128
 
.B num-devices=
 
128
.B num\-devices=
129
129
The value is the number of devices in a complete active array.  As with
130
130
.B level=
131
131
this is mainly for compatibility with the output of
132
132
 
133
 
.BR "mdadm --examine --scan" .
 
133
.BR "mdadm \-\-examine \-\-scan" .
134
134
 
135
135
.TP
136
136
.B spares=
137
137
The value is a number of spare devices to expect the array to have.
138
 
.I mdadm --monitor
 
138
.B mdadm \-\-monitor
139
139
will report an array if it is found to have fewer than this number of
140
140
spares when
141
 
.B --monitor
 
141
.B \-\-monitor
142
142
starts or when
143
 
.B --oneshot
 
143
.B \-\-oneshot
144
144
is used.
145
145
 
146
146
.TP
147
 
.B spare-group=
 
147
.B spare\-group=
148
148
The value is a textual name for a group of arrays.  All arrays with
149
149
the same
150
 
.B spare-group
 
150
.B spare\-group
151
151
name are considered to be part of the same group.  The significance of
152
152
a group of arrays is that
153
153
.B mdadm
179
179
will provide this file to the
180
180
.B md
181
181
driver as the bitmap file.  This has the same function as the
182
 
.B --bitmap-file
 
182
.B \-\-bitmap\-file
183
183
option to
184
 
.BR --assemble .
 
184
.BR \-\-assemble .
185
185
 
186
186
.TP
187
187
.B metadata=
188
188
Specify the metadata format that the array has.  This is mainly
189
189
recognised for comparability with the output of
190
 
.IR "mdadm -Es" .
 
190
.BR "mdadm \-Es" .
191
191
 
192
192
.RE
193
193
 
199
199
sent to when
200
200
.M mdadm
201
201
is running in
202
 
.B --monitor
 
202
.B \-\-monitor
203
203
mode (and was given the
204
 
.B --scan
 
204
.B \-\-scan
205
205
option).  There should only be one
206
206
.B MAILADDR
207
207
line and it should have only one address.
226
226
The
227
227
.B program
228
228
line gives the name of a program to be run when
229
 
.B "mdadm --monitor"
 
229
.B "mdadm \-\-monitor"
230
230
detects potentially interesting events on any of the arrays that it
231
231
is monitoring.  This program gets run with two or three arguments, they
232
232
being the Event, the md device, and possibly the related component
259
259
.TP
260
260
.B auto=
261
261
This corresponds to the
262
 
.B --auto
 
262
.B \-\-auto
263
263
flag to mdadm.  Give
264
264
.BR yes ,
265
265
.BR md ,
266
266
.BR mdp ,
267
267
.B part
268
 
- possibly followed by a number of partitions - to indicate how
 
268
\(em possibly followed by a number of partitions \(em to indicate how
269
269
missing device entries should be created.
270
270
 
271
271
.TP
285
285
or
286
286
.BR md_ .
287
287
Give
288
 
.B symlinked=no
 
288
.B symlinks=no
289
289
to suppress this symlink creation.
290
290
.RE
291
291
 
315
315
.br
316
316
ARRAY /dev/md4 uuid=b23f3c6d:aec43a9f:fd65db85:369432df
317
317
.br
318
 
           spare-group=group1
 
318
           spare\-group=group1
319
319
.br
320
320
ARRAY /dev/md5 uuid=19464854:03f71b1b:e0df2edd:246cc977
321
321
.br
322
 
           spare-group=group1
 
322
           spare\-group=group1
323
323
.br
324
324
# /dev/md/home is created if need to be a partitionable md array
325
325
.br
331
331
 
332
332
MAILADDR root@mydomain.tld
333
333
.br
334
 
PROGRAM /usr/sbin/handle-mdadm-events
 
334
PROGRAM /usr/sbin/handle\-mdadm\-events
335
335
.br
336
 
CREATE group=system mode=0640 auto=part-8
 
336
CREATE group=system mode=0640 auto=part\-8
337
337
.br
338
338
HOMEHOST <system>
339
339