]> git.ipfire.org Git - thirdparty/mdadm.git/blob - Detail.c
Teach --detail about containers and members there-of.
[thirdparty/mdadm.git] / Detail.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
30 #include "mdadm.h"
31 #include "md_p.h"
32 #include "md_u.h"
33 #include <dirent.h>
34
35 int Detail(char *dev, int brief, int export, int test, char *homehost)
36 {
37 /*
38 * Print out details for an md array by using
39 * GET_ARRAY_INFO and GET_DISK_INFO ioctl calls
40 */
41
42 int fd = open(dev, O_RDONLY);
43 int vers;
44 mdu_array_info_t array;
45 mdu_disk_info_t *disks;
46 int next;
47 int d;
48 time_t atime;
49 char *c;
50 char *devices = NULL;
51 int spares = 0;
52 struct stat stb;
53 int is_26 = get_linux_version() >= 2006000;
54 int is_rebuilding = 0;
55 int failed = 0;
56 struct supertype *st = NULL;
57 int max_disks = MD_SB_DISKS; /* just a default */
58 struct mdinfo info;
59 struct mdinfo *sra;
60 char *member = NULL;
61 char *container = NULL;
62
63 int rv = test ? 4 : 1;
64 int avail_disks = 0;
65 char *avail;
66
67 if (fd < 0) {
68 fprintf(stderr, Name ": cannot open %s: %s\n",
69 dev, strerror(errno));
70 return rv;
71 }
72 vers = md_get_version(fd);
73 if (vers < 0) {
74 fprintf(stderr, Name ": %s does not appear to be an md device\n",
75 dev);
76 close(fd);
77 return rv;
78 }
79 if (vers < 9000) {
80 fprintf(stderr, Name ": cannot get detail for md device %s: driver version too old.\n",
81 dev);
82 close(fd);
83 return rv;
84 }
85 if (ioctl(fd, GET_ARRAY_INFO, &array)<0) {
86 if (errno == ENODEV)
87 fprintf(stderr, Name ": md device %s does not appear to be active.\n",
88 dev);
89 else
90 fprintf(stderr, Name ": cannot get array detail for %s: %s\n",
91 dev, strerror(errno));
92 close(fd);
93 return rv;
94 }
95 sra = sysfs_read(fd, 0, GET_VERSION);
96 st = super_by_fd(fd);
97
98 if (fstat(fd, &stb) != 0 && !S_ISBLK(stb.st_mode))
99 stb.st_rdev = 0;
100 rv = 0;
101
102 if (st)
103 max_disks = st->max_devs;
104
105 if (sra && is_subarray(sra->text_version) &&
106 strchr(sra->text_version+1, '/')) {
107 /* This is a subarray of some container.
108 * We want the name of the container, and the member
109 */
110 char *s = strchr(sra->text_version+1, '/');
111 int dn;
112 *s++ = '\0';
113 member = s;
114 dn = devname2devnum(sra->text_version+1);
115 container = map_dev(dev2major(dn), dev2minor(dn), 1);
116 }
117
118 /* try to load a superblock */
119 for (d= 0; d<max_disks; d++) {
120 mdu_disk_info_t disk;
121 char *dv;
122 disk.number = d;
123 if (ioctl(fd, GET_DISK_INFO, &disk) < 0)
124 continue;
125 if (d >= array.raid_disks &&
126 disk.major == 0 &&
127 disk.minor == 0)
128 continue;
129 if ((dv=map_dev(disk.major, disk.minor, 1))) {
130 if ((!st || !st->sb) &&
131 (disk.state & (1<<MD_DISK_ACTIVE))) {
132 /* try to read the superblock from this device
133 * to get more info
134 */
135 int fd2 = dev_open(dv, O_RDONLY);
136 if (fd2 >=0 && st &&
137 st->ss->load_super(st, fd2, NULL) == 0) {
138 st->ss->getinfo_super(st, &info);
139 if (info.array.ctime != array.ctime ||
140 info.array.level != array.level)
141 st->ss->free_super(st);
142 }
143 if (fd2 >= 0) close(fd2);
144 }
145 }
146 }
147
148 /* Ok, we have some info to print... */
149 c = map_num(pers, array.level);
150
151 if (export) {
152 if (array.raid_disks) {
153 if (c)
154 printf("MD_LEVEL=%s\n", c);
155 printf("MD_DEVICES=%d\n", array.raid_disks);
156 } else {
157 printf("MD_LEVEL=container\n");
158 printf("MD_DEVICES=%d\n", array.nr_disks);
159 }
160 if (container) {
161 printf("MD_CONTAINER=%s\n", container);
162 printf("MD_MEMBER=%s\n", member);
163 } else {
164 if (sra && sra->array.major_version < 0)
165 printf("MD_METADATA=%s\n", sra->text_version);
166 else
167 printf("MD_METADATA=%02d.%02d\n",
168 array.major_version, array.minor_version);
169 }
170
171 if (st && st->sb)
172 st->ss->export_detail_super(st);
173 goto out;
174 }
175
176 if (brief) {
177 mdu_bitmap_file_t bmf;
178 if (array.raid_disks)
179 printf("ARRAY %s level=%s num-devices=%d", dev,
180 c?c:"-unknown-",
181 array.raid_disks );
182 else
183 printf("ARRAY %s level=container num-devices=%d",
184 dev, array.nr_disks);
185
186 if (container) {
187 printf(" container=%s", container);
188 printf(" member=%s", member);
189 } else {
190 if (sra && sra->array.major_version < 0)
191 printf(" metadata=%s", sra->text_version);
192 else
193 printf(" metadata=%02d.%02d",
194 array.major_version, array.minor_version);
195 }
196
197 /* Only try GET_BITMAP_FILE for 0.90.01 and later */
198 if (vers >= 9001 &&
199 ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
200 bmf.pathname[0]) {
201 printf(" bitmap=%s", bmf.pathname);
202 }
203 } else {
204 mdu_bitmap_file_t bmf;
205 unsigned long long larray_size;
206 struct mdstat_ent *ms = mdstat_read(0, 0);
207 struct mdstat_ent *e;
208 int devnum = array.md_minor;
209 if (major(stb.st_rdev) != MD_MAJOR)
210 devnum = -1 - devnum;
211
212 for (e=ms; e; e=e->next)
213 if (e->devnum == devnum)
214 break;
215 if (!get_dev_size(fd, NULL, &larray_size))
216 larray_size = 0;
217
218 printf("%s:\n", dev);
219
220 if (container)
221 printf(" Container : %s, member %s\n", container, member);
222 else {
223 if (sra && sra->array.major_version < 0)
224 printf(" Version : %s\n", sra->text_version);
225 else
226 printf(" Version : %02d.%02d\n",
227 array.major_version, array.minor_version);
228 }
229
230 atime = array.ctime;
231 if (atime)
232 printf(" Creation Time : %.24s\n", ctime(&atime));
233 if (array.raid_disks == 0) c = "container";
234 printf(" Raid Level : %s\n", c?c:"-unknown-");
235 if (larray_size)
236 printf(" Array Size : %llu%s\n", (larray_size>>10), human_size(larray_size));
237 if (array.level >= 1) {
238 if (array.major_version != 0 &&
239 (larray_size >= 0xFFFFFFFFULL|| array.size == 0)) {
240 unsigned long long dsize = get_component_size(fd);
241 if (dsize > 0)
242 printf(" Used Dev Size : %llu%s\n",
243 dsize,
244 human_size((long long)dsize<<10));
245 else
246 printf(" Used Dev Size : unknown\n");
247 } else
248 printf(" Used Dev Size : %d%s\n", array.size,
249 human_size((long long)array.size<<10));
250 }
251 if (array.raid_disks)
252 printf(" Raid Devices : %d\n", array.raid_disks);
253 printf(" Total Devices : %d\n", array.nr_disks);
254 if (!container &&
255 ((sra == NULL && array.major_version == 0) ||
256 (sra && sra->array.major_version == 0)))
257 printf("Preferred Minor : %d\n", array.md_minor);
258 if (sra == NULL || sra->array.major_version >= 0)
259 printf(" Persistence : Superblock is %spersistent\n",
260 array.not_persistent?"not ":"");
261 printf("\n");
262 /* Only try GET_BITMAP_FILE for 0.90.01 and later */
263 if (vers >= 9001 &&
264 ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
265 bmf.pathname[0]) {
266 printf(" Intent Bitmap : %s\n", bmf.pathname);
267 printf("\n");
268 } else if (array.state & (1<<MD_SB_BITMAP_PRESENT))
269 printf(" Intent Bitmap : Internal\n\n");
270 atime = array.utime;
271 if (atime)
272 printf(" Update Time : %.24s\n", ctime(&atime));
273 if (array.raid_disks)
274 printf(" State : %s%s%s%s\n",
275 (array.state&(1<<MD_SB_CLEAN))?"clean":"active",
276 array.active_disks < array.raid_disks? ", degraded":"",
277 (!e || e->percent < 0) ? "" :
278 (e->resync) ? ", resyncing": ", recovering",
279 larray_size ? "": ", Not Started");
280 if (array.raid_disks)
281 printf(" Active Devices : %d\n", array.active_disks);
282 printf("Working Devices : %d\n", array.working_disks);
283 if (array.raid_disks) {
284 printf(" Failed Devices : %d\n", array.failed_disks);
285 printf(" Spare Devices : %d\n", array.spare_disks);
286 }
287 printf("\n");
288 if (array.level == 5) {
289 c = map_num(r5layout, array.layout);
290 printf(" Layout : %s\n", c?c:"-unknown-");
291 }
292 if (array.level == 10) {
293 printf(" Layout : near=%d, %s=%d\n",
294 array.layout&255, (array.layout&0x10000)?"offset":"far",
295 (array.layout>>8)&255);
296 }
297 switch (array.level) {
298 case 0:
299 case 4:
300 case 5:
301 case 10:
302 case 6:
303 if (array.chunk_size)
304 printf(" Chunk Size : %dK\n\n",
305 array.chunk_size/1024);
306 break;
307 case -1:
308 printf(" Rounding : %dK\n\n", array.chunk_size/1024);
309 break;
310 default: break;
311 }
312
313 if (e && e->percent >= 0) {
314 printf(" Re%s Status : %d%% complete\n",
315 (st && st->sb && info.reshape_active)?
316 "shape":"build",
317 e->percent);
318 is_rebuilding = 1;
319 }
320 free_mdstat(ms);
321
322 if (st->sb && info.reshape_active) {
323 #if 0
324 This is pretty boring
325 printf(" Reshape pos'n : %llu%s\n", (unsigned long long) info.reshape_progress<<9,
326 human_size(info.reshape_progress<<9));
327 #endif
328 if (info.delta_disks > 0)
329 printf(" Delta Devices : %d, (%d->%d)\n",
330 info.delta_disks, array.raid_disks - info.delta_disks, array.raid_disks);
331 if (info.delta_disks < 0)
332 printf(" Delta Devices : %d, (%d->%d)\n",
333 info.delta_disks, array.raid_disks, array.raid_disks + info.delta_disks);
334 if (info.new_level != array.level) {
335 char *c = map_num(pers, info.new_level);
336 printf(" New Level : %s\n", c?c:"-unknown-");
337 }
338 if (info.new_level != array.level ||
339 info.new_layout != array.layout) {
340 if (info.new_level == 5) {
341 char *c = map_num(r5layout, info.new_layout);
342 printf(" New Layout : %s\n",
343 c?c:"-unknown-");
344 }
345 if (info.new_level == 10) {
346 printf(" New Layout : near=%d, %s=%d\n",
347 info.new_layout&255,
348 (info.new_layout&0x10000)?"offset":"far",
349 (info.new_layout>>8)&255);
350 }
351 }
352 if (info.new_chunk != array.chunk_size)
353 printf(" New Chunksize : %dK\n", info.new_chunk/1024);
354 printf("\n");
355 } else if (e && e->percent >= 0)
356 printf("\n");
357 if (st && st->sb)
358 st->ss->detail_super(st, homehost);
359
360 if (array.raid_disks == 0 && sra && sra->array.major_version == -1
361 && sra->array.minor_version == -2 && sra->text_version[0] != '/') {
362 /* This looks like a container. Find any active arrays
363 * That claim to be a member.
364 */
365 DIR *dir = opendir("/sys/block");
366 struct dirent *de;
367
368 printf(" Member Arrays :");
369
370 while (dir && (de = readdir(dir)) != NULL) {
371 char path[200];
372 char vbuf[1024];
373 int nlen = strlen(sra->sys_name);
374 int dn;
375 if (de->d_name[0] == '.')
376 continue;
377 sprintf(path, "/sys/block/%s/md/metadata_version",
378 de->d_name);
379 if (load_sys(path, vbuf) < 0)
380 continue;
381 if (strncmp(vbuf, "external:", 9) != 0 ||
382 !is_subarray(sra->sys_name+9) ||
383 strncmp(vbuf+10, sra->sys_name, nlen) != 0 ||
384 vbuf[10+nlen] != '/')
385 continue;
386 dn = devname2devnum(de->d_name);
387 printf(" %s", map_dev(dev2major(dn),
388 dev2minor(dn), 1));
389 }
390 if (dir)
391 closedir(dir);
392 printf("\n\n");
393 }
394
395 if (array.raid_disks)
396 printf(" Number Major Minor RaidDevice State\n");
397 else
398 printf(" Number Major Minor RaidDevice\n");
399 }
400 disks = malloc(max_disks * sizeof(mdu_disk_info_t));
401 for (d=0; d<max_disks; d++) {
402 disks[d].state = (1<<MD_DISK_REMOVED);
403 disks[d].major = disks[d].minor = 0;
404 disks[d].number = disks[d].raid_disk = d;
405 }
406
407 next = array.raid_disks;
408 for (d=0; d < max_disks; d++) {
409 mdu_disk_info_t disk;
410 disk.number = d;
411 if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
412 if (d < array.raid_disks)
413 fprintf(stderr, Name ": cannot get device detail for device %d: %s\n",
414 d, strerror(errno));
415 continue;
416 }
417 if (disk.major == 0 && disk.minor == 0)
418 continue;
419 if (disk.raid_disk >= 0 && disk.raid_disk < array.raid_disks)
420 disks[disk.raid_disk] = disk;
421 else if (next < max_disks)
422 disks[next++] = disk;
423 }
424
425 avail = calloc(array.raid_disks, 1);
426 for (d= 0; d < max_disks; d++) {
427 char *dv;
428 mdu_disk_info_t disk = disks[d];
429
430 if (d >= array.raid_disks &&
431 disk.major == 0 &&
432 disk.minor == 0)
433 continue;
434 if (!brief) {
435 if (d == array.raid_disks) printf("\n");
436 if (disk.raid_disk < 0)
437 printf(" %5d %5d %5d - ",
438 disk.number, disk.major, disk.minor);
439 else
440 printf(" %5d %5d %5d %5d ",
441 disk.number, disk.major, disk.minor, disk.raid_disk);
442 }
443 if (!brief && array.raid_disks) {
444
445 if (disk.state & (1<<MD_DISK_FAULTY)) {
446 printf(" faulty");
447 if (disk.raid_disk < array.raid_disks &&
448 disk.raid_disk >= 0)
449 failed++;
450 }
451 if (disk.state & (1<<MD_DISK_ACTIVE)) printf(" active");
452 if (disk.state & (1<<MD_DISK_SYNC)) printf(" sync");
453 if (disk.state & (1<<MD_DISK_REMOVED)) printf(" removed");
454 if (disk.state & (1<<MD_DISK_WRITEMOSTLY)) printf(" writemostly");
455 if ((disk.state &
456 ((1<<MD_DISK_ACTIVE)|(1<<MD_DISK_SYNC)|(1<<MD_DISK_REMOVED)))
457 == 0) {
458 printf(" spare");
459 if (is_26) {
460 if (disk.raid_disk < array.raid_disks && disk.raid_disk >= 0)
461 printf(" rebuilding");
462 } else if (is_rebuilding && failed) {
463 /* Taking a bit of a risk here, we remove the
464 * device from the array, and then put it back.
465 * If this fails, we are rebuilding
466 */
467 int err = ioctl(fd, HOT_REMOVE_DISK, makedev(disk.major, disk.minor));
468 if (err == 0) ioctl(fd, HOT_ADD_DISK, makedev(disk.major, disk.minor));
469 if (err && errno == EBUSY)
470 printf(" rebuilding");
471 }
472 }
473 }
474 if (disk.state == 0) spares++;
475 if (test && d < array.raid_disks
476 && !(disk.state & (1<<MD_DISK_SYNC)))
477 rv |= 1;
478 if (d < array.raid_disks
479 && (disk.state & (1<<MD_DISK_SYNC))) {
480 avail_disks ++;
481 avail[d] = 1;
482 }
483 if ((dv=map_dev(disk.major, disk.minor, 0))) {
484 if (brief) {
485 if (devices) {
486 devices = realloc(devices,
487 strlen(devices)+1+strlen(dv)+1);
488 strcat(strcat(devices,","),dv);
489 } else
490 devices = strdup(dv);
491 } else
492 printf(" %s", dv);
493 }
494 if (!brief) printf("\n");
495 }
496 if (spares && brief && array.raid_disks) printf(" spares=%d", spares);
497 if (brief && st && st->sb)
498 st->ss->brief_detail_super(st);
499 st->ss->free_super(st);
500
501 if (brief > 1 && devices) printf("\n devices=%s", devices);
502 if (brief) printf("\n");
503 if (test &&
504 !enough(array.level, array.raid_disks, array.layout,
505 1, avail, avail_disks))
506 rv = 2;
507
508 out:
509 close(fd);
510 return rv;
511 }