X-Git-Url: http://git.ipfire.org/?p=thirdparty%2Fmdadm.git;a=blobdiff_plain;f=Detail.c;h=e0817aac20298c442ea32f59b33ad7298d92171e;hp=9b04efdaa02d56f9efb48f3f21b861731629dc8f;hb=0592faeb5e693d4317fb85d5ab013697a21c301d;hpb=aa88f531b468349982905ecacf11da2cb6678ce6

diff --git a/Detail.c b/Detail.c
index 9b04efda..e0817aac 100644
--- a/Detail.c
+++ b/Detail.c
@@ -1,7 +1,7 @@
 /*
  * mdadm - manage Linux "md" devices aka RAID arrays.
  *
- * Copyright (C) 2001-2002 Neil Brown <neilb@cse.unsw.edu.au>
+ * Copyright (C) 2001-2009 Neil Brown <neilb@suse.de>
  *
  *
  *    This program is free software; you can redistribute it and/or modify
@@ -19,53 +19,63 @@
  *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  *
  *    Author: Neil Brown
- *    Email: <neilb@cse.unsw.edu.au>
- *    Paper: Neil Brown
- *           School of Computer Science and Engineering
- *           The University of New South Wales
- *           Sydney, 2052
- *           Australia
+ *    Email: <neilb@suse.de>
  */
 
 #include	"mdadm.h"
 #include	"md_p.h"
 #include	"md_u.h"
+#include	<dirent.h>
 
-int Detail(char *dev, int brief)
+int Detail(char *dev, int brief, int export, int test, char *homehost)
 {
 	/*
 	 * Print out details for an md array by using
 	 * GET_ARRAY_INFO and GET_DISK_INFO ioctl calls
 	 */
 
-	int fd = open(dev, O_RDONLY, 0);
+	int fd = open(dev, O_RDONLY);
 	int vers;
 	mdu_array_info_t array;
+	mdu_disk_info_t *disks;
+	int next;
 	int d;
 	time_t atime;
 	char *c;
 	char *devices = NULL;
+	int spares = 0;
+	struct stat stb;
+	int is_26 = get_linux_version() >= 2006000;
+	int is_rebuilding = 0;
+	int failed = 0;
+	struct supertype *st;
+	int max_disks = MD_SB_DISKS; /* just a default */
+	struct mdinfo info;
+	struct mdinfo *sra;
+	char *member = NULL;
+	char *container = NULL;
 
-	mdp_super_t super;
-	int have_super = 0;
+	int rv = test ? 4 : 1;
+	int avail_disks = 0;
+	char *avail;
 
 	if (fd < 0) {
 		fprintf(stderr, Name ": cannot open %s: %s\n",
 			dev, strerror(errno));
-		return 1;
+		return rv;
 	}
 	vers = md_get_version(fd);
 	if (vers < 0) {
 		fprintf(stderr, Name ": %s does not appear to be an md device\n",
 			dev);
 		close(fd);
-		return 1;
+		return rv;
 	}
 	if (vers < 9000) {
 		fprintf(stderr, Name ": cannot get detail for md device %s: driver version too old.\n",
 			dev);
 		close(fd);
-		return 1;
+		return rv;
 	}
 	if (ioctl(fd, GET_ARRAY_INFO, &array)<0) {
 		if (errno == ENODEV)
@@ -75,96 +85,475 @@ int Detail(char *dev, int brief)
 			fprintf(stderr, Name ": cannot get array detail for %s: %s\n",
 				dev, strerror(errno));
 		close(fd);
-		return 1;
+		return rv;
 	}
+	sra = sysfs_read(fd, 0, GET_VERSION);
+	st = super_by_fd(fd);
+
+	if (fstat(fd, &stb) != 0 && !S_ISBLK(stb.st_mode))
+		stb.st_rdev = 0;
+	rv = 0;
+
+	if (st)
+		max_disks = st->max_devs;
+
+	if (sra && is_subarray(sra->text_version) &&
+		strchr(sra->text_version+1, '/')) {
+		/* This is a subarray of some container.
+		 * We want the name of the container, and the member
+		 */
+		char *s = strchr(sra->text_version+1, '/');
+		int dn;
+		*s++ = '\0';
+		member = s;
+		dn = devname2devnum(sra->text_version+1);
+		container = map_dev(dev2major(dn), dev2minor(dn), 1);
+	}
+
+	/* try to load a superblock */
+	if (st) for (d = 0; d < max_disks; d++) {
+		mdu_disk_info_t disk;
+		char *dv;
+		int fd2;
+		int err;
+		disk.number = d;
+		if (ioctl(fd, GET_DISK_INFO, &disk) < 0)
+			continue;
+		if (d >= array.raid_disks &&
+		    disk.major == 0 &&
+		    disk.minor == 0)
+			continue;
+
+		if (array.raid_disks > 0 &&
+		    (disk.state & (1 << MD_DISK_ACTIVE)) == 0)
+			continue;
+
+		dv = map_dev(disk.major, disk.minor, 1);
+		if (!dv)
+			continue;
+
+		fd2 = dev_open(dv, O_RDONLY);
+		if (fd2 < 0)
+			continue;
+
+		if (st->sb)
+			st->ss->free_super(st);
+
+		err = st->ss->load_super(st, fd2, NULL);
+		close(fd2);
+		if (err)
+			continue;
+		st->ss->getinfo_super(st, &info);
+
+		if (array.raid_disks != 0 && /* container */
+		    (info.array.ctime != array.ctime ||
+		     info.array.level != array.level)) {
+			st->ss->free_super(st);
+			continue;
+		}
+		/* some formats (imsm) have free-floating-spares
+		 * with a uuid of uuid_match_any, they don't
+		 * have very good info about the rest of the
+		 * container, so keep searching when
+		 * encountering such a device.  Otherwise, stop
+		 * after the first successful call to
+		 * ->load_super.
+		 */
+		if (memcmp(uuid_match_any,
+			   info.uuid,
+			   sizeof(uuid_match_any)) == 0) {
+			st->ss->free_super(st);
+			continue;
+		}
+		break;
+	}
+
 	/* Ok, we have some info to print... */
 	c = map_num(pers, array.level);
-	if (brief) 
-		printf("ARRAY %s level=%s num-devices=%d", dev, c?c:"-unknown-",array.raid_disks );
-	else {
-		unsigned long array_size;
-		unsigned long long larray_size;
-#ifdef BLKGETSIZE64
-		if (ioctl(fd, BLKGETSIZE64, &larray_size)==0)
-			;
-		else
-#endif
-			if (ioctl(fd, BLKGETSIZE, &array_size)==0) {
-				larray_size = array_size;
-				larray_size <<= 9;
-			}
+
+	if (export) {
+		if (array.raid_disks) {
+			if (c)
+				printf("MD_LEVEL=%s\n", c);
+			printf("MD_DEVICES=%d\n", array.raid_disks);
+		} else {
+			printf("MD_LEVEL=container\n");
+			printf("MD_DEVICES=%d\n", array.nr_disks);
+		}
+		if (container) {
+			printf("MD_CONTAINER=%s\n", container);
+			printf("MD_MEMBER=%s\n", member);
+		} else {
+			if (sra && sra->array.major_version < 0)
+				printf("MD_METADATA=%s\n", sra->text_version);
+			else
+				printf("MD_METADATA=%d.%d\n",
+				       array.major_version, array.minor_version);
+		}
 		
-		else larray_size = 0;
+		if (st && st->sb) {
+			char nbuf[64];
+			struct map_ent *mp, *map = NULL;
+
+			fname_from_uuid(st, &info, nbuf, ':');
+			printf("MD_UUID=%s\n", nbuf+5);
+			mp = map_by_uuid(&map, info.uuid);
+			if (mp && mp->path &&
+			    strncmp(mp->path, "/dev/md/", 8) == 0)
+				printf("MD_DEVNAME=%s\n", mp->path+8);
+
+			if (st->ss->export_detail_super)
+				st->ss->export_detail_super(st);
+		} else {
+			struct map_ent *mp, *map = NULL;
+			char nbuf[64];
+			mp = map_by_devnum(&map, fd2devnum(fd));
+			if (mp) {
+				__fname_from_uuid(mp->uuid, 0, nbuf, ':');
+				printf("MD_UUID=%s\n", nbuf+5);
+			}
+			if (mp && mp->path &&
+			    strncmp(mp->path, "/dev/md/", 8) == 0)
+				printf("MD_DEVNAME=%s\n", mp->path+8);
+		}
+		goto out;
+	}
+
+	disks = malloc(max_disks * sizeof(mdu_disk_info_t));
+	for (d=0; d<max_disks; d++) {
+		disks[d].state = (1<<MD_DISK_REMOVED);
+		disks[d].major = disks[d].minor = 0;
+		disks[d].number = disks[d].raid_disk = d;
+	}
+
+	next = array.raid_disks;
+	for (d=0; d < max_disks; d++) {
+		mdu_disk_info_t disk;
+		disk.number = d;
+		if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
+			if (d < array.raid_disks)
+				fprintf(stderr, Name ": cannot get device detail for device %d: %s\n",
+					d, strerror(errno));
+			continue;
+		}
+		if (disk.major == 0 && disk.minor == 0)
+			continue;
+		if (disk.raid_disk >= 0 && disk.raid_disk < array.raid_disks)
+			disks[disk.raid_disk] = disk;
+		else if (next < max_disks)
+			disks[next++] = disk;
+	}
+
+	avail = calloc(array.raid_disks, 1);
+
+	for (d= 0; d < array.raid_disks; d++) {
+		mdu_disk_info_t disk = disks[d];
+
+		if ((disk.state & (1<<MD_DISK_SYNC))) {
+			avail_disks ++;
+			avail[d] = 1;
+		}
+	}
+
+	if (brief) {
+		mdu_bitmap_file_t bmf;
+		printf("ARRAY %s", dev);
+		if (brief > 1) {
+			if (array.raid_disks)
+				printf(" level=%s num-devices=%d",
+				       c?c:"-unknown-",
+				       array.raid_disks );
+			else
+				printf(" level=container num-devices=%d",
+				       array.nr_disks);
+		}
+		if (container) {
+			printf(" container=%s", container);
+			printf(" member=%s", member);
+		} else {
+			if (sra && sra->array.major_version < 0)
+				printf(" metadata=%s", sra->text_version);
+			else
+				printf(" metadata=%d.%d",
+				       array.major_version, array.minor_version);
+		}
+
+		/* Only try GET_BITMAP_FILE for 0.90.01 and later */
+		if (vers >= 9001 &&
+		    ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
+		    bmf.pathname[0]) {
+			printf(" bitmap=%s", bmf.pathname);
+		}
+	} else {
+		mdu_bitmap_file_t bmf;
+		unsigned long long larray_size;
+		struct mdstat_ent *ms = mdstat_read(0, 0);
+		struct mdstat_ent *e;
+		int devnum = array.md_minor;
+		if (major(stb.st_rdev) == (unsigned)get_mdp_major())
+			devnum = -1 - devnum;
+
+		for (e=ms; e; e=e->next)
+			if (e->devnum == devnum)
+				break;
+		if (!get_dev_size(fd, NULL, &larray_size))
+			larray_size = 0;
 
 		printf("%s:\n", dev);
-		printf("        Version : %02d.%02d.%02d\n",
-		       array.major_version, array.minor_version, array.patch_version);
+
+		if (container)
+			printf("      Container : %s, member %s\n", container, member);
+		else {
+		if (sra && sra->array.major_version < 0)
+			printf("        Version : %s\n", sra->text_version);
+		else
+			printf("        Version : %d.%d\n",
+			       array.major_version, array.minor_version);
+		}
+
 		atime = array.ctime;
-		printf("  Creation Time : %.24s\n", ctime(&atime));
+		if (atime)
+			printf("  Creation Time : %.24s\n", ctime(&atime));
+		if (array.raid_disks == 0) c = "container";
 		printf("     Raid Level : %s\n", c?c:"-unknown-");
 		if (larray_size)
-		printf("     Array Size : %llu%s\n", (larray_size>>10), human_size(larray_size));
-		if (array.level >= 1)
-			printf("    Device Size : %d%s\n", array.size, human_size((long long)array.size<<10));
-		printf("   Raid Devices : %d\n", array.raid_disks);
+			printf("     Array Size : %llu%s\n", (larray_size>>10), human_size(larray_size));
+		if (array.level >= 1) {
+			if (array.major_version != 0 &&
+			    (larray_size >= 0xFFFFFFFFULL|| array.size == 0)) {
+				unsigned long long dsize = get_component_size(fd);
+				if (dsize > 0)
+					printf("  Used Dev Size : %llu%s\n",
+					       dsize/2,
+					 human_size((long long)dsize<<9));
+				else
+					printf("  Used Dev Size : unknown\n");
+			} else
+				printf("  Used Dev Size : %d%s\n", array.size,
+				       human_size((long long)array.size<<10));
+		}
+		if (array.raid_disks)
+			printf("   Raid Devices : %d\n", array.raid_disks);
 		printf("  Total Devices : %d\n", array.nr_disks);
-		printf("Preferred Minor : %d\n", array.md_minor);
-		printf("    Persistence : Superblock is %spersistent\n",
-		       array.not_persistent?"not ":"");
+		if (!container && 
+		    ((sra == NULL && array.major_version == 0) ||
+		     (sra && sra->array.major_version == 0)))
+			printf("Preferred Minor : %d\n", array.md_minor);
+		if (sra == NULL || sra->array.major_version >= 0)
+			printf("    Persistence : Superblock is %spersistent\n",
+			       array.not_persistent?"not ":"");
 		printf("\n");
+		/* Only try GET_BITMAP_FILE for 0.90.01 and later */
+		if (vers >= 9001 &&
+		    ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
+		    bmf.pathname[0]) {
+			printf("  Intent Bitmap : %s\n", bmf.pathname);
+			printf("\n");
+		} else if (array.state & (1<<MD_SB_BITMAP_PRESENT))
+			printf("  Intent Bitmap : Internal\n\n");
 		atime = array.utime;
-		printf("    Update Time : %.24s\n", ctime(&atime));
-		printf("          State : %s, %serrors\n",
-		       (array.state&(1<<MD_SB_CLEAN))?"clean":"dirty",
-		       (array.state&(1<<MD_SB_ERRORS))?"":"no-");
-		printf(" Active Devices : %d\n", array.active_disks);
+		if (atime)
+			printf("    Update Time : %.24s\n", ctime(&atime));
+		if (array.raid_disks) {
+			char *st;
+			if (avail_disks == array.raid_disks)
+				st = "";
+			else if (!enough(array.level, array.raid_disks,
+					 array.layout, 1, avail, avail_disks))
+				st = ", FAILED";
+			else
+				st = ", degraded";
+
+			printf("          State : %s%s%s%s\n",
+			       (array.state&(1<<MD_SB_CLEAN))?"clean":"active",
+			       st,
+			       (!e || e->percent < 0) ? "" :
+			       (e->resync) ? ", resyncing": ", recovering",
+			       larray_size ? "": ", Not Started");
+		}
+		if (array.raid_disks)
+			printf(" Active Devices : %d\n", array.active_disks);
 		printf("Working Devices : %d\n", array.working_disks);
-		printf(" Failed Devices : %d\n", array.failed_disks);
-		printf("  Spare Devices : %d\n", array.spare_disks);
+		if (array.raid_disks) {
+			printf(" Failed Devices : %d\n", array.failed_disks);
+			printf("  Spare Devices : %d\n", array.spare_disks);
+		}
 		printf("\n");
 		if (array.level == 5) {
 			c = map_num(r5layout, array.layout);
 			printf("         Layout : %s\n", c?c:"-unknown-");
 		}
+		if (array.level == 6) {
+			c = map_num(r6layout, array.layout);
+			printf("         Layout : %s\n", c?c:"-unknown-");
+		}
+		if (array.level == 10) {
+			printf("         Layout :");
+			print_r10_layout(array.layout);
+			printf("\n");
+		}
 		switch (array.level) {
 		case 0:
 		case 4:
 		case 5:
-			printf("     Chunk Size : %dK\n", array.chunk_size/1024);
+		case 10:
+		case 6:
+			if (array.chunk_size)
+				printf("     Chunk Size : %dK\n\n",
+				       array.chunk_size/1024);
 			break;
 		case -1:
-			printf("       Rounding : %dK\n", array.chunk_size/1024);
+			printf("       Rounding : %dK\n\n", array.chunk_size/1024);
 			break;
 		default: break;
 		}
-	
-		printf("\n");
-		printf("    Number   Major   Minor   RaidDevice State\n");
+
+		if (e && e->percent >= 0) {
+			printf(" Re%s Status : %d%% complete\n",
+			       (st && st->sb && info.reshape_active)?
+			          "shape":"build",
+			       e->percent);
+			is_rebuilding = 1;
+		}
+		free_mdstat(ms);
+
+		if (st->sb && info.reshape_active) {
+#if 0
+This is pretty boring
+			printf("  Reshape pos'n : %llu%s\n", (unsigned long long) info.reshape_progress<<9,
+			       human_size((unsigned long long)info.reshape_progress<<9));
+#endif
+			if (info.delta_disks > 0)
+				printf("  Delta Devices : %d, (%d->%d)\n",
+				       info.delta_disks, array.raid_disks - info.delta_disks, array.raid_disks);
+			if (info.delta_disks < 0)
+				printf("  Delta Devices : %d, (%d->%d)\n",
+				       info.delta_disks, array.raid_disks, array.raid_disks + info.delta_disks);
+			if (info.new_level != array.level) {
+				char *c = map_num(pers, info.new_level);
+				printf("      New Level : %s\n", c?c:"-unknown-");
+			}
+			if (info.new_level != array.level ||
+			    info.new_layout != array.layout) {
+				if (info.new_level == 5) {
+					char *c = map_num(r5layout, info.new_layout);
+					printf("     New Layout : %s\n",
+					       c?c:"-unknown-");
+				}
+				if (info.new_level == 6) {
+					char *c = map_num(r6layout, info.new_layout);
+					printf("     New Layout : %s\n",
+					       c?c:"-unknown-");
+				}
+				if (info.new_level == 10) {
+					printf("     New Layout : near=%d, %s=%d\n",
+					       info.new_layout&255,
+					       (info.new_layout&0x10000)?"offset":"far",
+					       (info.new_layout>>8)&255);
+				}
+			}
+			if (info.new_chunk != array.chunk_size)
+				printf("  New Chunksize : %dK\n", info.new_chunk/1024);
+			printf("\n");
+		} else if (e && e->percent >= 0)
+			printf("\n");
+		if (st && st->sb)
+			st->ss->detail_super(st, homehost);
+
+		if (array.raid_disks == 0 && sra && sra->array.major_version == -1
+		    && sra->array.minor_version == -2 && sra->text_version[0] != '/') {
+			/* This looks like a container.  Find any active arrays
+			 * That claim to be a member.
+			 */
+			DIR *dir = opendir("/sys/block");
+			struct dirent *de;
+
+			printf("  Member Arrays :");
+
+			while (dir && (de = readdir(dir)) != NULL) {
+				char path[200];
+				char vbuf[1024];
+				int nlen = strlen(sra->sys_name);
+				int dn;
+				if (de->d_name[0] == '.')
+					continue;
+				sprintf(path, "/sys/block/%s/md/metadata_version",
+					de->d_name);
+				if (load_sys(path, vbuf) < 0)
+					continue;
+				if (strncmp(vbuf, "external:", 9) != 0 ||
+				    !is_subarray(sra->sys_name+9) ||
+				    strncmp(vbuf+10, sra->sys_name, nlen) != 0 ||
+				    vbuf[10+nlen] != '/')
+					continue;
+				dn = devname2devnum(de->d_name);
+				printf(" %s", map_dev(dev2major(dn),
+						      dev2minor(dn), 1));
+			}
+			if (dir)
+				closedir(dir);
+			printf("\n\n");
+		}
+
+		if (array.raid_disks)
+			printf("    Number   Major   Minor   RaidDevice State\n");
+		else
+			printf("    Number   Major   Minor   RaidDevice\n");
 	}
-	for (d= 0; d<MD_SB_DISKS; d++) {
-		mdu_disk_info_t disk;
+
+	for (d= 0; d < max_disks; d++) {
 		char *dv;
-		disk.number = d;
-		if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
-			if (d < array.raid_disks)
-				fprintf(stderr, Name ": cannot get device detail for device %d: %s\n",
-					d, strerror(errno));
-			continue;
-		}
+		mdu_disk_info_t disk = disks[d];
+
 		if (d >= array.raid_disks &&
 		    disk.major == 0 &&
 		    disk.minor == 0)
 			continue;
 		if (!brief) {
-			printf("   %5d   %5d    %5d    %5d     ", 
-			       disk.number, disk.major, disk.minor, disk.raid_disk);
-			if (disk.state & (1<<MD_DISK_FAULTY)) printf(" faulty");
+			if (d == array.raid_disks) printf("\n");
+			if (disk.raid_disk < 0)
+				printf("   %5d   %5d    %5d        -     ",
+				       disk.number, disk.major, disk.minor);
+			else
+				printf("   %5d   %5d    %5d    %5d     ",
+				       disk.number, disk.major, disk.minor, disk.raid_disk);
+		}
+		if (!brief && array.raid_disks) {
+
+			if (disk.state & (1<<MD_DISK_FAULTY)) {
+				printf(" faulty");
+				if (disk.raid_disk < array.raid_disks &&
+				    disk.raid_disk >= 0)
+					failed++;
+			}
 			if (disk.state & (1<<MD_DISK_ACTIVE)) printf(" active");
 			if (disk.state & (1<<MD_DISK_SYNC)) printf(" sync");
 			if (disk.state & (1<<MD_DISK_REMOVED)) printf(" removed");
-			if (disk.state == 0) printf(" spare");
+			if (disk.state & (1<<MD_DISK_WRITEMOSTLY)) printf(" writemostly");
+			if ((disk.state &
+			     ((1<<MD_DISK_ACTIVE)|(1<<MD_DISK_SYNC)|(1<<MD_DISK_REMOVED)))
+			    == 0) {
+				printf(" spare");
+				if (is_26) {
+					if (disk.raid_disk < array.raid_disks && disk.raid_disk >= 0)
+						printf(" rebuilding");
+				} else if (is_rebuilding && failed) {
+					/* Taking a bit of a risk here, we remove the
+					 * device from the array, and then put it back.
+					 * If this fails, we are rebuilding
+					 */
+					int err = ioctl(fd, HOT_REMOVE_DISK, makedev(disk.major, disk.minor));
+					if (err == 0) ioctl(fd, HOT_ADD_DISK, makedev(disk.major, disk.minor));
+					if (err && errno ==  EBUSY)
+						printf(" rebuilding");
+				}
+			}
 		}
-		if ((dv=map_dev(disk.major, disk.minor))) {
+		if (disk.state == 0) spares++;
+		if (test && d < array.raid_disks
+		    && !(disk.state & (1<<MD_DISK_SYNC)))
+			rv |= 1;
+		if ((dv=map_dev(disk.major, disk.minor, 0))) {
 			if (brief) {
 				if (devices) {
 					devices = realloc(devices,
@@ -174,32 +563,64 @@ int Detail(char *dev, int brief)
 					devices = strdup(dv);
 			} else
 				printf("   %s", dv);
-			if (!have_super && (disk.state & (1<<MD_DISK_ACTIVE))) {
-				/* try to read the superblock from this device
-				 * to get more info
-				 */
-				int fd = open(dv, O_RDONLY);
-				if (fd >=0 &&
-				    load_super(fd, &super) ==0 &&
-				    super.ctime == array.ctime &&
-				    super.level == array.level)
-					have_super = 1;
-			}
 		}
 		if (!brief) printf("\n");
 	}
-	if (have_super) {
-		if (brief) printf(" UUID=");
-		else printf("           UUID : ");
-	    	if (super.minor_version >= 90)
-			printf("%08x:%08x:%08x:%08x", super.set_uuid0, super.set_uuid1,
-			       super.set_uuid2, super.set_uuid3);
-		else
-			printf("%08x", super.set_uuid0);
-		if (!brief) 
-			printf("\n         Events : %d.%d\n", super.events_hi, super.events_lo);
-	}
-	if (brief && devices) printf("\n   devices=%s", devices);
+	if (spares && brief && array.raid_disks) printf(" spares=%d", spares);
+	if (brief && st && st->sb)
+		st->ss->brief_detail_super(st);
+	st->ss->free_super(st);
+
+	if (brief > 1 && devices) printf("\n   devices=%s", devices);
 	if (brief) printf("\n");
-	return 0;
+	if (test &&
+	    !enough(array.level, array.raid_disks, array.layout,
+		    1, avail, avail_disks))
+		rv = 2;
+
+	free(disks);
+out:
+	close(fd);
+	return rv;
+}
+
+int Detail_Platform(struct superswitch *ss, int scan, int verbose)
+{
+	/* display platform capabilities for the given metadata format
+	 * 'scan' in this context means iterate over all metadata types
+	 */
+	int i;
+	int err = 1;
+
+	if (ss && ss->detail_platform)
+		err = ss->detail_platform(verbose, 0);
+	else if (ss) {
+		if (verbose)
+			fprintf(stderr, Name ": %s metadata is platform independent\n",
+				ss->name ? : "[no name]");
+	} else if (!scan) {
+		if (verbose)
+			fprintf(stderr, Name ": specify a metadata type or --scan\n");
+	}
+
+	if (!scan)
+		return err;
+
+	for (i = 0; superlist[i]; i++) {
+		struct superswitch *meta = superlist[i];
+
+		if (meta == ss)
+			continue;
+		if (verbose)
+			fprintf(stderr, Name ": checking metadata %s\n",
+				meta->name ? : "[no name]");
+		if (!meta->detail_platform) {
+			if (verbose)
+				fprintf(stderr, Name ": %s metadata is platform independent\n",
+					meta->name ? : "[no name]");
+		} else
+			err |= meta->detail_platform(verbose, 0);
+	}
+
+	return err;
 }