]>
git.ipfire.org Git - thirdparty/mdadm.git/blob - config.c
2 * mdadm - manage Linux "md" devices aka RAID arrays.
4 * Copyright (C) 2001-2006 Neil Brown <neilb@suse.de>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 * Email: <neilb@cse.unsw.edu.au>
24 * School of Computer Science and Engineering
25 * The University of New South Wales
40 * Read the config file
42 * conf_get_uuids gets a list of devicename+uuid pairs
43 * conf_get_devs gets device names after expanding wildcards
45 * Each keeps the returned list and frees it when asked to make
48 * The format of the config file needs to be fairly extensible.
49 * Now, arrays only have names and uuids and devices merely are.
50 * But later arrays might want names, and devices might want superblock
51 * versions, and who knows what else.
52 * I like free format, abhore backslash line continuation, adore
53 * indentation for structure and am ok about # comments.
55 * So, each line that isn't blank or a #comment must either start
56 * with a key word, and not be indented, or must start with a
57 * non-key-word and must be indented.
59 * Keywords are DEVICE and ARRAY ... and several others.
60 * DEV{ICE} introduces some devices that might contain raid components.
62 * DEV style=0 /dev/sda* /dev/hd*
63 * DEV style=1 /dev/sd[b-f]*
64 * ARR{AY} describes an array giving md device and attributes like uuid=whatever
66 * ARRAY /dev/md0 uuid=whatever name=something
67 * Spaces separate words on each line. Quoting, with "" or '' protects them,
68 * but may not wrap over lines
73 #define CONFFILE "/etc/mdadm.conf"
76 /* for Debian compatibility .... */
77 #define CONFFILE2 "/etc/mdadm/mdadm.conf"
79 char DefaultConfFile
[] = CONFFILE
;
80 char DefaultAltConfFile
[] = CONFFILE2
;
82 enum linetype
{ Devices
, Array
, Mailaddr
, Mailfrom
, Program
, CreateDev
,
83 Homehost
, AutoMode
, LTEnd
};
85 [Devices
] = "devices",
87 [Mailaddr
] = "mailaddr",
88 [Mailfrom
] = "mailfrom",
89 [Program
] = "program",
90 [CreateDev
]= "create",
91 [Homehost
] = "homehost",
97 * match_keyword returns an index into the keywords array, or -1 for no match
98 * case is ignored, and at least three characters must be given
101 int match_keyword(char *word
)
103 int len
= strlen(word
);
106 if (len
< 3) return -1;
107 for (n
=0; keywords
[n
]; n
++) {
108 if (strncasecmp(word
, keywords
[n
], len
)==0)
114 /* conf_word gets one word from the conf file.
115 * if "allow_key", then accept words at the start of a line,
116 * otherwise stop when such a word is found.
117 * We assume that the file pointer is at the end of a word, so the
118 * next character is a space, or a newline. If not, it is the start of a line.
121 char *conf_word(FILE *file
, int allow_key
)
128 char *word
= malloc(wsize
);
132 while (wordfound
==0) {
133 /* at the end of a word.. */
136 while (c
!= EOF
&& c
!= '\n')
139 if (c
== '\n') continue;
141 if (c
!= ' ' && c
!= '\t' && ! allow_key
) {
145 /* looks like it is safe to get a word here, if there is one */
147 /* first, skip any spaces */
148 while (c
== ' ' || c
== '\t')
150 if (c
!= EOF
&& c
!= '\n' && c
!= '#') {
151 /* we really have a character of a word, so start saving it */
152 while (c
!= EOF
&& c
!= '\n' && (quote
|| (c
!=' ' && c
!= '\t'))) {
154 if (quote
&& c
== quote
) quote
= 0;
155 else if (quote
== 0 && (c
== '\'' || c
== '"'))
158 if (len
== wsize
-1) {
160 word
= realloc(word
, wsize
);
166 /* Hack for broken kernels (2.6.14-.24) that put
167 * "active(auto-read-only)"
168 * in /proc/mdstat instead of
169 * "active (auto-read-only)"
171 if (c
== '(' && len
>= 6
172 && strncmp(word
+len
-6, "active", 6) == 0)
176 if (c
!= EOF
) ungetc(c
, file
);
180 /* Further HACK for broken kernels.. 2.6.14-2.6.24 */
181 if (strcmp(word
, "auto-read-only)") == 0)
182 strcpy(word
, "(auto-read-only)");
184 /* printf("word is <%s>\n", word); */
193 * conf_line reads one logical line from the conffile.
194 * It skips comments and continues until it finds a line that starts
195 * with a non blank/comment. This character is pushed back for the next call
196 * A doubly linked list of words is returned.
197 * the first word will be a keyword. Other words will have had quotes removed.
200 char *conf_line(FILE *file
)
205 w
= conf_word(file
, 1);
206 if (w
== NULL
) return NULL
;
212 while ((w
= conf_word(file
,0))){
213 char *w2
= dl_strdup(w
);
217 /* printf("got a line\n");*/
221 void free_line(char *line
)
224 for (w
=dl_next(line
); w
!= line
; w
=dl_next(line
)) {
233 struct conf_dev
*next
;
237 mddev_dev_t
load_partitions(void)
239 FILE *f
= fopen("/proc/partitions", "r");
241 mddev_dev_t rv
= NULL
;
243 fprintf(stderr
, Name
": cannot open /proc/partitions\n");
246 while (fgets(buf
, 1024, f
)) {
254 major
= strtoul(buf
, &mp
, 10);
255 if (mp
== buf
|| *mp
!= ' ')
257 minor
= strtoul(mp
, NULL
, 10);
259 name
= map_dev(major
, minor
, 1);
262 d
= malloc(sizeof(*d
));
263 d
->devname
= strdup(name
);
273 mddev_dev_t
load_containers(void)
275 struct mdstat_ent
*mdstat
= mdstat_read(1, 0);
276 struct mdstat_ent
*ent
;
278 mddev_dev_t rv
= NULL
;
283 for (ent
= mdstat
; ent
; ent
= ent
->next
)
284 if (ent
->metadata_version
&&
285 strncmp(ent
->metadata_version
, "external:", 9) == 0 &&
286 !is_subarray(&ent
->metadata_version
[9])) {
287 d
= malloc(sizeof(*d
));
290 if (asprintf(&d
->devname
, "/dev/%s", ent
->dev
) < 0) {
304 struct createinfo createinfo
= {
305 .autof
= 2, /* by default, create devices with standard names */
315 int parse_auto(char *str
, char *msg
, int config
)
318 if (str
== NULL
|| *str
== 0)
320 else if (strcasecmp(str
,"no")==0)
322 else if (strcasecmp(str
,"yes")==0)
324 else if (strcasecmp(str
,"md")==0)
327 /* There might be digits, and maybe a hypen, at the end */
328 char *e
= str
+ strlen(str
);
331 while (e
> str
&& isdigit(e
[-1]))
335 if (num
<= 0) num
= 1;
337 if (e
> str
&& e
[-1] == '-')
340 if ((len
== 2 && strncasecmp(str
,"md",2)==0)) {
341 autof
= config
? 5 : 3;
342 } else if ((len
== 3 && strncasecmp(str
,"yes",3)==0)) {
344 } else if ((len
== 3 && strncasecmp(str
,"mdp",3)==0)) {
345 autof
= config
? 6 : 4;
346 } else if ((len
== 1 && strncasecmp(str
,"p",1)==0) ||
347 (len
>= 4 && strncasecmp(str
,"part",4)==0)) {
350 fprintf(stderr
, Name
": %s arg of \"%s\" unrecognised: use no,yes,md,mdp,part\n"
351 " optionally followed by a number.\n",
360 static void createline(char *line
)
365 for (w
=dl_next(line
); w
!=line
; w
=dl_next(w
)) {
366 if (strncasecmp(w
, "auto=", 5) == 0)
367 createinfo
.autof
= parse_auto(w
+5, "auto=", 1);
368 else if (strncasecmp(w
, "owner=", 6) == 0) {
370 fprintf(stderr
, Name
": missing owner name\n");
373 createinfo
.uid
= strtoul(w
+6, &ep
, 10);
379 createinfo
.uid
= pw
->pw_uid
;
381 fprintf(stderr
, Name
": CREATE user %s not found\n", w
+6);
383 } else if (strncasecmp(w
, "group=", 6) == 0) {
385 fprintf(stderr
, Name
": missing group name\n");
388 createinfo
.gid
= strtoul(w
+6, &ep
, 10);
394 createinfo
.gid
= gr
->gr_gid
;
396 fprintf(stderr
, Name
": CREATE group %s not found\n", w
+6);
398 } else if (strncasecmp(w
, "mode=", 5) == 0) {
400 fprintf(stderr
, Name
": missing CREATE mode\n");
403 createinfo
.mode
= strtoul(w
+5, &ep
, 8);
405 createinfo
.mode
= 0600;
406 fprintf(stderr
, Name
": unrecognised CREATE mode %s\n",
409 } else if (strncasecmp(w
, "metadata=", 9) == 0) {
410 /* style of metadata to use by default */
412 for (i
=0; superlist
[i
] && !createinfo
.supertype
; i
++)
413 createinfo
.supertype
=
414 superlist
[i
]->match_metadata_desc(w
+9);
415 if (!createinfo
.supertype
)
416 fprintf(stderr
, Name
": metadata format %s unknown, ignoring\n",
418 } else if (strncasecmp(w
, "symlinks=yes", 12) == 0)
419 createinfo
.symlinks
= 1;
420 else if (strncasecmp(w
, "symlinks=no", 11) == 0)
421 createinfo
.symlinks
= 0;
423 fprintf(stderr
, Name
": unrecognised word on CREATE line: %s\n",
429 void devline(char *line
)
434 for (w
=dl_next(line
); w
!= line
; w
=dl_next(w
)) {
435 if (w
[0] == '/' || strcasecmp(w
, "partitions") == 0 ||
436 strcasecmp(w
, "containers") == 0) {
437 cd
= malloc(sizeof(*cd
));
438 cd
->name
= strdup(w
);
442 fprintf(stderr
, Name
": unreconised word on DEVICE line: %s\n",
448 mddev_ident_t mddevlist
= NULL
;
449 mddev_ident_t
*mddevlp
= &mddevlist
;
451 void arrayline(char *line
)
455 struct mddev_ident_s mis
;
459 mis
.super_minor
= UnSet
;
461 mis
.raid_disks
= UnSet
;
465 mis
.spare_group
= NULL
;
470 mis
.bitmap_file
= NULL
;
472 mis
.container
= NULL
;
475 for (w
=dl_next(line
); w
!=line
; w
=dl_next(w
)) {
476 if (w
[0] == '/' || strcasecmp(w
, "<ignore>") == 0) {
478 fprintf(stderr
, Name
": only give one device per ARRAY line: %s and %s\n",
480 else mis
.devname
= w
;
481 } else if (strncasecmp(w
, "uuid=", 5)==0 ) {
483 fprintf(stderr
, Name
": only specify uuid once, %s ignored.\n",
486 if (parse_uuid(w
+5, mis
.uuid
))
489 fprintf(stderr
, Name
": bad uuid: %s\n", w
);
491 } else if (strncasecmp(w
, "super-minor=", 12)==0 ) {
492 if (mis
.super_minor
!= UnSet
)
493 fprintf(stderr
, Name
": only specify super-minor once, %s ignored.\n",
497 mis
.super_minor
= strtol(w
+12, &endptr
, 10);
498 if (w
[12]==0 || endptr
[0]!=0 || mis
.super_minor
< 0) {
499 fprintf(stderr
, Name
": invalid super-minor number: %s\n",
501 mis
.super_minor
= UnSet
;
504 } else if (strncasecmp(w
, "name=", 5)==0) {
506 fprintf(stderr
, Name
": only specify name once, %s ignored.\n",
508 else if (strlen(w
+5) > 32)
509 fprintf(stderr
, Name
": name too long, ignoring %s\n", w
);
511 strcpy(mis
.name
, w
+5);
513 } else if (strncasecmp(w
, "bitmap=", 7) == 0) {
515 fprintf(stderr
, Name
": only specify bitmap file once. %s ignored\n",
518 mis
.bitmap_file
= strdup(w
+7);
520 } else if (strncasecmp(w
, "devices=", 8 ) == 0 ) {
522 fprintf(stderr
, Name
": only specify devices once (use a comma separated list). %s ignored\n",
525 mis
.devices
= strdup(w
+8);
526 } else if (strncasecmp(w
, "spare-group=", 12) == 0 ) {
528 fprintf(stderr
, Name
": only specify one spare group per array. %s ignored.\n",
531 mis
.spare_group
= strdup(w
+12);
532 } else if (strncasecmp(w
, "level=", 6) == 0 ) {
533 /* this is mainly for compatability with --brief output */
534 mis
.level
= map_name(pers
, w
+6);
535 } else if (strncasecmp(w
, "disks=", 6) == 0 ) {
536 /* again, for compat */
537 mis
.raid_disks
= atoi(w
+6);
538 } else if (strncasecmp(w
, "num-devices=", 12) == 0 ) {
539 /* again, for compat */
540 mis
.raid_disks
= atoi(w
+12);
541 } else if (strncasecmp(w
, "spares=", 7) == 0 ) {
542 /* for warning if not all spares present */
543 mis
.spare_disks
= atoi(w
+7);
544 } else if (strncasecmp(w
, "metadata=", 9) == 0) {
545 /* style of metadata on the devices. */
548 for(i
=0; superlist
[i
] && !mis
.st
; i
++)
549 mis
.st
= superlist
[i
]->match_metadata_desc(w
+9);
552 fprintf(stderr
, Name
": metadata format %s unknown, ignored.\n", w
+9);
553 } else if (strncasecmp(w
, "auto=", 5) == 0 ) {
554 /* whether to create device special files as needed */
555 mis
.autof
= parse_auto(w
+5, "auto type", 0);
556 } else if (strncasecmp(w
, "member=", 7) == 0) {
557 /* subarray within a container */
558 mis
.member
= strdup(w
+7);
559 } else if (strncasecmp(w
, "container=", 10) == 0) {
560 /* the container holding this subarray. Either a device name
562 mis
.container
= strdup(w
+10);
564 fprintf(stderr
, Name
": unrecognised word on ARRAY line: %s\n",
568 if (mis
.uuid_set
== 0 && mis
.devices
== NULL
&&
569 mis
.super_minor
== UnSet
&& mis
.name
[0] == 0 &&
570 (mis
.container
== NULL
&& mis
.member
== NULL
))
571 fprintf(stderr
, Name
": ARRAY line %s has no identity information.\n", mis
.devname
);
573 mi
= malloc(sizeof(*mi
));
575 mi
->devname
= mis
.devname
? strdup(mis
.devname
) : NULL
;
582 static char *alert_email
= NULL
;
583 void mailline(char *line
)
587 for (w
=dl_next(line
); w
!= line
; w
=dl_next(w
)) {
588 if (alert_email
== NULL
)
589 alert_email
= strdup(w
);
591 fprintf(stderr
, Name
": excess address on MAIL line: %s - ignored\n",
596 static char *alert_mail_from
= NULL
;
597 void mailfromline(char *line
)
601 for (w
=dl_next(line
); w
!= line
; w
=dl_next(w
)) {
602 if (alert_mail_from
== NULL
)
603 alert_mail_from
= strdup(w
);
607 if (xasprintf(&t
, "%s %s", alert_mail_from
, w
) > 0) {
608 free(alert_mail_from
);
616 static char *alert_program
= NULL
;
617 void programline(char *line
)
621 for (w
=dl_next(line
); w
!= line
; w
=dl_next(w
)) {
622 if (alert_program
== NULL
)
623 alert_program
= strdup(w
);
625 fprintf(stderr
, Name
": excess program on PROGRAM line: %s - ignored\n",
630 static char *home_host
= NULL
;
631 void homehostline(char *line
)
635 for (w
=dl_next(line
); w
!= line
; w
=dl_next(w
)) {
636 if (home_host
== NULL
)
637 home_host
= strdup(w
);
639 fprintf(stderr
, Name
": excess host name on HOMEHOST line: %s - ignored\n",
644 static char *auto_options
= NULL
;
645 void autoline(char *line
)
648 fprintf(stderr
, Name
": AUTO line may only be give once."
649 " Subsequent lines ignored\n");
657 static char *conffile
= NULL
;
658 void set_conffile(char *file
)
663 void load_conffile(void)
669 if (conffile
== NULL
)
670 conffile
= DefaultConfFile
;
672 if (strcmp(conffile
, "none") == 0) {
676 if (strcmp(conffile
, "partitions")==0) {
677 char *list
= dl_strdup("DEV");
679 dl_add(list
, dl_strdup("partitions"));
685 f
= fopen(conffile
, "r");
686 /* Debian chose to relocate mdadm.conf into /etc/mdadm/.
687 * To allow Debian users to compile from clean source and still
688 * have a working mdadm, we read /etc/mdadm/mdadm.conf
689 * if /etc/mdadm.conf doesn't exist
692 conffile
== DefaultConfFile
) {
693 f
= fopen(DefaultAltConfFile
, "r");
695 conffile
= DefaultAltConfFile
;
701 while ((line
=conf_line(f
))) {
702 switch(match_keyword(line
)) {
728 fprintf(stderr
, Name
": Unknown keyword %s\n", line
);
735 /* printf("got file\n"); */
738 char *conf_get_mailaddr(void)
744 char *conf_get_mailfrom(void)
747 return alert_mail_from
;
750 char *conf_get_program(void)
753 return alert_program
;
756 char *conf_get_homehost(void)
762 struct createinfo
*conf_get_create_info(void)
768 mddev_ident_t
conf_get_ident(char *dev
)
773 while (dev
&& rv
&& (rv
->devname
== NULL
774 || strcmp(dev
, rv
->devname
)!=0))
779 static void append_dlist(mddev_dev_t
*dlp
, mddev_dev_t list
)
786 mddev_dev_t
conf_get_devs()
791 static mddev_dev_t dlist
= NULL
;
795 mddev_dev_t t
= dlist
;
803 if (cdevlist
== NULL
) {
804 /* default to 'partitions' and 'containers' */
805 dlist
= load_partitions();
806 append_dlist(&dlist
, load_containers());
809 for (cd
=cdevlist
; cd
; cd
=cd
->next
) {
810 if (strcasecmp(cd
->name
, "partitions")==0)
811 append_dlist(&dlist
, load_partitions());
812 else if (strcasecmp(cd
->name
, "containers")==0)
813 append_dlist(&dlist
, load_containers());
815 glob(cd
->name
, flags
, NULL
, &globbuf
);
816 flags
|= GLOB_APPEND
;
819 if (flags
& GLOB_APPEND
) {
820 for (i
=0; i
<globbuf
.gl_pathc
; i
++) {
821 mddev_dev_t t
= malloc(sizeof(*t
));
822 t
->devname
= strdup(globbuf
.gl_pathv
[i
]);
827 /* printf("one dev is %s\n", t->devname);*/
835 int conf_test_dev(char *devname
)
838 if (cdevlist
== NULL
)
839 /* allow anything by default */
841 for (cd
= cdevlist
; cd
; cd
= cd
->next
) {
842 if (strcasecmp(cd
->name
, "partitions") == 0)
844 if (fnmatch(cd
->name
, devname
, FNM_PATHNAME
) == 0)
850 int conf_test_metadata(const char *version
)
852 /* Check if the given metadata version is allowed
853 * to be auto-assembled.
854 * The default is 'yes' but the 'auto' line might over-ride that.
855 * Word in auto_options are processed in order with the first
858 * +version - that version can be assembled
859 * -version - that version cannot be auto-assembled
860 * yes or +all - any other version can be assembled
861 * no or -all - no other version can be assembled.
867 for (w
= dl_next(auto_options
); w
!= auto_options
; w
= dl_next(w
)) {
869 if (strcasecmp(w
, "yes") == 0)
871 if (strcasecmp(w
, "no") == 0)
875 else if (w
[0] == '-')
879 if (strcasecmp(w
+1, "all") == 0)
881 if (strcasecmp(w
+1, version
) == 0)
883 /* allow '0' to match version '0.90'
884 * and 1 or 1.whatever to match version '1.x'
886 if (version
[1] == '.' &&
890 if (version
[1] == '.' && version
[2] == 'x' &&
891 strncmp(w
+1, version
, 2) == 0)
897 int match_oneof(char *devices
, char *devname
)
899 /* check if one of the comma separated patterns in devices
904 while (devices
&& *devices
) {
907 devices
= strchr(devices
, ',');
909 devices
= p
+ strlen(p
);
910 if (devices
-p
< 1024) {
911 strncpy(patn
, p
, devices
-p
);
913 if (fnmatch(patn
, devname
, FNM_PATHNAME
)==0)