Detail.c

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