2 * mdadm - manage Linux "md" devices aka RAID arrays.
4 * Copyright (C) 2001-2012 Neil Brown <neilb@suse.de>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 * Email: <neilb@suse.de>
30 int Detail(char *dev, struct context *c)
33 * Print out details for an md array by using
34 * GET_ARRAY_INFO and GET_DISK_INFO ioctl calls
37 int fd = open(dev, O_RDONLY);
39 mdu_array_info_t array;
40 mdu_disk_info_t *disks;
48 int is_26 = get_linux_version() >= 2006000;
49 int is_rebuilding = 0;
52 char *subarray = NULL;
53 int max_disks = MD_SB_DISKS; /* just a default */
54 struct mdinfo *info = NULL;
57 char *container = NULL;
59 int rv = c->test ? 4 : 1;
64 pr_err("cannot open %s: %s\n",
65 dev, strerror(errno));
68 vers = md_get_version(fd);
70 pr_err("%s does not appear to be an md device\n",
76 pr_err("cannot get detail for md device %s: driver version too old.\n",
81 if (ioctl(fd, GET_ARRAY_INFO, &array)<0) {
83 pr_err("md device %s does not appear to be active.\n",
86 pr_err("cannot get array detail for %s: %s\n",
87 dev, strerror(errno));
91 sra = sysfs_read(fd, NULL, GET_VERSION);
92 st = super_by_fd(fd, &subarray);
94 if (fstat(fd, &stb) != 0 && !S_ISBLK(stb.st_mode))
99 max_disks = st->max_devs;
102 /* This is a subarray of some container.
103 * We want the name of the container, and the member
105 int devid = devnm2devid(st->container_devnm);
108 container = map_dev_preferred(major(devid), minor(devid),
112 /* try to load a superblock */
113 if (st) for (d = 0; d < max_disks; d++) {
114 mdu_disk_info_t disk;
119 if (ioctl(fd, GET_DISK_INFO, &disk) < 0)
121 if (d >= array.raid_disks &&
126 if (array.raid_disks > 0 &&
127 (disk.state & (1 << MD_DISK_ACTIVE)) == 0)
130 dv = map_dev(disk.major, disk.minor, 1);
134 fd2 = dev_open(dv, O_RDONLY);
139 st->ss->free_super(st);
141 err = st->ss->load_super(st, fd2, NULL);
148 info = st->ss->container_content(st, subarray);
150 info = xmalloc(sizeof(*info));
151 st->ss->getinfo_super(st, info, NULL);
156 if (array.raid_disks != 0 && /* container */
157 (info->array.ctime != array.ctime ||
158 info->array.level != array.level)) {
159 st->ss->free_super(st);
162 /* some formats (imsm) have free-floating-spares
163 * with a uuid of uuid_zero, they don't
164 * have very good info about the rest of the
165 * container, so keep searching when
166 * encountering such a device. Otherwise, stop
167 * after the first successful call to
170 if (memcmp(uuid_zero,
172 sizeof(uuid_zero)) == 0) {
173 st->ss->free_super(st);
179 /* Ok, we have some info to print... */
180 str = map_num(pers, array.level);
183 if (array.raid_disks) {
185 printf("MD_LEVEL=%s\n", str);
186 printf("MD_DEVICES=%d\n", array.raid_disks);
188 printf("MD_LEVEL=container\n");
189 printf("MD_DEVICES=%d\n", array.nr_disks);
192 printf("MD_CONTAINER=%s\n", container);
193 printf("MD_MEMBER=%s\n", member);
195 if (sra && sra->array.major_version < 0)
196 printf("MD_METADATA=%s\n", sra->text_version);
198 printf("MD_METADATA=%d.%d\n",
199 array.major_version, array.minor_version);
202 if (st && st->sb && info) {
204 struct map_ent *mp, *map = NULL;
206 fname_from_uuid(st, info, nbuf, ':');
207 printf("MD_UUID=%s\n", nbuf+5);
208 mp = map_by_uuid(&map, info->uuid);
209 if (mp && mp->path &&
210 strncmp(mp->path, "/dev/md/", 8) == 0) {
211 printf("MD_DEVNAME=");
212 print_escape(mp->path+8);
216 if (st->ss->export_detail_super)
217 st->ss->export_detail_super(st);
219 struct map_ent *mp, *map = NULL;
221 mp = map_by_devnm(&map, fd2devnm(fd));
223 __fname_from_uuid(mp->uuid, 0, nbuf, ':');
224 printf("MD_UUID=%s\n", nbuf+5);
226 if (mp && mp->path &&
227 strncmp(mp->path, "/dev/md/", 8) == 0) {
228 printf("MD_DEVNAME=");
229 print_escape(mp->path+8);
236 disks = xmalloc(max_disks * sizeof(mdu_disk_info_t));
237 for (d = 0; d < max_disks; d++) {
238 disks[d].state = (1<<MD_DISK_REMOVED);
239 disks[d].major = disks[d].minor = 0;
240 disks[d].number = disks[d].raid_disk = d;
243 next = array.raid_disks*2;
244 for (d = 0; d < max_disks; d++) {
245 mdu_disk_info_t disk;
247 if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
248 if (d < array.raid_disks)
249 pr_err("cannot get device detail for device %d: %s\n",
253 if (disk.major == 0 && disk.minor == 0)
255 if (disk.raid_disk >= 0 && disk.raid_disk < array.raid_disks
256 && disks[disk.raid_disk*2].state == (1<<MD_DISK_REMOVED))
257 disks[disk.raid_disk*2] = disk;
258 else if (disk.raid_disk >= 0 && disk.raid_disk < array.raid_disks
259 && disks[disk.raid_disk*2+1].state == (1<<MD_DISK_REMOVED))
260 disks[disk.raid_disk*2+1] = disk;
261 else if (next < max_disks)
262 disks[next++] = disk;
265 avail = xcalloc(array.raid_disks, 1);
267 for (d= 0; d < array.raid_disks; d++) {
269 if ((disks[d*2].state & (1<<MD_DISK_SYNC)) ||
270 (disks[d*2+1].state & (1<<MD_DISK_SYNC))) {
277 mdu_bitmap_file_t bmf;
278 printf("ARRAY %s", dev);
280 if (array.raid_disks)
281 printf(" level=%s num-devices=%d",
285 printf(" level=container num-devices=%d",
289 printf(" container=%s", container);
290 printf(" member=%s", member);
292 if (sra && sra->array.major_version < 0)
293 printf(" metadata=%s", sra->text_version);
295 printf(" metadata=%d.%d",
296 array.major_version, array.minor_version);
299 /* Only try GET_BITMAP_FILE for 0.90.01 and later */
301 ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
303 printf(" bitmap=%s", bmf.pathname);
306 mdu_bitmap_file_t bmf;
307 unsigned long long larray_size;
308 struct mdstat_ent *ms = mdstat_read(0, 0);
309 struct mdstat_ent *e;
312 devnm = stat2devnm(&stb);
313 for (e=ms; e; e=e->next)
314 if (strcmp(e->devnm, devnm) == 0)
316 if (!get_dev_size(fd, NULL, &larray_size))
319 printf("%s:\n", dev);
322 printf(" Container : %s, member %s\n", container, member);
324 if (sra && sra->array.major_version < 0)
325 printf(" Version : %s\n", sra->text_version);
327 printf(" Version : %d.%d\n",
328 array.major_version, array.minor_version);
333 printf(" Creation Time : %.24s\n", ctime(&atime));
334 if (array.raid_disks == 0)
336 printf(" Raid Level : %s\n", str?str:"-unknown-");
338 printf(" Array Size : %llu%s\n", (larray_size>>10),
339 human_size(larray_size));
340 if (array.level >= 1) {
342 array.major_version = sra->array.major_version;
343 if (array.major_version != 0 &&
344 (larray_size >= 0xFFFFFFFFULL|| array.size == 0)) {
345 unsigned long long dsize = get_component_size(fd);
347 printf(" Used Dev Size : %llu%s\n",
349 human_size((long long)dsize<<9));
351 printf(" Used Dev Size : unknown\n");
353 printf(" Used Dev Size : %d%s\n", array.size,
354 human_size((long long)array.size<<10));
356 if (array.raid_disks)
357 printf(" Raid Devices : %d\n", array.raid_disks);
358 printf(" Total Devices : %d\n", array.nr_disks);
360 ((sra == NULL && array.major_version == 0) ||
361 (sra && sra->array.major_version == 0)))
362 printf("Preferred Minor : %d\n", array.md_minor);
363 if (sra == NULL || sra->array.major_version >= 0)
364 printf(" Persistence : Superblock is %spersistent\n",
365 array.not_persistent?"not ":"");
367 /* Only try GET_BITMAP_FILE for 0.90.01 and later */
369 ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
371 printf(" Intent Bitmap : %s\n", bmf.pathname);
373 } else if (array.state & (1<<MD_SB_BITMAP_PRESENT))
374 printf(" Intent Bitmap : Internal\n\n");
377 printf(" Update Time : %.24s\n", ctime(&atime));
378 if (array.raid_disks) {
379 static char *sync_action[] = {
380 ", recovering", ", resyncing",
381 ", reshaping", ", checking" };
383 if (avail_disks == array.raid_disks)
385 else if (!enough(array.level, array.raid_disks,
386 array.layout, 1, avail))
391 printf(" State : %s%s%s%s%s%s \n",
392 (array.state&(1<<MD_SB_CLEAN))?"clean":"active", st,
393 (!e || (e->percent < 0 && e->percent != RESYNC_PENDING &&
394 e->percent != RESYNC_DELAYED)) ? "" : sync_action[e->resync],
395 larray_size ? "": ", Not Started",
396 e->percent == RESYNC_DELAYED ? " (DELAYED)": "",
397 e->percent == RESYNC_PENDING ? " (PENDING)": "");
399 if (array.raid_disks)
400 printf(" Active Devices : %d\n", array.active_disks);
401 printf("Working Devices : %d\n", array.working_disks);
402 if (array.raid_disks) {
403 printf(" Failed Devices : %d\n", array.failed_disks);
404 printf(" Spare Devices : %d\n", array.spare_disks);
407 if (array.level == 5) {
408 str = map_num(r5layout, array.layout);
409 printf(" Layout : %s\n", str?str:"-unknown-");
411 if (array.level == 6) {
412 str = map_num(r6layout, array.layout);
413 printf(" Layout : %s\n", str?str:"-unknown-");
415 if (array.level == 10) {
417 print_r10_layout(array.layout);
420 switch (array.level) {
426 if (array.chunk_size)
427 printf(" Chunk Size : %dK\n\n",
428 array.chunk_size/1024);
431 printf(" Rounding : %dK\n\n", array.chunk_size/1024);
436 if (e && e->percent >= 0) {
437 static char *sync_action[] = {
440 printf(" %7s Status : %d%% complete\n", sync_action[e->resync], e->percent);
445 if ((st && st->sb) && (info && info->reshape_active)) {
447 This is pretty boring
448 printf(" Reshape pos'n : %llu%s\n", (unsigned long long) info->reshape_progress<<9,
449 human_size((unsigned long long)info->reshape_progress<<9));
451 if (info->delta_disks != 0)
452 printf(" Delta Devices : %d, (%d->%d)\n",
454 array.raid_disks - info->delta_disks,
456 if (info->new_level != array.level) {
457 str = map_num(pers, info->new_level);
458 printf(" New Level : %s\n", str?str:"-unknown-");
460 if (info->new_level != array.level ||
461 info->new_layout != array.layout) {
462 if (info->new_level == 5) {
463 str = map_num(r5layout, info->new_layout);
464 printf(" New Layout : %s\n",
465 str?str:"-unknown-");
467 if (info->new_level == 6) {
468 str = map_num(r6layout, info->new_layout);
469 printf(" New Layout : %s\n",
470 str?str:"-unknown-");
472 if (info->new_level == 10) {
473 printf(" New Layout : near=%d, %s=%d\n",
474 info->new_layout&255,
475 (info->new_layout&0x10000)?"offset":"far",
476 (info->new_layout>>8)&255);
479 if (info->new_chunk != array.chunk_size)
480 printf(" New Chunksize : %dK\n", info->new_chunk/1024);
482 } else if (e && e->percent >= 0)
485 st->ss->detail_super(st, c->homehost);
487 if (array.raid_disks == 0 && sra && sra->array.major_version == -1
488 && sra->array.minor_version == -2 && sra->text_version[0] != '/') {
489 /* This looks like a container. Find any active arrays
490 * That claim to be a member.
492 DIR *dir = opendir("/sys/block");
495 printf(" Member Arrays :");
497 while (dir && (de = readdir(dir)) != NULL) {
500 int nlen = strlen(sra->sys_name);
502 if (de->d_name[0] == '.')
504 sprintf(path, "/sys/block/%s/md/metadata_version",
506 if (load_sys(path, vbuf) < 0)
508 if (strncmp(vbuf, "external:", 9) != 0 ||
509 !is_subarray(vbuf+9) ||
510 strncmp(vbuf+10, sra->sys_name, nlen) != 0 ||
511 vbuf[10+nlen] != '/')
513 devid = devnm2devid(de->d_name);
514 printf(" %s", map_dev_preferred(
516 minor(devid), 1, c->prefer));
523 if (array.raid_disks)
524 printf(" Number Major Minor RaidDevice State\n");
526 printf(" Number Major Minor RaidDevice\n");
530 for (d= 0; d < max_disks; d++) {
532 mdu_disk_info_t disk = disks[d];
534 if (d >= array.raid_disks*2 &&
543 if (d == array.raid_disks*2) printf("\n");
544 if (disk.raid_disk < 0)
545 printf(" %5d %5d %5d - ",
546 disk.number, disk.major, disk.minor);
548 printf(" %5d %5d %5d %5d ",
549 disk.number, disk.major, disk.minor, disk.raid_disk);
551 if (!c->brief && array.raid_disks) {
553 if (disk.state & (1<<MD_DISK_FAULTY)) {
555 if (disk.raid_disk < array.raid_disks &&
559 if (disk.state & (1<<MD_DISK_ACTIVE)) printf(" active");
560 if (disk.state & (1<<MD_DISK_SYNC)) {
562 if (array.level == 10 && (array.layout & ~0x1FFFF) == 0) {
563 int nc = array.layout & 0xff;
564 int fc = (array.layout >> 8) & 0xff;
566 if (fc == 1 && array.raid_disks % copies == 0 && copies <= 26) {
567 /* We can divide the devices into 'sets' */
568 int set = disk.raid_disk % copies;
569 printf(" set-%c", set + 'A');
573 if (disk.state & (1<<MD_DISK_REMOVED)) printf(" removed");
574 if (disk.state & (1<<MD_DISK_WRITEMOSTLY)) printf(" writemostly");
576 ((1<<MD_DISK_ACTIVE)|(1<<MD_DISK_SYNC)
577 |(1<<MD_DISK_REMOVED)|(1<<MD_DISK_FAULTY)))
581 if (disk.raid_disk < array.raid_disks && disk.raid_disk >= 0)
582 printf(" rebuilding");
583 } else if (is_rebuilding && failed) {
584 /* Taking a bit of a risk here, we remove the
585 * device from the array, and then put it back.
586 * If this fails, we are rebuilding
588 int err = ioctl(fd, HOT_REMOVE_DISK, makedev(disk.major, disk.minor));
589 if (err == 0) ioctl(fd, HOT_ADD_DISK, makedev(disk.major, disk.minor));
590 if (err && errno == EBUSY)
591 printf(" rebuilding");
595 if (disk.state == 0) spares++;
596 if (c->test && d < array.raid_disks
597 && !(disk.state & (1<<MD_DISK_SYNC)))
599 dv=map_dev_preferred(disk.major, disk.minor, 0, c->prefer);
603 devices = xrealloc(devices,
604 strlen(devices)+1+strlen(dv)+1);
605 strcat(strcat(devices,","),dv);
607 devices = xstrdup(dv);
611 if (!c->brief) printf("\n");
613 if (spares && c->brief && array.raid_disks) printf(" spares=%d", spares);
614 if (c->brief && st && st->sb)
615 st->ss->brief_detail_super(st);
617 st->ss->free_super(st);
619 if (c->brief > 1 && devices) printf("\n devices=%s", devices);
623 !enough(array.level, array.raid_disks, array.layout,
636 int Detail_Platform(struct superswitch *ss, int scan, int verbose, int export, char *controller_path)
638 /* display platform capabilities for the given metadata format
639 * 'scan' in this context means iterate over all metadata types
644 if (ss && export && ss->export_detail_platform)
645 err = ss->export_detail_platform(verbose, controller_path);
646 else if (ss && ss->detail_platform)
647 err = ss->detail_platform(verbose, 0, controller_path);
650 pr_err("%s metadata is platform independent\n",
651 ss->name ? : "[no name]");
654 pr_err("specify a metadata type or --scan\n");
661 for (i = 0; superlist[i]; i++) {
662 struct superswitch *meta = superlist[i];
667 pr_err("checking metadata %s\n",
668 meta->name ? : "[no name]");
669 if (!meta->detail_platform) {
671 pr_err("%s metadata is platform independent\n",
672 meta->name ? : "[no name]");
673 } else if (export && meta->export_detail_platform) {
674 err |= meta->export_detail_platform(verbose, controller_path);
676 err |= meta->detail_platform(verbose, 0, controller_path);