]> git.ipfire.org Git - thirdparty/mdadm.git/blame - mdadm.c
Add zlib license to crc32.c
[thirdparty/mdadm.git] / mdadm.c
CommitLineData
64c4757e 1/*
9a9dab36 2 * mdadm - manage Linux "md" devices aka RAID arrays.
64c4757e 3 *
18361a1a 4 * Copyright (C) 2001-2012 Neil Brown <neilb@suse.de>
64c4757e
NB
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
e736b623 22 * Email: <neilb@suse.de>
c82f047c 23 *
aba69144 24 * Additions for bitmap and write-behind RAID options, Copyright (C) 2003-2004,
c82f047c 25 * Paul Clements, SteelEye Technology, Inc.
64c4757e
NB
26 */
27
9a9dab36 28#include "mdadm.h"
64c4757e 29#include "md_p.h"
dd0781e5 30#include <ctype.h>
64c4757e 31
3cbc4d12 32
4977146a
N
33static int scan_assemble(struct supertype *ss,
34 struct context *c,
35 struct mddev_ident *ident);
ef898ce6 36static int misc_scan(char devmode, struct context *c);
ba728be7 37static int stop_scan(int verbose);
7d27d1c0 38static int misc_list(struct mddev_dev *devlist,
86da243f
N
39 struct mddev_ident *ident,
40 struct supertype *ss, struct context *c);
7d27d1c0 41
3cbc4d12 42
52826846
NB
43int main(int argc, char *argv[])
44{
e0d19036 45 int mode = 0;
52826846 46 int opt;
e0d19036 47 int option_index;
52826846 48 int rv;
f9ce90ba 49 int i;
52826846 50
a93f8c65 51 unsigned long long array_size = 0;
fa56eddb 52 struct mddev_ident ident;
52826846 53 char *configfile = NULL;
1c7a808c 54 int devmode = 0;
c82f047c 55 int bitmap_fd = -1;
a655e550
N
56 struct mddev_dev *devlist = NULL;
57 struct mddev_dev **devlistend = & devlist;
58 struct mddev_dev *dv;
52826846 59 int devs_found = 0;
38098016 60 char *symlinks = NULL;
2dddadb0 61 int grow_continue = 0;
f1ae21c4
NB
62 /* autof indicates whether and how to create device node.
63 * bottom 3 bits are style. Rest (when shifted) are number of parts
64 * 0 - unset
65 * 1 - don't create (no)
66 * 2 - if is_standard, then create (yes)
67 * 3 - create as 'md' - reject is_standard mdp (md)
68 * 4 - create as 'mdp' - reject is_standard md (mdp)
69 * 5 - default to md if not is_standard (md in config file)
70 * 6 - default to mdp if not is_standard (part, or mdp in config file)
71 */
9e33d556
N
72 struct context c = {
73 .require_homehost = 1,
74 };
e705e81b
N
75 struct shape s = {
76 .level = UnSet,
77 .layout = UnSet,
78 .bitmap_chunk = UnSet,
79 };
52826846 80
05697ec1 81 char sys_hostname[256];
52826846
NB
82 char *mailaddr = NULL;
83 char *program = NULL;
9a36a9b7 84 int increments = 20;
d013a55e 85 int daemonise = 0;
b5e64645 86 char *pidfile = NULL;
aa88f531 87 int oneshot = 0;
edde9560 88 int spare_sharing = 1;
82d9eba6 89 struct supertype *ss = NULL;
dfd4d8ee 90 int writemostly = 0;
c06487ce 91 char *shortopt = short_options;
773135f5 92 int dosyslog = 0;
8382f19b 93 int rebuild_map = 0;
950bc344 94 char *remove_path = NULL;
20b60dcd 95 char *udev_filename = NULL;
52826846 96
3d4064cc 97 int print_help = 0;
0047d254 98 FILE *outf;
e5329c37 99
52826846
NB
100 int mdfd = -1;
101
dfe47e00
NB
102 srandom(time(0) ^ getpid());
103
52826846 104 ident.uuid_set=0;
98c6faba
NB
105 ident.level = UnSet;
106 ident.raid_disks = UnSet;
107 ident.super_minor= UnSet;
52826846 108 ident.devices=0;
a75f2fbc
NB
109 ident.spare_group = NULL;
110 ident.autof = 0;
a825febc 111 ident.st = NULL;
c82f047c 112 ident.bitmap_fd = -1;
7ef02d01 113 ident.bitmap_file = NULL;
947fd4dd 114 ident.name[0] = 0;
aef35714
N
115 ident.container = NULL;
116 ident.member = NULL;
52826846 117
e0d19036
NB
118 while ((option_index = -1) ,
119 (opt=getopt_long(argc, argv,
c06487ce 120 shortopt, long_options,
e0d19036
NB
121 &option_index)) != -1) {
122 int newmode = mode;
35904960 123 /* firstly, some mode-independent options */
52826846 124 switch(opt) {
1c7a808c
N
125 case HelpOptions:
126 print_help = 2;
127 continue;
52826846 128 case 'h':
1c7a808c 129 print_help = 1;
3d4064cc 130 continue;
52826846
NB
131
132 case 'V':
133 fputs(Version, stderr);
134 exit(0);
135
9e33d556 136 case 'v': c.verbose++;
52826846
NB
137 continue;
138
0937132d 139 case 'q': c.verbose--;
dab6685f
NB
140 continue;
141
c82f047c 142 case 'b':
1c7a808c
N
143 if (mode == ASSEMBLE || mode == BUILD || mode == CREATE
144 || mode == GROW || mode == INCREMENTAL
145 || mode == MANAGE)
c82f047c 146 break; /* b means bitmap */
1c7a808c 147 case Brief:
9e33d556 148 c.brief = 1;
cd29a5c8
NB
149 continue;
150
9e33d556 151 case 'Y': c.export++;
54bad364
KS
152 continue;
153
997aed5d 154 case HomeHost:
0ac91628 155 if (strcasecmp(optarg, "<ignore>") == 0)
9e33d556 156 c.require_homehost = 0;
0ac91628 157 else
9e33d556 158 c.homehost = optarg;
997aed5d
NB
159 continue;
160
08ca2adf
JS
161 /*
162 * --offroot sets first char of argv[0] to @. This is used
18361a1a 163 * by systemd to signal that the task was launched from
08ca2adf
JS
164 * initrd/initramfs and should be preserved during shutdown
165 */
166 case OffRootOpt:
167 argv[0][0] = '@';
a0963a86 168 __offroot = 1;
08ca2adf
JS
169 continue;
170
c2ecf5f6 171 case Prefer:
9e33d556
N
172 if (c.prefer)
173 free(c.prefer);
174 if (asprintf(&c.prefer, "/%s/", optarg) <= 0)
175 c.prefer = NULL;
c2ecf5f6
N
176 continue;
177
e0d19036
NB
178 case ':':
179 case '?':
180 fputs(Usage, stderr);
181 exit(2);
182 }
183 /* second, figure out the mode.
184 * Some options force the mode. Others
aba69144 185 * set the mode if it isn't already
e0d19036
NB
186 */
187
188 switch(opt) {
1c7a808c 189 case ManageOpt:
c06487ce 190 newmode = MANAGE;
024768c4 191 shortopt = short_bitmap_options;
c06487ce 192 break;
e0d19036 193 case 'a':
1c7a808c 194 case Add:
e0d19036 195 case 'r':
1c7a808c 196 case Remove:
e0d19036 197 case 'f':
1c7a808c 198 case Fail:
41a3b72a 199 case ReAdd: /* re-add */
c06487ce
NB
200 if (!mode) {
201 newmode = MANAGE;
024768c4 202 shortopt = short_bitmap_options;
c06487ce 203 }
0320ea45 204 break;
e0d19036 205
18361a1a
N
206 case 'A': newmode = ASSEMBLE;
207 shortopt = short_bitmap_auto_options;
208 break;
209 case 'B': newmode = BUILD;
210 shortopt = short_bitmap_auto_options;
211 break;
212 case 'C': newmode = CREATE;
213 shortopt = short_bitmap_auto_options;
214 break;
215 case 'F': newmode = MONITOR;
216 break;
024768c4
DL
217 case 'G': newmode = GROW;
218 shortopt = short_bitmap_options;
219 break;
95b79df0 220 case 'I': newmode = INCREMENTAL;
18361a1a
N
221 shortopt = short_bitmap_auto_options;
222 break;
1f48664b 223 case AutoDetect:
5a53aeec
JS
224 newmode = AUTODETECT;
225 break;
e0d19036 226
1c7a808c 227 case MiscOpt:
e0d19036
NB
228 case 'D':
229 case 'E':
c82f047c 230 case 'X':
5a53aeec
JS
231 case 'Q':
232 newmode = MISC;
233 break;
234
e0d19036
NB
235 case 'R':
236 case 'S':
237 case 'o':
238 case 'w':
b90c0e9a 239 case 'W':
1c7a808c 240 case WaitOpt:
1770662b 241 case Waitclean:
4cce4069 242 case DetailPlatform:
33414a01 243 case KillSubarray:
aa534678 244 case UpdateSubarray:
20b60dcd 245 case UdevRules:
f7d3febc 246 case KillOpt:
5a53aeec
JS
247 if (!mode)
248 newmode = MISC;
249 break;
250
251 case NoSharing:
252 newmode = MONITOR;
253 break;
e0d19036
NB
254 }
255 if (mode && newmode == mode) {
256 /* everybody happy ! */
257 } else if (mode && newmode != mode) {
258 /* not allowed.. */
e7b84f9d 259 pr_err("");
e0d19036
NB
260 if (option_index >= 0)
261 fprintf(stderr, "--%s", long_options[option_index].name);
262 else
263 fprintf(stderr, "-%c", opt);
e6b64cd0 264 fprintf(stderr, " would set mdadm mode to \"%s\", but it is already set to \"%s\".\n",
e0d19036
NB
265 map_num(modes, newmode),
266 map_num(modes, mode));
267 exit(2);
268 } else if (!mode && newmode) {
269 mode = newmode;
dec18cae 270 if (mode == MISC && devs_found) {
e7b84f9d 271 pr_err("No action given for %s in --misc mode\n",
dec18cae
N
272 devlist->devname);
273 fprintf(stderr," Action options must come before device names\n");
274 exit(2);
275 }
e0d19036
NB
276 } else {
277 /* special case of -c --help */
1c7a808c 278 if ((opt == 'c' || opt == ConfigFile) &&
e0d19036
NB
279 ( strncmp(optarg, "--h", 3)==0 ||
280 strncmp(optarg, "-h", 2)==0)) {
0047d254 281 fputs(Help_config, stdout);
e0d19036 282 exit(0);
cd29a5c8 283 }
0320ea45
NB
284
285 /* If first option is a device, don't force the mode yet */
286 if (opt == 1) {
287 if (devs_found == 0) {
503975b9 288 dv = xmalloc(sizeof(*dv));
0320ea45
NB
289 dv->devname = optarg;
290 dv->disposition = devmode;
dfd4d8ee 291 dv->writemostly = writemostly;
da6b5ca9 292 dv->used = 0;
0320ea45
NB
293 dv->next = NULL;
294 *devlistend = dv;
295 devlistend = &dv->next;
aba69144 296
0320ea45
NB
297 devs_found++;
298 continue;
299 }
300 /* No mode yet, and this is the second device ... */
e7b84f9d 301 pr_err("An option must be given to set the mode before a second device\n"
a1331cc4 302 " (%s) is listed\n", optarg);
0320ea45
NB
303 exit(2);
304 }
e0d19036 305 if (option_index >= 0)
e7b84f9d 306 pr_err("--%s", long_options[option_index].name);
e0d19036 307 else
e7b84f9d 308 pr_err("-%c", opt);
0320ea45 309 fprintf(stderr, " does not set the mode, and so cannot be the first option.\n");
e0d19036
NB
310 exit(2);
311 }
312
313 /* if we just set the mode, then done */
314 switch(opt) {
1c7a808c
N
315 case ManageOpt:
316 case MiscOpt:
e0d19036
NB
317 case 'A':
318 case 'B':
319 case 'C':
320 case 'F':
dd0781e5 321 case 'G':
8382f19b 322 case 'I':
1f48664b 323 case AutoDetect:
e0d19036
NB
324 continue;
325 }
326 if (opt == 1) {
327 /* an undecorated option - must be a device name.
328 */
1c7a808c 329 if (devs_found > 0 && mode == MANAGE && !devmode) {
e7b84f9d 330 pr_err("Must give one of -a/-r/-f"
1c7a808c 331 " for subsequent devices at %s\n", optarg);
52826846
NB
332 exit(2);
333 }
1c7a808c 334 if (devs_found > 0 && mode == GROW && !devmode) {
e7b84f9d
N
335 pr_err("Must give -a/--add for"
336 " devices to add: %s\n", optarg);
e5329c37
NB
337 exit(2);
338 }
503975b9 339 dv = xmalloc(sizeof(*dv));
cd29a5c8
NB
340 dv->devname = optarg;
341 dv->disposition = devmode;
dfd4d8ee 342 dv->writemostly = writemostly;
9008ed1c 343 dv->used = 0;
cd29a5c8
NB
344 dv->next = NULL;
345 *devlistend = dv;
346 devlistend = &dv->next;
aba69144 347
52826846
NB
348 devs_found++;
349 continue;
682c7051 350 }
682c7051 351
52826846
NB
352 /* We've got a mode, and opt is now something else which
353 * could depend on the mode */
1c7a808c 354#define O(a,b) ((a<<16)|b)
52826846 355 switch (O(mode,opt)) {
7236ee7a 356 case O(GROW,'c'):
1c7a808c 357 case O(GROW,ChunkSize):
e0d19036 358 case O(CREATE,'c'):
1c7a808c 359 case O(CREATE,ChunkSize):
e0d19036 360 case O(BUILD,'c'): /* chunk or rounding */
1c7a808c 361 case O(BUILD,ChunkSize): /* chunk or rounding */
e705e81b 362 if (s.chunk) {
e7b84f9d 363 pr_err("chunk/rounding may only be specified once. "
52826846
NB
364 "Second value is %s.\n", optarg);
365 exit(2);
366 }
e705e81b
N
367 s.chunk = parse_size(optarg);
368 if (s.chunk < 8 || (s.chunk&1)) {
e7b84f9d 369 pr_err("invalid chunk/rounding value: %s\n",
52826846
NB
370 optarg);
371 exit(2);
372 }
a252c078 373 /* Convert sectors to K */
e705e81b 374 s.chunk /= 2;
52826846 375 continue;
64c4757e 376
8382f19b 377 case O(INCREMENTAL, 'e'):
f9ce90ba
NB
378 case O(CREATE,'e'):
379 case O(ASSEMBLE,'e'):
380 case O(MISC,'e'): /* set metadata (superblock) information */
381 if (ss) {
e7b84f9d 382 pr_err("metadata information already given\n");
f9ce90ba
NB
383 exit(2);
384 }
aba69144 385 for(i=0; !ss && superlist[i]; i++)
82d9eba6
NB
386 ss = superlist[i]->match_metadata_desc(optarg);
387
f9ce90ba 388 if (!ss) {
e7b84f9d 389 pr_err("unrecognised metadata identifier: %s\n", optarg);
f9ce90ba
NB
390 exit(2);
391 }
392 continue;
393
dfd4d8ee 394 case O(MANAGE,'W'):
1c7a808c 395 case O(MANAGE,WriteMostly):
dfd4d8ee 396 case O(BUILD,'W'):
1c7a808c 397 case O(BUILD,WriteMostly):
dfd4d8ee 398 case O(CREATE,'W'):
1c7a808c 399 case O(CREATE,WriteMostly):
dfd4d8ee
NB
400 /* set write-mostly for following devices */
401 writemostly = 1;
402 continue;
403
b3d31955
N
404 case O(MANAGE,'w'):
405 /* clear write-mostly for following devices */
406 writemostly = 2;
407 continue;
408
409
dd0781e5 410 case O(GROW,'z'):
25affb56
PC
411 case O(CREATE,'z'):
412 case O(BUILD,'z'): /* size */
e705e81b 413 if (s.size > 0) {
e7b84f9d 414 pr_err("size may only be specified once. "
52826846
NB
415 "Second value is %s.\n", optarg);
416 exit(2);
417 }
dd0781e5 418 if (strcmp(optarg, "max")==0)
e705e81b 419 s.size = MAX_SIZE;
dd0781e5 420 else {
e705e81b
N
421 s.size = parse_size(optarg);
422 if (s.size < 8) {
e7b84f9d 423 pr_err("invalid size: %s\n",
dd0781e5
NB
424 optarg);
425 exit(2);
426 }
5f4fc0e1 427 /* convert sectors to K */
e705e81b 428 s.size /= 2;
52826846
NB
429 }
430 continue;
64c4757e 431
84e11361 432 case O(GROW,'Z'): /* array size */
a93f8c65 433 if (array_size > 0) {
e7b84f9d 434 pr_err("array-size may only be specified once. "
84e11361
N
435 "Second value is %s.\n", optarg);
436 exit(2);
437 }
438 if (strcmp(optarg, "max") == 0)
a93f8c65 439 array_size = MAX_SIZE;
84e11361
N
440 else {
441 array_size = parse_size(optarg);
442 if (array_size <= 0) {
e7b84f9d 443 pr_err("invalid array size: %s\n",
84e11361
N
444 optarg);
445 exit(2);
446 }
447 }
448 continue;
449
7236ee7a 450 case O(GROW,'l'):
e0d19036
NB
451 case O(CREATE,'l'):
452 case O(BUILD,'l'): /* set raid level*/
e705e81b 453 if (s.level != UnSet) {
e7b84f9d 454 pr_err("raid level may only be set once. "
52826846
NB
455 "Second value is %s.\n", optarg);
456 exit(2);
457 }
e705e81b
N
458 s.level = map_name(pers, optarg);
459 if (s.level == UnSet) {
e7b84f9d 460 pr_err("invalid raid level: %s\n",
52826846
NB
461 optarg);
462 exit(2);
463 }
e705e81b
N
464 if (s.level != 0 && s.level != LEVEL_LINEAR && s.level != 1 &&
465 s.level != LEVEL_MULTIPATH && s.level != LEVEL_FAULTY &&
466 s.level != 10 &&
e0fe762a 467 mode == BUILD) {
e7b84f9d 468 pr_err("Raid level %s not permitted with --build.\n",
52826846
NB
469 optarg);
470 exit(2);
471 }
e705e81b 472 if (s.sparedisks > 0 && s.level < 1 && s.level >= -1) {
e7b84f9d 473 pr_err("raid level %s is incompatible with spare-devices setting.\n",
52826846
NB
474 optarg);
475 exit(2);
476 }
e705e81b 477 ident.level = s.level;
52826846 478 continue;
64c4757e 479
19678e53 480 case O(GROW, 'p'): /* new layout */
1c7a808c 481 case O(GROW, Layout):
e705e81b 482 if (s.layout_str) {
e7b84f9d
N
483 pr_err("layout may only be sent once. "
484 "Second value was %s\n", optarg);
19678e53
N
485 exit(2);
486 }
e705e81b 487 s.layout_str = optarg;
19678e53
N
488 /* 'Grow' will parse the value */
489 continue;
490
e0d19036 491 case O(CREATE,'p'): /* raid5 layout */
1c7a808c 492 case O(CREATE,Layout):
b5e64645 493 case O(BUILD,'p'): /* faulty layout */
1c7a808c 494 case O(BUILD,Layout):
e705e81b 495 if (s.layout != UnSet) {
e7b84f9d
N
496 pr_err("layout may only be sent once. "
497 "Second value was %s\n", optarg);
52826846
NB
498 exit(2);
499 }
e705e81b 500 switch(s.level) {
52826846 501 default:
e7b84f9d 502 pr_err("layout not meaningful for %s arrays.\n",
e705e81b 503 map_num(pers, s.level));
52826846 504 exit(2);
98c6faba 505 case UnSet:
e7b84f9d 506 pr_err("raid level must be given before layout.\n");
52826846
NB
507 exit(2);
508
509 case 5:
e705e81b
N
510 s.layout = map_name(r5layout, optarg);
511 if (s.layout==UnSet) {
e7b84f9d 512 pr_err("layout %s not understood for raid5.\n",
52826846
NB
513 optarg);
514 exit(2);
515 }
516 break;
b640a252 517 case 6:
e705e81b
N
518 s.layout = map_name(r6layout, optarg);
519 if (s.layout==UnSet) {
e7b84f9d 520 pr_err("layout %s not understood for raid6.\n",
b640a252
N
521 optarg);
522 exit(2);
523 }
524 break;
e5329c37
NB
525
526 case 10:
e705e81b
N
527 s.layout = parse_layout_10(optarg);
528 if (s.layout < 0) {
e7b84f9d 529 pr_err("layout for raid10 must be 'nNN', 'oNN' or 'fNN' where NN is a number, not %s\n", optarg);
e5329c37
NB
530 exit(2);
531 }
e5329c37 532 break;
19678e53
N
533 case LEVEL_FAULTY:
534 /* Faulty
535 * modeNNN
536 */
e705e81b
N
537 s.layout = parse_layout_faulty(optarg);
538 if (s.layout == -1) {
e7b84f9d 539 pr_err("layout %s not understood for faulty.\n",
b5e64645
NB
540 optarg);
541 exit(2);
542 }
4a06e2c2 543 break;
52826846
NB
544 }
545 continue;
546
997aed5d
NB
547 case O(CREATE,AssumeClean):
548 case O(BUILD,AssumeClean): /* assume clean */
ce52f92f 549 case O(GROW,AssumeClean):
e705e81b 550 s.assume_clean = 1;
dd0781e5
NB
551 continue;
552
553 case O(GROW,'n'):
e0d19036
NB
554 case O(CREATE,'n'):
555 case O(BUILD,'n'): /* number of raid disks */
e705e81b 556 if (s.raiddisks) {
e7b84f9d 557 pr_err("raid-devices set twice: %d and %s\n",
e705e81b 558 s.raiddisks, optarg);
52826846
NB
559 exit(2);
560 }
e705e81b
N
561 s.raiddisks = parse_num(optarg);
562 if (s.raiddisks <= 0) {
e7b84f9d 563 pr_err("invalid number of raid devices: %s\n",
52826846
NB
564 optarg);
565 exit(2);
566 }
e705e81b 567 ident.raid_disks = s.raiddisks;
52826846
NB
568 continue;
569
18361a1a 570 case O(CREATE,'x'): /* number of spare (eXtra) disks */
e705e81b 571 if (s.sparedisks) {
e7b84f9d 572 pr_err("spare-devices set twice: %d and %s\n",
e705e81b 573 s.sparedisks, optarg);
52826846
NB
574 exit(2);
575 }
e705e81b 576 if (s.level != UnSet && s.level <= 0 && s.level >= -1) {
e7b84f9d 577 pr_err("spare-devices setting is incompatible with raid level %d\n",
e705e81b 578 s.level);
52826846
NB
579 exit(2);
580 }
e705e81b
N
581 s.sparedisks = parse_num(optarg);
582 if (s.sparedisks < 0) {
e7b84f9d 583 pr_err("invalid number of spare-devices: %s\n",
52826846
NB
584 optarg);
585 exit(2);
586 }
587 continue;
dd0781e5
NB
588
589 case O(CREATE,'a'):
1c7a808c 590 case O(CREATE,Auto):
dd0781e5 591 case O(BUILD,'a'):
1c7a808c 592 case O(BUILD,Auto):
95b79df0 593 case O(INCREMENTAL,'a'):
1c7a808c
N
594 case O(INCREMENTAL,Auto):
595 case O(ASSEMBLE,'a'):
596 case O(ASSEMBLE,Auto): /* auto-creation of device node */
9e33d556 597 c.autof = parse_auto(optarg, "--auto flag", 0);
dd0781e5
NB
598 continue;
599
38098016
NB
600 case O(CREATE,Symlinks):
601 case O(BUILD,Symlinks):
602 case O(ASSEMBLE,Symlinks): /* auto creation of symlinks in /dev to /dev/md */
603 symlinks = optarg;
604 continue;
605
aa88f531 606 case O(BUILD,'f'): /* force honouring '-n 1' */
1c7a808c 607 case O(BUILD,Force): /* force honouring '-n 1' */
bd72c2b2 608 case O(GROW,'f'): /* ditto */
1c7a808c 609 case O(GROW,Force): /* ditto */
e0d19036 610 case O(CREATE,'f'): /* force honouring of device list */
1c7a808c 611 case O(CREATE,Force): /* force honouring of device list */
e0d19036 612 case O(ASSEMBLE,'f'): /* force assembly */
1c7a808c 613 case O(ASSEMBLE,Force): /* force assembly */
e0d19036 614 case O(MISC,'f'): /* force zero */
1c7a808c 615 case O(MISC,Force): /* force zero */
11b391ec 616 case O(MANAGE,Force): /* add device which is too large */
9e33d556 617 c.force=1;
52826846 618 continue;
52826846 619 /* now for the Assemble options */
b76b30e0
AK
620 case O(ASSEMBLE, FreezeReshape): /* Freeze reshape during
621 * initrd phase */
622 case O(INCREMENTAL, FreezeReshape):
9e33d556 623 c.freeze_reshape = 1;
b76b30e0 624 continue;
3d3dd91e 625 case O(CREATE,'u'): /* uuid of array */
e0d19036 626 case O(ASSEMBLE,'u'): /* uuid of array */
52826846 627 if (ident.uuid_set) {
e7b84f9d 628 pr_err("uuid cannot be set twice. "
52826846
NB
629 "Second value %s.\n", optarg);
630 exit(2);
631 }
632 if (parse_uuid(optarg, ident.uuid))
633 ident.uuid_set = 1;
634 else {
e7b84f9d 635 pr_err("Bad uuid: %s\n", optarg);
52826846
NB
636 exit(2);
637 }
638 continue;
639
947fd4dd
NB
640 case O(CREATE,'N'):
641 case O(ASSEMBLE,'N'):
aa534678 642 case O(MISC,'N'):
947fd4dd 643 if (ident.name[0]) {
e7b84f9d 644 pr_err("name cannot be set twice. "
947fd4dd
NB
645 "Second value %s.\n", optarg);
646 exit(2);
647 }
9e33d556 648 if (mode == MISC && !c.subarray) {
e7b84f9d 649 pr_err("-N/--name only valid with --update-subarray in misc mode\n");
aa534678
DW
650 exit(2);
651 }
947fd4dd 652 if (strlen(optarg) > 32) {
e7b84f9d 653 pr_err("name '%s' is too long, 32 chars max.\n",
947fd4dd
NB
654 optarg);
655 exit(2);
656 }
657 strcpy(ident.name, optarg);
658 continue;
659
e0d19036 660 case O(ASSEMBLE,'m'): /* super-minor for array */
1c7a808c 661 case O(ASSEMBLE,SuperMinor):
98c6faba 662 if (ident.super_minor != UnSet) {
e7b84f9d 663 pr_err("super-minor cannot be set twice. "
cd29a5c8
NB
664 "Second value: %s.\n", optarg);
665 exit(2);
666 }
d013a55e
NB
667 if (strcmp(optarg, "dev")==0)
668 ident.super_minor = -2;
669 else {
79868890
N
670 ident.super_minor = parse_num(optarg);
671 if (ident.super_minor < 0) {
e7b84f9d 672 pr_err("Bad super-minor number: %s.\n", optarg);
d013a55e
NB
673 exit(2);
674 }
cd29a5c8
NB
675 }
676 continue;
677
0ea8f5b1
N
678 case O(ASSEMBLE,'o'):
679 case O(MANAGE,'o'):
680 case O(CREATE,'o'):
9e33d556 681 c.readonly = 1;
0ea8f5b1
N
682 continue;
683
5787fa49 684 case O(ASSEMBLE,'U'): /* update the superblock */
aa534678 685 case O(MISC,'U'):
9e33d556 686 if (c.update) {
e7b84f9d 687 pr_err("Can only update one aspect"
833bb0f8 688 " of superblock, both %s and %s given.\n",
9e33d556 689 c.update, optarg);
5787fa49
NB
690 exit(2);
691 }
9e33d556 692 if (mode == MISC && !c.subarray) {
e7b84f9d 693 pr_err("Only subarrays can be"
833bb0f8 694 " updated in misc mode\n");
aa534678
DW
695 exit(2);
696 }
9e33d556
N
697 c.update = optarg;
698 if (strcmp(c.update, "sparc2.2")==0)
e5329c37 699 continue;
9e33d556 700 if (strcmp(c.update, "super-minor") == 0)
5787fa49 701 continue;
9e33d556 702 if (strcmp(c.update, "summaries")==0)
feb716e9 703 continue;
9e33d556 704 if (strcmp(c.update, "resync")==0)
e5329c37 705 continue;
9e33d556 706 if (strcmp(c.update, "uuid")==0)
7d99579f 707 continue;
9e33d556 708 if (strcmp(c.update, "name")==0)
c4f12c13 709 continue;
9e33d556 710 if (strcmp(c.update, "homehost")==0)
0237e0ca 711 continue;
9e33d556 712 if (strcmp(c.update, "devicesize")==0)
bee8ec56 713 continue;
9e33d556 714 if (strcmp(c.update, "no-bitmap")==0)
5a31170d 715 continue;
688e99a7
N
716 if (strcmp(c.update, "bbl") == 0)
717 continue;
718 if (strcmp(c.update, "no-bbl") == 0)
719 continue;
9e33d556 720 if (strcmp(c.update, "byteorder")==0) {
586ed405 721 if (ss) {
e7b84f9d
N
722 pr_err("must not set metadata"
723 " type with --update=byteorder.\n");
586ed405
NB
724 exit(2);
725 }
aba69144 726 for(i=0; !ss && superlist[i]; i++)
833bb0f8
N
727 ss = superlist[i]->match_metadata_desc(
728 "0.swap");
586ed405 729 if (!ss) {
e7b84f9d 730 pr_err("INTERNAL ERROR"
833bb0f8 731 " cannot find 0.swap\n");
586ed405
NB
732 exit(2);
733 }
734
735 continue;
736 }
9e33d556
N
737 if (strcmp(c.update,"?") == 0 ||
738 strcmp(c.update, "help") == 0) {
0047d254
NB
739 outf = stdout;
740 fprintf(outf, Name ": ");
741 } else {
742 outf = stderr;
743 fprintf(outf,
744 Name ": '--update=%s' is invalid. ",
9e33d556 745 c.update);
0047d254
NB
746 }
747 fprintf(outf, "Valid --update options are:\n"
bee8ec56 748 " 'sparc2.2', 'super-minor', 'uuid', 'name', 'resync',\n"
5a31170d
N
749 " 'summaries', 'homehost', 'byteorder', 'devicesize',\n"
750 " 'no-bitmap'\n");
0047d254 751 exit(outf == stdout ? 0 : 2);
5787fa49 752
833bb0f8
N
753 case O(MANAGE,'U'):
754 /* update=devicesize is allowed with --re-add */
c8e1a230 755 if (devmode != 'A') {
e7b84f9d 756 pr_err("--update in Manage mode only"
833bb0f8
N
757 " allowed with --re-add.\n");
758 exit(1);
759 }
9e33d556 760 if (c.update) {
e7b84f9d 761 pr_err("Can only update one aspect"
833bb0f8 762 " of superblock, both %s and %s given.\n",
9e33d556 763 c.update, optarg);
833bb0f8
N
764 exit(2);
765 }
9e33d556 766 c.update = optarg;
688e99a7
N
767 if (strcmp(c.update, "devicesize") != 0 &&
768 strcmp(c.update, "bbl") != 0 &&
769 strcmp(c.update, "no-bbl") != 0) {
770 pr_err("only 'devicesize', 'bbl' and 'no-bbl' can be"
833bb0f8
N
771 " updated with --re-add\n");
772 exit(2);
773 }
774 continue;
775
172356c9 776 case O(INCREMENTAL,NoDegraded):
e7b84f9d 777 pr_err("--no-degraded is deprecated in Incremental mode\n");
997aed5d 778 case O(ASSEMBLE,NoDegraded): /* --no-degraded */
9e33d556
N
779 c.runstop = -1; /* --stop isn't allowed for --assemble,
780 * so we overload slightly */
b8a8ccf9
NB
781 continue;
782
1c7a808c
N
783 case O(ASSEMBLE,'c'):
784 case O(ASSEMBLE,ConfigFile):
7b187ed7 785 case O(INCREMENTAL, 'c'):
1c7a808c 786 case O(INCREMENTAL, ConfigFile):
2d465520 787 case O(MISC, 'c'):
1c7a808c 788 case O(MISC, ConfigFile):
e0d19036 789 case O(MONITOR,'c'):
1c7a808c 790 case O(MONITOR,ConfigFile):
52826846 791 if (configfile) {
e7b84f9d 792 pr_err("configfile cannot be set twice. "
52826846
NB
793 "Second value is %s.\n", optarg);
794 exit(2);
795 }
796 configfile = optarg;
8aec876d 797 set_conffile(configfile);
52826846
NB
798 /* FIXME possibly check that config file exists. Even parse it */
799 continue;
e0d19036
NB
800 case O(ASSEMBLE,'s'): /* scan */
801 case O(MISC,'s'):
802 case O(MONITOR,'s'):
8382f19b 803 case O(INCREMENTAL,'s'):
9e33d556 804 c.scan = 1;
52826846
NB
805 continue;
806
e0d19036 807 case O(MONITOR,'m'): /* mail address */
1c7a808c 808 case O(MONITOR,EMail):
52826846 809 if (mailaddr)
e7b84f9d 810 pr_err("only specify one mailaddress. %s ignored.\n",
52826846
NB
811 optarg);
812 else
813 mailaddr = optarg;
814 continue;
815
e0d19036 816 case O(MONITOR,'p'): /* alert program */
1c7a808c 817 case O(MONITOR,ProgramOpt): /* alert program */
52826846 818 if (program)
e7b84f9d 819 pr_err("only specify one alter program. %s ignored.\n",
52826846
NB
820 optarg);
821 else
822 program = optarg;
823 continue;
64c4757e 824
9a36a9b7 825 case O(MONITOR,'r'): /* rebuild increments */
1c7a808c 826 case O(MONITOR,Increment):
9a36a9b7 827 increments = atoi(optarg);
18361a1a 828 if (increments > 99 || increments < 1) {
e7b84f9d 829 pr_err("please specify positive integer between 1 and 99 as rebuild increments.\n");
9a36a9b7
ZB
830 exit(2);
831 }
832 continue;
833
e0d19036 834 case O(MONITOR,'d'): /* delay in seconds */
f5e166fe 835 case O(GROW, 'd'):
c82f047c
NB
836 case O(BUILD,'d'): /* delay for bitmap updates */
837 case O(CREATE,'d'):
9e33d556 838 if (c.delay)
e7b84f9d 839 pr_err("only specify delay once. %s ignored.\n",
52826846
NB
840 optarg);
841 else {
9e33d556
N
842 c.delay = parse_num(optarg);
843 if (c.delay < 1) {
e7b84f9d 844 pr_err("invalid delay: %s\n",
52826846
NB
845 optarg);
846 exit(2);
847 }
848 }
849 continue;
d013a55e 850 case O(MONITOR,'f'): /* daemonise */
1c7a808c 851 case O(MONITOR,Fork):
d013a55e
NB
852 daemonise = 1;
853 continue;
b5e64645
NB
854 case O(MONITOR,'i'): /* pid */
855 if (pidfile)
e7b84f9d 856 pr_err("only specify one pid file. %s ignored.\n",
b5e64645
NB
857 optarg);
858 else
859 pidfile = optarg;
860 continue;
aa88f531
NB
861 case O(MONITOR,'1'): /* oneshot */
862 oneshot = 1;
3f555346 863 spare_sharing = 0;
aa88f531 864 continue;
98c6faba 865 case O(MONITOR,'t'): /* test */
9e33d556 866 c.test = 1;
98c6faba 867 continue;
773135f5 868 case O(MONITOR,'y'): /* log messages to syslog */
6ac8aac2 869 openlog("mdadm", LOG_PID, SYSLOG_FACILITY);
773135f5
NB
870 dosyslog = 1;
871 continue;
edde9560
AC
872 case O(MONITOR, NoSharing):
873 spare_sharing = 0;
874 continue;
18361a1a 875
52826846
NB
876 /* now the general management options. Some are applicable
877 * to other modes. None have arguments.
878 */
e5329c37 879 case O(GROW,'a'):
1c7a808c
N
880 case O(GROW,Add):
881 case O(MANAGE,'a'):
882 case O(MANAGE,Add): /* add a drive */
52826846 883 devmode = 'a';
fe80f49b 884 continue;
997aed5d 885 case O(MANAGE,ReAdd):
c8e1a230 886 devmode = 'A';
52826846 887 continue;
e0d19036 888 case O(MANAGE,'r'): /* remove a drive */
1c7a808c 889 case O(MANAGE,Remove):
52826846
NB
890 devmode = 'r';
891 continue;
e0d19036 892 case O(MANAGE,'f'): /* set faulty */
1c7a808c
N
893 case O(MANAGE,Fail):
894 case O(INCREMENTAL,'f'):
895 case O(INCREMENTAL,Remove):
896 case O(INCREMENTAL,Fail): /* r for incremental is taken, use f
7d27d1c0
N
897 * even though we will both fail and
898 * remove the device */
52826846
NB
899 devmode = 'f';
900 continue;
8382f19b 901 case O(INCREMENTAL,'R'):
e0d19036
NB
902 case O(MANAGE,'R'):
903 case O(ASSEMBLE,'R'):
904 case O(BUILD,'R'):
905 case O(CREATE,'R'): /* Run the array */
9e33d556 906 if (c.runstop < 0) {
e7b84f9d 907 pr_err("Cannot both Stop and Run an array\n");
52826846
NB
908 exit(2);
909 }
9e33d556 910 c.runstop = 1;
52826846 911 continue;
e0d19036 912 case O(MANAGE,'S'):
9e33d556 913 if (c.runstop > 0) {
e7b84f9d 914 pr_err("Cannot both Run and Stop an array\n");
52826846
NB
915 exit(2);
916 }
9e33d556 917 c.runstop = -1;
52826846 918 continue;
7d2e6486 919 case O(MANAGE,'t'):
9e33d556 920 c.test = 1;
7d2e6486 921 continue;
52826846 922
e0d19036
NB
923 case O(MISC,'Q'):
924 case O(MISC,'D'):
925 case O(MISC,'E'):
f7d3febc 926 case O(MISC,KillOpt):
e0d19036
NB
927 case O(MISC,'R'):
928 case O(MISC,'S'):
c82f047c 929 case O(MISC,'X'):
e0d19036
NB
930 case O(MISC,'o'):
931 case O(MISC,'w'):
b90c0e9a 932 case O(MISC,'W'):
1c7a808c 933 case O(MISC, WaitOpt):
1770662b 934 case O(MISC, Waitclean):
4cce4069 935 case O(MISC, DetailPlatform):
33414a01 936 case O(MISC, KillSubarray):
aa534678 937 case O(MISC, UpdateSubarray):
5a53aeec 938 if (opt == KillSubarray || opt == UpdateSubarray) {
9e33d556 939 if (c.subarray) {
e7b84f9d 940 pr_err("subarray can only"
5a53aeec
JS
941 " be specified once\n");
942 exit(2);
943 }
9e33d556 944 c.subarray = optarg;
5a53aeec 945 }
e0d19036
NB
946 if (devmode && devmode != opt &&
947 (devmode == 'E' || (opt == 'E' && devmode != 'Q'))) {
e7b84f9d 948 pr_err("--examine/-E cannot be given with ");
aa534678
DW
949 if (devmode == 'E') {
950 if (option_index >= 0)
951 fprintf(stderr, "--%s\n",
952 long_options[option_index].name);
953 else
954 fprintf(stderr, "-%c\n", opt);
955 } else if (isalpha(devmode))
956 fprintf(stderr, "-%c\n", devmode);
957 else
958 fprintf(stderr, "previous option\n");
e0d19036
NB
959 exit(2);
960 }
961 devmode = opt;
962 continue;
7d27d1c0
N
963 case O(MISC, UdevRules):
964 if (devmode && devmode != opt) {
e7b84f9d
N
965 pr_err("--udev-rules must"
966 " be the only option.\n");
7d27d1c0
N
967 } else {
968 if (udev_filename)
e7b84f9d 969 pr_err("only specify one udev "
7d27d1c0
N
970 "rule filename. %s ignored.\n",
971 optarg);
972 else
973 udev_filename = optarg;
974 }
975 devmode = opt;
976 continue;
feb716e9 977 case O(MISC,'t'):
9e33d556 978 c.test = 1;
feb716e9 979 continue;
e0d19036 980
997aed5d 981 case O(MISC, Sparc22):
bd526cee 982 if (devmode != 'E') {
e7b84f9d 983 pr_err("--sparc2.2 only allowed with --examine\n");
bd526cee
NB
984 exit(2);
985 }
9e33d556 986 c.SparcAdjust = 1;
bd526cee 987 continue;
c82f047c
NB
988
989 case O(ASSEMBLE,'b'): /* here we simply set the bitmap file */
1c7a808c 990 case O(ASSEMBLE,Bitmap):
c82f047c 991 if (!optarg) {
e7b84f9d 992 pr_err("bitmap file needed with -b in --assemble mode\n");
c82f047c
NB
993 exit(2);
994 }
55935d51 995 if (strcmp(optarg, "internal")==0) {
e7b84f9d 996 pr_err("there is no need to specify --bitmap when assembling arrays with internal bitmaps\n");
55935d51
NB
997 continue;
998 }
c82f047c
NB
999 bitmap_fd = open(optarg, O_RDWR);
1000 if (!*optarg || bitmap_fd < 0) {
e7b84f9d 1001 pr_err("cannot open bitmap file %s: %s\n", optarg, strerror(errno));
c82f047c
NB
1002 exit(2);
1003 }
1004 ident.bitmap_fd = bitmap_fd; /* for Assemble */
1005 continue;
f5e166fe 1006
997aed5d
NB
1007 case O(ASSEMBLE, BackupFile):
1008 case O(GROW, BackupFile):
06b0d786
NB
1009 /* Specify a file into which grow might place a backup,
1010 * or from which assemble might recover a backup
1011 */
9e33d556 1012 if (c.backup_file) {
e7b84f9d 1013 pr_err("backup file already specified, rejecting %s\n", optarg);
06b0d786
NB
1014 exit(2);
1015 }
9e33d556 1016 c.backup_file = optarg;
06b0d786
NB
1017 continue;
1018
2dddadb0
AK
1019 case O(GROW, Continue):
1020 /* Continue interrupted grow
1021 */
1022 grow_continue = 1;
1023 continue;
87f26d14
N
1024 case O(ASSEMBLE, InvalidBackup):
1025 /* Acknowledge that the backupfile is invalid, but ask
1026 * to continue anyway
1027 */
9e33d556 1028 c.invalid_backup = 1;
87f26d14
N
1029 continue;
1030
c82f047c 1031 case O(BUILD,'b'):
1c7a808c
N
1032 case O(BUILD,Bitmap):
1033 case O(CREATE,'b'):
1034 case O(CREATE,Bitmap): /* here we create the bitmap */
85375d6d 1035 if (strcmp(optarg, "none") == 0) {
e7b84f9d 1036 pr_err("'--bitmap none' only"
18361a1a 1037 " supported for --grow\n");
85375d6d
NB
1038 exit(2);
1039 }
1040 /* FALL THROUGH */
1041 case O(GROW,'b'):
1c7a808c 1042 case O(GROW,Bitmap):
1e0d770c
NB
1043 if (strcmp(optarg, "internal")== 0 ||
1044 strcmp(optarg, "none")== 0 ||
1045 strchr(optarg, '/') != NULL) {
e705e81b 1046 s.bitmap_file = optarg;
1e0d770c
NB
1047 continue;
1048 }
1049 /* probable typo */
e7b84f9d 1050 pr_err("bitmap file must contain a '/', or be 'internal', or 'none'\n"
a1331cc4 1051 " not '%s'\n", optarg);
1e0d770c 1052 exit(2);
c82f047c 1053
997aed5d
NB
1054 case O(GROW,BitmapChunk):
1055 case O(BUILD,BitmapChunk):
1056 case O(CREATE,BitmapChunk): /* bitmap chunksize */
e705e81b
N
1057 s.bitmap_chunk = parse_size(optarg);
1058 if (s.bitmap_chunk <= 0 ||
1059 s.bitmap_chunk & (s.bitmap_chunk - 1)) {
e7b84f9d
N
1060 pr_err("invalid bitmap chunksize: %s\n",
1061 optarg);
c82f047c
NB
1062 exit(2);
1063 }
e705e81b 1064 s.bitmap_chunk = s.bitmap_chunk * 512;
c82f047c 1065 continue;
dfd4d8ee 1066
7d19ad0d 1067 case O(GROW, WriteBehind):
997aed5d
NB
1068 case O(BUILD, WriteBehind):
1069 case O(CREATE, WriteBehind): /* write-behind mode */
e705e81b 1070 s.write_behind = DEFAULT_MAX_WRITE_BEHIND;
dfd4d8ee 1071 if (optarg) {
e705e81b
N
1072 s.write_behind = parse_num(optarg);
1073 if (s.write_behind < 0 ||
1074 s.write_behind > 16383) {
e7b84f9d 1075 pr_err("Invalid value for maximum outstanding write-behind writes: %s.\n\tMust be between 0 and 16383.\n", optarg);
dfd4d8ee
NB
1076 exit(2);
1077 }
1078 }
1079 continue;
8382f19b
NB
1080
1081 case O(INCREMENTAL, 'r'):
1c7a808c 1082 case O(INCREMENTAL, RebuildMapOpt):
8382f19b
NB
1083 rebuild_map = 1;
1084 continue;
950bc344
PC
1085 case O(INCREMENTAL, IncrementalPath):
1086 remove_path = optarg;
1087 continue;
52826846
NB
1088 }
1089 /* We have now processed all the valid options. Anything else is
1090 * an error
1091 */
06b0d786 1092 if (option_index > 0)
e7b84f9d 1093 pr_err(":option --%s not valid in %s mode\n",
06b0d786
NB
1094 long_options[option_index].name,
1095 map_num(modes, mode));
1096 else
e7b84f9d 1097 pr_err("option -%c not valid in %s mode\n",
06b0d786 1098 opt, map_num(modes, mode));
64c4757e 1099 exit(2);
52826846
NB
1100
1101 }
1102
3d4064cc 1103 if (print_help) {
5187a385 1104 char *help_text;
3d4064cc
NB
1105 if (print_help == 2)
1106 help_text = OptionHelp;
1107 else
5187a385
N
1108 help_text = mode_help[mode];
1109 if (help_text == NULL)
1110 help_text = Help;
0047d254 1111 fputs(help_text,stdout);
3d4064cc
NB
1112 exit(0);
1113 }
1114
0320ea45
NB
1115 if (!mode && devs_found) {
1116 mode = MISC;
1117 devmode = 'Q';
1118 if (devlist->disposition == 0)
1119 devlist->disposition = devmode;
1120 }
52826846
NB
1121 if (!mode) {
1122 fputs(Usage, stderr);
64c4757e 1123 exit(2);
64c4757e 1124 }
38098016
NB
1125
1126 if (symlinks) {
1127 struct createinfo *ci = conf_get_create_info();
1128
1129 if (strcasecmp(symlinks, "yes") == 0)
1130 ci->symlinks = 1;
1131 else if (strcasecmp(symlinks, "no") == 0)
1132 ci->symlinks = 0;
1133 else {
e7b84f9d 1134 pr_err("option --symlinks must be 'no' or 'yes'\n");
38098016
NB
1135 exit(2);
1136 }
1137 }
52826846
NB
1138 /* Ok, got the option parsing out of the way
1139 * hopefully it's mostly right but there might be some stuff
1140 * missing
1141 *
e0d19036 1142 * That is mosty checked in the per-mode stuff but...
52826846 1143 *
18361a1a
N
1144 * For @,B,C and A without -s, the first device listed must be
1145 * an md device. We check that here and open it.
64c4757e 1146 */
52826846 1147
18361a1a
N
1148 if (mode == MANAGE || mode == BUILD || mode == CREATE
1149 || mode == GROW
9e33d556 1150 || (mode == ASSEMBLE && ! c.scan)) {
52826846 1151 if (devs_found < 1) {
e7b84f9d 1152 pr_err("an md device must be given in this mode\n");
52826846
NB
1153 exit(2);
1154 }
9e33d556 1155 if ((int)ident.super_minor == -2 && c.autof) {
e7b84f9d 1156 pr_err("--super-minor=dev is incompatible with --auto\n");
dd0781e5
NB
1157 exit(2);
1158 }
7f91af49 1159 if (mode == MANAGE || mode == GROW) {
6be1d39d 1160 mdfd = open_mddev(devlist->devname, 1);
7f91af49
N
1161 if (mdfd < 0)
1162 exit(1);
1163 } else
1164 /* non-existent device is OK */
1165 mdfd = open_mddev(devlist->devname, 0);
1166 if (mdfd == -2) {
e7b84f9d 1167 pr_err("device %s exists but is not an "
7f91af49 1168 "md array.\n", devlist->devname);
52826846 1169 exit(1);
7f91af49 1170 }
98c6faba 1171 if ((int)ident.super_minor == -2) {
d013a55e 1172 struct stat stb;
7f91af49 1173 if (mdfd < 0) {
e7b84f9d 1174 pr_err("--super-minor=dev given, and "
7f91af49
N
1175 "listed device %s doesn't exist.\n",
1176 devlist->devname);
1177 exit(1);
1178 }
d013a55e 1179 fstat(mdfd, &stb);
0df46c2a 1180 ident.super_minor = minor(stb.st_rdev);
d013a55e 1181 }
7f91af49
N
1182 if (mdfd >= 0 && mode != MANAGE && mode != GROW) {
1183 /* We don't really want this open yet, we just might
1184 * have wanted to check some things
1185 */
1186 close(mdfd);
1187 mdfd = -1;
1188 }
64c4757e 1189 }
52826846 1190
e705e81b
N
1191 if (s.raiddisks) {
1192 if (s.raiddisks == 1 && !c.force && s.level != LEVEL_FAULTY) {
e7b84f9d 1193 pr_err("'1' is an unusual number of drives for an array, so it is probably\n"
e4c4352e
NB
1194 " a mistake. If you really mean it you will need to specify --force before\n"
1195 " setting the number of drives.\n");
1196 exit(2);
1197 }
1198 }
c82f047c 1199
9e33d556
N
1200 if (c.homehost == NULL)
1201 c.homehost = conf_get_homehost(&c.require_homehost);
1202 if (c.homehost == NULL || strcasecmp(c.homehost, "<system>")==0) {
05697ec1
NB
1203 if (gethostname(sys_hostname, sizeof(sys_hostname)) == 0) {
1204 sys_hostname[sizeof(sys_hostname)-1] = 0;
9e33d556 1205 c.homehost = sys_hostname;
05697ec1
NB
1206 }
1207 }
9e33d556
N
1208 if (c.homehost && (!c.homehost[0] || strcasecmp(c.homehost, "<none>") == 0)) {
1209 c.homehost = NULL;
1210 c.require_homehost = 0;
0f23aa88 1211 }
997aed5d 1212
18361a1a
N
1213 if ((mode == MISC && devmode == 'E')
1214 || (mode == MONITOR && spare_sharing == 0))
1215 /* Anyone may try this */;
1216 else if (geteuid() != 0) {
e7b84f9d 1217 pr_err("must be super-user to perform this action\n");
ac5678dd
N
1218 exit(1);
1219 }
1220
9e33d556 1221 ident.autof = c.autof;
7f91af49 1222
265460ab
N
1223 if (c.scan && c.verbose < 2)
1224 /* --scan implied --brief unless -vv */
1225 c.brief = 1;
1226
52826846
NB
1227 rv = 0;
1228 switch(mode) {
e0d19036 1229 case MANAGE:
52826846 1230 /* readonly, add/remove, readwrite, runstop */
9e33d556
N
1231 if (c.readonly > 0)
1232 rv = Manage_ro(devlist->devname, mdfd, c.readonly);
52826846 1233 if (!rv && devs_found>1)
cd29a5c8 1234 rv = Manage_subdevs(devlist->devname, mdfd,
0937132d 1235 devlist->next, c.verbose, c.test,
9e33d556
N
1236 c.update, c.force);
1237 if (!rv && c.readonly < 0)
1238 rv = Manage_ro(devlist->devname, mdfd, c.readonly);
1239 if (!rv && c.runstop)
0937132d 1240 rv = Manage_runstop(devlist->devname, mdfd, c.runstop, c.verbose, 0);
52826846 1241 break;
e0d19036 1242 case ASSEMBLE:
d013a55e 1243 if (devs_found == 1 && ident.uuid_set == 0 &&
9e33d556 1244 ident.super_minor == UnSet && ident.name[0] == 0 && !c.scan ) {
d013a55e 1245 /* Only a device has been given, so get details from config file */
fa56eddb 1246 struct mddev_ident *array_ident = conf_get_ident(devlist->devname);
b5e64645 1247 if (array_ident == NULL) {
e7b84f9d 1248 pr_err("%s not identified in config file.\n",
b5e64645 1249 devlist->devname);
d013a55e 1250 rv |= 1;
7f91af49
N
1251 if (mdfd >= 0)
1252 close(mdfd);
b5e64645 1253 } else {
7f91af49 1254 if (array_ident->autof == 0)
9e33d556 1255 array_ident->autof = c.autof;
7f91af49 1256 rv |= Assemble(ss, devlist->devname, array_ident,
4977146a 1257 NULL, &c);
d013a55e 1258 }
9e33d556 1259 } else if (!c.scan)
7f91af49 1260 rv = Assemble(ss, devlist->devname, &ident,
4977146a 1261 devlist->next, &c);
18361a1a 1262 else if (devs_found > 0) {
9e33d556 1263 if (c.update && devs_found > 1) {
e7b84f9d 1264 pr_err("can only update a single array at a time\n");
5787fa49
NB
1265 exit(1);
1266 }
9e33d556 1267 if (c.backup_file && devs_found > 1) {
e7b84f9d 1268 pr_err("can only assemble a single array when providing a backup file.\n");
06b0d786
NB
1269 exit(1);
1270 }
cd29a5c8 1271 for (dv = devlist ; dv ; dv=dv->next) {
fa56eddb 1272 struct mddev_ident *array_ident = conf_get_ident(dv->devname);
52826846 1273 if (array_ident == NULL) {
e7b84f9d 1274 pr_err("%s not identified in config file.\n",
cd29a5c8 1275 dv->devname);
52826846
NB
1276 rv |= 1;
1277 continue;
1278 }
7f91af49 1279 if (array_ident->autof == 0)
9e33d556 1280 array_ident->autof = c.autof;
7f91af49 1281 rv |= Assemble(ss, dv->devname, array_ident,
4977146a 1282 NULL, &c);
52826846 1283 }
5787fa49 1284 } else {
9e33d556 1285 if (c.update) {
e7b84f9d 1286 pr_err("--update not meaningful with a --scan assembly.\n");
da6b5ca9
NB
1287 exit(1);
1288 }
9e33d556 1289 if (c.backup_file) {
e7b84f9d 1290 pr_err("--backup_file not meaningful with a --scan assembly.\n");
da6b5ca9
NB
1291 exit(1);
1292 }
4977146a 1293 rv = scan_assemble(ss, &c, &ident);
52826846 1294 }
3cbc4d12 1295
52826846 1296 break;
e0d19036 1297 case BUILD:
9e33d556
N
1298 if (c.delay == 0)
1299 c.delay = DEFAULT_BITMAP_DELAY;
e705e81b 1300 if (s.write_behind && !s.bitmap_file) {
e7b84f9d 1301 pr_err("write-behind mode requires a bitmap.\n");
dfd4d8ee
NB
1302 rv = 1;
1303 break;
1304 }
e705e81b 1305 if (s.raiddisks == 0) {
e7b84f9d 1306 pr_err("no raid-devices specified.\n");
5b28bd56
NB
1307 rv = 1;
1308 break;
1309 }
dfd4d8ee 1310
e705e81b
N
1311 if (s.bitmap_file) {
1312 if (strcmp(s.bitmap_file, "internal")==0) {
e7b84f9d 1313 pr_err("'internal' bitmaps not supported with --build\n");
55935d51
NB
1314 rv |= 1;
1315 break;
1316 }
c82f047c 1317 }
a4e8316a 1318 rv = Build(devlist->devname, devlist->next, &s, &c);
52826846 1319 break;
e0d19036 1320 case CREATE:
9e33d556
N
1321 if (c.delay == 0)
1322 c.delay = DEFAULT_BITMAP_DELAY;
e705e81b 1323 if (s.write_behind && !s.bitmap_file) {
e7b84f9d 1324 pr_err("write-behind mode requires a bitmap.\n");
dfd4d8ee
NB
1325 rv = 1;
1326 break;
1327 }
e705e81b 1328 if (s.raiddisks == 0) {
e7b84f9d 1329 pr_err("no raid-devices specified.\n");
5b28bd56
NB
1330 rv = 1;
1331 break;
1332 }
f9ce90ba 1333
99cc42f4
N
1334 rv = Create(ss, devlist->devname,
1335 ident.name, ident.uuid_set ? ident.uuid : NULL,
171dccc8 1336 devs_found-1, devlist->next,
99cc42f4 1337 &s, &c);
52826846 1338 break;
e0d19036 1339 case MISC:
e0d19036 1340 if (devmode == 'E') {
9e33d556 1341 if (devlist == NULL && !c.scan) {
e7b84f9d 1342 pr_err("No devices to examine\n");
e0d19036
NB
1343 exit(2);
1344 }
1345 if (devlist == NULL)
8aec876d 1346 devlist = conf_get_devs();
e0d19036 1347 if (devlist == NULL) {
e7b84f9d 1348 pr_err("No devices listed in %s\n", configfile?configfile:DefaultConfFile);
e0d19036
NB
1349 exit(1);
1350 }
eec3f887 1351 rv = Examine(devlist, &c, ss);
4cce4069 1352 } else if (devmode == DetailPlatform) {
e50cf220 1353 rv = Detail_Platform(ss ? ss->ss : NULL, ss ? c.scan : 1, c.verbose, c.export);
7d27d1c0 1354 } else if (devlist == NULL) {
9e33d556 1355 if (devmode == 'S' && c.scan)
0937132d 1356 rv = stop_scan(c.verbose);
9e33d556 1357 else if ((devmode == 'D' || devmode == Waitclean) && c.scan)
ef898ce6 1358 rv = misc_scan(devmode, &c);
7d27d1c0
N
1359 else if (devmode == UdevRules)
1360 rv = Write_rules(udev_filename);
1361 else {
e7b84f9d 1362 pr_err("No devices given.\n");
7d27d1c0 1363 exit(2);
e0d19036 1364 }
7d27d1c0 1365 } else
86da243f 1366 rv = misc_list(devlist, &ident, ss, &c);
9a9dab36 1367 break;
e0d19036 1368 case MONITOR:
9e33d556 1369 if (!devlist && !c.scan) {
e7b84f9d 1370 pr_err("Cannot monitor: need --scan or at least one device\n");
e0d19036
NB
1371 rv = 1;
1372 break;
1373 }
b5e64645 1374 if (pidfile && !daemonise) {
e7b84f9d 1375 pr_err("Cannot write a pid file when not in daemon mode\n");
b5e64645
NB
1376 rv = 1;
1377 break;
1378 }
9e33d556 1379 if (c.delay == 0) {
3e82d76d 1380 if (get_linux_version() > 2006016)
ddc7201f 1381 /* mdstat responds to poll */
9e33d556 1382 c.delay = 1000;
ddc7201f 1383 else
9e33d556 1384 c.delay = 60;
ddc7201f 1385 }
95c50205
N
1386 if (c.delay == 0)
1387 c.delay = 60;
d013a55e 1388 rv= Monitor(devlist, mailaddr, program,
95c50205
N
1389 &c, daemonise, oneshot,
1390 dosyslog, pidfile, increments,
1391 spare_sharing);
9a9dab36 1392 break;
dd0781e5
NB
1393
1394 case GROW:
a93f8c65 1395 if (array_size > 0) {
84e11361
N
1396 /* alway impose array size first, independent of
1397 * anything else
9ce510be
N
1398 * Do not allow level or raid_disks changes at the
1399 * same time as that can be irreversibly destructive.
84e11361
N
1400 */
1401 struct mdinfo sra;
1402 int err;
e705e81b 1403 if (s.raiddisks || s.level != UnSet) {
e7b84f9d 1404 pr_err("cannot change array size in same operation "
9ce510be
N
1405 "as changing raiddisks or level.\n"
1406 " Change size first, then check that data is still intact.\n");
1407 rv = 1;
1408 break;
1409 }
84e11361 1410 sysfs_init(&sra, mdfd, 0);
a93f8c65 1411 if (array_size == MAX_SIZE)
84e11361
N
1412 err = sysfs_set_str(&sra, NULL, "array_size", "default");
1413 else
1414 err = sysfs_set_num(&sra, NULL, "array_size", array_size / 2);
1415 if (err < 0) {
1416 if (errno == E2BIG)
e7b84f9d 1417 pr_err("--array-size setting"
84e11361
N
1418 " is too large.\n");
1419 else
e7b84f9d 1420 pr_err("current kernel does"
84e11361
N
1421 " not support setting --array-size\n");
1422 rv = 1;
1423 break;
1424 }
1425 }
e705e81b 1426 if (devs_found > 1 && s.raiddisks == 0) {
e5329c37 1427 /* must be '-a'. */
e705e81b 1428 if (s.size > 0 || s.chunk || s.layout_str != NULL || s.bitmap_file) {
e7b84f9d 1429 pr_err("--add cannot be used with "
e2e53a2d 1430 "other geometry changes in --grow mode\n");
e5329c37
NB
1431 rv = 1;
1432 break;
1433 }
1434 for (dv=devlist->next; dv ; dv=dv->next) {
e2e53a2d
N
1435 rv = Grow_Add_device(devlist->devname, mdfd,
1436 dv->devname);
e5329c37
NB
1437 if (rv)
1438 break;
1439 }
e705e81b
N
1440 } else if (s.bitmap_file) {
1441 if (s.size > 0 || s.raiddisks || s.chunk ||
1442 s.layout_str != NULL || devs_found > 1) {
e7b84f9d 1443 pr_err("--bitmap changes cannot be "
e2e53a2d
N
1444 "used with other geometry changes "
1445 "in --grow mode\n");
7236ee7a
N
1446 rv = 1;
1447 break;
1448 }
9e33d556
N
1449 if (c.delay == 0)
1450 c.delay = DEFAULT_BITMAP_DELAY;
50f01ba5 1451 rv = Grow_addbitmap(devlist->devname, mdfd, &c, &s);
2dddadb0
AK
1452 } else if (grow_continue)
1453 rv = Grow_continue_command(devlist->devname,
9e33d556 1454 mdfd, c.backup_file,
0937132d 1455 c.verbose);
e705e81b
N
1456 else if (s.size > 0 || s.raiddisks || s.layout_str != NULL
1457 || s.chunk != 0 || s.level != UnSet) {
32754b7d
N
1458 rv = Grow_reshape(devlist->devname, mdfd,
1459 devlist->next, &c, &s);
a93f8c65 1460 } else if (array_size == 0)
e7b84f9d 1461 pr_err("no changes to --grow\n");
dd0781e5 1462 break;
8382f19b
NB
1463 case INCREMENTAL:
1464 if (rebuild_map) {
1465 RebuildMap();
1466 }
9e33d556
N
1467 if (c.scan) {
1468 if (c.runstop <= 0) {
e7b84f9d 1469 pr_err("--incremental --scan meaningless without --run.\n");
8382f19b
NB
1470 break;
1471 }
29ba4804 1472 if (devmode == 'f') {
e7b84f9d 1473 pr_err("--incremental --scan --fail not supported.\n");
29ba4804
N
1474 break;
1475 }
0937132d 1476 rv = IncrementalScan(c.verbose);
8382f19b
NB
1477 }
1478 if (!devlist) {
9e33d556 1479 if (!rebuild_map && !c.scan) {
e7b84f9d 1480 pr_err("--incremental requires a device.\n");
8382f19b
NB
1481 rv = 1;
1482 }
1483 break;
1484 }
1485 if (devlist->next) {
e7b84f9d 1486 pr_err("--incremental can only handle one device.\n");
8382f19b
NB
1487 rv = 1;
1488 break;
1489 }
950bc344
PC
1490 if (devmode == 'f')
1491 rv = IncrementalRemove(devlist->devname, remove_path,
0937132d 1492 c.verbose);
950bc344 1493 else
11b6d91d 1494 rv = Incremental(devlist->devname, &c, ss);
1f48664b
NB
1495 break;
1496 case AUTODETECT:
1497 autodetect();
1498 break;
64c4757e 1499 }
52826846 1500 exit(rv);
64c4757e 1501}
3cbc4d12 1502
4977146a
N
1503static int scan_assemble(struct supertype *ss,
1504 struct context *c,
1505 struct mddev_ident *ident)
3cbc4d12
N
1506{
1507 struct mddev_ident *a, *array_list = conf_get_ident(NULL);
1508 struct mddev_dev *devlist = conf_get_devs();
1509 struct map_ent *map = NULL;
1510 int cnt = 0;
1511 int rv = 0;
1512 int failures, successes;
1513
1514 if (conf_verify_devnames(array_list)) {
e7b84f9d
N
1515 pr_err("Duplicate MD device names in "
1516 "conf file were found.\n");
3cbc4d12
N
1517 return 1;
1518 }
1519 if (devlist == NULL) {
e7b84f9d 1520 pr_err("No devices listed in conf file were found.\n");
3cbc4d12
N
1521 return 1;
1522 }
1523 for (a = array_list; a ; a = a->next) {
1524 a->assembled = 0;
1525 if (a->autof == 0)
4977146a 1526 a->autof = c->autof;
3cbc4d12
N
1527 }
1528 if (map_lock(&map))
e7b84f9d
N
1529 pr_err("%s: failed to get "
1530 "exclusive lock on mapfile\n",
1531 __func__);
3cbc4d12
N
1532 do {
1533 failures = 0;
1534 successes = 0;
1535 rv = 0;
1536 for (a = array_list; a ; a = a->next) {
1537 int r;
1538 if (a->assembled)
1539 continue;
1540 if (a->devname &&
1541 strcasecmp(a->devname, "<ignore>") == 0)
1542 continue;
1543
1544 r = Assemble(ss, a->devname,
4977146a 1545 a, NULL, c);
3cbc4d12
N
1546 if (r == 0) {
1547 a->assembled = 1;
1548 successes++;
1549 } else
1550 failures++;
1551 rv |= r;
1552 cnt++;
1553 }
1554 } while (failures && successes);
4977146a 1555 if (c->homehost && cnt == 0) {
3cbc4d12
N
1556 /* Maybe we can auto-assemble something.
1557 * Repeatedly call Assemble in auto-assemble mode
1558 * until it fails
1559 */
1560 int rv2;
1561 int acnt;
4977146a 1562 ident->autof = c->autof;
3cbc4d12
N
1563 do {
1564 struct mddev_dev *devlist = conf_get_devs();
1565 acnt = 0;
1566 do {
1567 rv2 = Assemble(ss, NULL,
1568 ident,
4977146a 1569 devlist, c);
3cbc4d12
N
1570 if (rv2==0) {
1571 cnt++;
1572 acnt++;
1573 }
1574 } while (rv2!=2);
1575 /* Incase there are stacked devices, we need to go around again */
1576 } while (acnt);
1577 if (cnt == 0 && rv == 0) {
e7b84f9d 1578 pr_err("No arrays found in config file or automatically\n");
3cbc4d12
N
1579 rv = 1;
1580 } else if (cnt)
1581 rv = 0;
1582 } else if (cnt == 0 && rv == 0) {
e7b84f9d 1583 pr_err("No arrays found in config file\n");
3cbc4d12
N
1584 rv = 1;
1585 }
1586 map_unlock(&map);
1587 return rv;
1588}
7d27d1c0 1589
ef898ce6 1590static int misc_scan(char devmode, struct context *c)
7d27d1c0
N
1591{
1592 /* apply --detail or --wait-clean to
1593 * all devices in /proc/mdstat
1594 */
1595 struct mdstat_ent *ms = mdstat_read(0, 1);
1596 struct mdstat_ent *e;
1597 struct map_ent *map = NULL;
1598 int members;
7d27d1c0
N
1599 int rv = 0;
1600
1601 for (members = 0; members <= 1; members++) {
1602 for (e=ms ; e ; e=e->next) {
1603 char *name;
1604 struct map_ent *me;
1605 int member = e->metadata_version &&
1606 strncmp(e->metadata_version,
1607 "external:/", 10) == 0;
1608 if (members != member)
1609 continue;
1610 me = map_by_devnum(&map, e->devnum);
1611 if (me && me->path
1612 && strcmp(me->path, "/unknown") != 0)
1613 name = me->path;
1614 else
1615 name = get_md_name(e->devnum);
1616
1617 if (!name) {
e7b84f9d 1618 pr_err("cannot find device file for %s\n",
7d27d1c0
N
1619 e->dev);
1620 continue;
1621 }
1622 if (devmode == 'D')
ef898ce6 1623 rv |= Detail(name, c);
7d27d1c0 1624 else
ef898ce6 1625 rv |= WaitClean(name, -1, c->verbose);
7d27d1c0
N
1626 put_md_name(name);
1627 }
1628 }
1629 free_mdstat(ms);
1630 return rv;
1631}
1632
ba728be7 1633static int stop_scan(int verbose)
7d27d1c0
N
1634{
1635 /* apply --stop to all devices in /proc/mdstat */
1636 /* Due to possible stacking of devices, repeat until
1637 * nothing more can be stopped
1638 */
1639 int progress=1, err;
1640 int last = 0;
1641 int rv = 0;
1642 do {
1643 struct mdstat_ent *ms = mdstat_read(0, 0);
1644 struct mdstat_ent *e;
1645
1646 if (!progress) last = 1;
1647 progress = 0; err = 0;
1648 for (e=ms ; e ; e=e->next) {
1649 char *name = get_md_name(e->devnum);
1650 int mdfd;
1651
1652 if (!name) {
e7b84f9d 1653 pr_err("cannot find device file for %s\n",
7d27d1c0
N
1654 e->dev);
1655 continue;
1656 }
1657 mdfd = open_mddev(name, 1);
1658 if (mdfd >= 0) {
ba728be7 1659 if (Manage_runstop(name, mdfd, -1, verbose, !last))
7d27d1c0
N
1660 err = 1;
1661 else
1662 progress = 1;
1663 close(mdfd);
1664 }
1665
1666 put_md_name(name);
1667 }
1668 free_mdstat(ms);
1669 } while (!last && err);
1670 if (err)
1671 rv |= 1;
1672 return rv;
1673}
1674
1675static int misc_list(struct mddev_dev *devlist,
86da243f
N
1676 struct mddev_ident *ident,
1677 struct supertype *ss, struct context *c)
7d27d1c0
N
1678{
1679 struct mddev_dev *dv;
1680 int rv = 0;
1681
1682 for (dv=devlist ; dv; dv=dv->next) {
1683 int mdfd;
1684
1685 switch(dv->disposition) {
1686 case 'D':
ef898ce6 1687 rv |= Detail(dv->devname, c);
7d27d1c0
N
1688 continue;
1689 case KillOpt: /* Zero superblock */
1690 if (ss)
86da243f 1691 rv |= Kill(dv->devname, ss, c->force, c->verbose,0);
7d27d1c0 1692 else {
86da243f 1693 int v = c->verbose;
7d27d1c0 1694 do {
86da243f 1695 rv |= Kill(dv->devname, NULL, c->force, v, 0);
ba728be7 1696 v = -1;
7d27d1c0
N
1697 } while (rv == 0);
1698 rv &= ~2;
1699 }
1700 continue;
1701 case 'Q':
1702 rv |= Query(dv->devname); continue;
1703 case 'X':
86da243f 1704 rv |= ExamineBitmap(dv->devname, c->brief, ss); continue;
7d27d1c0
N
1705 case 'W':
1706 case WaitOpt:
1707 rv |= Wait(dv->devname); continue;
1708 case Waitclean:
86da243f 1709 rv |= WaitClean(dv->devname, -1, c->verbose); continue;
7d27d1c0 1710 case KillSubarray:
86da243f 1711 rv |= Kill_subarray(dv->devname, c->subarray, c->verbose);
7d27d1c0
N
1712 continue;
1713 case UpdateSubarray:
86da243f 1714 if (c->update == NULL) {
e7b84f9d 1715 pr_err("-U/--update must be specified with --update-subarray\n");
7d27d1c0
N
1716 rv |= 1;
1717 continue;
1718 }
86da243f
N
1719 rv |= Update_subarray(dv->devname, c->subarray,
1720 c->update, ident, c->verbose);
7d27d1c0
N
1721 continue;
1722 }
1723 mdfd = open_mddev(dv->devname, 1);
1724 if (mdfd>=0) {
1725 switch(dv->disposition) {
1726 case 'R':
86da243f 1727 rv |= Manage_runstop(dv->devname, mdfd, 1, c->verbose, 0); break;
7d27d1c0 1728 case 'S':
86da243f 1729 rv |= Manage_runstop(dv->devname, mdfd, -1, c->verbose, 0); break;
7d27d1c0
N
1730 case 'o':
1731 rv |= Manage_ro(dv->devname, mdfd, 1); break;
1732 case 'w':
1733 rv |= Manage_ro(dv->devname, mdfd, -1); break;
1734 }
1735 close(mdfd);
1736 } else
1737 rv |= 1;
1738 }
1739 return rv;
1740}