]> git.ipfire.org Git - thirdparty/mdadm.git/blob - mdadm.c
Typo in mdadm.conf man page
[thirdparty/mdadm.git] / mdadm.c
1 /*
2 * mdadm - manage Linux "md" devices aka RAID arrays.
3 *
4 * Copyright (C) 2001-2006 Neil Brown <neilb@suse.de>
5 *
6 *
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.
11 *
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.
16 *
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
20 *
21 * Author: Neil Brown
22 * Email: <neilb@cse.unsw.edu.au>
23 * Paper: Neil Brown
24 * School of Computer Science and Engineering
25 * The University of New South Wales
26 * Sydney, 2052
27 * Australia
28 *
29 * Additions for bitmap and write-behind RAID options, Copyright (C) 2003-2004,
30 * Paul Clements, SteelEye Technology, Inc.
31 */
32
33 #include "mdadm.h"
34 #include "md_p.h"
35 #include <ctype.h>
36
37
38 int main(int argc, char *argv[])
39 {
40 int mode = 0;
41 int opt;
42 int option_index;
43 char *c;
44 int rv;
45 int i;
46
47 int chunk = 0;
48 long long size = -1;
49 int level = UnSet;
50 int layout = UnSet;
51 int raiddisks = 0;
52 int max_disks = MD_SB_DISKS; /* just a default */
53 int sparedisks = 0;
54 struct mddev_ident_s ident;
55 char *configfile = NULL;
56 char *cp;
57 char *update = NULL;
58 int scan = 0;
59 char devmode = 0;
60 int runstop = 0;
61 int readonly = 0;
62 int write_behind = 0;
63 int bitmap_fd = -1;
64 char *bitmap_file = NULL;
65 char *backup_file = NULL;
66 int bitmap_chunk = UnSet;
67 int SparcAdjust = 0;
68 mddev_dev_t devlist = NULL;
69 mddev_dev_t *devlistend = & devlist;
70 mddev_dev_t dv;
71 int devs_found = 0;
72 int verbose = 0;
73 int quiet = 0;
74 int brief = 0;
75 int force = 0;
76 int test = 0;
77 int assume_clean = 0;
78 char *symlinks = NULL;
79 /* autof indicates whether and how to create device node.
80 * bottom 3 bits are style. Rest (when shifted) are number of parts
81 * 0 - unset
82 * 1 - don't create (no)
83 * 2 - if is_standard, then create (yes)
84 * 3 - create as 'md' - reject is_standard mdp (md)
85 * 4 - create as 'mdp' - reject is_standard md (mdp)
86 * 5 - default to md if not is_standard (md in config file)
87 * 6 - default to mdp if not is_standard (part, or mdp in config file)
88 */
89 int autof = 0;
90
91 char *homehost = NULL;
92 char sys_hostname[256];
93 char *mailaddr = NULL;
94 char *program = NULL;
95 int delay = 0;
96 int daemonise = 0;
97 char *pidfile = NULL;
98 int oneshot = 0;
99 struct supertype *ss = NULL;
100 int writemostly = 0;
101 int re_add = 0;
102 char *shortopt = short_options;
103 int dosyslog = 0;
104 int rebuild_map = 0;
105 int auto_update_home = 0;
106
107 int copies;
108 int print_help = 0;
109
110 int mdfd = -1;
111
112 srandom(time(0) ^ getpid());
113
114 ident.uuid_set=0;
115 ident.level = UnSet;
116 ident.raid_disks = UnSet;
117 ident.super_minor= UnSet;
118 ident.devices=0;
119 ident.spare_group = NULL;
120 ident.autof = 0;
121 ident.st = NULL;
122 ident.bitmap_fd = -1;
123 ident.bitmap_file = NULL;
124 ident.name[0] = 0;
125
126 while ((option_index = -1) ,
127 (opt=getopt_long(argc, argv,
128 shortopt, long_options,
129 &option_index)) != -1) {
130 int newmode = mode;
131 /* firstly, some mode-independant options */
132 switch(opt) {
133 case 'h':
134 if (option_index > 0 &&
135 strcmp(long_options[option_index].name, "help-options")==0)
136 print_help = 2;
137 else
138 print_help = 1;
139 continue;
140
141 case 'V':
142 fputs(Version, stderr);
143 exit(0);
144
145 case 'v': verbose++;
146 continue;
147
148 case 'q': quiet++;
149 continue;
150
151 case 'b':
152 if (mode == ASSEMBLE || mode == BUILD || mode == CREATE || mode == GROW)
153 break; /* b means bitmap */
154 brief = 1;
155 if (optarg) {
156 fprintf(stderr, Name ": -b cannot have any extra immediately after it, sorry.\n");
157 exit(2);
158 }
159 continue;
160
161 case HomeHost:
162 homehost = optarg;
163 continue;
164
165 case ':':
166 case '?':
167 fputs(Usage, stderr);
168 exit(2);
169 }
170 /* second, figure out the mode.
171 * Some options force the mode. Others
172 * set the mode if it isn't already
173 */
174
175 switch(opt) {
176 case '@': /* just incase they say --manage */
177 newmode = MANAGE;
178 shortopt = short_bitmap_auto_options;
179 break;
180 case 'a':
181 case 'r':
182 case 'f':
183 case ReAdd: /* re-add */
184 if (!mode) {
185 newmode = MANAGE;
186 shortopt = short_bitmap_auto_options;
187 }
188 break;
189
190 case 'A': newmode = ASSEMBLE; shortopt = short_bitmap_auto_options; break;
191 case 'B': newmode = BUILD; shortopt = short_bitmap_auto_options; break;
192 case 'C': newmode = CREATE; shortopt = short_bitmap_auto_options; break;
193 case 'F': newmode = MONITOR;break;
194 case 'G': newmode = GROW; shortopt = short_bitmap_auto_options; break;
195 case 'I': newmode = INCREMENTAL; break;
196
197 case '#':
198 case 'D':
199 case 'E':
200 case 'X':
201 case 'Q': newmode = MISC; break;
202 case 'R':
203 case 'S':
204 case 'o':
205 case 'w':
206 case 'W':
207 case 'K': if (!mode) newmode = MISC; break;
208 }
209 if (mode && newmode == mode) {
210 /* everybody happy ! */
211 } else if (mode && newmode != mode) {
212 /* not allowed.. */
213 fprintf(stderr, Name ": ");
214 if (option_index >= 0)
215 fprintf(stderr, "--%s", long_options[option_index].name);
216 else
217 fprintf(stderr, "-%c", opt);
218 fprintf(stderr, " would set mdadm mode to \"%s\", but it is already set to \"%s\".\n",
219 map_num(modes, newmode),
220 map_num(modes, mode));
221 exit(2);
222 } else if (!mode && newmode) {
223 mode = newmode;
224 } else {
225 /* special case of -c --help */
226 if (opt == 'c' &&
227 ( strncmp(optarg, "--h", 3)==0 ||
228 strncmp(optarg, "-h", 2)==0)) {
229 fputs(Help_config, stderr);
230 exit(0);
231 }
232
233 /* If first option is a device, don't force the mode yet */
234 if (opt == 1) {
235 if (devs_found == 0) {
236 dv = malloc(sizeof(*dv));
237 if (dv == NULL) {
238 fprintf(stderr, Name ": malloc failed\n");
239 exit(3);
240 }
241 dv->devname = optarg;
242 dv->disposition = devmode;
243 dv->writemostly = writemostly;
244 dv->re_add = re_add;
245 dv->used = 0;
246 dv->next = NULL;
247 *devlistend = dv;
248 devlistend = &dv->next;
249
250 devs_found++;
251 continue;
252 }
253 /* No mode yet, and this is the second device ... */
254 fprintf(stderr, Name ": An option must be given to set the mode before a second device is listed\n");
255 exit(2);
256 }
257 if (option_index >= 0)
258 fprintf(stderr, Name ": --%s", long_options[option_index].name);
259 else
260 fprintf(stderr, Name ": -%c", opt);
261 fprintf(stderr, " does not set the mode, and so cannot be the first option.\n");
262 exit(2);
263 }
264
265 /* if we just set the mode, then done */
266 switch(opt) {
267 case '@':
268 case '#':
269 case 'A':
270 case 'B':
271 case 'C':
272 case 'F':
273 case 'G':
274 case 'I':
275 continue;
276 }
277 if (opt == 1) {
278 /* an undecorated option - must be a device name.
279 */
280 if (devs_found > 0 && mode == '@' && !devmode) {
281 fprintf(stderr, Name ": Must give one of -a/-r/-f for subsequent devices at %s\n", optarg);
282 exit(2);
283 }
284 if (devs_found > 0 && mode == 'G' && !devmode) {
285 fprintf(stderr, Name ": Must give one of -a for devices do add: %s\n", optarg);
286 exit(2);
287 }
288 dv = malloc(sizeof(*dv));
289 if (dv == NULL) {
290 fprintf(stderr, Name ": malloc failed\n");
291 exit(3);
292 }
293 dv->devname = optarg;
294 dv->disposition = devmode;
295 dv->writemostly = writemostly;
296 dv->re_add = re_add;
297 dv->next = NULL;
298 *devlistend = dv;
299 devlistend = &dv->next;
300
301 devs_found++;
302 continue;
303 }
304
305 /* We've got a mode, and opt is now something else which
306 * could depend on the mode */
307 #define O(a,b) ((a<<8)|b)
308 switch (O(mode,opt)) {
309 case O(CREATE,'c'):
310 case O(BUILD,'c'): /* chunk or rounding */
311 if (chunk) {
312 fprintf(stderr, Name ": chunk/rounding may only be specified once. "
313 "Second value is %s.\n", optarg);
314 exit(2);
315 }
316 chunk = strtol(optarg, &c, 10);
317 if (!optarg[0] || *c || chunk<4 || ((chunk-1)&chunk)) {
318 fprintf(stderr, Name ": invalid chunk/rounding value: %s\n",
319 optarg);
320 exit(2);
321 }
322 continue;
323
324 case O(ASSEMBLE,AutoHomeHost):
325 auto_update_home = 1;
326 continue;
327 case O(INCREMENTAL, 'e'):
328 case O(CREATE,'e'):
329 case O(ASSEMBLE,'e'):
330 case O(MISC,'e'): /* set metadata (superblock) information */
331 if (ss) {
332 fprintf(stderr, Name ": metadata information already given\n");
333 exit(2);
334 }
335 for(i=0; !ss && superlist[i]; i++)
336 ss = superlist[i]->match_metadata_desc(optarg);
337
338 if (!ss) {
339 fprintf(stderr, Name ": unrecognised metadata identifier: %s\n", optarg);
340 exit(2);
341 }
342 max_disks = ss->max_devs;
343 continue;
344
345 case O(MANAGE,'W'):
346 case O(BUILD,'W'):
347 case O(CREATE,'W'):
348 /* set write-mostly for following devices */
349 writemostly = 1;
350 continue;
351
352 case O(GROW,'z'):
353 case O(CREATE,'z'): /* size */
354 if (size >= 0) {
355 fprintf(stderr, Name ": size may only be specified once. "
356 "Second value is %s.\n", optarg);
357 exit(2);
358 }
359 if (strcmp(optarg, "max")==0)
360 size = 0;
361 else {
362 size = strtoll(optarg, &c, 10);
363 if (!optarg[0] || *c || size < 4) {
364 fprintf(stderr, Name ": invalid size: %s\n",
365 optarg);
366 exit(2);
367 }
368 }
369 continue;
370
371 case O(GROW,'l'): /* hack - needed to understand layout */
372 case O(CREATE,'l'):
373 case O(BUILD,'l'): /* set raid level*/
374 if (level != UnSet) {
375 fprintf(stderr, Name ": raid level may only be set once. "
376 "Second value is %s.\n", optarg);
377 exit(2);
378 }
379 level = map_name(pers, optarg);
380 if (level == UnSet) {
381 fprintf(stderr, Name ": invalid raid level: %s\n",
382 optarg);
383 exit(2);
384 }
385 if (level != 0 && level != -1 && level != 1 && level != -4 && level != -5 && mode == BUILD) {
386 fprintf(stderr, Name ": Raid level %s not permitted with --build.\n",
387 optarg);
388 exit(2);
389 }
390 if (sparedisks > 0 && level < 1 && level >= -1) {
391 fprintf(stderr, Name ": raid level %s is incompatible with spare-devices setting.\n",
392 optarg);
393 exit(2);
394 }
395 ident.level = level;
396 continue;
397
398 case O(CREATE,'p'): /* raid5 layout */
399 case O(BUILD,'p'): /* faulty layout */
400 case O(GROW, 'p'): /* faulty reconfig */
401 if (layout != UnSet) {
402 fprintf(stderr,Name ": layout may only be sent once. "
403 "Second value was %s\n", optarg);
404 exit(2);
405 }
406 switch(level) {
407 default:
408 fprintf(stderr, Name ": layout not meaningful for %s arrays.\n",
409 map_num(pers, level));
410 exit(2);
411 case UnSet:
412 fprintf(stderr, Name ": raid level must be given before layout.\n");
413 exit(2);
414
415 case 5:
416 case 6:
417 layout = map_name(r5layout, optarg);
418 if (layout==UnSet) {
419 fprintf(stderr, Name ": layout %s not understood for raid5.\n",
420 optarg);
421 exit(2);
422 }
423 break;
424
425 case 10:
426 /* 'f', 'o' or 'n' followed by a number <= raid_disks */
427 if ((optarg[0] != 'n' && optarg[0] != 'f' && optarg[0] != 'o') ||
428 (copies = strtoul(optarg+1, &cp, 10)) < 1 ||
429 copies > 200 ||
430 *cp) {
431 fprintf(stderr, Name ": layout for raid10 must be 'nNN', 'oNN' or 'fNN' where NN is a number, not %s\n", optarg);
432 exit(2);
433 }
434 if (optarg[0] == 'n')
435 layout = 256 + copies;
436 else if (optarg[0] == 'o')
437 layout = 0x10000 + (copies<<8) + 1;
438 else
439 layout = 1 + (copies<<8);
440 break;
441 case -5: /* Faulty
442 * modeNNN
443 */
444
445 {
446 int ln = strcspn(optarg, "0123456789");
447 char *m = strdup(optarg);
448 int mode;
449 m[ln] = 0;
450 mode = map_name(faultylayout, m);
451 if (mode == UnSet) {
452 fprintf(stderr, Name ": layout %s not understood for faulty.\n",
453 optarg);
454 exit(2);
455 }
456 layout = mode | (atoi(optarg+ln)<< ModeShift);
457 }
458 }
459 continue;
460
461 case O(CREATE,AssumeClean):
462 case O(BUILD,AssumeClean): /* assume clean */
463 assume_clean = 1;
464 continue;
465
466 case O(GROW,'n'):
467 case O(CREATE,'n'):
468 case O(BUILD,'n'): /* number of raid disks */
469 if (raiddisks) {
470 fprintf(stderr, Name ": raid-devices set twice: %d and %s\n",
471 raiddisks, optarg);
472 exit(2);
473 }
474 raiddisks = strtol(optarg, &c, 10);
475 if (!optarg[0] || *c || raiddisks<=0) {
476 fprintf(stderr, Name ": invalid number of raid devices: %s\n",
477 optarg);
478 exit(2);
479 }
480 ident.raid_disks = raiddisks;
481 continue;
482
483 case O(CREATE,'x'): /* number of spare (eXtra) discs */
484 if (sparedisks) {
485 fprintf(stderr,Name ": spare-devices set twice: %d and %s\n",
486 sparedisks, optarg);
487 exit(2);
488 }
489 if (level != UnSet && level <= 0 && level >= -1) {
490 fprintf(stderr, Name ": spare-devices setting is incompatible with raid level %d\n",
491 level);
492 exit(2);
493 }
494 sparedisks = strtol(optarg, &c, 10);
495 if (!optarg[0] || *c || sparedisks < 0) {
496 fprintf(stderr, Name ": invalid number of spare-devices: %s\n",
497 optarg);
498 exit(2);
499 }
500 continue;
501
502 case O(CREATE,'a'):
503 case O(BUILD,'a'):
504 case O(ASSEMBLE,'a'): /* auto-creation of device node */
505 autof = parse_auto(optarg, "--auto flag", 0);
506 continue;
507
508 case O(CREATE,Symlinks):
509 case O(BUILD,Symlinks):
510 case O(ASSEMBLE,Symlinks): /* auto creation of symlinks in /dev to /dev/md */
511 symlinks = optarg;
512 continue;
513
514 case O(BUILD,'f'): /* force honouring '-n 1' */
515 case O(GROW,'f'): /* ditto */
516 case O(CREATE,'f'): /* force honouring of device list */
517 case O(ASSEMBLE,'f'): /* force assembly */
518 case O(MISC,'f'): /* force zero */
519 force=1;
520 continue;
521
522 /* now for the Assemble options */
523 case O(CREATE,'u'): /* uuid of array */
524 case O(ASSEMBLE,'u'): /* uuid of array */
525 if (ident.uuid_set) {
526 fprintf(stderr, Name ": uuid cannot be set twice. "
527 "Second value %s.\n", optarg);
528 exit(2);
529 }
530 if (parse_uuid(optarg, ident.uuid))
531 ident.uuid_set = 1;
532 else {
533 fprintf(stderr,Name ": Bad uuid: %s\n", optarg);
534 exit(2);
535 }
536 continue;
537
538 case O(CREATE,'N'):
539 case O(ASSEMBLE,'N'):
540 if (ident.name[0]) {
541 fprintf(stderr, Name ": name cannot be set twice. "
542 "Second value %s.\n", optarg);
543 exit(2);
544 }
545 if (strlen(optarg) > 32) {
546 fprintf(stderr, Name ": name '%s' is too long, 32 chars max.\n",
547 optarg);
548 exit(2);
549 }
550 strcpy(ident.name, optarg);
551 continue;
552
553 case O(ASSEMBLE,'m'): /* super-minor for array */
554 if (ident.super_minor != UnSet) {
555 fprintf(stderr, Name ": super-minor cannot be set twice. "
556 "Second value: %s.\n", optarg);
557 exit(2);
558 }
559 if (strcmp(optarg, "dev")==0)
560 ident.super_minor = -2;
561 else {
562 ident.super_minor = strtoul(optarg, &cp, 10);
563 if (!optarg[0] || *cp) {
564 fprintf(stderr, Name ": Bad super-minor number: %s.\n", optarg);
565 exit(2);
566 }
567 }
568 continue;
569
570 case O(ASSEMBLE,'U'): /* update the superblock */
571 if (update) {
572 fprintf(stderr, Name ": Can only update one aspect of superblock, both %s and %s given.\n",
573 update, optarg);
574 exit(2);
575 }
576 update = optarg;
577 if (strcmp(update, "sparc2.2")==0)
578 continue;
579 if (strcmp(update, "super-minor") == 0)
580 continue;
581 if (strcmp(update, "summaries")==0)
582 continue;
583 if (strcmp(update, "resync")==0)
584 continue;
585 if (strcmp(update, "uuid")==0)
586 continue;
587 if (strcmp(update, "name")==0)
588 continue;
589 if (strcmp(update, "homehost")==0)
590 continue;
591 if (strcmp(update, "devicesize")==0)
592 continue;
593 if (strcmp(update, "byteorder")==0) {
594 if (ss) {
595 fprintf(stderr, Name ": must not set metadata type with --update=byteorder.\n");
596 exit(2);
597 }
598 for(i=0; !ss && superlist[i]; i++)
599 ss = superlist[i]->match_metadata_desc("0.swap");
600 if (!ss) {
601 fprintf(stderr, Name ": INTERNAL ERROR cannot find 0.swap\n");
602 exit(2);
603 }
604
605 continue;
606 }
607 if (strcmp(update,"?") == 0 || strcmp(update, "help") == 0)
608 fprintf(stderr, Name ": ");
609 else
610 fprintf(stderr, Name ": '--update=%s' is invalid. ", update);
611 fprintf(stderr, "Valid --update options are:\n"
612 " 'sparc2.2', 'super-minor', 'uuid', 'name', 'resync',\n"
613 " 'summaries', 'homehost', 'byteorder', 'devicesize'.\n");
614 exit(2);
615
616 case O(ASSEMBLE,NoDegraded): /* --no-degraded */
617 runstop = -1; /* --stop isn't allowed for --assemble, so we overload slightly */
618 continue;
619
620 case O(ASSEMBLE,'c'): /* config file */
621 case O(MISC, 'c'):
622 case O(MONITOR,'c'):
623 if (configfile) {
624 fprintf(stderr, Name ": configfile cannot be set twice. "
625 "Second value is %s.\n", optarg);
626 exit(2);
627 }
628 configfile = optarg;
629 set_conffile(configfile);
630 /* FIXME possibly check that config file exists. Even parse it */
631 continue;
632 case O(ASSEMBLE,'s'): /* scan */
633 case O(MISC,'s'):
634 case O(MONITOR,'s'):
635 case O(INCREMENTAL,'s'):
636 scan = 1;
637 continue;
638
639 case O(MONITOR,'m'): /* mail address */
640 if (mailaddr)
641 fprintf(stderr, Name ": only specify one mailaddress. %s ignored.\n",
642 optarg);
643 else
644 mailaddr = optarg;
645 continue;
646
647 case O(MONITOR,'p'): /* alert program */
648 if (program)
649 fprintf(stderr, Name ": only specify one alter program. %s ignored.\n",
650 optarg);
651 else
652 program = optarg;
653 continue;
654
655 case O(MONITOR,'d'): /* delay in seconds */
656 case O(GROW, 'd'):
657 case O(BUILD,'d'): /* delay for bitmap updates */
658 case O(CREATE,'d'):
659 if (delay)
660 fprintf(stderr, Name ": only specify delay once. %s ignored.\n",
661 optarg);
662 else {
663 delay = strtol(optarg, &c, 10);
664 if (!optarg[0] || *c || delay<1) {
665 fprintf(stderr, Name ": invalid delay: %s\n",
666 optarg);
667 exit(2);
668 }
669 }
670 continue;
671 case O(MONITOR,'f'): /* daemonise */
672 daemonise = 1;
673 continue;
674 case O(MONITOR,'i'): /* pid */
675 if (pidfile)
676 fprintf(stderr, Name ": only specify one pid file. %s ignored.\n",
677 optarg);
678 else
679 pidfile = optarg;
680 continue;
681 case O(MONITOR,'1'): /* oneshot */
682 oneshot = 1;
683 continue;
684 case O(MONITOR,'t'): /* test */
685 test = 1;
686 continue;
687 case O(MONITOR,'y'): /* log messages to syslog */
688 openlog("mdadm", 0, SYSLOG_FACILITY);
689 dosyslog = 1;
690 continue;
691
692 /* now the general management options. Some are applicable
693 * to other modes. None have arguments.
694 */
695 case O(GROW,'a'):
696 case O(MANAGE,'a'): /* add a drive */
697 devmode = 'a';
698 re_add = 0;
699 continue;
700 case O(MANAGE,ReAdd):
701 devmode = 'a';
702 re_add = 1;
703 continue;
704 case O(MANAGE,'r'): /* remove a drive */
705 devmode = 'r';
706 continue;
707 case O(MANAGE,'f'): /* set faulty */
708 devmode = 'f';
709 continue;
710 case O(INCREMENTAL,'R'):
711 case O(MANAGE,'R'):
712 case O(ASSEMBLE,'R'):
713 case O(BUILD,'R'):
714 case O(CREATE,'R'): /* Run the array */
715 if (runstop < 0) {
716 fprintf(stderr, Name ": Cannot both Stop and Run an array\n");
717 exit(2);
718 }
719 runstop = 1;
720 continue;
721 case O(MANAGE,'S'):
722 if (runstop > 0) {
723 fprintf(stderr, Name ": Cannot both Run and Stop an array\n");
724 exit(2);
725 }
726 runstop = -1;
727 continue;
728
729 case O(MANAGE,'o'):
730 if (readonly < 0) {
731 fprintf(stderr, Name ": Cannot have both readonly and readwrite\n");
732 exit(2);
733 }
734 readonly = 1;
735 continue;
736 case O(MANAGE,'w'):
737 if (readonly > 0) {
738 fprintf(stderr, Name ": Cannot have both readwrite and readonly.\n");
739 exit(2);
740 }
741 readonly = -1;
742 continue;
743
744 case O(MISC,'Q'):
745 case O(MISC,'D'):
746 case O(MISC,'E'):
747 case O(MISC,'K'):
748 case O(MISC,'R'):
749 case O(MISC,'S'):
750 case O(MISC,'X'):
751 case O(MISC,'o'):
752 case O(MISC,'w'):
753 case O(MISC,'W'):
754 if (devmode && devmode != opt &&
755 (devmode == 'E' || (opt == 'E' && devmode != 'Q'))) {
756 fprintf(stderr, Name ": --examine/-E cannot be given with -%c\n",
757 devmode =='E'?opt:devmode);
758 exit(2);
759 }
760 devmode = opt;
761 continue;
762 case O(MISC,'t'):
763 test = 1;
764 continue;
765
766 case O(MISC, Sparc22):
767 if (devmode != 'E') {
768 fprintf(stderr, Name ": --sparc2.2 only allowed with --examine\n");
769 exit(2);
770 }
771 SparcAdjust = 1;
772 continue;
773
774 case O(ASSEMBLE,'b'): /* here we simply set the bitmap file */
775 if (!optarg) {
776 fprintf(stderr, Name ": bitmap file needed with -b in --assemble mode\n");
777 exit(2);
778 }
779 if (strcmp(optarg, "internal")==0) {
780 fprintf(stderr, Name ": there is no need to specify --bitmap when assembling arrays with internal bitmaps\n");
781 continue;
782 }
783 bitmap_fd = open(optarg, O_RDWR);
784 if (!*optarg || bitmap_fd < 0) {
785 fprintf(stderr, Name ": cannot open bitmap file %s: %s\n", optarg, strerror(errno));
786 exit(2);
787 }
788 ident.bitmap_fd = bitmap_fd; /* for Assemble */
789 continue;
790
791 case O(ASSEMBLE, BackupFile):
792 case O(GROW, BackupFile):
793 /* Specify a file into which grow might place a backup,
794 * or from which assemble might recover a backup
795 */
796 if (backup_file) {
797 fprintf(stderr, Name ": backup file already specified, rejecting %s\n", optarg);
798 exit(2);
799 }
800 backup_file = optarg;
801 continue;
802
803 case O(GROW,'b'):
804 case O(BUILD,'b'):
805 case O(CREATE,'b'): /* here we create the bitmap */
806 if (strcmp(optarg, "internal")== 0 ||
807 strcmp(optarg, "none")== 0 ||
808 strchr(optarg, '/') != NULL) {
809 bitmap_file = optarg;
810 continue;
811 }
812 /* probable typo */
813 fprintf(stderr, Name ": bitmap file must contain a '/', or be 'internal', or 'none'\n");
814 exit(2);
815
816 case O(GROW,BitmapChunk):
817 case O(BUILD,BitmapChunk):
818 case O(CREATE,BitmapChunk): /* bitmap chunksize */
819 bitmap_chunk = strtol(optarg, &c, 10);
820 if (!optarg[0] || *c || bitmap_chunk < 0 ||
821 bitmap_chunk & (bitmap_chunk - 1)) {
822 fprintf(stderr, Name ": invalid bitmap chunksize: %s\n",
823 optarg);
824 exit(2);
825 }
826 /* convert K to B, chunk of 0K means 512B */
827 bitmap_chunk = bitmap_chunk ? bitmap_chunk * 1024 : 512;
828 continue;
829
830 case O(BUILD, WriteBehind):
831 case O(CREATE, WriteBehind): /* write-behind mode */
832 write_behind = DEFAULT_MAX_WRITE_BEHIND;
833 if (optarg) {
834 write_behind = strtol(optarg, &c, 10);
835 if (write_behind < 0 || *c ||
836 write_behind > 16383) {
837 fprintf(stderr, Name ": Invalid value for maximum outstanding write-behind writes: %s.\n\tMust be between 0 and 16383.\n", optarg);
838 exit(2);
839 }
840 }
841 continue;
842
843 case O(INCREMENTAL, 'r'):
844 rebuild_map = 1;
845 continue;
846 }
847 /* We have now processed all the valid options. Anything else is
848 * an error
849 */
850 if (option_index > 0)
851 fprintf(stderr, Name ":option --%s not valid in %s mode\n",
852 long_options[option_index].name,
853 map_num(modes, mode));
854 else
855 fprintf(stderr, Name ": option -%c not valid in %s mode\n",
856 opt, map_num(modes, mode));
857 exit(2);
858
859 }
860
861 if (print_help) {
862 char *help_text = Help;
863 if (print_help == 2)
864 help_text = OptionHelp;
865 else
866 switch (mode) {
867 case ASSEMBLE : help_text = Help_assemble; break;
868 case BUILD : help_text = Help_build; break;
869 case CREATE : help_text = Help_create; break;
870 case MANAGE : help_text = Help_manage; break;
871 case MISC : help_text = Help_misc; break;
872 case MONITOR : help_text = Help_monitor; break;
873 case GROW : help_text = Help_grow; break;
874 case INCREMENTAL:help_text= Help_incr; break;
875 }
876 fputs(help_text,stderr);
877 exit(0);
878 }
879
880 if (!mode && devs_found) {
881 mode = MISC;
882 devmode = 'Q';
883 if (devlist->disposition == 0)
884 devlist->disposition = devmode;
885 }
886 if (!mode) {
887 fputs(Usage, stderr);
888 exit(2);
889 }
890
891 if (symlinks) {
892 struct createinfo *ci = conf_get_create_info();
893
894 if (strcasecmp(symlinks, "yes") == 0)
895 ci->symlinks = 1;
896 else if (strcasecmp(symlinks, "no") == 0)
897 ci->symlinks = 0;
898 else {
899 fprintf(stderr, Name ": option --symlinks must be 'no' or 'yes'\n");
900 exit(2);
901 }
902 }
903 /* Ok, got the option parsing out of the way
904 * hopefully it's mostly right but there might be some stuff
905 * missing
906 *
907 * That is mosty checked in the per-mode stuff but...
908 *
909 * For @,B,C and A without -s, the first device listed must be an md device
910 * we check that here and open it.
911 */
912
913 if (mode==MANAGE || mode == BUILD || mode == CREATE || mode == GROW ||
914 (mode == ASSEMBLE && ! scan)) {
915 if (devs_found < 1) {
916 fprintf(stderr, Name ": an md device must be given in this mode\n");
917 exit(2);
918 }
919 if ((int)ident.super_minor == -2 && autof) {
920 fprintf(stderr, Name ": --super-minor=dev is incompatible with --auto\n");
921 exit(2);
922 }
923 if (mode == MANAGE || mode == GROW)
924 autof=1; /* Don't create */
925 mdfd = open_mddev(devlist->devname, autof);
926 if (mdfd < 0)
927 exit(1);
928 if ((int)ident.super_minor == -2) {
929 struct stat stb;
930 fstat(mdfd, &stb);
931 ident.super_minor = minor(stb.st_rdev);
932 }
933 }
934
935 if (raiddisks) {
936 if (raiddisks > max_disks) {
937 fprintf(stderr, Name ": invalid number of raid devices: %d\n",
938 raiddisks);
939 exit(2);
940 }
941 if (raiddisks == 1 && !force && level != -5) {
942 fprintf(stderr, Name ": '1' is an unusual number of drives for an array, so it is probably\n"
943 " a mistake. If you really mean it you will need to specify --force before\n"
944 " setting the number of drives.\n");
945 exit(2);
946 }
947 }
948 if (sparedisks) {
949 if ( sparedisks > max_disks - raiddisks) {
950 fprintf(stderr, Name ": invalid number of spare-devices: %d\n",
951 sparedisks);
952 exit(2);
953 }
954 }
955
956 if (homehost == NULL)
957 homehost = conf_get_homehost();
958 if (homehost && strcmp(homehost, "<system>")==0) {
959 if (gethostname(sys_hostname, sizeof(sys_hostname)) == 0) {
960 sys_hostname[sizeof(sys_hostname)-1] = 0;
961 homehost = sys_hostname;
962 }
963 }
964
965 rv = 0;
966 switch(mode) {
967 case MANAGE:
968 /* readonly, add/remove, readwrite, runstop */
969 if (readonly>0)
970 rv = Manage_ro(devlist->devname, mdfd, readonly);
971 if (!rv && devs_found>1)
972 rv = Manage_subdevs(devlist->devname, mdfd,
973 devlist->next, verbose-quiet);
974 if (!rv && readonly < 0)
975 rv = Manage_ro(devlist->devname, mdfd, readonly);
976 if (!rv && runstop)
977 rv = Manage_runstop(devlist->devname, mdfd, runstop, quiet);
978 break;
979 case ASSEMBLE:
980 if (devs_found == 1 && ident.uuid_set == 0 &&
981 ident.super_minor == UnSet && ident.name[0] == 0 && !scan ) {
982 /* Only a device has been given, so get details from config file */
983 mddev_ident_t array_ident = conf_get_ident(devlist->devname);
984 if (array_ident == NULL) {
985 fprintf(stderr, Name ": %s not identified in config file.\n",
986 devlist->devname);
987 rv |= 1;
988 } else {
989 mdfd = open_mddev(devlist->devname,
990 array_ident->autof ? array_ident->autof : autof);
991 if (mdfd < 0)
992 rv |= 1;
993 else {
994 rv |= Assemble(ss, devlist->devname, mdfd, array_ident,
995 NULL, backup_file,
996 readonly, runstop, update, homehost, verbose-quiet, force);
997 close(mdfd);
998 }
999 }
1000 } else if (!scan)
1001 rv = Assemble(ss, devlist->devname, mdfd, &ident,
1002 devlist->next, backup_file,
1003 readonly, runstop, update, homehost, verbose-quiet, force);
1004 else if (devs_found>0) {
1005 if (update && devs_found > 1) {
1006 fprintf(stderr, Name ": can only update a single array at a time\n");
1007 exit(1);
1008 }
1009 if (backup_file && devs_found > 1) {
1010 fprintf(stderr, Name ": can only assemble a single array when providing a backup file.\n");
1011 exit(1);
1012 }
1013 for (dv = devlist ; dv ; dv=dv->next) {
1014 mddev_ident_t array_ident = conf_get_ident(dv->devname);
1015 if (array_ident == NULL) {
1016 fprintf(stderr, Name ": %s not identified in config file.\n",
1017 dv->devname);
1018 rv |= 1;
1019 continue;
1020 }
1021 mdfd = open_mddev(dv->devname,
1022 array_ident->autof ?array_ident->autof : autof);
1023 if (mdfd < 0) {
1024 rv |= 1;
1025 continue;
1026 }
1027 rv |= Assemble(ss, dv->devname, mdfd, array_ident,
1028 NULL, backup_file,
1029 readonly, runstop, update, homehost, verbose-quiet, force);
1030 close(mdfd);
1031 }
1032 } else {
1033 mddev_ident_t array_list = conf_get_ident(NULL);
1034 mddev_dev_t devlist = conf_get_devs();
1035 int cnt = 0;
1036 if (devlist == NULL) {
1037 fprintf(stderr, Name ": No devices listed in conf file were found.\n");
1038 exit(1);
1039 }
1040 if (update) {
1041 fprintf(stderr, Name ": --update not meaningful with a --scan assembly.\n");
1042 exit(1);
1043 }
1044 if (backup_file) {
1045 fprintf(stderr, Name ": --backup_file not meaningful with a --scan assembly.\n");
1046 exit(1);
1047 }
1048 for (; array_list; array_list = array_list->next) {
1049 mdu_array_info_t array;
1050 mdfd = open_mddev(array_list->devname,
1051 array_list->autof ? array_list->autof : autof);
1052 if (mdfd < 0) {
1053 rv |= 1;
1054 continue;
1055 }
1056 if (ioctl(mdfd, GET_ARRAY_INFO, &array)>=0)
1057 /* already assembled, skip */
1058 cnt++;
1059 else {
1060 rv |= Assemble(ss, array_list->devname, mdfd,
1061 array_list,
1062 NULL, NULL,
1063 readonly, runstop, NULL, homehost, verbose-quiet, force);
1064 if (rv == 0) cnt++;
1065 }
1066 close(mdfd);
1067 }
1068 if (homehost) {
1069 /* Maybe we can auto-assemble something.
1070 * Repeatedly call Assemble in auto-assmble mode
1071 * until it fails
1072 */
1073 int rv2;
1074 int acnt;
1075 ident.autof = autof;
1076 do {
1077 acnt = 0;
1078 do {
1079 rv2 = Assemble(ss, NULL, -1,
1080 &ident,
1081 NULL, NULL,
1082 readonly, runstop, NULL, homehost, verbose-quiet, force);
1083 if (rv2==0) {
1084 cnt++;
1085 acnt++;
1086 }
1087 if (rv2 == 1)
1088 /* found something so even though assembly failed we
1089 * want to avoid auto-updates
1090 */
1091 auto_update_home = 0;
1092 } while (rv2!=2);
1093 /* Incase there are stacked devices, we need to go around again */
1094 } while (acnt);
1095 if (cnt == 0 && auto_update_home && homehost) {
1096 /* Nothing found, maybe we need to bootstrap homehost info */
1097 do {
1098 acnt = 0;
1099 do {
1100 rv2 = Assemble(ss, NULL, -1,
1101 &ident,
1102 NULL, NULL,
1103 readonly, runstop, "homehost", homehost, verbose-quiet, force);
1104 if (rv2==0) {
1105 cnt++;
1106 acnt++;
1107 }
1108 } while (rv2!=2);
1109 /* Incase there are stacked devices, we need to go around again */
1110 } while (acnt);
1111 }
1112 if (cnt == 0 && rv == 0) {
1113 fprintf(stderr, Name ": No arrays found in config file or automatically\n");
1114 rv = 1;
1115 }
1116 } else if (cnt == 0 && rv == 0) {
1117 fprintf(stderr, Name ": No arrays found in config file\n");
1118 rv = 1;
1119 }
1120 }
1121 break;
1122 case BUILD:
1123 if (delay == 0) delay = DEFAULT_BITMAP_DELAY;
1124 if (write_behind && !bitmap_file) {
1125 fprintf(stderr, Name ": write-behind mode requires a bitmap.\n");
1126 rv = 1;
1127 break;
1128 }
1129
1130 if (bitmap_file) {
1131 if (strcmp(bitmap_file, "internal")==0) {
1132 fprintf(stderr, Name ": 'internal' bitmaps not supported with --build\n");
1133 rv |= 1;
1134 break;
1135 }
1136 }
1137 rv = Build(devlist->devname, mdfd, chunk, level, layout,
1138 raiddisks, devlist->next, assume_clean,
1139 bitmap_file, bitmap_chunk, write_behind, delay, verbose-quiet);
1140 break;
1141 case CREATE:
1142 if (delay == 0) delay = DEFAULT_BITMAP_DELAY;
1143 if (write_behind && !bitmap_file) {
1144 fprintf(stderr, Name ": write-behind mode requires a bitmap.\n");
1145 rv = 1;
1146 break;
1147 }
1148
1149 rv = Create(ss, devlist->devname, mdfd, chunk, level, layout, size<0 ? 0 : size,
1150 raiddisks, sparedisks, ident.name, homehost,
1151 ident.uuid_set ? ident.uuid : NULL,
1152 devs_found-1, devlist->next, runstop, verbose-quiet, force, assume_clean,
1153 bitmap_file, bitmap_chunk, write_behind, delay);
1154 break;
1155 case MISC:
1156 if (devmode == 'E') {
1157 if (devlist == NULL && !scan) {
1158 fprintf(stderr, Name ": No devices to examine\n");
1159 exit(2);
1160 }
1161 if (devlist == NULL)
1162 devlist = conf_get_devs();
1163 if (devlist == NULL) {
1164 fprintf(stderr, Name ": No devices listed in %s\n", configfile?configfile:DefaultConfFile);
1165 exit(1);
1166 }
1167 if (brief && verbose)
1168 brief = 2;
1169 rv = Examine(devlist, scan?(verbose>1?0:verbose+1):brief, scan, SparcAdjust, ss, homehost);
1170 } else {
1171 if (devlist == NULL) {
1172 if (devmode=='D' && scan) {
1173 /* apply --detail to all devices in /proc/mdstat */
1174 struct mdstat_ent *ms = mdstat_read(0, 1);
1175 struct mdstat_ent *e;
1176 for (e=ms ; e ; e=e->next) {
1177 char *name = get_md_name(e->devnum);
1178
1179 if (!name) {
1180 fprintf(stderr, Name ": cannot find device file for %s\n",
1181 e->dev);
1182 continue;
1183 }
1184 rv |= Detail(name, verbose>1?0:verbose+1, test, homehost);
1185 put_md_name(name);
1186 }
1187 } else if (devmode == 'S' && scan) {
1188 /* apply --stop to all devices in /proc/mdstat */
1189 /* Due to possible stacking of devices, repeat until
1190 * nothing more can be stopped
1191 */
1192 int progress=1, err;
1193 int last = 0;
1194 do {
1195 struct mdstat_ent *ms = mdstat_read(0, 0);
1196 struct mdstat_ent *e;
1197
1198 if (!progress) last = 1;
1199 progress = 0; err = 0;
1200 for (e=ms ; e ; e=e->next) {
1201 char *name = get_md_name(e->devnum);
1202
1203 if (!name) {
1204 fprintf(stderr, Name ": cannot find device file for %s\n",
1205 e->dev);
1206 continue;
1207 }
1208 mdfd = open_mddev(name, 1);
1209 if (mdfd >= 0) {
1210 if (Manage_runstop(name, mdfd, -1, quiet?1:last?0:-1))
1211 err = 1;
1212 else
1213 progress = 1;
1214 close(mdfd);
1215 }
1216
1217 put_md_name(name);
1218 }
1219 } while (!last && err);
1220 if (err) rv |= 1;
1221 } else {
1222 fprintf(stderr, Name ": No devices given.\n");
1223 exit(2);
1224 }
1225 }
1226 for (dv=devlist ; dv; dv=dv->next) {
1227 switch(dv->disposition) {
1228 case 'D':
1229 rv |= Detail(dv->devname, brief?1+verbose:0, test, homehost); continue;
1230 case 'K': /* Zero superblock */
1231 rv |= Kill(dv->devname, force, quiet); continue;
1232 case 'Q':
1233 rv |= Query(dv->devname); continue;
1234 case 'X':
1235 rv |= ExamineBitmap(dv->devname, brief, ss); continue;
1236 case 'W':
1237 rv |= Wait(dv->devname); continue;
1238 }
1239 mdfd = open_mddev(dv->devname, 1);
1240 if (mdfd>=0) {
1241 switch(dv->disposition) {
1242 case 'R':
1243 rv |= Manage_runstop(dv->devname, mdfd, 1, quiet); break;
1244 case 'S':
1245 rv |= Manage_runstop(dv->devname, mdfd, -1, quiet); break;
1246 case 'o':
1247 rv |= Manage_ro(dv->devname, mdfd, 1); break;
1248 case 'w':
1249 rv |= Manage_ro(dv->devname, mdfd, -1); break;
1250 }
1251 close(mdfd);
1252 } else
1253 rv |= 1;
1254 }
1255 }
1256 break;
1257 case MONITOR:
1258 if (!devlist && !scan) {
1259 fprintf(stderr, Name ": Cannot monitor: need --scan or at least one device\n");
1260 rv = 1;
1261 break;
1262 }
1263 if (pidfile && !daemonise) {
1264 fprintf(stderr, Name ": Cannot write a pid file when not in daemon mode\n");
1265 rv = 1;
1266 break;
1267 }
1268 rv= Monitor(devlist, mailaddr, program,
1269 delay?delay:60, daemonise, scan, oneshot,
1270 dosyslog, test, pidfile);
1271 break;
1272
1273 case GROW:
1274 if (devs_found > 1) {
1275
1276 /* must be '-a'. */
1277 if (size >= 0 || raiddisks) {
1278 fprintf(stderr, Name ": --size, --raiddisks, and --add are exclusing in --grow mode\n");
1279 rv = 1;
1280 break;
1281 }
1282 for (dv=devlist->next; dv ; dv=dv->next) {
1283 rv = Grow_Add_device(devlist->devname, mdfd, dv->devname);
1284 if (rv)
1285 break;
1286 }
1287 } else if ((size >= 0) + (raiddisks != 0) + (layout != UnSet) + (bitmap_file != NULL)> 1) {
1288 fprintf(stderr, Name ": can change at most one of size, raiddisks, bitmap, and layout\n");
1289 rv = 1;
1290 break;
1291 } else if (layout != UnSet)
1292 rv = Manage_reconfig(devlist->devname, mdfd, layout);
1293 else if (size >= 0 || raiddisks)
1294 rv = Grow_reshape(devlist->devname, mdfd, quiet, backup_file,
1295 size, level, layout, chunk, raiddisks);
1296 else if (bitmap_file) {
1297 if (delay == 0) delay = DEFAULT_BITMAP_DELAY;
1298 rv = Grow_addbitmap(devlist->devname, mdfd, bitmap_file,
1299 bitmap_chunk, delay, write_behind, force);
1300 } else
1301 fprintf(stderr, Name ": no changes to --grow\n");
1302 break;
1303 case INCREMENTAL:
1304 if (rebuild_map) {
1305 RebuildMap();
1306 }
1307 if (scan) {
1308 if (runstop <= 0) {
1309 fprintf(stderr, Name
1310 ": --incremental --scan meaningless without --run.\n");
1311 break;
1312 }
1313 rv = IncrementalScan(verbose);
1314 }
1315 if (!devlist) {
1316 if (!rebuild_map && !scan) {
1317 fprintf(stderr, Name
1318 ": --incremental requires a device.\n");
1319 rv = 1;
1320 }
1321 break;
1322 }
1323 if (devlist->next) {
1324 fprintf(stderr, Name
1325 ": --incremental can only handle one device.\n");
1326 rv = 1;
1327 break;
1328 }
1329 rv = Incremental(devlist->devname, verbose-quiet, runstop,
1330 ss, homehost, autof);
1331 }
1332 exit(rv);
1333 }