cmd/zpool/zpool_main.c

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21
  22 /*
  23  * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
  24  */
  25
  26 #include <assert.h>
  27 #include <ctype.h>
  28 #include <dirent.h>
  29 #include <errno.h>
  30 #include <fcntl.h>
  31 #include <libgen.h>
  32 #include <libintl.h>
  33 #include <libuutil.h>
  34 #include <locale.h>
  35 #include <stdio.h>
  36 #include <stdlib.h>
  37 #include <string.h>
  38 #include <strings.h>
  39 #include <unistd.h>
  40 #include <priv.h>
  41 #include <pwd.h>
  42 #include <zone.h>
  43 #include <sys/fs/zfs.h>
  44 #include <sys/stat.h>
  45 #include <sys/fm/util.h>
  46 #include <sys/fm/protocol.h>
  47
  48 #include <libzfs.h>
  49
  50 #include "zpool_util.h"
  51 #include "zfs_comutil.h"
  52
  53 #include "statcommon.h"
  54
  55 static int zpool_do_create(int, char **);
  56 static int zpool_do_destroy(int, char **);
  57
  58 static int zpool_do_add(int, char **);
  59 static int zpool_do_remove(int, char **);
  60
  61 static int zpool_do_list(int, char **);
  62 static int zpool_do_iostat(int, char **);
  63 static int zpool_do_status(int, char **);
  64
  65 static int zpool_do_online(int, char **);
  66 static int zpool_do_offline(int, char **);
  67 static int zpool_do_clear(int, char **);
  68
  69 static int zpool_do_attach(int, char **);
  70 static int zpool_do_detach(int, char **);
  71 static int zpool_do_replace(int, char **);
  72 static int zpool_do_split(int, char **);
  73
  74 static int zpool_do_scrub(int, char **);
  75
  76 static int zpool_do_import(int, char **);
  77 static int zpool_do_export(int, char **);
  78
  79 static int zpool_do_upgrade(int, char **);
  80
  81 static int zpool_do_history(int, char **);
  82 static int zpool_do_events(int, char **);
  83
  84 static int zpool_do_get(int, char **);
  85 static int zpool_do_set(int, char **);
  86
  87 /*
  88  * These libumem hooks provide a reasonable set of defaults for the allocator's
  89  * debugging facilities.
  90  */
  91
  92 #ifdef DEBUG
  93 const char *
  94 _umem_debug_init(void)
  95 {
  96         return ("default,verbose"); /* $UMEM_DEBUG setting */
  97 }
  98
  99 const char *
 100 _umem_logging_init(void)
 101 {
 102         return ("fail,contents"); /* $UMEM_LOGGING setting */
 103 }
 104 #endif
 105
 106 typedef enum {
 107         HELP_ADD,
 108         HELP_ATTACH,
 109         HELP_CLEAR,
 110         HELP_CREATE,
 111         HELP_DESTROY,
 112         HELP_DETACH,
 113         HELP_EXPORT,
 114         HELP_HISTORY,
 115         HELP_IMPORT,
 116         HELP_IOSTAT,
 117         HELP_LIST,
 118         HELP_OFFLINE,
 119         HELP_ONLINE,
 120         HELP_REPLACE,
 121         HELP_REMOVE,
 122         HELP_SCRUB,
 123         HELP_STATUS,
 124         HELP_UPGRADE,
 125         HELP_EVENTS,
 126         HELP_GET,
 127         HELP_SET,
 128         HELP_SPLIT
 129 } zpool_help_t;
 130
 131
 132 typedef struct zpool_command {
 133         const char      *name;
 134         int             (*func)(int, char **);
 135         zpool_help_t    usage;
 136 } zpool_command_t;
 137
 138 /*
 139  * Master command table.  Each ZFS command has a name, associated function, and
 140  * usage message.  The usage messages need to be internationalized, so we have
 141  * to have a function to return the usage message based on a command index.
 142  *
 143  * These commands are organized according to how they are displayed in the usage
 144  * message.  An empty command (one with a NULL name) indicates an empty line in
 145  * the generic usage message.
 146  */
 147 static zpool_command_t command_table[] = {
 148         { "create",     zpool_do_create,        HELP_CREATE             },
 149         { "destroy",    zpool_do_destroy,       HELP_DESTROY            },
 150         { NULL },
 151         { "add",        zpool_do_add,           HELP_ADD                },
 152         { "remove",     zpool_do_remove,        HELP_REMOVE             },
 153         { NULL },
 154         { "list",       zpool_do_list,          HELP_LIST               },
 155         { "iostat",     zpool_do_iostat,        HELP_IOSTAT             },
 156         { "status",     zpool_do_status,        HELP_STATUS             },
 157         { NULL },
 158         { "online",     zpool_do_online,        HELP_ONLINE             },
 159         { "offline",    zpool_do_offline,       HELP_OFFLINE            },
 160         { "clear",      zpool_do_clear,         HELP_CLEAR              },
 161         { NULL },
 162         { "attach",     zpool_do_attach,        HELP_ATTACH             },
 163         { "detach",     zpool_do_detach,        HELP_DETACH             },
 164         { "replace",    zpool_do_replace,       HELP_REPLACE            },
 165         { "split",      zpool_do_split,         HELP_SPLIT              },
 166         { NULL },
 167         { "scrub",      zpool_do_scrub,         HELP_SCRUB              },
 168         { NULL },
 169         { "import",     zpool_do_import,        HELP_IMPORT             },
 170         { "export",     zpool_do_export,        HELP_EXPORT             },
 171         { "upgrade",    zpool_do_upgrade,       HELP_UPGRADE            },
 172         { NULL },
 173         { "history",    zpool_do_history,       HELP_HISTORY            },
 174         { "events",     zpool_do_events,        HELP_EVENTS             },
 175         { NULL },
 176         { "get",        zpool_do_get,           HELP_GET                },
 177         { "set",        zpool_do_set,           HELP_SET                },
 178 };
 179
 180 #define NCOMMAND        (sizeof (command_table) / sizeof (command_table[0]))
 181
 182 zpool_command_t *current_command;
 183 static char history_str[HIS_MAX_RECORD_LEN];
 184
 185 static uint_t timestamp_fmt = NODATE;
 186
 187 static const char *
 188 get_usage(zpool_help_t idx) {
 189         switch (idx) {
 190         case HELP_ADD:
 191                 return (gettext("\tadd [-fn] <pool> <vdev> ...\n"));
 192         case HELP_ATTACH:
 193                 return (gettext("\tattach [-f] <pool> <device> "
 194                     "<new-device>\n"));
 195         case HELP_CLEAR:
 196                 return (gettext("\tclear [-nF] <pool> [device]\n"));
 197         case HELP_CREATE:
 198                 return (gettext("\tcreate [-fn] [-o property=value] ... \n"
 199                     "\t    [-O file-system-property=value] ... \n"
 200                     "\t    [-m mountpoint] [-R root] <pool> <vdev> ...\n"));
 201         case HELP_DESTROY:
 202                 return (gettext("\tdestroy [-f] <pool>\n"));
 203         case HELP_DETACH:
 204                 return (gettext("\tdetach <pool> <device>\n"));
 205         case HELP_EXPORT:
 206                 return (gettext("\texport [-f] <pool> ...\n"));
 207         case HELP_HISTORY:
 208                 return (gettext("\thistory [-il] [<pool>] ...\n"));
 209         case HELP_IMPORT:
 210                 return (gettext("\timport [-d dir] [-D]\n"
 211                     "\timport [-d dir | -c cachefile] [-F [-n]] <pool | id>\n"
 212                     "\timport [-o mntopts] [-o property=value] ... \n"
 213                     "\t    [-d dir | -c cachefile] [-D] [-f] [-m] [-N] "
 214                     "[-R root] [-F [-n]] -a\n"
 215                     "\timport [-o mntopts] [-o property=value] ... \n"
 216                     "\t    [-d dir | -c cachefile] [-D] [-f] [-m] [-N] "
 217                     "[-R root] [-F [-n]]\n"
 218                     "\t    <pool | id> [newpool]\n"));
 219         case HELP_IOSTAT:
 220                 return (gettext("\tiostat [-v] [-T d|u] [pool] ... [interval "
 221                     "[count]]\n"));
 222         case HELP_LIST:
 223                 return (gettext("\tlist [-H] [-o property[,...]] "
 224                     "[-T d|u] [pool] ... [interval [count]]\n"));
 225         case HELP_OFFLINE:
 226                 return (gettext("\toffline [-t] <pool> <device> ...\n"));
 227         case HELP_ONLINE:
 228                 return (gettext("\tonline <pool> <device> ...\n"));
 229         case HELP_REPLACE:
 230                 return (gettext("\treplace [-f] <pool> <device> "
 231                     "[new-device]\n"));
 232         case HELP_REMOVE:
 233                 return (gettext("\tremove <pool> <device> ...\n"));
 234         case HELP_SCRUB:
 235                 return (gettext("\tscrub [-s] <pool> ...\n"));
 236         case HELP_STATUS:
 237                 return (gettext("\tstatus [-vx] [-T d|u] [pool] ... [interval "
 238                     "[count]]\n"));
 239         case HELP_UPGRADE:
 240                 return (gettext("\tupgrade\n"
 241                     "\tupgrade -v\n"
 242                     "\tupgrade [-V version] <-a | pool ...>\n"));
 243         case HELP_EVENTS:
 244                 return (gettext("\tevents [-vHfc]\n"));
 245         case HELP_GET:
 246                 return (gettext("\tget <\"all\" | property[,...]> "
 247                     "<pool> ...\n"));
 248         case HELP_SET:
 249                 return (gettext("\tset <property=value> <pool> \n"));
 250         case HELP_SPLIT:
 251                 return (gettext("\tsplit [-n] [-R altroot] [-o mntopts]\n"
 252                     "\t    [-o property=value] <pool> <newpool> "
 253                     "[<device> ...]\n"));
 254         }
 255
 256         abort();
 257         /* NOTREACHED */
 258 }
 259
 260
 261 /*
 262  * Callback routine that will print out a pool property value.
 263  */
 264 static int
 265 print_prop_cb(int prop, void *cb)
 266 {
 267         FILE *fp = cb;
 268
 269         (void) fprintf(fp, "\t%-15s  ", zpool_prop_to_name(prop));
 270
 271         if (zpool_prop_readonly(prop))
 272                 (void) fprintf(fp, "  NO   ");
 273         else
 274                 (void) fprintf(fp, " YES   ");
 275
 276         if (zpool_prop_values(prop) == NULL)
 277                 (void) fprintf(fp, "-\n");
 278         else
 279                 (void) fprintf(fp, "%s\n", zpool_prop_values(prop));
 280
 281         return (ZPROP_CONT);
 282 }
 283
 284 /*
 285  * Display usage message.  If we're inside a command, display only the usage for
 286  * that command.  Otherwise, iterate over the entire command table and display
 287  * a complete usage message.
 288  */
 289 void
 290 usage(boolean_t requested)
 291 {
 292         FILE *fp = requested ? stdout : stderr;
 293
 294         if (current_command == NULL) {
 295                 int i;
 296
 297                 (void) fprintf(fp, gettext("usage: zpool command args ...\n"));
 298                 (void) fprintf(fp,
 299                     gettext("where 'command' is one of the following:\n\n"));
 300
 301                 for (i = 0; i < NCOMMAND; i++) {
 302                         if (command_table[i].name == NULL)
 303                                 (void) fprintf(fp, "\n");
 304                         else
 305                                 (void) fprintf(fp, "%s",
 306                                     get_usage(command_table[i].usage));
 307                 }
 308         } else {
 309                 (void) fprintf(fp, gettext("usage:\n"));
 310                 (void) fprintf(fp, "%s", get_usage(current_command->usage));
 311         }
 312
 313         if (current_command != NULL &&
 314             ((strcmp(current_command->name, "set") == 0) ||
 315             (strcmp(current_command->name, "get") == 0) ||
 316             (strcmp(current_command->name, "list") == 0))) {
 317
 318                 (void) fprintf(fp,
 319                     gettext("\nthe following properties are supported:\n"));
 320
 321                 (void) fprintf(fp, "\n\t%-15s  %s   %s\n\n",
 322                     "PROPERTY", "EDIT", "VALUES");
 323
 324                 /* Iterate over all properties */
 325                 (void) zprop_iter(print_prop_cb, fp, B_FALSE, B_TRUE,
 326                     ZFS_TYPE_POOL);
 327         }
 328
 329         /*
 330          * See comments at end of main().
 331          */
 332         if (getenv("ZFS_ABORT") != NULL) {
 333                 (void) printf("dumping core by request\n");
 334                 abort();
 335         }
 336
 337         exit(requested ? 0 : 2);
 338 }
 339
 340 void
 341 print_vdev_tree(zpool_handle_t *zhp, const char *name, nvlist_t *nv, int indent,
 342     boolean_t print_logs)
 343 {
 344         nvlist_t **child;
 345         uint_t c, children;
 346         char *vname;
 347
 348         if (name != NULL)
 349                 (void) printf("\t%*s%s\n", indent, "", name);
 350
 351         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
 352             &child, &children) != 0)
 353                 return;
 354
 355         for (c = 0; c < children; c++) {
 356                 uint64_t is_log = B_FALSE;
 357
 358                 (void) nvlist_lookup_uint64(child[c], ZPOOL_CONFIG_IS_LOG,
 359                     &is_log);
 360                 if ((is_log && !print_logs) || (!is_log && print_logs))
 361                         continue;
 362
 363                 vname = zpool_vdev_name(g_zfs, zhp, child[c], B_FALSE);
 364                 print_vdev_tree(zhp, vname, child[c], indent + 2,
 365                     B_FALSE);
 366                 free(vname);
 367         }
 368 }
 369
 370 /*
 371  * Add a property pair (name, string-value) into a property nvlist.
 372  */
 373 static int
 374 add_prop_list(const char *propname, char *propval, nvlist_t **props,
 375     boolean_t poolprop)
 376 {
 377         zpool_prop_t prop = ZPROP_INVAL;
 378         zfs_prop_t fprop;
 379         nvlist_t *proplist;
 380         const char *normnm;
 381         char *strval;
 382
 383         if (*props == NULL &&
 384             nvlist_alloc(props, NV_UNIQUE_NAME, 0) != 0) {
 385                 (void) fprintf(stderr,
 386                     gettext("internal error: out of memory\n"));
 387                 return (1);
 388         }
 389
 390         proplist = *props;
 391
 392         if (poolprop) {
 393                 if ((prop = zpool_name_to_prop(propname)) == ZPROP_INVAL) {
 394                         (void) fprintf(stderr, gettext("property '%s' is "
 395                             "not a valid pool property\n"), propname);
 396                         return (2);
 397                 }
 398                 normnm = zpool_prop_to_name(prop);
 399         } else {
 400                 if ((fprop = zfs_name_to_prop(propname)) != ZPROP_INVAL) {
 401                         normnm = zfs_prop_to_name(fprop);
 402                 } else {
 403                         normnm = propname;
 404                 }
 405         }
 406
 407         if (nvlist_lookup_string(proplist, normnm, &strval) == 0 &&
 408             prop != ZPOOL_PROP_CACHEFILE) {
 409                 (void) fprintf(stderr, gettext("property '%s' "
 410                     "specified multiple times\n"), propname);
 411                 return (2);
 412         }
 413
 414         if (nvlist_add_string(proplist, normnm, propval) != 0) {
 415                 (void) fprintf(stderr, gettext("internal "
 416                     "error: out of memory\n"));
 417                 return (1);
 418         }
 419
 420         return (0);
 421 }
 422
 423 /*
 424  * zpool add [-fn] <pool> <vdev> ...
 425  *
 426  *      -f      Force addition of devices, even if they appear in use
 427  *      -n      Do not add the devices, but display the resulting layout if
 428  *              they were to be added.
 429  *
 430  * Adds the given vdevs to 'pool'.  As with create, the bulk of this work is
 431  * handled by get_vdev_spec(), which constructs the nvlist needed to pass to
 432  * libzfs.
 433  */
 434 int
 435 zpool_do_add(int argc, char **argv)
 436 {
 437         boolean_t force = B_FALSE;
 438         boolean_t dryrun = B_FALSE;
 439         int c;
 440         nvlist_t *nvroot;
 441         char *poolname;
 442         int ret;
 443         zpool_handle_t *zhp;
 444         nvlist_t *config;
 445
 446         /* check options */
 447         while ((c = getopt(argc, argv, "fn")) != -1) {
 448                 switch (c) {
 449                 case 'f':
 450                         force = B_TRUE;
 451                         break;
 452                 case 'n':
 453                         dryrun = B_TRUE;
 454                         break;
 455                 case '?':
 456                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
 457                             optopt);
 458                         usage(B_FALSE);
 459                 }
 460         }
 461
 462         argc -= optind;
 463         argv += optind;
 464
 465         /* get pool name and check number of arguments */
 466         if (argc < 1) {
 467                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
 468                 usage(B_FALSE);
 469         }
 470         if (argc < 2) {
 471                 (void) fprintf(stderr, gettext("missing vdev specification\n"));
 472                 usage(B_FALSE);
 473         }
 474
 475         poolname = argv[0];
 476
 477         argc--;
 478         argv++;
 479
 480         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
 481                 return (1);
 482
 483         if ((config = zpool_get_config(zhp, NULL)) == NULL) {
 484                 (void) fprintf(stderr, gettext("pool '%s' is unavailable\n"),
 485                     poolname);
 486                 zpool_close(zhp);
 487                 return (1);
 488         }
 489
 490         /* pass off to get_vdev_spec for processing */
 491         nvroot = make_root_vdev(zhp, NULL, force, !force, B_FALSE, dryrun,
 492             argc, argv);
 493         if (nvroot == NULL) {
 494                 zpool_close(zhp);
 495                 return (1);
 496         }
 497
 498         if (dryrun) {
 499                 nvlist_t *poolnvroot;
 500
 501                 verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
 502                     &poolnvroot) == 0);
 503
 504                 (void) printf(gettext("would update '%s' to the following "
 505                     "configuration:\n"), zpool_get_name(zhp));
 506
 507                 /* print original main pool and new tree */
 508                 print_vdev_tree(zhp, poolname, poolnvroot, 0, B_FALSE);
 509                 print_vdev_tree(zhp, NULL, nvroot, 0, B_FALSE);
 510
 511                 /* Do the same for the logs */
 512                 if (num_logs(poolnvroot) > 0) {
 513                         print_vdev_tree(zhp, "logs", poolnvroot, 0, B_TRUE);
 514                         print_vdev_tree(zhp, NULL, nvroot, 0, B_TRUE);
 515                 } else if (num_logs(nvroot) > 0) {
 516                         print_vdev_tree(zhp, "logs", nvroot, 0, B_TRUE);
 517                 }
 518
 519                 ret = 0;
 520         } else {
 521                 ret = (zpool_add(zhp, nvroot) != 0);
 522         }
 523
 524         nvlist_free(nvroot);
 525         zpool_close(zhp);
 526
 527         return (ret);
 528 }
 529
 530 /*
 531  * zpool remove  <pool> <vdev> ...
 532  *
 533  * Removes the given vdev from the pool.  Currently, this supports removing
 534  * spares, cache, and log devices from the pool.
 535  */
 536 int
 537 zpool_do_remove(int argc, char **argv)
 538 {
 539         char *poolname;
 540         int i, ret = 0;
 541         zpool_handle_t *zhp;
 542
 543         argc--;
 544         argv++;
 545
 546         /* get pool name and check number of arguments */
 547         if (argc < 1) {
 548                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
 549                 usage(B_FALSE);
 550         }
 551         if (argc < 2) {
 552                 (void) fprintf(stderr, gettext("missing device\n"));
 553                 usage(B_FALSE);
 554         }
 555
 556         poolname = argv[0];
 557
 558         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
 559                 return (1);
 560
 561         for (i = 1; i < argc; i++) {
 562                 if (zpool_vdev_remove(zhp, argv[i]) != 0)
 563                         ret = 1;
 564         }
 565
 566         return (ret);
 567 }
 568
 569 /*
 570  * zpool create [-fn] [-o property=value] ...
 571  *              [-O file-system-property=value] ...
 572  *              [-R root] [-m mountpoint] <pool> <dev> ...
 573  *
 574  *      -f      Force creation, even if devices appear in use
 575  *      -n      Do not create the pool, but display the resulting layout if it
 576  *              were to be created.
 577  *      -R      Create a pool under an alternate root
 578  *      -m      Set default mountpoint for the root dataset.  By default it's
 579  *              '/<pool>'
 580  *      -o      Set property=value.
 581  *      -O      Set fsproperty=value in the pool's root file system
 582  *
 583  * Creates the named pool according to the given vdev specification.  The
 584  * bulk of the vdev processing is done in get_vdev_spec() in zpool_vdev.c.  Once
 585  * we get the nvlist back from get_vdev_spec(), we either print out the contents
 586  * (if '-n' was specified), or pass it to libzfs to do the creation.
 587  */
 588 int
 589 zpool_do_create(int argc, char **argv)
 590 {
 591         boolean_t force = B_FALSE;
 592         boolean_t dryrun = B_FALSE;
 593         int c;
 594         nvlist_t *nvroot = NULL;
 595         char *poolname;
 596         int ret = 1;
 597         char *altroot = NULL;
 598         char *mountpoint = NULL;
 599         nvlist_t *fsprops = NULL;
 600         nvlist_t *props = NULL;
 601         char *propval;
 602
 603         /* check options */
 604         while ((c = getopt(argc, argv, ":fnR:m:o:O:")) != -1) {
 605                 switch (c) {
 606                 case 'f':
 607                         force = B_TRUE;
 608                         break;
 609                 case 'n':
 610                         dryrun = B_TRUE;
 611                         break;
 612                 case 'R':
 613                         altroot = optarg;
 614                         if (add_prop_list(zpool_prop_to_name(
 615                             ZPOOL_PROP_ALTROOT), optarg, &props, B_TRUE))
 616                                 goto errout;
 617                         if (nvlist_lookup_string(props,
 618                             zpool_prop_to_name(ZPOOL_PROP_CACHEFILE),
 619                             &propval) == 0)
 620                                 break;
 621                         if (add_prop_list(zpool_prop_to_name(
 622                             ZPOOL_PROP_CACHEFILE), "none", &props, B_TRUE))
 623                                 goto errout;
 624                         break;
 625                 case 'm':
 626                         mountpoint = optarg;
 627                         break;
 628                 case 'o':
 629                         if ((propval = strchr(optarg, '=')) == NULL) {
 630                                 (void) fprintf(stderr, gettext("missing "
 631                                     "'=' for -o option\n"));
 632                                 goto errout;
 633                         }
 634                         *propval = '\0';
 635                         propval++;
 636
 637                         if (add_prop_list(optarg, propval, &props, B_TRUE))
 638                                 goto errout;
 639                         break;
 640                 case 'O':
 641                         if ((propval = strchr(optarg, '=')) == NULL) {
 642                                 (void) fprintf(stderr, gettext("missing "
 643                                     "'=' for -O option\n"));
 644                                 goto errout;
 645                         }
 646                         *propval = '\0';
 647                         propval++;
 648
 649                         if (add_prop_list(optarg, propval, &fsprops, B_FALSE))
 650                                 goto errout;
 651                         break;
 652                 case ':':
 653                         (void) fprintf(stderr, gettext("missing argument for "
 654                             "'%c' option\n"), optopt);
 655                         goto badusage;
 656                 case '?':
 657                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
 658                             optopt);
 659                         goto badusage;
 660                 }
 661         }
 662
 663         argc -= optind;
 664         argv += optind;
 665
 666         /* get pool name and check number of arguments */
 667         if (argc < 1) {
 668                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
 669                 goto badusage;
 670         }
 671         if (argc < 2) {
 672                 (void) fprintf(stderr, gettext("missing vdev specification\n"));
 673                 goto badusage;
 674         }
 675
 676         poolname = argv[0];
 677
 678         /*
 679          * As a special case, check for use of '/' in the name, and direct the
 680          * user to use 'zfs create' instead.
 681          */
 682         if (strchr(poolname, '/') != NULL) {
 683                 (void) fprintf(stderr, gettext("cannot create '%s': invalid "
 684                     "character '/' in pool name\n"), poolname);
 685                 (void) fprintf(stderr, gettext("use 'zfs create' to "
 686                     "create a dataset\n"));
 687                 goto errout;
 688         }
 689
 690         /* pass off to get_vdev_spec for bulk processing */
 691         nvroot = make_root_vdev(NULL, props, force, !force, B_FALSE, dryrun,
 692             argc - 1, argv + 1);
 693         if (nvroot == NULL)
 694                 goto errout;
 695
 696         /* make_root_vdev() allows 0 toplevel children if there are spares */
 697         if (!zfs_allocatable_devs(nvroot)) {
 698                 (void) fprintf(stderr, gettext("invalid vdev "
 699                     "specification: at least one toplevel vdev must be "
 700                     "specified\n"));
 701                 goto errout;
 702         }
 703
 704
 705         if (altroot != NULL && altroot[0] != '/') {
 706                 (void) fprintf(stderr, gettext("invalid alternate root '%s': "
 707                     "must be an absolute path\n"), altroot);
 708                 goto errout;
 709         }
 710
 711         /*
 712          * Check the validity of the mountpoint and direct the user to use the
 713          * '-m' mountpoint option if it looks like its in use.
 714          */
 715         if (mountpoint == NULL ||
 716             (strcmp(mountpoint, ZFS_MOUNTPOINT_LEGACY) != 0 &&
 717             strcmp(mountpoint, ZFS_MOUNTPOINT_NONE) != 0)) {
 718                 char buf[MAXPATHLEN];
 719                 DIR *dirp;
 720
 721                 if (mountpoint && mountpoint[0] != '/') {
 722                         (void) fprintf(stderr, gettext("invalid mountpoint "
 723                             "'%s': must be an absolute path, 'legacy', or "
 724                             "'none'\n"), mountpoint);
 725                         goto errout;
 726                 }
 727
 728                 if (mountpoint == NULL) {
 729                         if (altroot != NULL)
 730                                 (void) snprintf(buf, sizeof (buf), "%s/%s",
 731                                     altroot, poolname);
 732                         else
 733                                 (void) snprintf(buf, sizeof (buf), "/%s",
 734                                     poolname);
 735                 } else {
 736                         if (altroot != NULL)
 737                                 (void) snprintf(buf, sizeof (buf), "%s%s",
 738                                     altroot, mountpoint);
 739                         else
 740                                 (void) snprintf(buf, sizeof (buf), "%s",
 741                                     mountpoint);
 742                 }
 743
 744                 if ((dirp = opendir(buf)) == NULL && errno != ENOENT) {
 745                         (void) fprintf(stderr, gettext("mountpoint '%s' : "
 746                             "%s\n"), buf, strerror(errno));
 747                         (void) fprintf(stderr, gettext("use '-m' "
 748                             "option to provide a different default\n"));
 749                         goto errout;
 750                 } else if (dirp) {
 751                         int count = 0;
 752
 753                         while (count < 3 && readdir(dirp) != NULL)
 754                                 count++;
 755                         (void) closedir(dirp);
 756
 757                         if (count > 2) {
 758                                 (void) fprintf(stderr, gettext("mountpoint "
 759                                     "'%s' exists and is not empty\n"), buf);
 760                                 (void) fprintf(stderr, gettext("use '-m' "
 761                                     "option to provide a "
 762                                     "different default\n"));
 763                                 goto errout;
 764                         }
 765                 }
 766         }
 767
 768         if (dryrun) {
 769                 /*
 770                  * For a dry run invocation, print out a basic message and run
 771                  * through all the vdevs in the list and print out in an
 772                  * appropriate hierarchy.
 773                  */
 774                 (void) printf(gettext("would create '%s' with the "
 775                     "following layout:\n\n"), poolname);
 776
 777                 print_vdev_tree(NULL, poolname, nvroot, 0, B_FALSE);
 778                 if (num_logs(nvroot) > 0)
 779                         print_vdev_tree(NULL, "logs", nvroot, 0, B_TRUE);
 780
 781                 ret = 0;
 782         } else {
 783                 /*
 784                  * Hand off to libzfs.
 785                  */
 786                 if (zpool_create(g_zfs, poolname,
 787                     nvroot, props, fsprops) == 0) {
 788                         zfs_handle_t *pool = zfs_open(g_zfs, poolname,
 789                             ZFS_TYPE_FILESYSTEM);
 790                         if (pool != NULL) {
 791                                 if (mountpoint != NULL)
 792                                         verify(zfs_prop_set(pool,
 793                                             zfs_prop_to_name(
 794                                             ZFS_PROP_MOUNTPOINT),
 795                                             mountpoint) == 0);
 796                                 if (zfs_mount(pool, NULL, 0) == 0)
 797                                         ret = zfs_shareall(pool);
 798                                 zfs_close(pool);
 799                         }
 800                 } else if (libzfs_errno(g_zfs) == EZFS_INVALIDNAME) {
 801                         (void) fprintf(stderr, gettext("pool name may have "
 802                             "been omitted\n"));
 803                 }
 804         }
 805
 806 errout:
 807         nvlist_free(nvroot);
 808         nvlist_free(fsprops);
 809         nvlist_free(props);
 810         return (ret);
 811 badusage:
 812         nvlist_free(fsprops);
 813         nvlist_free(props);
 814         usage(B_FALSE);
 815         return (2);
 816 }
 817
 818 /*
 819  * zpool destroy <pool>
 820  *
 821  *      -f      Forcefully unmount any datasets
 822  *
 823  * Destroy the given pool.  Automatically unmounts any datasets in the pool.
 824  */
 825 int
 826 zpool_do_destroy(int argc, char **argv)
 827 {
 828         boolean_t force = B_FALSE;
 829         int c;
 830         char *pool;
 831         zpool_handle_t *zhp;
 832         int ret;
 833
 834         /* check options */
 835         while ((c = getopt(argc, argv, "f")) != -1) {
 836                 switch (c) {
 837                 case 'f':
 838                         force = B_TRUE;
 839                         break;
 840                 case '?':
 841                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
 842                             optopt);
 843                         usage(B_FALSE);
 844                 }
 845         }
 846
 847         argc -= optind;
 848         argv += optind;
 849
 850         /* check arguments */
 851         if (argc < 1) {
 852                 (void) fprintf(stderr, gettext("missing pool argument\n"));
 853                 usage(B_FALSE);
 854         }
 855         if (argc > 1) {
 856                 (void) fprintf(stderr, gettext("too many arguments\n"));
 857                 usage(B_FALSE);
 858         }
 859
 860         pool = argv[0];
 861
 862         if ((zhp = zpool_open_canfail(g_zfs, pool)) == NULL) {
 863                 /*
 864                  * As a special case, check for use of '/' in the name, and
 865                  * direct the user to use 'zfs destroy' instead.
 866                  */
 867                 if (strchr(pool, '/') != NULL)
 868                         (void) fprintf(stderr, gettext("use 'zfs destroy' to "
 869                             "destroy a dataset\n"));
 870                 return (1);
 871         }
 872
 873         if (zpool_disable_datasets(zhp, force) != 0) {
 874                 (void) fprintf(stderr, gettext("could not destroy '%s': "
 875                     "could not unmount datasets\n"), zpool_get_name(zhp));
 876                 return (1);
 877         }
 878
 879         ret = (zpool_destroy(zhp) != 0);
 880
 881         zpool_close(zhp);
 882
 883         return (ret);
 884 }
 885
 886 /*
 887  * zpool export [-f] <pool> ...
 888  *
 889  *      -f      Forcefully unmount datasets
 890  *
 891  * Export the given pools.  By default, the command will attempt to cleanly
 892  * unmount any active datasets within the pool.  If the '-f' flag is specified,
 893  * then the datasets will be forcefully unmounted.
 894  */
 895 int
 896 zpool_do_export(int argc, char **argv)
 897 {
 898         boolean_t force = B_FALSE;
 899         boolean_t hardforce = B_FALSE;
 900         int c;
 901         zpool_handle_t *zhp;
 902         int ret;
 903         int i;
 904
 905         /* check options */
 906         while ((c = getopt(argc, argv, "fF")) != -1) {
 907                 switch (c) {
 908                 case 'f':
 909                         force = B_TRUE;
 910                         break;
 911                 case 'F':
 912                         hardforce = B_TRUE;
 913                         break;
 914                 case '?':
 915                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
 916                             optopt);
 917                         usage(B_FALSE);
 918                 }
 919         }
 920
 921         argc -= optind;
 922         argv += optind;
 923
 924         /* check arguments */
 925         if (argc < 1) {
 926                 (void) fprintf(stderr, gettext("missing pool argument\n"));
 927                 usage(B_FALSE);
 928         }
 929
 930         ret = 0;
 931         for (i = 0; i < argc; i++) {
 932                 if ((zhp = zpool_open_canfail(g_zfs, argv[i])) == NULL) {
 933                         ret = 1;
 934                         continue;
 935                 }
 936
 937                 if (zpool_disable_datasets(zhp, force) != 0) {
 938                         ret = 1;
 939                         zpool_close(zhp);
 940                         continue;
 941                 }
 942
 943                 if (hardforce) {
 944                         if (zpool_export_force(zhp) != 0)
 945                                 ret = 1;
 946                 } else if (zpool_export(zhp, force) != 0) {
 947                         ret = 1;
 948                 }
 949
 950                 zpool_close(zhp);
 951         }
 952
 953         return (ret);
 954 }
 955
 956 /*
 957  * Given a vdev configuration, determine the maximum width needed for the device
 958  * name column.
 959  */
 960 static int
 961 max_width(zpool_handle_t *zhp, nvlist_t *nv, int depth, int max)
 962 {
 963         char *name = zpool_vdev_name(g_zfs, zhp, nv, B_TRUE);
 964         nvlist_t **child;
 965         uint_t c, children;
 966         int ret;
 967
 968         if (strlen(name) + depth > max)
 969                 max = strlen(name) + depth;
 970
 971         free(name);
 972
 973         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_SPARES,
 974             &child, &children) == 0) {
 975                 for (c = 0; c < children; c++)
 976                         if ((ret = max_width(zhp, child[c], depth + 2,
 977                             max)) > max)
 978                                 max = ret;
 979         }
 980
 981         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_L2CACHE,
 982             &child, &children) == 0) {
 983                 for (c = 0; c < children; c++)
 984                         if ((ret = max_width(zhp, child[c], depth + 2,
 985                             max)) > max)
 986                                 max = ret;
 987         }
 988
 989         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
 990             &child, &children) == 0) {
 991                 for (c = 0; c < children; c++)
 992                         if ((ret = max_width(zhp, child[c], depth + 2,
 993                             max)) > max)
 994                                 max = ret;
 995         }
 996
 997
 998         return (max);
 999 }
1000
1001 typedef struct spare_cbdata {
1002         uint64_t        cb_guid;
1003         zpool_handle_t  *cb_zhp;
1004 } spare_cbdata_t;
1005
1006 static boolean_t
1007 find_vdev(nvlist_t *nv, uint64_t search)
1008 {
1009         uint64_t guid;
1010         nvlist_t **child;
1011         uint_t c, children;
1012
1013         if (nvlist_lookup_uint64(nv, ZPOOL_CONFIG_GUID, &guid) == 0 &&
1014             search == guid)
1015                 return (B_TRUE);
1016
1017         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
1018             &child, &children) == 0) {
1019                 for (c = 0; c < children; c++)
1020                         if (find_vdev(child[c], search))
1021                                 return (B_TRUE);
1022         }
1023
1024         return (B_FALSE);
1025 }
1026
1027 static int
1028 find_spare(zpool_handle_t *zhp, void *data)
1029 {
1030         spare_cbdata_t *cbp = data;
1031         nvlist_t *config, *nvroot;
1032
1033         config = zpool_get_config(zhp, NULL);
1034         verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
1035             &nvroot) == 0);
1036
1037         if (find_vdev(nvroot, cbp->cb_guid)) {
1038                 cbp->cb_zhp = zhp;
1039                 return (1);
1040         }
1041
1042         zpool_close(zhp);
1043         return (0);
1044 }
1045
1046 /*
1047  * Print out configuration state as requested by status_callback.
1048  */
1049 void
1050 print_status_config(zpool_handle_t *zhp, const char *name, nvlist_t *nv,
1051     int namewidth, int depth, boolean_t isspare)
1052 {
1053         nvlist_t **child;
1054         uint_t c, children;
1055         pool_scan_stat_t *ps = NULL;
1056         vdev_stat_t *vs;
1057         char rbuf[6], wbuf[6], cbuf[6];
1058         char *vname;
1059         uint64_t notpresent;
1060         spare_cbdata_t cb;
1061         char *state;
1062
1063         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
1064             &child, &children) != 0)
1065                 children = 0;
1066
1067         verify(nvlist_lookup_uint64_array(nv, ZPOOL_CONFIG_VDEV_STATS,
1068             (uint64_t **)&vs, &c) == 0);
1069
1070         state = zpool_state_to_name(vs->vs_state, vs->vs_aux);
1071         if (isspare) {
1072                 /*
1073                  * For hot spares, we use the terms 'INUSE' and 'AVAILABLE' for
1074                  * online drives.
1075                  */
1076                 if (vs->vs_aux == VDEV_AUX_SPARED)
1077                         state = "INUSE";
1078                 else if (vs->vs_state == VDEV_STATE_HEALTHY)
1079                         state = "AVAIL";
1080         }
1081
1082         (void) printf("\t%*s%-*s  %-8s", depth, "", namewidth - depth,
1083             name, state);
1084
1085         if (!isspare) {
1086                 zfs_nicenum(vs->vs_read_errors, rbuf, sizeof (rbuf));
1087                 zfs_nicenum(vs->vs_write_errors, wbuf, sizeof (wbuf));
1088                 zfs_nicenum(vs->vs_checksum_errors, cbuf, sizeof (cbuf));
1089                 (void) printf(" %5s %5s %5s", rbuf, wbuf, cbuf);
1090         }
1091
1092         if (nvlist_lookup_uint64(nv, ZPOOL_CONFIG_NOT_PRESENT,
1093             &notpresent) == 0) {
1094                 char *path;
1095                 verify(nvlist_lookup_string(nv, ZPOOL_CONFIG_PATH, &path) == 0);
1096                 (void) printf("  was %s", path);
1097         } else if (vs->vs_aux != 0) {
1098                 (void) printf("  ");
1099
1100                 switch (vs->vs_aux) {
1101                 case VDEV_AUX_OPEN_FAILED:
1102                         (void) printf(gettext("cannot open"));
1103                         break;
1104
1105                 case VDEV_AUX_BAD_GUID_SUM:
1106                         (void) printf(gettext("missing device"));
1107                         break;
1108
1109                 case VDEV_AUX_NO_REPLICAS:
1110                         (void) printf(gettext("insufficient replicas"));
1111                         break;
1112
1113                 case VDEV_AUX_VERSION_NEWER:
1114                         (void) printf(gettext("newer version"));
1115                         break;
1116
1117                 case VDEV_AUX_SPARED:
1118                         verify(nvlist_lookup_uint64(nv, ZPOOL_CONFIG_GUID,
1119                             &cb.cb_guid) == 0);
1120                         if (zpool_iter(g_zfs, find_spare, &cb) == 1) {
1121                                 if (strcmp(zpool_get_name(cb.cb_zhp),
1122                                     zpool_get_name(zhp)) == 0)
1123                                         (void) printf(gettext("currently in "
1124                                             "use"));
1125                                 else
1126                                         (void) printf(gettext("in use by "
1127                                             "pool '%s'"),
1128                                             zpool_get_name(cb.cb_zhp));
1129                                 zpool_close(cb.cb_zhp);
1130                         } else {
1131                                 (void) printf(gettext("currently in use"));
1132                         }
1133                         break;
1134
1135                 case VDEV_AUX_ERR_EXCEEDED:
1136                         (void) printf(gettext("too many errors"));
1137                         break;
1138
1139                 case VDEV_AUX_IO_FAILURE:
1140                         (void) printf(gettext("experienced I/O failures"));
1141                         break;
1142
1143                 case VDEV_AUX_BAD_LOG:
1144                         (void) printf(gettext("bad intent log"));
1145                         break;
1146
1147                 case VDEV_AUX_EXTERNAL:
1148                         (void) printf(gettext("external device fault"));
1149                         break;
1150
1151                 case VDEV_AUX_SPLIT_POOL:
1152                         (void) printf(gettext("split into new pool"));
1153                         break;
1154
1155                 default:
1156                         (void) printf(gettext("corrupted data"));
1157                         break;
1158                 }
1159         }
1160
1161         (void) nvlist_lookup_uint64_array(nv, ZPOOL_CONFIG_SCAN_STATS,
1162             (uint64_t **)&ps, &c);
1163
1164         if (ps && ps->pss_state == DSS_SCANNING &&
1165             vs->vs_scan_processed != 0 && children == 0) {
1166                 (void) printf(gettext("  (%s)"),
1167                     (ps->pss_func == POOL_SCAN_RESILVER) ?
1168                     "resilvering" : "repairing");
1169         }
1170
1171         (void) printf("\n");
1172
1173         for (c = 0; c < children; c++) {
1174                 uint64_t islog = B_FALSE, ishole = B_FALSE;
1175
1176                 /* Don't print logs or holes here */
1177                 (void) nvlist_lookup_uint64(child[c], ZPOOL_CONFIG_IS_LOG,
1178                     &islog);
1179                 (void) nvlist_lookup_uint64(child[c], ZPOOL_CONFIG_IS_HOLE,
1180                     &ishole);
1181                 if (islog || ishole)
1182                         continue;
1183                 vname = zpool_vdev_name(g_zfs, zhp, child[c], B_TRUE);
1184                 print_status_config(zhp, vname, child[c],
1185                     namewidth, depth + 2, isspare);
1186                 free(vname);
1187         }
1188 }
1189
1190
1191 /*
1192  * Print the configuration of an exported pool.  Iterate over all vdevs in the
1193  * pool, printing out the name and status for each one.
1194  */
1195 void
1196 print_import_config(const char *name, nvlist_t *nv, int namewidth, int depth)
1197 {
1198         nvlist_t **child;
1199         uint_t c, children;
1200         vdev_stat_t *vs;
1201         char *type, *vname;
1202
1203         verify(nvlist_lookup_string(nv, ZPOOL_CONFIG_TYPE, &type) == 0);
1204         if (strcmp(type, VDEV_TYPE_MISSING) == 0 ||
1205             strcmp(type, VDEV_TYPE_HOLE) == 0)
1206                 return;
1207
1208         verify(nvlist_lookup_uint64_array(nv, ZPOOL_CONFIG_VDEV_STATS,
1209             (uint64_t **)&vs, &c) == 0);
1210
1211         (void) printf("\t%*s%-*s", depth, "", namewidth - depth, name);
1212         (void) printf("  %s", zpool_state_to_name(vs->vs_state, vs->vs_aux));
1213
1214         if (vs->vs_aux != 0) {
1215                 (void) printf("  ");
1216
1217                 switch (vs->vs_aux) {
1218                 case VDEV_AUX_OPEN_FAILED:
1219                         (void) printf(gettext("cannot open"));
1220                         break;
1221
1222                 case VDEV_AUX_BAD_GUID_SUM:
1223                         (void) printf(gettext("missing device"));
1224                         break;
1225
1226                 case VDEV_AUX_NO_REPLICAS:
1227                         (void) printf(gettext("insufficient replicas"));
1228                         break;
1229
1230                 case VDEV_AUX_VERSION_NEWER:
1231                         (void) printf(gettext("newer version"));
1232                         break;
1233
1234                 case VDEV_AUX_ERR_EXCEEDED:
1235                         (void) printf(gettext("too many errors"));
1236                         break;
1237
1238                 default:
1239                         (void) printf(gettext("corrupted data"));
1240                         break;
1241                 }
1242         }
1243         (void) printf("\n");
1244
1245         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
1246             &child, &children) != 0)
1247                 return;
1248
1249         for (c = 0; c < children; c++) {
1250                 uint64_t is_log = B_FALSE;
1251
1252                 (void) nvlist_lookup_uint64(child[c], ZPOOL_CONFIG_IS_LOG,
1253                     &is_log);
1254                 if (is_log)
1255                         continue;
1256
1257                 vname = zpool_vdev_name(g_zfs, NULL, child[c], B_TRUE);
1258                 print_import_config(vname, child[c], namewidth, depth + 2);
1259                 free(vname);
1260         }
1261
1262         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_L2CACHE,
1263             &child, &children) == 0) {
1264                 (void) printf(gettext("\tcache\n"));
1265                 for (c = 0; c < children; c++) {
1266                         vname = zpool_vdev_name(g_zfs, NULL, child[c], B_FALSE);
1267                         (void) printf("\t  %s\n", vname);
1268                         free(vname);
1269                 }
1270         }
1271
1272         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_SPARES,
1273             &child, &children) == 0) {
1274                 (void) printf(gettext("\tspares\n"));
1275                 for (c = 0; c < children; c++) {
1276                         vname = zpool_vdev_name(g_zfs, NULL, child[c], B_FALSE);
1277                         (void) printf("\t  %s\n", vname);
1278                         free(vname);
1279                 }
1280         }
1281 }
1282
1283 /*
1284  * Print log vdevs.
1285  * Logs are recorded as top level vdevs in the main pool child array
1286  * but with "is_log" set to 1. We use either print_status_config() or
1287  * print_import_config() to print the top level logs then any log
1288  * children (eg mirrored slogs) are printed recursively - which
1289  * works because only the top level vdev is marked "is_log"
1290  */
1291 static void
1292 print_logs(zpool_handle_t *zhp, nvlist_t *nv, int namewidth, boolean_t verbose)
1293 {
1294         uint_t c, children;
1295         nvlist_t **child;
1296
1297         if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN, &child,
1298             &children) != 0)
1299                 return;
1300
1301         (void) printf(gettext("\tlogs\n"));
1302
1303         for (c = 0; c < children; c++) {
1304                 uint64_t is_log = B_FALSE;
1305                 char *name;
1306
1307                 (void) nvlist_lookup_uint64(child[c], ZPOOL_CONFIG_IS_LOG,
1308                     &is_log);
1309                 if (!is_log)
1310                         continue;
1311                 name = zpool_vdev_name(g_zfs, zhp, child[c], B_TRUE);
1312                 if (verbose)
1313                         print_status_config(zhp, name, child[c], namewidth,
1314                             2, B_FALSE);
1315                 else
1316                         print_import_config(name, child[c], namewidth, 2);
1317                 free(name);
1318         }
1319 }
1320
1321 /*
1322  * Display the status for the given pool.
1323  */
1324 static void
1325 show_import(nvlist_t *config)
1326 {
1327         uint64_t pool_state;
1328         vdev_stat_t *vs;
1329         char *name;
1330         uint64_t guid;
1331         char *msgid;
1332         nvlist_t *nvroot;
1333         int reason;
1334         const char *health;
1335         uint_t vsc;
1336         int namewidth;
1337
1338         verify(nvlist_lookup_string(config, ZPOOL_CONFIG_POOL_NAME,
1339             &name) == 0);
1340         verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_GUID,
1341             &guid) == 0);
1342         verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_STATE,
1343             &pool_state) == 0);
1344         verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
1345             &nvroot) == 0);
1346
1347         verify(nvlist_lookup_uint64_array(nvroot, ZPOOL_CONFIG_VDEV_STATS,
1348             (uint64_t **)&vs, &vsc) == 0);
1349         health = zpool_state_to_name(vs->vs_state, vs->vs_aux);
1350
1351         reason = zpool_import_status(config, &msgid);
1352
1353         (void) printf(gettext("  pool: %s\n"), name);
1354         (void) printf(gettext("    id: %llu\n"), (u_longlong_t)guid);
1355         (void) printf(gettext(" state: %s"), health);
1356         if (pool_state == POOL_STATE_DESTROYED)
1357                 (void) printf(gettext(" (DESTROYED)"));
1358         (void) printf("\n");
1359
1360         switch (reason) {
1361         case ZPOOL_STATUS_MISSING_DEV_R:
1362         case ZPOOL_STATUS_MISSING_DEV_NR:
1363         case ZPOOL_STATUS_BAD_GUID_SUM:
1364                 (void) printf(gettext("status: One or more devices are missing "
1365                     "from the system.\n"));
1366                 break;
1367
1368         case ZPOOL_STATUS_CORRUPT_LABEL_R:
1369         case ZPOOL_STATUS_CORRUPT_LABEL_NR:
1370                 (void) printf(gettext("status: One or more devices contains "
1371                     "corrupted data.\n"));
1372                 break;
1373
1374         case ZPOOL_STATUS_CORRUPT_DATA:
1375                 (void) printf(gettext("status: The pool data is corrupted.\n"));
1376                 break;
1377
1378         case ZPOOL_STATUS_OFFLINE_DEV:
1379                 (void) printf(gettext("status: One or more devices "
1380                     "are offlined.\n"));
1381                 break;
1382
1383         case ZPOOL_STATUS_CORRUPT_POOL:
1384                 (void) printf(gettext("status: The pool metadata is "
1385                     "corrupted.\n"));
1386                 break;
1387
1388         case ZPOOL_STATUS_VERSION_OLDER:
1389                 (void) printf(gettext("status: The pool is formatted using an "
1390                     "older on-disk version.\n"));
1391                 break;
1392
1393         case ZPOOL_STATUS_VERSION_NEWER:
1394                 (void) printf(gettext("status: The pool is formatted using an "
1395                     "incompatible version.\n"));
1396                 break;
1397
1398         case ZPOOL_STATUS_HOSTID_MISMATCH:
1399                 (void) printf(gettext("status: The pool was last accessed by "
1400                     "another system.\n"));
1401                 break;
1402
1403         case ZPOOL_STATUS_FAULTED_DEV_R:
1404         case ZPOOL_STATUS_FAULTED_DEV_NR:
1405                 (void) printf(gettext("status: One or more devices are "
1406                     "faulted.\n"));
1407                 break;
1408
1409         case ZPOOL_STATUS_BAD_LOG:
1410                 (void) printf(gettext("status: An intent log record cannot be "
1411                     "read.\n"));
1412                 break;
1413
1414         case ZPOOL_STATUS_RESILVERING:
1415                 (void) printf(gettext("status: One or more devices were being "
1416                     "resilvered.\n"));
1417                 break;
1418
1419         default:
1420                 /*
1421                  * No other status can be seen when importing pools.
1422                  */
1423                 assert(reason == ZPOOL_STATUS_OK);
1424         }
1425
1426         /*
1427          * Print out an action according to the overall state of the pool.
1428          */
1429         if (vs->vs_state == VDEV_STATE_HEALTHY) {
1430                 if (reason == ZPOOL_STATUS_VERSION_OLDER)
1431                         (void) printf(gettext("action: The pool can be "
1432                             "imported using its name or numeric identifier, "
1433                             "though\n\tsome features will not be available "
1434                             "without an explicit 'zpool upgrade'.\n"));
1435                 else if (reason == ZPOOL_STATUS_HOSTID_MISMATCH)
1436                         (void) printf(gettext("action: The pool can be "
1437                             "imported using its name or numeric "
1438                             "identifier and\n\tthe '-f' flag.\n"));
1439                 else
1440                         (void) printf(gettext("action: The pool can be "
1441                             "imported using its name or numeric "
1442                             "identifier.\n"));
1443         } else if (vs->vs_state == VDEV_STATE_DEGRADED) {
1444                 (void) printf(gettext("action: The pool can be imported "
1445                     "despite missing or damaged devices.  The\n\tfault "
1446                     "tolerance of the pool may be compromised if imported.\n"));
1447         } else {
1448                 switch (reason) {
1449                 case ZPOOL_STATUS_VERSION_NEWER:
1450                         (void) printf(gettext("action: The pool cannot be "
1451                             "imported.  Access the pool on a system running "
1452                             "newer\n\tsoftware, or recreate the pool from "
1453                             "backup.\n"));
1454                         break;
1455                 case ZPOOL_STATUS_MISSING_DEV_R:
1456                 case ZPOOL_STATUS_MISSING_DEV_NR:
1457                 case ZPOOL_STATUS_BAD_GUID_SUM:
1458                         (void) printf(gettext("action: The pool cannot be "
1459                             "imported. Attach the missing\n\tdevices and try "
1460                             "again.\n"));
1461                         break;
1462                 default:
1463                         (void) printf(gettext("action: The pool cannot be "
1464                             "imported due to damaged devices or data.\n"));
1465                 }
1466         }
1467
1468         /*
1469          * If the state is "closed" or "can't open", and the aux state
1470          * is "corrupt data":
1471          */
1472         if (((vs->vs_state == VDEV_STATE_CLOSED) ||
1473             (vs->vs_state == VDEV_STATE_CANT_OPEN)) &&
1474             (vs->vs_aux == VDEV_AUX_CORRUPT_DATA)) {
1475                 if (pool_state == POOL_STATE_DESTROYED)
1476                         (void) printf(gettext("\tThe pool was destroyed, "
1477                             "but can be imported using the '-Df' flags.\n"));
1478                 else if (pool_state != POOL_STATE_EXPORTED)
1479                         (void) printf(gettext("\tThe pool may be active on "
1480                             "another system, but can be imported using\n\t"
1481                             "the '-f' flag.\n"));
1482         }
1483
1484         if (msgid != NULL)
1485                 (void) printf(gettext("   see: http://zfsonlinux.org/msg/%s\n"),
1486                     msgid);
1487
1488         (void) printf(gettext("config:\n\n"));
1489
1490         namewidth = max_width(NULL, nvroot, 0, 0);
1491         if (namewidth < 10)
1492                 namewidth = 10;
1493
1494         print_import_config(name, nvroot, namewidth, 0);
1495         if (num_logs(nvroot) > 0)
1496                 print_logs(NULL, nvroot, namewidth, B_FALSE);
1497
1498         if (reason == ZPOOL_STATUS_BAD_GUID_SUM) {
1499                 (void) printf(gettext("\n\tAdditional devices are known to "
1500                     "be part of this pool, though their\n\texact "
1501                     "configuration cannot be determined.\n"));
1502         }
1503 }
1504
1505 /*
1506  * Perform the import for the given configuration.  This passes the heavy
1507  * lifting off to zpool_import_props(), and then mounts the datasets contained
1508  * within the pool.
1509  */
1510 static int
1511 do_import(nvlist_t *config, const char *newname, const char *mntopts,
1512     nvlist_t *props, int flags)
1513 {
1514         zpool_handle_t *zhp;
1515         char *name;
1516         uint64_t state;
1517         uint64_t version;
1518
1519         verify(nvlist_lookup_string(config, ZPOOL_CONFIG_POOL_NAME,
1520             &name) == 0);
1521
1522         verify(nvlist_lookup_uint64(config,
1523             ZPOOL_CONFIG_POOL_STATE, &state) == 0);
1524         verify(nvlist_lookup_uint64(config,
1525             ZPOOL_CONFIG_VERSION, &version) == 0);
1526         if (version > SPA_VERSION) {
1527                 (void) fprintf(stderr, gettext("cannot import '%s': pool "
1528                     "is formatted using a newer ZFS version\n"), name);
1529                 return (1);
1530         } else if (state != POOL_STATE_EXPORTED &&
1531             !(flags & ZFS_IMPORT_ANY_HOST)) {
1532                 uint64_t hostid;
1533
1534                 if (nvlist_lookup_uint64(config, ZPOOL_CONFIG_HOSTID,
1535                     &hostid) == 0) {
1536                         unsigned long system_hostid = gethostid() & 0xffffffff;
1537
1538                         if ((unsigned long)hostid != system_hostid) {
1539                                 char *hostname;
1540                                 uint64_t timestamp;
1541                                 time_t t;
1542
1543                                 verify(nvlist_lookup_string(config,
1544                                     ZPOOL_CONFIG_HOSTNAME, &hostname) == 0);
1545                                 verify(nvlist_lookup_uint64(config,
1546                                     ZPOOL_CONFIG_TIMESTAMP, &timestamp) == 0);
1547                                 t = timestamp;
1548                                 (void) fprintf(stderr, gettext("cannot import "
1549                                     "'%s': pool may be in use from other "
1550                                     "system, it was last accessed by %s "
1551                                     "(hostid: 0x%lx) on %s"), name, hostname,
1552                                     (unsigned long)hostid,
1553                                     asctime(localtime(&t)));
1554                                 (void) fprintf(stderr, gettext("use '-f' to "
1555                                     "import anyway\n"));
1556                                 return (1);
1557                         }
1558                 } else {
1559                         (void) fprintf(stderr, gettext("cannot import '%s': "
1560                             "pool may be in use from other system\n"), name);
1561                         (void) fprintf(stderr, gettext("use '-f' to import "
1562                             "anyway\n"));
1563                         return (1);
1564                 }
1565         }
1566
1567         if (zpool_import_props(g_zfs, config, newname, props, flags) != 0)
1568                 return (1);
1569
1570         if (newname != NULL)
1571                 name = (char *)newname;
1572
1573         if ((zhp = zpool_open_canfail(g_zfs, name)) == NULL)
1574                 return (1);
1575
1576         if (zpool_get_state(zhp) != POOL_STATE_UNAVAIL &&
1577             !(flags & ZFS_IMPORT_ONLY) &&
1578             zpool_enable_datasets(zhp, mntopts, 0) != 0) {
1579                 zpool_close(zhp);
1580                 return (1);
1581         }
1582
1583         zpool_close(zhp);
1584         return (0);
1585 }
1586
1587 /*
1588  * zpool import [-d dir] [-D]
1589  *       import [-o mntopts] [-o prop=value] ... [-R root] [-D]
1590  *              [-d dir | -c cachefile] [-f] -a
1591  *       import [-o mntopts] [-o prop=value] ... [-R root] [-D]
1592  *              [-d dir | -c cachefile] [-f] [-n] [-F] <pool | id> [newpool]
1593  *
1594  *       -c     Read pool information from a cachefile instead of searching
1595  *              devices.
1596  *
1597  *       -d     Scan in a specific directory, other than /dev/.  More than
1598  *              one directory can be specified using multiple '-d' options.
1599  *
1600  *       -D     Scan for previously destroyed pools or import all or only
1601  *              specified destroyed pools.
1602  *
1603  *       -R     Temporarily import the pool, with all mountpoints relative to
1604  *              the given root.  The pool will remain exported when the machine
1605  *              is rebooted.
1606  *
1607  *       -V     Import even in the presence of faulted vdevs.  This is an
1608  *              intentionally undocumented option for testing purposes, and
1609  *              treats the pool configuration as complete, leaving any bad
1610  *              vdevs in the FAULTED state. In other words, it does verbatim
1611  *              import.
1612  *
1613  *       -f     Force import, even if it appears that the pool is active.
1614  *
1615  *       -F     Attempt rewind if necessary.
1616  *
1617  *       -n     See if rewind would work, but don't actually rewind.
1618  *
1619  *       -N     Import the pool but don't mount datasets.
1620  *
1621  *       -T     Specify a starting txg to use for import. This option is
1622  *              intentionally undocumented option for testing purposes.
1623  *
1624  *       -a     Import all pools found.
1625  *
1626  *       -o     Set property=value and/or temporary mount options (without '=').
1627  *
1628  * The import command scans for pools to import, and import pools based on pool
1629  * name and GUID.  The pool can also be renamed as part of the import process.
1630  */
1631 int
1632 zpool_do_import(int argc, char **argv)
1633 {
1634         char **searchdirs = NULL;
1635         int nsearch = 0;
1636         int c;
1637         int err = 0;
1638         nvlist_t *pools = NULL;
1639         boolean_t do_all = B_FALSE;
1640         boolean_t do_destroyed = B_FALSE;
1641         char *mntopts = NULL;
1642         nvpair_t *elem;
1643         nvlist_t *config;
1644         uint64_t searchguid = 0;
1645         char *searchname = NULL;
1646         char *propval;
1647         nvlist_t *found_config;
1648         nvlist_t *policy = NULL;
1649         nvlist_t *props = NULL;
1650         boolean_t first;
1651         int flags = ZFS_IMPORT_NORMAL;
1652         uint32_t rewind_policy = ZPOOL_NO_REWIND;
1653         boolean_t dryrun = B_FALSE;
1654         boolean_t do_rewind = B_FALSE;
1655         boolean_t xtreme_rewind = B_FALSE;
1656         uint64_t pool_state, txg = -1ULL;
1657         char *cachefile = NULL;
1658         importargs_t idata = { 0 };
1659         char *endptr;
1660
1661         /* check options */
1662         while ((c = getopt(argc, argv, ":aCc:d:DEfFmnNo:rR:T:VX")) != -1) {
1663                 switch (c) {
1664                 case 'a':
1665                         do_all = B_TRUE;
1666                         break;
1667                 case 'c':
1668                         cachefile = optarg;
1669                         break;
1670                 case 'd':
1671                         if (searchdirs == NULL) {
1672                                 searchdirs = safe_malloc(sizeof (char *));
1673                         } else {
1674                                 char **tmp = safe_malloc((nsearch + 1) *
1675                                     sizeof (char *));
1676                                 bcopy(searchdirs, tmp, nsearch *
1677                                     sizeof (char *));
1678                                 free(searchdirs);
1679                                 searchdirs = tmp;
1680                         }
1681                         searchdirs[nsearch++] = optarg;
1682                         break;
1683                 case 'D':
1684                         do_destroyed = B_TRUE;
1685                         break;
1686                 case 'f':
1687                         flags |= ZFS_IMPORT_ANY_HOST;
1688                         break;
1689                 case 'F':
1690                         do_rewind = B_TRUE;
1691                         break;
1692                 case 'm':
1693                         flags |= ZFS_IMPORT_MISSING_LOG;
1694                         break;
1695                 case 'n':
1696                         dryrun = B_TRUE;
1697                         break;
1698                 case 'N':
1699                         flags |= ZFS_IMPORT_ONLY;
1700                         break;
1701                 case 'o':
1702                         if ((propval = strchr(optarg, '=')) != NULL) {
1703                                 *propval = '\0';
1704                                 propval++;
1705                                 if (add_prop_list(optarg, propval,
1706                                     &props, B_TRUE))
1707                                         goto error;
1708                         } else {
1709                                 mntopts = optarg;
1710                         }
1711                         break;
1712                 case 'R':
1713                         if (add_prop_list(zpool_prop_to_name(
1714                             ZPOOL_PROP_ALTROOT), optarg, &props, B_TRUE))
1715                                 goto error;
1716                         if (nvlist_lookup_string(props,
1717                             zpool_prop_to_name(ZPOOL_PROP_CACHEFILE),
1718                             &propval) == 0)
1719                                 break;
1720                         if (add_prop_list(zpool_prop_to_name(
1721                             ZPOOL_PROP_CACHEFILE), "none", &props, B_TRUE))
1722                                 goto error;
1723                         break;
1724                 case 'T':
1725                         errno = 0;
1726                         txg = strtoull(optarg, &endptr, 10);
1727                         if (errno != 0 || *endptr != '\0') {
1728                                 (void) fprintf(stderr,
1729                                     gettext("invalid txg value\n"));
1730                                 usage(B_FALSE);
1731                         }
1732                         rewind_policy = ZPOOL_DO_REWIND | ZPOOL_EXTREME_REWIND;
1733                         break;
1734                 case 'V':
1735                         flags |= ZFS_IMPORT_VERBATIM;
1736                         break;
1737                 case 'X':
1738                         xtreme_rewind = B_TRUE;
1739                         break;
1740                 case ':':
1741                         (void) fprintf(stderr, gettext("missing argument for "
1742                             "'%c' option\n"), optopt);
1743                         usage(B_FALSE);
1744                         break;
1745                 case '?':
1746                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
1747                             optopt);
1748                         usage(B_FALSE);
1749                 }
1750         }
1751
1752         argc -= optind;
1753         argv += optind;
1754
1755         if (cachefile && nsearch != 0) {
1756                 (void) fprintf(stderr, gettext("-c is incompatible with -d\n"));
1757                 usage(B_FALSE);
1758         }
1759
1760         if ((dryrun || xtreme_rewind) && !do_rewind) {
1761                 (void) fprintf(stderr,
1762                     gettext("-n or -X only meaningful with -F\n"));
1763                 usage(B_FALSE);
1764         }
1765         if (dryrun)
1766                 rewind_policy = ZPOOL_TRY_REWIND;
1767         else if (do_rewind)
1768                 rewind_policy = ZPOOL_DO_REWIND;
1769         if (xtreme_rewind)
1770                 rewind_policy |= ZPOOL_EXTREME_REWIND;
1771
1772         /* In the future, we can capture further policy and include it here */
1773         if (nvlist_alloc(&policy, NV_UNIQUE_NAME, 0) != 0 ||
1774             nvlist_add_uint64(policy, ZPOOL_REWIND_REQUEST_TXG, txg) != 0 ||
1775             nvlist_add_uint32(policy, ZPOOL_REWIND_REQUEST, rewind_policy) != 0)
1776                 goto error;
1777
1778         /* check argument count */
1779         if (do_all) {
1780                 if (argc != 0) {
1781                         (void) fprintf(stderr, gettext("too many arguments\n"));
1782                         usage(B_FALSE);
1783                 }
1784         } else {
1785                 if (argc > 2) {
1786                         (void) fprintf(stderr, gettext("too many arguments\n"));
1787                         usage(B_FALSE);
1788                 }
1789
1790                 /*
1791                  * Check for the SYS_CONFIG privilege.  We do this explicitly
1792                  * here because otherwise any attempt to discover pools will
1793                  * silently fail.
1794                  */
1795                 if (argc == 0 && !priv_ineffect(PRIV_SYS_CONFIG)) {
1796                         (void) fprintf(stderr, gettext("cannot "
1797                             "discover pools: permission denied\n"));
1798                         if (searchdirs != NULL)
1799                                 free(searchdirs);
1800
1801                         nvlist_free(policy);
1802                         return (1);
1803                 }
1804         }
1805
1806         /*
1807          * Depending on the arguments given, we do one of the following:
1808          *
1809          *      <none>  Iterate through all pools and display information about
1810          *              each one.
1811          *
1812          *      -a      Iterate through all pools and try to import each one.
1813          *
1814          *      <id>    Find the pool that corresponds to the given GUID/pool
1815          *              name and import that one.
1816          *
1817          *      -D      Above options applies only to destroyed pools.
1818          */
1819         if (argc != 0) {
1820                 char *endptr;
1821
1822                 errno = 0;
1823                 searchguid = strtoull(argv[0], &endptr, 10);
1824                 if (errno != 0 || *endptr != '\0')
1825                         searchname = argv[0];
1826                 found_config = NULL;
1827
1828                 /*
1829                  * User specified a name or guid.  Ensure it's unique.
1830                  */
1831                 idata.unique = B_TRUE;
1832         }
1833
1834
1835         idata.path = searchdirs;
1836         idata.paths = nsearch;
1837         idata.poolname = searchname;
1838         idata.guid = searchguid;
1839         idata.cachefile = cachefile;
1840
1841         pools = zpool_search_import(g_zfs, &idata);
1842
1843         if (pools != NULL && idata.exists &&
1844             (argc == 1 || strcmp(argv[0], argv[1]) == 0)) {
1845                 (void) fprintf(stderr, gettext("cannot import '%s': "
1846                     "a pool with that name already exists\n"),
1847                     argv[0]);
1848                 (void) fprintf(stderr, gettext("use the form '%s "
1849                     "<pool | id> <newpool>' to give it a new name\n"),
1850                     "zpool import");
1851                 err = 1;
1852         } else if (pools == NULL && idata.exists) {
1853                 (void) fprintf(stderr, gettext("cannot import '%s': "
1854                     "a pool with that name is already created/imported,\n"),
1855                     argv[0]);
1856                 (void) fprintf(stderr, gettext("and no additional pools "
1857                     "with that name were found\n"));
1858                 err = 1;
1859         } else if (pools == NULL) {
1860                 if (argc != 0) {
1861                         (void) fprintf(stderr, gettext("cannot import '%s': "
1862                             "no such pool available\n"), argv[0]);
1863                 }
1864                 err = 1;
1865         }
1866
1867         if (err == 1) {
1868                 if (searchdirs != NULL)
1869                         free(searchdirs);
1870                 nvlist_free(policy);
1871                 return (1);
1872         }
1873
1874         /*
1875          * At this point we have a list of import candidate configs. Even if
1876          * we were searching by pool name or guid, we still need to
1877          * post-process the list to deal with pool state and possible
1878          * duplicate names.
1879          */
1880         err = 0;
1881         elem = NULL;
1882         first = B_TRUE;
1883         while ((elem = nvlist_next_nvpair(pools, elem)) != NULL) {
1884
1885                 verify(nvpair_value_nvlist(elem, &config) == 0);
1886
1887                 verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_STATE,
1888                     &pool_state) == 0);
1889                 if (!do_destroyed && pool_state == POOL_STATE_DESTROYED)
1890                         continue;
1891                 if (do_destroyed && pool_state != POOL_STATE_DESTROYED)
1892                         continue;
1893
1894                 verify(nvlist_add_nvlist(config, ZPOOL_REWIND_POLICY,
1895                     policy) == 0);
1896
1897                 if (argc == 0) {
1898                         if (first)
1899                                 first = B_FALSE;
1900                         else if (!do_all)
1901                                 (void) printf("\n");
1902
1903                         if (do_all) {
1904                                 err |= do_import(config, NULL, mntopts,
1905                                     props, flags);
1906                         } else {
1907                                 show_import(config);
1908                         }
1909                 } else if (searchname != NULL) {
1910                         char *name;
1911
1912                         /*
1913                          * We are searching for a pool based on name.
1914                          */
1915                         verify(nvlist_lookup_string(config,
1916                             ZPOOL_CONFIG_POOL_NAME, &name) == 0);
1917
1918                         if (strcmp(name, searchname) == 0) {
1919                                 if (found_config != NULL) {
1920                                         (void) fprintf(stderr, gettext(
1921                                             "cannot import '%s': more than "
1922                                             "one matching pool\n"), searchname);
1923                                         (void) fprintf(stderr, gettext(
1924                                             "import by numeric ID instead\n"));
1925                                         err = B_TRUE;
1926                                 }
1927                                 found_config = config;
1928                         }
1929                 } else {
1930                         uint64_t guid;
1931
1932                         /*
1933                          * Search for a pool by guid.
1934                          */
1935                         verify(nvlist_lookup_uint64(config,
1936                             ZPOOL_CONFIG_POOL_GUID, &guid) == 0);
1937
1938                         if (guid == searchguid)
1939                                 found_config = config;
1940                 }
1941         }
1942
1943         /*
1944          * If we were searching for a specific pool, verify that we found a
1945          * pool, and then do the import.
1946          */
1947         if (argc != 0 && err == 0) {
1948                 if (found_config == NULL) {
1949                         (void) fprintf(stderr, gettext("cannot import '%s': "
1950                             "no such pool available\n"), argv[0]);
1951                         err = B_TRUE;
1952                 } else {
1953                         err |= do_import(found_config, argc == 1 ? NULL :
1954                             argv[1], mntopts, props, flags);
1955                 }
1956         }
1957
1958         /*
1959          * If we were just looking for pools, report an error if none were
1960          * found.
1961          */
1962         if (argc == 0 && first)
1963                 (void) fprintf(stderr,
1964                     gettext("no pools available to import\n"));
1965
1966 error:
1967         nvlist_free(props);
1968         nvlist_free(pools);
1969         nvlist_free(policy);
1970         if (searchdirs != NULL)
1971                 free(searchdirs);
1972
1973         return (err ? 1 : 0);
1974 }
1975
1976 typedef struct iostat_cbdata {
1977         zpool_list_t *cb_list;
1978         int cb_verbose;
1979         int cb_iteration;
1980         int cb_namewidth;
1981 } iostat_cbdata_t;
1982
1983 static void
1984 print_iostat_separator(iostat_cbdata_t *cb)
1985 {
1986         int i = 0;
1987
1988         for (i = 0; i < cb->cb_namewidth; i++)
1989                 (void) printf("-");
1990         (void) printf("  -----  -----  -----  -----  -----  -----\n");
1991 }
1992
1993 static void
1994 print_iostat_header(iostat_cbdata_t *cb)
1995 {
1996         (void) printf("%*s     capacity     operations    bandwidth\n",
1997             cb->cb_namewidth, "");
1998         (void) printf("%-*s  alloc   free   read  write   read  write\n",
1999             cb->cb_namewidth, "pool");
2000         print_iostat_separator(cb);
2001 }
2002
2003 /*
2004  * Display a single statistic.
2005  */
2006 static void
2007 print_one_stat(uint64_t value)
2008 {
2009         char buf[64];
2010
2011         zfs_nicenum(value, buf, sizeof (buf));
2012         (void) printf("  %5s", buf);
2013 }
2014
2015 /*
2016  * Print out all the statistics for the given vdev.  This can either be the
2017  * toplevel configuration, or called recursively.  If 'name' is NULL, then this
2018  * is a verbose output, and we don't want to display the toplevel pool stats.
2019  */
2020 void
2021 print_vdev_stats(zpool_handle_t *zhp, const char *name, nvlist_t *oldnv,
2022     nvlist_t *newnv, iostat_cbdata_t *cb, int depth)
2023 {
2024         nvlist_t **oldchild, **newchild;
2025         uint_t c, children;
2026         vdev_stat_t *oldvs, *newvs;
2027         vdev_stat_t zerovs = { 0 };
2028         uint64_t tdelta;
2029         double scale;
2030         char *vname;
2031
2032         if (oldnv != NULL) {
2033                 verify(nvlist_lookup_uint64_array(oldnv,
2034                     ZPOOL_CONFIG_VDEV_STATS, (uint64_t **)&oldvs, &c) == 0);
2035         } else {
2036                 oldvs = &zerovs;
2037         }
2038
2039         verify(nvlist_lookup_uint64_array(newnv, ZPOOL_CONFIG_VDEV_STATS,
2040             (uint64_t **)&newvs, &c) == 0);
2041
2042         if (strlen(name) + depth > cb->cb_namewidth)
2043                 (void) printf("%*s%s", depth, "", name);
2044         else
2045                 (void) printf("%*s%s%*s", depth, "", name,
2046                     (int)(cb->cb_namewidth - strlen(name) - depth), "");
2047
2048         tdelta = newvs->vs_timestamp - oldvs->vs_timestamp;
2049
2050         if (tdelta == 0)
2051                 scale = 1.0;
2052         else
2053                 scale = (double)NANOSEC / tdelta;
2054
2055         /* only toplevel vdevs have capacity stats */
2056         if (newvs->vs_space == 0) {
2057                 (void) printf("      -      -");
2058         } else {
2059                 print_one_stat(newvs->vs_alloc);
2060                 print_one_stat(newvs->vs_space - newvs->vs_alloc);
2061         }
2062
2063         print_one_stat((uint64_t)(scale * (newvs->vs_ops[ZIO_TYPE_READ] -
2064             oldvs->vs_ops[ZIO_TYPE_READ])));
2065
2066         print_one_stat((uint64_t)(scale * (newvs->vs_ops[ZIO_TYPE_WRITE] -
2067             oldvs->vs_ops[ZIO_TYPE_WRITE])));
2068
2069         print_one_stat((uint64_t)(scale * (newvs->vs_bytes[ZIO_TYPE_READ] -
2070             oldvs->vs_bytes[ZIO_TYPE_READ])));
2071
2072         print_one_stat((uint64_t)(scale * (newvs->vs_bytes[ZIO_TYPE_WRITE] -
2073             oldvs->vs_bytes[ZIO_TYPE_WRITE])));
2074
2075         (void) printf("\n");
2076
2077         if (!cb->cb_verbose)
2078                 return;
2079
2080         if (nvlist_lookup_nvlist_array(newnv, ZPOOL_CONFIG_CHILDREN,
2081             &newchild, &children) != 0)
2082                 return;
2083
2084         if (oldnv && nvlist_lookup_nvlist_array(oldnv, ZPOOL_CONFIG_CHILDREN,
2085             &oldchild, &c) != 0)
2086                 return;
2087
2088         for (c = 0; c < children; c++) {
2089                 uint64_t ishole = B_FALSE;
2090
2091                 if (nvlist_lookup_uint64(newchild[c],
2092                     ZPOOL_CONFIG_IS_HOLE, &ishole) == 0 && ishole)
2093                         continue;
2094
2095                 vname = zpool_vdev_name(g_zfs, zhp, newchild[c], B_FALSE);
2096                 print_vdev_stats(zhp, vname, oldnv ? oldchild[c] : NULL,
2097                     newchild[c], cb, depth + 2);
2098                 free(vname);
2099         }
2100
2101         /*
2102          * Include level 2 ARC devices in iostat output
2103          */
2104         if (nvlist_lookup_nvlist_array(newnv, ZPOOL_CONFIG_L2CACHE,
2105             &newchild, &children) != 0)
2106                 return;
2107
2108         if (oldnv && nvlist_lookup_nvlist_array(oldnv, ZPOOL_CONFIG_L2CACHE,
2109             &oldchild, &c) != 0)
2110                 return;
2111
2112         if (children > 0) {
2113                 (void) printf("%-*s      -      -      -      -      -      "
2114                     "-\n", cb->cb_namewidth, "cache");
2115                 for (c = 0; c < children; c++) {
2116                         vname = zpool_vdev_name(g_zfs, zhp, newchild[c],
2117                             B_FALSE);
2118                         print_vdev_stats(zhp, vname, oldnv ? oldchild[c] : NULL,
2119                             newchild[c], cb, depth + 2);
2120                         free(vname);
2121                 }
2122         }
2123 }
2124
2125 static int
2126 refresh_iostat(zpool_handle_t *zhp, void *data)
2127 {
2128         iostat_cbdata_t *cb = data;
2129         boolean_t missing;
2130
2131         /*
2132          * If the pool has disappeared, remove it from the list and continue.
2133          */
2134         if (zpool_refresh_stats(zhp, &missing) != 0)
2135                 return (-1);
2136
2137         if (missing)
2138                 pool_list_remove(cb->cb_list, zhp);
2139
2140         return (0);
2141 }
2142
2143 /*
2144  * Callback to print out the iostats for the given pool.
2145  */
2146 int
2147 print_iostat(zpool_handle_t *zhp, void *data)
2148 {
2149         iostat_cbdata_t *cb = data;
2150         nvlist_t *oldconfig, *newconfig;
2151         nvlist_t *oldnvroot, *newnvroot;
2152
2153         newconfig = zpool_get_config(zhp, &oldconfig);
2154
2155         if (cb->cb_iteration == 1)
2156                 oldconfig = NULL;
2157
2158         verify(nvlist_lookup_nvlist(newconfig, ZPOOL_CONFIG_VDEV_TREE,
2159             &newnvroot) == 0);
2160
2161         if (oldconfig == NULL)
2162                 oldnvroot = NULL;
2163         else
2164                 verify(nvlist_lookup_nvlist(oldconfig, ZPOOL_CONFIG_VDEV_TREE,
2165                     &oldnvroot) == 0);
2166
2167         /*
2168          * Print out the statistics for the pool.
2169          */
2170         print_vdev_stats(zhp, zpool_get_name(zhp), oldnvroot, newnvroot, cb, 0);
2171
2172         if (cb->cb_verbose)
2173                 print_iostat_separator(cb);
2174
2175         return (0);
2176 }
2177
2178 static int
2179 get_columns(void)
2180 {
2181         struct winsize ws;
2182         int columns = 80;
2183         int error;
2184
2185         if (isatty(STDOUT_FILENO)) {
2186                 error = ioctl(STDOUT_FILENO, TIOCGWINSZ, &ws);
2187                 if (error == 0)
2188                         columns = ws.ws_col;
2189         } else {
2190                 columns = 999;
2191         }
2192
2193         return columns;
2194 }
2195
2196 int
2197 get_namewidth(zpool_handle_t *zhp, void *data)
2198 {
2199         iostat_cbdata_t *cb = data;
2200         nvlist_t *config, *nvroot;
2201         int columns;
2202
2203         if ((config = zpool_get_config(zhp, NULL)) != NULL) {
2204                 verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
2205                     &nvroot) == 0);
2206                 if (!cb->cb_verbose)
2207                         cb->cb_namewidth = strlen(zpool_get_name(zhp));
2208                 else
2209                         cb->cb_namewidth = max_width(zhp, nvroot, 0, 0);
2210         }
2211
2212         /*
2213          * The width must be at least 10, but may be as large as the
2214          * column width - 42 so that we can still fit in one line.
2215          */
2216         columns = get_columns();
2217
2218         if (cb->cb_namewidth < 10)
2219                 cb->cb_namewidth = 10;
2220         if (cb->cb_namewidth > columns - 42)
2221                 cb->cb_namewidth = columns - 42;
2222
2223         return (0);
2224 }
2225
2226 /*
2227  * Parse the input string, get the 'interval' and 'count' value if there is one.
2228  */
2229 static void
2230 get_interval_count(int *argcp, char **argv, unsigned long *iv,
2231     unsigned long *cnt)
2232 {
2233         unsigned long interval = 0, count = 0;
2234         int argc = *argcp;
2235
2236         /*
2237          * Determine if the last argument is an integer or a pool name
2238          */
2239         if (argc > 0 && isdigit(argv[argc - 1][0])) {
2240                 char *end;
2241
2242                 errno = 0;
2243                 interval = strtoul(argv[argc - 1], &end, 10);
2244
2245                 if (*end == '\0' && errno == 0) {
2246                         if (interval == 0) {
2247                                 (void) fprintf(stderr, gettext("interval "
2248                                     "cannot be zero\n"));
2249                                 usage(B_FALSE);
2250                         }
2251                         /*
2252                          * Ignore the last parameter
2253                          */
2254                         argc--;
2255                 } else {
2256                         /*
2257                          * If this is not a valid number, just plow on.  The
2258                          * user will get a more informative error message later
2259                          * on.
2260                          */
2261                         interval = 0;
2262                 }
2263         }
2264
2265         /*
2266          * If the last argument is also an integer, then we have both a count
2267          * and an interval.
2268          */
2269         if (argc > 0 && isdigit(argv[argc - 1][0])) {
2270                 char *end;
2271
2272                 errno = 0;
2273                 count = interval;
2274                 interval = strtoul(argv[argc - 1], &end, 10);
2275
2276                 if (*end == '\0' && errno == 0) {
2277                         if (interval == 0) {
2278                                 (void) fprintf(stderr, gettext("interval "
2279                                     "cannot be zero\n"));
2280                                 usage(B_FALSE);
2281                         }
2282
2283                         /*
2284                          * Ignore the last parameter
2285                          */
2286                         argc--;
2287                 } else {
2288                         interval = 0;
2289                 }
2290         }
2291
2292         *iv = interval;
2293         *cnt = count;
2294         *argcp = argc;
2295 }
2296
2297 static void
2298 get_timestamp_arg(char c)
2299 {
2300         if (c == 'u')
2301                 timestamp_fmt = UDATE;
2302         else if (c == 'd')
2303                 timestamp_fmt = DDATE;
2304         else
2305                 usage(B_FALSE);
2306 }
2307
2308 /*
2309  * zpool iostat [-v] [-T d|u] [pool] ... [interval [count]]
2310  *
2311  *      -v      Display statistics for individual vdevs
2312  *      -T      Display a timestamp in date(1) or Unix format
2313  *
2314  * This command can be tricky because we want to be able to deal with pool
2315  * creation/destruction as well as vdev configuration changes.  The bulk of this
2316  * processing is handled by the pool_list_* routines in zpool_iter.c.  We rely
2317  * on pool_list_update() to detect the addition of new pools.  Configuration
2318  * changes are all handled within libzfs.
2319  */
2320 int
2321 zpool_do_iostat(int argc, char **argv)
2322 {
2323         int c;
2324         int ret;
2325         int npools;
2326         unsigned long interval = 0, count = 0;
2327         zpool_list_t *list;
2328         boolean_t verbose = B_FALSE;
2329         iostat_cbdata_t cb;
2330
2331         /* check options */
2332         while ((c = getopt(argc, argv, "T:v")) != -1) {
2333                 switch (c) {
2334                 case 'T':
2335                         get_timestamp_arg(*optarg);
2336                         break;
2337                 case 'v':
2338                         verbose = B_TRUE;
2339                         break;
2340                 case '?':
2341                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2342                             optopt);
2343                         usage(B_FALSE);
2344                 }
2345         }
2346
2347         argc -= optind;
2348         argv += optind;
2349
2350         get_interval_count(&argc, argv, &interval, &count);
2351
2352         /*
2353          * Construct the list of all interesting pools.
2354          */
2355         ret = 0;
2356         if ((list = pool_list_get(argc, argv, NULL, &ret)) == NULL)
2357                 return (1);
2358
2359         if (pool_list_count(list) == 0 && argc != 0) {
2360                 pool_list_free(list);
2361                 return (1);
2362         }
2363
2364         if (pool_list_count(list) == 0 && interval == 0) {
2365                 pool_list_free(list);
2366                 (void) fprintf(stderr, gettext("no pools available\n"));
2367                 return (1);
2368         }
2369
2370         /*
2371          * Enter the main iostat loop.
2372          */
2373         cb.cb_list = list;
2374         cb.cb_verbose = verbose;
2375         cb.cb_iteration = 0;
2376         cb.cb_namewidth = 0;
2377
2378         for (;;) {
2379                 pool_list_update(list);
2380
2381                 if ((npools = pool_list_count(list)) == 0)
2382                         (void) fprintf(stderr, gettext("no pools available\n"));
2383                 else {
2384                         /*
2385                          * Refresh all statistics.  This is done as an
2386                          * explicit step before calculating the maximum name
2387                          * width, so that any * configuration changes are
2388                          * properly accounted for.
2389                          */
2390                         (void) pool_list_iter(list, B_FALSE, refresh_iostat,
2391                                 &cb);
2392
2393                         /*
2394                          * Iterate over all pools to determine the maximum width
2395                          * for the pool / device name column across all pools.
2396                          */
2397                         cb.cb_namewidth = 0;
2398                         (void) pool_list_iter(list, B_FALSE, get_namewidth,
2399                                 &cb);
2400
2401                         if (timestamp_fmt != NODATE)
2402                                 print_timestamp(timestamp_fmt);
2403
2404                         /*
2405                          * If it's the first time, or verbose mode, print the
2406                          * header.
2407                          */
2408                         if (++cb.cb_iteration == 1 || verbose)
2409                                 print_iostat_header(&cb);
2410
2411                         (void) pool_list_iter(list, B_FALSE, print_iostat, &cb);
2412
2413                         /*
2414                          * If there's more than one pool, and we're not in
2415                          * verbose mode (which prints a separator for us),
2416                          * then print a separator.
2417                          */
2418                         if (npools > 1 && !verbose)
2419                                 print_iostat_separator(&cb);
2420
2421                         if (verbose)
2422                                 (void) printf("\n");
2423                 }
2424
2425                 /*
2426                  * Flush the output so that redirection to a file isn't buffered
2427                  * indefinitely.
2428                  */
2429                 (void) fflush(stdout);
2430
2431                 if (interval == 0)
2432                         break;
2433
2434                 if (count != 0 && --count == 0)
2435                         break;
2436
2437                 (void) sleep(interval);
2438         }
2439
2440         pool_list_free(list);
2441
2442         return (ret);
2443 }
2444
2445 typedef struct list_cbdata {
2446         boolean_t       cb_scripted;
2447         boolean_t       cb_first;
2448         zprop_list_t    *cb_proplist;
2449 } list_cbdata_t;
2450
2451 /*
2452  * Given a list of columns to display, output appropriate headers for each one.
2453  */
2454 static void
2455 print_header(zprop_list_t *pl)
2456 {
2457         const char *header;
2458         boolean_t first = B_TRUE;
2459         boolean_t right_justify;
2460
2461         for (; pl != NULL; pl = pl->pl_next) {
2462                 if (pl->pl_prop == ZPROP_INVAL)
2463                         continue;
2464
2465                 if (!first)
2466                         (void) printf("  ");
2467                 else
2468                         first = B_FALSE;
2469
2470                 header = zpool_prop_column_name(pl->pl_prop);
2471                 right_justify = zpool_prop_align_right(pl->pl_prop);
2472
2473                 if (pl->pl_next == NULL && !right_justify)
2474                         (void) printf("%s", header);
2475                 else if (right_justify)
2476                         (void) printf("%*s", (int)pl->pl_width, header);
2477                 else
2478                         (void) printf("%-*s", (int)pl->pl_width, header);
2479         }
2480
2481         (void) printf("\n");
2482 }
2483
2484 /*
2485  * Given a pool and a list of properties, print out all the properties according
2486  * to the described layout.
2487  */
2488 static void
2489 print_pool(zpool_handle_t *zhp, zprop_list_t *pl, int scripted)
2490 {
2491         boolean_t first = B_TRUE;
2492         char property[ZPOOL_MAXPROPLEN];
2493         char *propstr;
2494         boolean_t right_justify;
2495         int width;
2496
2497         for (; pl != NULL; pl = pl->pl_next) {
2498                 if (!first) {
2499                         if (scripted)
2500                                 (void) printf("\t");
2501                         else
2502                                 (void) printf("  ");
2503                 } else {
2504                         first = B_FALSE;
2505                 }
2506
2507                 right_justify = B_FALSE;
2508                 if (pl->pl_prop != ZPROP_INVAL) {
2509                         if (zpool_get_prop(zhp, pl->pl_prop, property,
2510                             sizeof (property), NULL) != 0)
2511                                 propstr = "-";
2512                         else
2513                                 propstr = property;
2514
2515                         right_justify = zpool_prop_align_right(pl->pl_prop);
2516                 } else {
2517                         propstr = "-";
2518                 }
2519
2520                 width = pl->pl_width;
2521
2522                 /*
2523                  * If this is being called in scripted mode, or if this is the
2524                  * last column and it is left-justified, don't include a width
2525                  * format specifier.
2526                  */
2527                 if (scripted || (pl->pl_next == NULL && !right_justify))
2528                         (void) printf("%s", propstr);
2529                 else if (right_justify)
2530                         (void) printf("%*s", width, propstr);
2531                 else
2532                         (void) printf("%-*s", width, propstr);
2533         }
2534
2535         (void) printf("\n");
2536 }
2537
2538 /*
2539  * Generic callback function to list a pool.
2540  */
2541 int
2542 list_callback(zpool_handle_t *zhp, void *data)
2543 {
2544         list_cbdata_t *cbp = data;
2545
2546         if (cbp->cb_first) {
2547                 if (!cbp->cb_scripted)
2548                         print_header(cbp->cb_proplist);
2549                 cbp->cb_first = B_FALSE;
2550         }
2551
2552         print_pool(zhp, cbp->cb_proplist, cbp->cb_scripted);
2553
2554         return (0);
2555 }
2556
2557 /*
2558  * zpool list [-H] [-o prop[,prop]*] [-T d|u] [pool] ... [interval [count]]
2559  *
2560  *      -H      Scripted mode.  Don't display headers, and separate properties
2561  *              by a single tab.
2562  *      -o      List of properties to display.  Defaults to
2563  *              "name,size,allocated,free,capacity,health,altroot"
2564  *      -T      Display a timestamp in date(1) or Unix format
2565  *
2566  * List all pools in the system, whether or not they're healthy.  Output space
2567  * statistics for each one, as well as health status summary.
2568  */
2569 int
2570 zpool_do_list(int argc, char **argv)
2571 {
2572         int c;
2573         int ret;
2574         list_cbdata_t cb = { 0 };
2575         static char default_props[] =
2576             "name,size,allocated,free,capacity,dedupratio,health,altroot";
2577         char *props = default_props;
2578         unsigned long interval = 0, count = 0;
2579
2580         /* check options */
2581         while ((c = getopt(argc, argv, ":Ho:T:")) != -1) {
2582                 switch (c) {
2583                 case 'H':
2584                         cb.cb_scripted = B_TRUE;
2585                         break;
2586                 case 'o':
2587                         props = optarg;
2588                         break;
2589                 case 'T':
2590                         get_timestamp_arg(*optarg);
2591                         break;
2592                 case ':':
2593                         (void) fprintf(stderr, gettext("missing argument for "
2594                             "'%c' option\n"), optopt);
2595                         usage(B_FALSE);
2596                         break;
2597                 case '?':
2598                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2599                             optopt);
2600                         usage(B_FALSE);
2601                 }
2602         }
2603
2604         argc -= optind;
2605         argv += optind;
2606
2607         get_interval_count(&argc, argv, &interval, &count);
2608
2609         if (zprop_get_list(g_zfs, props, &cb.cb_proplist, ZFS_TYPE_POOL) != 0)
2610                 usage(B_FALSE);
2611
2612         cb.cb_first = B_TRUE;
2613
2614         for (;;) {
2615
2616                 if (timestamp_fmt != NODATE)
2617                         print_timestamp(timestamp_fmt);
2618
2619                 ret = for_each_pool(argc, argv, B_TRUE, &cb.cb_proplist,
2620                     list_callback, &cb);
2621
2622                 if (argc == 0 && cb.cb_first)
2623                         (void) fprintf(stderr, gettext("no pools available\n"));
2624                 else if (argc && cb.cb_first) {
2625                         /* cannot open the given pool */
2626                         zprop_free_list(cb.cb_proplist);
2627                         return (1);
2628                 }
2629
2630                 if (interval == 0)
2631                         break;
2632
2633                 if (count != 0 && --count == 0)
2634                         break;
2635
2636                 (void) sleep(interval);
2637         }
2638
2639         zprop_free_list(cb.cb_proplist);
2640         return (ret);
2641 }
2642
2643 static int
2644 zpool_do_attach_or_replace(int argc, char **argv, int replacing)
2645 {
2646         boolean_t force = B_FALSE;
2647         int c;
2648         nvlist_t *nvroot;
2649         char *poolname, *old_disk, *new_disk;
2650         zpool_handle_t *zhp;
2651         int ret;
2652
2653         /* check options */
2654         while ((c = getopt(argc, argv, "f")) != -1) {
2655                 switch (c) {
2656                 case 'f':
2657                         force = B_TRUE;
2658                         break;
2659                 case '?':
2660                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2661                             optopt);
2662                         usage(B_FALSE);
2663                 }
2664         }
2665
2666         argc -= optind;
2667         argv += optind;
2668
2669         /* get pool name and check number of arguments */
2670         if (argc < 1) {
2671                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
2672                 usage(B_FALSE);
2673         }
2674
2675         poolname = argv[0];
2676
2677         if (argc < 2) {
2678                 (void) fprintf(stderr,
2679                     gettext("missing <device> specification\n"));
2680                 usage(B_FALSE);
2681         }
2682
2683         old_disk = argv[1];
2684
2685         if (argc < 3) {
2686                 if (!replacing) {
2687                         (void) fprintf(stderr,
2688                             gettext("missing <new_device> specification\n"));
2689                         usage(B_FALSE);
2690                 }
2691                 new_disk = old_disk;
2692                 argc -= 1;
2693                 argv += 1;
2694         } else {
2695                 new_disk = argv[2];
2696                 argc -= 2;
2697                 argv += 2;
2698         }
2699
2700         if (argc > 1) {
2701                 (void) fprintf(stderr, gettext("too many arguments\n"));
2702                 usage(B_FALSE);
2703         }
2704
2705         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
2706                 return (1);
2707
2708         if (zpool_get_config(zhp, NULL) == NULL) {
2709                 (void) fprintf(stderr, gettext("pool '%s' is unavailable\n"),
2710                     poolname);
2711                 zpool_close(zhp);
2712                 return (1);
2713         }
2714
2715         nvroot = make_root_vdev(zhp, NULL, force, B_FALSE, replacing, B_FALSE,
2716             argc, argv);
2717         if (nvroot == NULL) {
2718                 zpool_close(zhp);
2719                 return (1);
2720         }
2721
2722         ret = zpool_vdev_attach(zhp, old_disk, new_disk, nvroot, replacing);
2723
2724         nvlist_free(nvroot);
2725         zpool_close(zhp);
2726
2727         return (ret);
2728 }
2729
2730 /*
2731  * zpool replace [-f] <pool> <device> <new_device>
2732  *
2733  *      -f      Force attach, even if <new_device> appears to be in use.
2734  *
2735  * Replace <device> with <new_device>.
2736  */
2737 /* ARGSUSED */
2738 int
2739 zpool_do_replace(int argc, char **argv)
2740 {
2741         return (zpool_do_attach_or_replace(argc, argv, B_TRUE));
2742 }
2743
2744 /*
2745  * zpool attach [-f] <pool> <device> <new_device>
2746  *
2747  *      -f      Force attach, even if <new_device> appears to be in use.
2748  *
2749  * Attach <new_device> to the mirror containing <device>.  If <device> is not
2750  * part of a mirror, then <device> will be transformed into a mirror of
2751  * <device> and <new_device>.  In either case, <new_device> will begin life
2752  * with a DTL of [0, now], and will immediately begin to resilver itself.
2753  */
2754 int
2755 zpool_do_attach(int argc, char **argv)
2756 {
2757         return (zpool_do_attach_or_replace(argc, argv, B_FALSE));
2758 }
2759
2760 /*
2761  * zpool detach [-f] <pool> <device>
2762  *
2763  *      -f      Force detach of <device>, even if DTLs argue against it
2764  *              (not supported yet)
2765  *
2766  * Detach a device from a mirror.  The operation will be refused if <device>
2767  * is the last device in the mirror, or if the DTLs indicate that this device
2768  * has the only valid copy of some data.
2769  */
2770 /* ARGSUSED */
2771 int
2772 zpool_do_detach(int argc, char **argv)
2773 {
2774         int c;
2775         char *poolname, *path;
2776         zpool_handle_t *zhp;
2777         int ret;
2778
2779         /* check options */
2780         while ((c = getopt(argc, argv, "f")) != -1) {
2781                 switch (c) {
2782                 case 'f':
2783                 case '?':
2784                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2785                             optopt);
2786                         usage(B_FALSE);
2787                 }
2788         }
2789
2790         argc -= optind;
2791         argv += optind;
2792
2793         /* get pool name and check number of arguments */
2794         if (argc < 1) {
2795                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
2796                 usage(B_FALSE);
2797         }
2798
2799         if (argc < 2) {
2800                 (void) fprintf(stderr,
2801                     gettext("missing <device> specification\n"));
2802                 usage(B_FALSE);
2803         }
2804
2805         poolname = argv[0];
2806         path = argv[1];
2807
2808         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
2809                 return (1);
2810
2811         ret = zpool_vdev_detach(zhp, path);
2812
2813         zpool_close(zhp);
2814
2815         return (ret);
2816 }
2817
2818 /*
2819  * zpool split [-n] [-o prop=val] ...
2820  *              [-o mntopt] ...
2821  *              [-R altroot] <pool> <newpool> [<device> ...]
2822  *
2823  *      -n      Do not split the pool, but display the resulting layout if
2824  *              it were to be split.
2825  *      -o      Set property=value, or set mount options.
2826  *      -R      Mount the split-off pool under an alternate root.
2827  *
2828  * Splits the named pool and gives it the new pool name.  Devices to be split
2829  * off may be listed, provided that no more than one device is specified
2830  * per top-level vdev mirror.  The newly split pool is left in an exported
2831  * state unless -R is specified.
2832  *
2833  * Restrictions: the top-level of the pool pool must only be made up of
2834  * mirrors; all devices in the pool must be healthy; no device may be
2835  * undergoing a resilvering operation.
2836  */
2837 int
2838 zpool_do_split(int argc, char **argv)
2839 {
2840         char *srcpool, *newpool, *propval;
2841         char *mntopts = NULL;
2842         splitflags_t flags;
2843         int c, ret = 0;
2844         zpool_handle_t *zhp;
2845         nvlist_t *config, *props = NULL;
2846
2847         flags.dryrun = B_FALSE;
2848         flags.import = B_FALSE;
2849
2850         /* check options */
2851         while ((c = getopt(argc, argv, ":R:no:")) != -1) {
2852                 switch (c) {
2853                 case 'R':
2854                         flags.import = B_TRUE;
2855                         if (add_prop_list(
2856                             zpool_prop_to_name(ZPOOL_PROP_ALTROOT), optarg,
2857                             &props, B_TRUE) != 0) {
2858                                 if (props)
2859                                         nvlist_free(props);
2860                                 usage(B_FALSE);
2861                         }
2862                         break;
2863                 case 'n':
2864                         flags.dryrun = B_TRUE;
2865                         break;
2866                 case 'o':
2867                         if ((propval = strchr(optarg, '=')) != NULL) {
2868                                 *propval = '\0';
2869                                 propval++;
2870                                 if (add_prop_list(optarg, propval,
2871                                     &props, B_TRUE) != 0) {
2872                                         if (props)
2873                                                 nvlist_free(props);
2874                                         usage(B_FALSE);
2875                                 }
2876                         } else {
2877                                 mntopts = optarg;
2878                         }
2879                         break;
2880                 case ':':
2881                         (void) fprintf(stderr, gettext("missing argument for "
2882                             "'%c' option\n"), optopt);
2883                         usage(B_FALSE);
2884                         break;
2885                 case '?':
2886                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2887                             optopt);
2888                         usage(B_FALSE);
2889                         break;
2890                 }
2891         }
2892
2893         if (!flags.import && mntopts != NULL) {
2894                 (void) fprintf(stderr, gettext("setting mntopts is only "
2895                     "valid when importing the pool\n"));
2896                 usage(B_FALSE);
2897         }
2898
2899         argc -= optind;
2900         argv += optind;
2901
2902         if (argc < 1) {
2903                 (void) fprintf(stderr, gettext("Missing pool name\n"));
2904                 usage(B_FALSE);
2905         }
2906         if (argc < 2) {
2907                 (void) fprintf(stderr, gettext("Missing new pool name\n"));
2908                 usage(B_FALSE);
2909         }
2910
2911         srcpool = argv[0];
2912         newpool = argv[1];
2913
2914         argc -= 2;
2915         argv += 2;
2916
2917         if ((zhp = zpool_open(g_zfs, srcpool)) == NULL)
2918                 return (1);
2919
2920         config = split_mirror_vdev(zhp, newpool, props, flags, argc, argv);
2921         if (config == NULL) {
2922                 ret = 1;
2923         } else {
2924                 if (flags.dryrun) {
2925                         (void) printf(gettext("would create '%s' with the "
2926                             "following layout:\n\n"), newpool);
2927                         print_vdev_tree(NULL, newpool, config, 0, B_FALSE);
2928                 }
2929                 nvlist_free(config);
2930         }
2931
2932         zpool_close(zhp);
2933
2934         if (ret != 0 || flags.dryrun || !flags.import)
2935                 return (ret);
2936
2937         /*
2938          * The split was successful. Now we need to open the new
2939          * pool and import it.
2940          */
2941         if ((zhp = zpool_open_canfail(g_zfs, newpool)) == NULL)
2942                 return (1);
2943         if (zpool_get_state(zhp) != POOL_STATE_UNAVAIL &&
2944             zpool_enable_datasets(zhp, mntopts, 0) != 0) {
2945                 ret = 1;
2946                 (void) fprintf(stderr, gettext("Split was succssful, but "
2947                     "the datasets could not all be mounted\n"));
2948                 (void) fprintf(stderr, gettext("Try doing '%s' with a "
2949                     "different altroot\n"), "zpool import");
2950         }
2951         zpool_close(zhp);
2952
2953         return (ret);
2954 }
2955
2956
2957
2958 /*
2959  * zpool online <pool> <device> ...
2960  */
2961 int
2962 zpool_do_online(int argc, char **argv)
2963 {
2964         int c, i;
2965         char *poolname;
2966         zpool_handle_t *zhp;
2967         int ret = 0;
2968         vdev_state_t newstate;
2969         int flags = 0;
2970
2971         /* check options */
2972         while ((c = getopt(argc, argv, "et")) != -1) {
2973                 switch (c) {
2974                 case 'e':
2975                         flags |= ZFS_ONLINE_EXPAND;
2976                         break;
2977                 case 't':
2978                 case '?':
2979                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2980                             optopt);
2981                         usage(B_FALSE);
2982                 }
2983         }
2984
2985         argc -= optind;
2986         argv += optind;
2987
2988         /* get pool name and check number of arguments */
2989         if (argc < 1) {
2990                 (void) fprintf(stderr, gettext("missing pool name\n"));
2991                 usage(B_FALSE);
2992         }
2993         if (argc < 2) {
2994                 (void) fprintf(stderr, gettext("missing device name\n"));
2995                 usage(B_FALSE);
2996         }
2997
2998         poolname = argv[0];
2999
3000         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
3001                 return (1);
3002
3003         for (i = 1; i < argc; i++) {
3004                 if (zpool_vdev_online(zhp, argv[i], flags, &newstate) == 0) {
3005                         if (newstate != VDEV_STATE_HEALTHY) {
3006                                 (void) printf(gettext("warning: device '%s' "
3007                                     "onlined, but remains in faulted state\n"),
3008                                     argv[i]);
3009                                 if (newstate == VDEV_STATE_FAULTED)
3010                                         (void) printf(gettext("use 'zpool "
3011                                             "clear' to restore a faulted "
3012                                             "device\n"));
3013                                 else
3014                                         (void) printf(gettext("use 'zpool "
3015                                             "replace' to replace devices "
3016                                             "that are no longer present\n"));
3017                         }
3018                 } else {
3019                         ret = 1;
3020                 }
3021         }
3022
3023         zpool_close(zhp);
3024
3025         return (ret);
3026 }
3027
3028 /*
3029  * zpool offline [-ft] <pool> <device> ...
3030  *
3031  *      -f      Force the device into the offline state, even if doing
3032  *              so would appear to compromise pool availability.
3033  *              (not supported yet)
3034  *
3035  *      -t      Only take the device off-line temporarily.  The offline
3036  *              state will not be persistent across reboots.
3037  */
3038 /* ARGSUSED */
3039 int
3040 zpool_do_offline(int argc, char **argv)
3041 {
3042         int c, i;
3043         char *poolname;
3044         zpool_handle_t *zhp;
3045         int ret = 0;
3046         boolean_t istmp = B_FALSE;
3047
3048         /* check options */
3049         while ((c = getopt(argc, argv, "ft")) != -1) {
3050                 switch (c) {
3051                 case 't':
3052                         istmp = B_TRUE;
3053                         break;
3054                 case 'f':
3055                 case '?':
3056                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
3057                             optopt);
3058                         usage(B_FALSE);
3059                 }
3060         }
3061
3062         argc -= optind;
3063         argv += optind;
3064
3065         /* get pool name and check number of arguments */
3066         if (argc < 1) {
3067                 (void) fprintf(stderr, gettext("missing pool name\n"));
3068                 usage(B_FALSE);
3069         }
3070         if (argc < 2) {
3071                 (void) fprintf(stderr, gettext("missing device name\n"));
3072                 usage(B_FALSE);
3073         }
3074
3075         poolname = argv[0];
3076
3077         if ((zhp = zpool_open(g_zfs, poolname)) == NULL)
3078                 return (1);
3079
3080         for (i = 1; i < argc; i++) {
3081                 if (zpool_vdev_offline(zhp, argv[i], istmp) != 0)
3082                         ret = 1;
3083         }
3084
3085         zpool_close(zhp);
3086
3087         return (ret);
3088 }
3089
3090 /*
3091  * zpool clear <pool> [device]
3092  *
3093  * Clear all errors associated with a pool or a particular device.
3094  */
3095 int
3096 zpool_do_clear(int argc, char **argv)
3097 {
3098         int c;
3099         int ret = 0;
3100         boolean_t dryrun = B_FALSE;
3101         boolean_t do_rewind = B_FALSE;
3102         boolean_t xtreme_rewind = B_FALSE;
3103         uint32_t rewind_policy = ZPOOL_NO_REWIND;
3104         nvlist_t *policy = NULL;
3105         zpool_handle_t *zhp;
3106         char *pool, *device;
3107
3108         /* check options */
3109         while ((c = getopt(argc, argv, "FnX")) != -1) {
3110                 switch (c) {
3111                 case 'F':
3112                         do_rewind = B_TRUE;
3113                         break;
3114                 case 'n':
3115                         dryrun = B_TRUE;
3116                         break;
3117                 case 'X':
3118                         xtreme_rewind = B_TRUE;
3119                         break;
3120                 case '?':
3121                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
3122                             optopt);
3123                         usage(B_FALSE);
3124                 }
3125         }
3126
3127         argc -= optind;
3128         argv += optind;
3129
3130         if (argc < 1) {
3131                 (void) fprintf(stderr, gettext("missing pool name\n"));
3132                 usage(B_FALSE);
3133         }
3134
3135         if (argc > 2) {
3136                 (void) fprintf(stderr, gettext("too many arguments\n"));
3137                 usage(B_FALSE);
3138         }
3139
3140         if ((dryrun || xtreme_rewind) && !do_rewind) {
3141                 (void) fprintf(stderr,
3142                     gettext("-n or -X only meaningful with -F\n"));
3143                 usage(B_FALSE);
3144         }
3145         if (dryrun)
3146                 rewind_policy = ZPOOL_TRY_REWIND;
3147         else if (do_rewind)
3148                 rewind_policy = ZPOOL_DO_REWIND;
3149         if (xtreme_rewind)
3150                 rewind_policy |= ZPOOL_EXTREME_REWIND;
3151
3152         /* In future, further rewind policy choices can be passed along here */
3153         if (nvlist_alloc(&policy, NV_UNIQUE_NAME, 0) != 0 ||
3154             nvlist_add_uint32(policy, ZPOOL_REWIND_REQUEST, rewind_policy) != 0)
3155                 return (1);
3156
3157         pool = argv[0];
3158         device = argc == 2 ? argv[1] : NULL;
3159
3160         if ((zhp = zpool_open_canfail(g_zfs, pool)) == NULL) {
3161                 nvlist_free(policy);
3162                 return (1);
3163         }
3164
3165         if (zpool_clear(zhp, device, policy) != 0)
3166                 ret = 1;
3167
3168         zpool_close(zhp);
3169
3170         nvlist_free(policy);
3171
3172         return (ret);
3173 }
3174
3175 typedef struct scrub_cbdata {
3176         int     cb_type;
3177         int     cb_argc;
3178         char    **cb_argv;
3179 } scrub_cbdata_t;
3180
3181 int
3182 scrub_callback(zpool_handle_t *zhp, void *data)
3183 {
3184         scrub_cbdata_t *cb = data;
3185         int err;
3186
3187         /*
3188          * Ignore faulted pools.
3189          */
3190         if (zpool_get_state(zhp) == POOL_STATE_UNAVAIL) {
3191                 (void) fprintf(stderr, gettext("cannot scrub '%s': pool is "
3192                     "currently unavailable\n"), zpool_get_name(zhp));
3193                 return (1);
3194         }
3195
3196         err = zpool_scan(zhp, cb->cb_type);
3197
3198         return (err != 0);
3199 }
3200
3201 /*
3202  * zpool scrub [-s] <pool> ...
3203  *
3204  *      -s      Stop.  Stops any in-progress scrub.
3205  */
3206 int
3207 zpool_do_scrub(int argc, char **argv)
3208 {
3209         int c;
3210         scrub_cbdata_t cb;
3211
3212         cb.cb_type = POOL_SCAN_SCRUB;
3213
3214         /* check options */
3215         while ((c = getopt(argc, argv, "s")) != -1) {
3216                 switch (c) {
3217                 case 's':
3218                         cb.cb_type = POOL_SCAN_NONE;
3219                         break;
3220                 case '?':
3221                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
3222                             optopt);
3223                         usage(B_FALSE);
3224                 }
3225         }
3226
3227         cb.cb_argc = argc;
3228         cb.cb_argv = argv;
3229         argc -= optind;
3230         argv += optind;
3231
3232         if (argc < 1) {
3233                 (void) fprintf(stderr, gettext("missing pool name argument\n"));
3234                 usage(B_FALSE);
3235         }
3236
3237         return (for_each_pool(argc, argv, B_TRUE, NULL, scrub_callback, &cb));
3238 }
3239
3240 typedef struct status_cbdata {
3241         int             cb_count;
3242         boolean_t       cb_allpools;
3243         boolean_t       cb_verbose;
3244         boolean_t       cb_explain;
3245         boolean_t       cb_first;
3246         boolean_t       cb_dedup_stats;
3247 } status_cbdata_t;
3248
3249 /*
3250  * Print out detailed scrub status.
3251  */
3252 void
3253 print_scan_status(pool_scan_stat_t *ps)
3254 {
3255         time_t start, end;
3256         uint64_t elapsed, mins_left, hours_left;
3257         uint64_t pass_exam, examined, total;
3258         uint_t rate;
3259         double fraction_done;
3260         char processed_buf[7], examined_buf[7], total_buf[7], rate_buf[7];
3261
3262         (void) printf(gettext(" scan: "));
3263
3264         /* If there's never been a scan, there's not much to say. */
3265         if (ps == NULL || ps->pss_func == POOL_SCAN_NONE ||
3266             ps->pss_func >= POOL_SCAN_FUNCS) {
3267                 (void) printf(gettext("none requested\n"));
3268                 return;
3269         }
3270
3271         start = ps->pss_start_time;
3272         end = ps->pss_end_time;
3273         zfs_nicenum(ps->pss_processed, processed_buf, sizeof (processed_buf));
3274
3275         assert(ps->pss_func == POOL_SCAN_SCRUB ||
3276             ps->pss_func == POOL_SCAN_RESILVER);
3277         /*
3278          * Scan is finished or canceled.
3279          */
3280         if (ps->pss_state == DSS_FINISHED) {
3281                 uint64_t minutes_taken = (end - start) / 60;
3282                 char *fmt = NULL;
3283
3284                 if (ps->pss_func == POOL_SCAN_SCRUB) {
3285                         fmt = gettext("scrub repaired %s in %lluh%um with "
3286                             "%llu errors on %s");
3287                 } else if (ps->pss_func == POOL_SCAN_RESILVER) {
3288                         fmt = gettext("resilvered %s in %lluh%um with "
3289                             "%llu errors on %s");
3290                 }
3291                 /* LINTED */
3292                 (void) printf(fmt, processed_buf,
3293                     (u_longlong_t)(minutes_taken / 60),
3294                     (uint_t)(minutes_taken % 60),
3295                     (u_longlong_t)ps->pss_errors,
3296                     ctime((time_t *)&end));
3297                 return;
3298         } else if (ps->pss_state == DSS_CANCELED) {
3299                 if (ps->pss_func == POOL_SCAN_SCRUB) {
3300                         (void) printf(gettext("scrub canceled on %s"),
3301                             ctime(&end));
3302                 } else if (ps->pss_func == POOL_SCAN_RESILVER) {
3303                         (void) printf(gettext("resilver canceled on %s"),
3304                             ctime(&end));
3305                 }
3306                 return;
3307         }
3308
3309         assert(ps->pss_state == DSS_SCANNING);
3310
3311         /*
3312          * Scan is in progress.
3313          */
3314         if (ps->pss_func == POOL_SCAN_SCRUB) {
3315                 (void) printf(gettext("scrub in progress since %s"),
3316                     ctime(&start));
3317         } else if (ps->pss_func == POOL_SCAN_RESILVER) {
3318                 (void) printf(gettext("resilver in progress since %s"),
3319                     ctime(&start));
3320         }
3321
3322         examined = ps->pss_examined ? ps->pss_examined : 1;
3323         total = ps->pss_to_examine;
3324         fraction_done = (double)examined / total;
3325
3326         /* elapsed time for this pass */
3327         elapsed = time(NULL) - ps->pss_pass_start;
3328         elapsed = elapsed ? elapsed : 1;
3329         pass_exam = ps->pss_pass_exam ? ps->pss_pass_exam : 1;
3330         rate = pass_exam / elapsed;
3331         rate = rate ? rate : 1;
3332         mins_left = ((total - examined) / rate) / 60;
3333         hours_left = mins_left / 60;
3334
3335         zfs_nicenum(examined, examined_buf, sizeof (examined_buf));
3336         zfs_nicenum(total, total_buf, sizeof (total_buf));
3337         zfs_nicenum(rate, rate_buf, sizeof (rate_buf));
3338
3339         /*
3340          * do not print estimated time if hours_left is more than 30 days
3341          */
3342         (void) printf(gettext("    %s scanned out of %s at %s/s"),
3343             examined_buf, total_buf, rate_buf);
3344         if (hours_left < (30 * 24)) {
3345                 (void) printf(gettext(", %lluh%um to go\n"),
3346                     (u_longlong_t)hours_left, (uint_t)(mins_left % 60));
3347         } else {
3348                 (void) printf(gettext(
3349                     ", (scan is slow, no estimated time)\n"));
3350         }
3351
3352         if (ps->pss_func == POOL_SCAN_RESILVER) {
3353                 (void) printf(gettext("    %s resilvered, %.2f%% done\n"),
3354                     processed_buf, 100 * fraction_done);
3355         } else if (ps->pss_func == POOL_SCAN_SCRUB) {
3356                 (void) printf(gettext("    %s repaired, %.2f%% done\n"),
3357                     processed_buf, 100 * fraction_done);
3358         }
3359 }
3360
3361 static void
3362 print_error_log(zpool_handle_t *zhp)
3363 {
3364         nvlist_t *nverrlist = NULL;
3365         nvpair_t *elem;
3366         char *pathname;
3367         size_t len = MAXPATHLEN * 2;
3368
3369         if (zpool_get_errlog(zhp, &nverrlist) != 0) {
3370                 (void) printf("errors: List of errors unavailable "
3371                     "(insufficient privileges)\n");
3372                 return;
3373         }
3374
3375         (void) printf("errors: Permanent errors have been "
3376             "detected in the following files:\n\n");
3377
3378         pathname = safe_malloc(len);
3379         elem = NULL;
3380         while ((elem = nvlist_next_nvpair(nverrlist, elem)) != NULL) {
3381                 nvlist_t *nv;
3382                 uint64_t dsobj, obj;
3383
3384                 verify(nvpair_value_nvlist(elem, &nv) == 0);
3385                 verify(nvlist_lookup_uint64(nv, ZPOOL_ERR_DATASET,
3386                     &dsobj) == 0);
3387                 verify(nvlist_lookup_uint64(nv, ZPOOL_ERR_OBJECT,
3388                     &obj) == 0);
3389                 zpool_obj_to_path(zhp, dsobj, obj, pathname, len);
3390                 (void) printf("%7s %s\n", "", pathname);
3391         }
3392         free(pathname);
3393         nvlist_free(nverrlist);
3394 }
3395
3396 static void
3397 print_spares(zpool_handle_t *zhp, nvlist_t **spares, uint_t nspares,
3398     int namewidth)
3399 {
3400         uint_t i;
3401         char *name;
3402
3403         if (nspares == 0)
3404                 return;
3405
3406         (void) printf(gettext("\tspares\n"));
3407
3408         for (i = 0; i < nspares; i++) {
3409                 name = zpool_vdev_name(g_zfs, zhp, spares[i], B_FALSE);
3410                 print_status_config(zhp, name, spares[i],
3411                     namewidth, 2, B_TRUE);
3412                 free(name);
3413         }
3414 }
3415
3416 static void
3417 print_l2cache(zpool_handle_t *zhp, nvlist_t **l2cache, uint_t nl2cache,
3418     int namewidth)
3419 {
3420         uint_t i;
3421         char *name;
3422
3423         if (nl2cache == 0)
3424                 return;
3425
3426         (void) printf(gettext("\tcache\n"));
3427
3428         for (i = 0; i < nl2cache; i++) {
3429                 name = zpool_vdev_name(g_zfs, zhp, l2cache[i], B_FALSE);
3430                 print_status_config(zhp, name, l2cache[i],
3431                     namewidth, 2, B_FALSE);
3432                 free(name);
3433         }
3434 }
3435
3436 static void
3437 print_dedup_stats(nvlist_t *config)
3438 {
3439         ddt_histogram_t *ddh;
3440         ddt_stat_t *dds;
3441         ddt_object_t *ddo;
3442         uint_t c;
3443
3444         /*
3445          * If the pool was faulted then we may not have been able to
3446          * obtain the config. Otherwise, if have anything in the dedup
3447          * table continue processing the stats.
3448          */
3449         if (nvlist_lookup_uint64_array(config, ZPOOL_CONFIG_DDT_OBJ_STATS,
3450             (uint64_t **)&ddo, &c) != 0 || ddo->ddo_count == 0)
3451                 return;
3452
3453         (void) printf("\n");
3454         (void) printf("DDT entries %llu, size %llu on disk, %llu in core\n",
3455             (u_longlong_t)ddo->ddo_count,
3456             (u_longlong_t)ddo->ddo_dspace,
3457             (u_longlong_t)ddo->ddo_mspace);
3458
3459         verify(nvlist_lookup_uint64_array(config, ZPOOL_CONFIG_DDT_STATS,
3460             (uint64_t **)&dds, &c) == 0);
3461         verify(nvlist_lookup_uint64_array(config, ZPOOL_CONFIG_DDT_HISTOGRAM,
3462             (uint64_t **)&ddh, &c) == 0);
3463         zpool_dump_ddt(dds, ddh);
3464 }
3465
3466 /*
3467  * Display a summary of pool status.  Displays a summary such as:
3468  *
3469  *        pool: tank
3470  *      status: DEGRADED
3471  *      reason: One or more devices ...
3472  *         see: http://zfsonlinux.org/msg/ZFS-xxxx-01
3473  *      config:
3474  *              mirror          DEGRADED
3475  *                c1t0d0        OK
3476  *                c2t0d0        UNAVAIL
3477  *
3478  * When given the '-v' option, we print out the complete config.  If the '-e'
3479  * option is specified, then we print out error rate information as well.
3480  */
3481 int
3482 status_callback(zpool_handle_t *zhp, void *data)
3483 {
3484         status_cbdata_t *cbp = data;
3485         nvlist_t *config, *nvroot;
3486         char *msgid;
3487         int reason;
3488         const char *health;
3489         uint_t c;
3490         vdev_stat_t *vs;
3491
3492         config = zpool_get_config(zhp, NULL);
3493         reason = zpool_get_status(zhp, &msgid);
3494
3495         cbp->cb_count++;
3496
3497         /*
3498          * If we were given 'zpool status -x', only report those pools with
3499          * problems.
3500          */
3501         if (reason == ZPOOL_STATUS_OK && cbp->cb_explain) {
3502                 if (!cbp->cb_allpools) {
3503                         (void) printf(gettext("pool '%s' is healthy\n"),
3504                             zpool_get_name(zhp));
3505                         if (cbp->cb_first)
3506                                 cbp->cb_first = B_FALSE;
3507                 }
3508                 return (0);
3509         }
3510
3511         if (cbp->cb_first)
3512                 cbp->cb_first = B_FALSE;
3513         else
3514                 (void) printf("\n");
3515
3516         verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
3517             &nvroot) == 0);
3518         verify(nvlist_lookup_uint64_array(nvroot, ZPOOL_CONFIG_VDEV_STATS,
3519             (uint64_t **)&vs, &c) == 0);
3520         health = zpool_state_to_name(vs->vs_state, vs->vs_aux);
3521
3522         (void) printf(gettext("  pool: %s\n"), zpool_get_name(zhp));
3523         (void) printf(gettext(" state: %s\n"), health);
3524
3525         switch (reason) {
3526         case ZPOOL_STATUS_MISSING_DEV_R:
3527                 (void) printf(gettext("status: One or more devices could not "
3528                     "be opened.  Sufficient replicas exist for\n\tthe pool to "
3529                     "continue functioning in a degraded state.\n"));
3530                 (void) printf(gettext("action: Attach the missing device and "
3531                     "online it using 'zpool online'.\n"));
3532                 break;
3533
3534         case ZPOOL_STATUS_MISSING_DEV_NR:
3535                 (void) printf(gettext("status: One or more devices could not "
3536                     "be opened.  There are insufficient\n\treplicas for the "
3537                     "pool to continue functioning.\n"));
3538                 (void) printf(gettext("action: Attach the missing device and "
3539                     "online it using 'zpool online'.\n"));
3540                 break;
3541
3542         case ZPOOL_STATUS_CORRUPT_LABEL_R:
3543                 (void) printf(gettext("status: One or more devices could not "
3544                     "be used because the label is missing or\n\tinvalid.  "
3545                     "Sufficient replicas exist for the pool to continue\n\t"
3546                     "functioning in a degraded state.\n"));
3547                 (void) printf(gettext("action: Replace the device using "
3548                     "'zpool replace'.\n"));
3549                 break;
3550
3551         case ZPOOL_STATUS_CORRUPT_LABEL_NR:
3552                 (void) printf(gettext("status: One or more devices could not "
3553                     "be used because the label is missing \n\tor invalid.  "
3554                     "There are insufficient replicas for the pool to "
3555                     "continue\n\tfunctioning.\n"));
3556                 zpool_explain_recover(zpool_get_handle(zhp),
3557                     zpool_get_name(zhp), reason, config);
3558                 break;
3559
3560         case ZPOOL_STATUS_FAILING_DEV:
3561                 (void) printf(gettext("status: One or more devices has "
3562                     "experienced an unrecoverable error.  An\n\tattempt was "
3563                     "made to correct the error.  Applications are "
3564                     "unaffected.\n"));
3565                 (void) printf(gettext("action: Determine if the device needs "
3566                     "to be replaced, and clear the errors\n\tusing "
3567                     "'zpool clear' or replace the device with 'zpool "
3568                     "replace'.\n"));
3569                 break;
3570
3571         case ZPOOL_STATUS_OFFLINE_DEV:
3572                 (void) printf(gettext("status: One or more devices has "
3573                     "been taken offline by the administrator.\n\tSufficient "
3574                     "replicas exist for the pool to continue functioning in "
3575                     "a\n\tdegraded state.\n"));
3576                 (void) printf(gettext("action: Online the device using "
3577                     "'zpool online' or replace the device with\n\t'zpool "
3578                     "replace'.\n"));
3579                 break;
3580
3581         case ZPOOL_STATUS_REMOVED_DEV:
3582                 (void) printf(gettext("status: One or more devices has "
3583                     "been removed by the administrator.\n\tSufficient "
3584                     "replicas exist for the pool to continue functioning in "
3585                     "a\n\tdegraded state.\n"));
3586                 (void) printf(gettext("action: Online the device using "
3587                     "'zpool online' or replace the device with\n\t'zpool "
3588                     "replace'.\n"));
3589                 break;
3590
3591         case ZPOOL_STATUS_RESILVERING:
3592                 (void) printf(gettext("status: One or more devices is "
3593                     "currently being resilvered.  The pool will\n\tcontinue "
3594                     "to function, possibly in a degraded state.\n"));
3595                 (void) printf(gettext("action: Wait for the resilver to "
3596                     "complete.\n"));
3597                 break;
3598
3599         case ZPOOL_STATUS_CORRUPT_DATA:
3600                 (void) printf(gettext("status: One or more devices has "
3601                     "experienced an error resulting in data\n\tcorruption.  "
3602                     "Applications may be affected.\n"));
3603                 (void) printf(gettext("action: Restore the file in question "
3604                     "if possible.  Otherwise restore the\n\tentire pool from "
3605                     "backup.\n"));
3606                 break;
3607
3608         case ZPOOL_STATUS_CORRUPT_POOL:
3609                 (void) printf(gettext("status: The pool metadata is corrupted "
3610                     "and the pool cannot be opened.\n"));
3611                 zpool_explain_recover(zpool_get_handle(zhp),
3612                     zpool_get_name(zhp), reason, config);
3613                 break;
3614
3615         case ZPOOL_STATUS_VERSION_OLDER:
3616                 (void) printf(gettext("status: The pool is formatted using an "
3617                     "older on-disk format.  The pool can\n\tstill be used, but "
3618                     "some features are unavailable.\n"));
3619                 (void) printf(gettext("action: Upgrade the pool using 'zpool "
3620                     "upgrade'.  Once this is done, the\n\tpool will no longer "
3621                     "be accessible on older software versions.\n"));
3622                 break;
3623
3624         case ZPOOL_STATUS_VERSION_NEWER:
3625                 (void) printf(gettext("status: The pool has been upgraded to a "
3626                     "newer, incompatible on-disk version.\n\tThe pool cannot "
3627                     "be accessed on this system.\n"));
3628                 (void) printf(gettext("action: Access the pool from a system "
3629                     "running more recent software, or\n\trestore the pool from "
3630                     "backup.\n"));
3631                 break;
3632
3633         case ZPOOL_STATUS_FAULTED_DEV_R:
3634                 (void) printf(gettext("status: One or more devices are "
3635                     "faulted in response to persistent errors.\n\tSufficient "
3636                     "replicas exist for the pool to continue functioning "
3637                     "in a\n\tdegraded state.\n"));
3638                 (void) printf(gettext("action: Replace the faulted device, "
3639                     "or use 'zpool clear' to mark the device\n\trepaired.\n"));
3640                 break;
3641
3642         case ZPOOL_STATUS_FAULTED_DEV_NR:
3643                 (void) printf(gettext("status: One or more devices are "
3644                     "faulted in response to persistent errors.  There are "
3645                     "insufficient replicas for the pool to\n\tcontinue "
3646                     "functioning.\n"));
3647                 (void) printf(gettext("action: Destroy and re-create the pool "
3648                     "from a backup source.  Manually marking the device\n"
3649                     "\trepaired using 'zpool clear' may allow some data "
3650                     "to be recovered.\n"));
3651                 break;
3652
3653         case ZPOOL_STATUS_IO_FAILURE_WAIT:
3654         case ZPOOL_STATUS_IO_FAILURE_CONTINUE:
3655                 (void) printf(gettext("status: One or more devices are "
3656                     "faulted in response to IO failures.\n"));
3657                 (void) printf(gettext("action: Make sure the affected devices "
3658                     "are connected, then run 'zpool clear'.\n"));
3659                 break;
3660
3661         case ZPOOL_STATUS_BAD_LOG:
3662                 (void) printf(gettext("status: An intent log record "
3663                     "could not be read.\n"
3664                     "\tWaiting for adminstrator intervention to fix the "
3665                     "faulted pool.\n"));
3666                 (void) printf(gettext("action: Either restore the affected "
3667                     "device(s) and run 'zpool online',\n"
3668                     "\tor ignore the intent log records by running "
3669                     "'zpool clear'.\n"));
3670                 break;
3671
3672         default:
3673                 /*
3674                  * The remaining errors can't actually be generated, yet.
3675                  */
3676                 assert(reason == ZPOOL_STATUS_OK);
3677         }
3678
3679         if (msgid != NULL)
3680                 (void) printf(gettext("   see: http://zfsonlinux.org/msg/%s\n"),
3681                     msgid);
3682
3683         if (config != NULL) {
3684                 int namewidth;
3685                 uint64_t nerr;
3686                 nvlist_t **spares, **l2cache;
3687                 uint_t nspares, nl2cache;
3688                 pool_scan_stat_t *ps = NULL;
3689
3690                 (void) nvlist_lookup_uint64_array(nvroot,
3691                     ZPOOL_CONFIG_SCAN_STATS, (uint64_t **)&ps, &c);
3692                 print_scan_status(ps);
3693
3694                 namewidth = max_width(zhp, nvroot, 0, 0);
3695                 if (namewidth < 10)
3696                         namewidth = 10;
3697
3698                 (void) printf(gettext("config:\n\n"));
3699                 (void) printf(gettext("\t%-*s  %-8s %5s %5s %5s\n"), namewidth,
3700                     "NAME", "STATE", "READ", "WRITE", "CKSUM");
3701                 print_status_config(zhp, zpool_get_name(zhp), nvroot,
3702                     namewidth, 0, B_FALSE);
3703
3704                 if (num_logs(nvroot) > 0)
3705                         print_logs(zhp, nvroot, namewidth, B_TRUE);
3706                 if (nvlist_lookup_nvlist_array(nvroot, ZPOOL_CONFIG_L2CACHE,
3707                     &l2cache, &nl2cache) == 0)
3708                         print_l2cache(zhp, l2cache, nl2cache, namewidth);
3709
3710                 if (nvlist_lookup_nvlist_array(nvroot, ZPOOL_CONFIG_SPARES,
3711                     &spares, &nspares) == 0)
3712                         print_spares(zhp, spares, nspares, namewidth);
3713
3714                 if (nvlist_lookup_uint64(config, ZPOOL_CONFIG_ERRCOUNT,
3715                     &nerr) == 0) {
3716                         nvlist_t *nverrlist = NULL;
3717
3718                         /*
3719                          * If the approximate error count is small, get a
3720                          * precise count by fetching the entire log and
3721                          * uniquifying the results.
3722                          */
3723                         if (nerr > 0 && nerr < 100 && !cbp->cb_verbose &&
3724                             zpool_get_errlog(zhp, &nverrlist) == 0) {
3725                                 nvpair_t *elem;
3726
3727                                 elem = NULL;
3728                                 nerr = 0;
3729                                 while ((elem = nvlist_next_nvpair(nverrlist,
3730                                     elem)) != NULL) {
3731                                         nerr++;
3732                                 }
3733                         }
3734                         nvlist_free(nverrlist);
3735
3736                         (void) printf("\n");
3737
3738                         if (nerr == 0)
3739                                 (void) printf(gettext("errors: No known data "
3740                                     "errors\n"));
3741                         else if (!cbp->cb_verbose)
3742                                 (void) printf(gettext("errors: %llu data "
3743                                     "errors, use '-v' for a list\n"),
3744                                     (u_longlong_t)nerr);
3745                         else
3746                                 print_error_log(zhp);
3747                 }
3748
3749                 if (cbp->cb_dedup_stats)
3750                         print_dedup_stats(config);
3751         } else {
3752                 (void) printf(gettext("config: The configuration cannot be "
3753                     "determined.\n"));
3754         }
3755
3756         return (0);
3757 }
3758
3759 /*
3760  * zpool status [-vx] [-T d|u] [pool] ... [interval [count]]
3761  *
3762  *      -v      Display complete error logs
3763  *      -x      Display only pools with potential problems
3764  *      -D      Display dedup status (undocumented)
3765  *      -T      Display a timestamp in date(1) or Unix format
3766  *
3767  * Describes the health status of all pools or some subset.
3768  */
3769 int
3770 zpool_do_status(int argc, char **argv)
3771 {
3772         int c;
3773         int ret;
3774         unsigned long interval = 0, count = 0;
3775         status_cbdata_t cb = { 0 };
3776
3777         /* check options */
3778         while ((c = getopt(argc, argv, "vxDT:")) != -1) {
3779                 switch (c) {
3780                 case 'v':
3781                         cb.cb_verbose = B_TRUE;
3782                         break;
3783                 case 'x':
3784                         cb.cb_explain = B_TRUE;
3785                         break;
3786                 case 'D':
3787                         cb.cb_dedup_stats = B_TRUE;
3788                         break;
3789                 case 'T':
3790                         get_timestamp_arg(*optarg);
3791                         break;
3792                 case '?':
3793                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
3794                             optopt);
3795                         usage(B_FALSE);
3796                 }
3797         }
3798
3799         argc -= optind;
3800         argv += optind;
3801
3802         get_interval_count(&argc, argv, &interval, &count);
3803
3804         if (argc == 0)
3805                 cb.cb_allpools = B_TRUE;
3806
3807         cb.cb_first = B_TRUE;
3808
3809         for (;;) {
3810                 if (timestamp_fmt != NODATE)
3811                         print_timestamp(timestamp_fmt);
3812
3813                 ret = for_each_pool(argc, argv, B_TRUE, NULL,
3814                     status_callback, &cb);
3815
3816                 if (argc == 0 && cb.cb_count == 0)
3817                         (void) fprintf(stderr, gettext("no pools available\n"));
3818                 else if (cb.cb_explain && cb.cb_first && cb.cb_allpools)
3819                         (void) printf(gettext("all pools are healthy\n"));
3820
3821                 if (ret != 0)
3822                         return (ret);
3823
3824                 if (interval == 0)
3825                         break;
3826
3827                 if (count != 0 && --count == 0)
3828                         break;
3829
3830                 (void) sleep(interval);
3831         }
3832
3833         return (0);
3834 }
3835
3836 typedef struct upgrade_cbdata {
3837         int     cb_all;
3838         int     cb_first;
3839         int     cb_newer;
3840         int     cb_argc;
3841         uint64_t cb_version;
3842         char    **cb_argv;
3843 } upgrade_cbdata_t;
3844
3845 static int
3846 upgrade_cb(zpool_handle_t *zhp, void *arg)
3847 {
3848         upgrade_cbdata_t *cbp = arg;
3849         nvlist_t *config;
3850         uint64_t version;
3851         int ret = 0;
3852
3853         config = zpool_get_config(zhp, NULL);
3854         verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_VERSION,
3855             &version) == 0);
3856
3857         if (!cbp->cb_newer && version < SPA_VERSION) {
3858                 if (!cbp->cb_all) {
3859                         if (cbp->cb_first) {
3860                                 (void) printf(gettext("The following pools are "
3861                                     "out of date, and can be upgraded.  After "
3862                                     "being\nupgraded, these pools will no "
3863                                     "longer be accessible by older software "
3864                                     "versions.\n\n"));
3865                                 (void) printf(gettext("VER  POOL\n"));
3866                                 (void) printf(gettext("---  ------------\n"));
3867                                 cbp->cb_first = B_FALSE;
3868                         }
3869
3870                         (void) printf("%2llu   %s\n", (u_longlong_t)version,
3871                             zpool_get_name(zhp));
3872                 } else {
3873                         cbp->cb_first = B_FALSE;
3874                         ret = zpool_upgrade(zhp, cbp->cb_version);
3875                         if (!ret) {
3876                                 (void) printf(gettext("Successfully upgraded "
3877                                     "'%s'\n\n"), zpool_get_name(zhp));
3878                         }
3879                 }
3880         } else if (cbp->cb_newer && version > SPA_VERSION) {
3881                 assert(!cbp->cb_all);
3882
3883                 if (cbp->cb_first) {
3884                         (void) printf(gettext("The following pools are "
3885                             "formatted using a newer software version and\n"
3886                             "cannot be accessed on the current system.\n\n"));
3887                         (void) printf(gettext("VER  POOL\n"));
3888                         (void) printf(gettext("---  ------------\n"));
3889                         cbp->cb_first = B_FALSE;
3890                 }
3891
3892                 (void) printf("%2llu   %s\n", (u_longlong_t)version,
3893                     zpool_get_name(zhp));
3894         }
3895
3896         zpool_close(zhp);
3897         return (ret);
3898 }
3899
3900 /* ARGSUSED */
3901 static int
3902 upgrade_one(zpool_handle_t *zhp, void *data)
3903 {
3904         upgrade_cbdata_t *cbp = data;
3905         uint64_t cur_version;
3906         int ret;
3907
3908         if (strcmp("log", zpool_get_name(zhp)) == 0) {
3909                 (void) printf(gettext("'log' is now a reserved word\n"
3910                     "Pool 'log' must be renamed using export and import"
3911                     " to upgrade.\n"));
3912                 return (1);
3913         }
3914
3915         cur_version = zpool_get_prop_int(zhp, ZPOOL_PROP_VERSION, NULL);
3916         if (cur_version > cbp->cb_version) {
3917                 (void) printf(gettext("Pool '%s' is already formatted "
3918                     "using more current version '%llu'.\n"),
3919                     zpool_get_name(zhp), (u_longlong_t) cur_version);
3920                 return (0);
3921         }
3922         if (cur_version == cbp->cb_version) {
3923                 (void) printf(gettext("Pool '%s' is already formatted "
3924                     "using the current version.\n"), zpool_get_name(zhp));
3925                 return (0);
3926         }
3927
3928         ret = zpool_upgrade(zhp, cbp->cb_version);
3929
3930         if (!ret) {
3931                 (void) printf(gettext("Successfully upgraded '%s' "
3932                     "from version %llu to version %llu\n\n"),
3933                     zpool_get_name(zhp), (u_longlong_t)cur_version,
3934                     (u_longlong_t)cbp->cb_version);
3935         }
3936
3937         return (ret != 0);
3938 }
3939
3940 /*
3941  * zpool upgrade
3942  * zpool upgrade -v
3943  * zpool upgrade [-V version] <-a | pool ...>
3944  *
3945  * With no arguments, display downrev'd ZFS pool available for upgrade.
3946  * Individual pools can be upgraded by specifying the pool, and '-a' will
3947  * upgrade all pools.
3948  */
3949 int
3950 zpool_do_upgrade(int argc, char **argv)
3951 {
3952         int c;
3953         upgrade_cbdata_t cb = { 0 };
3954         int ret = 0;
3955         boolean_t showversions = B_FALSE;
3956         char *end;
3957
3958
3959         /* check options */
3960         while ((c = getopt(argc, argv, ":avV:")) != -1) {
3961                 switch (c) {
3962                 case 'a':
3963                         cb.cb_all = B_TRUE;
3964                         break;
3965                 case 'v':
3966                         showversions = B_TRUE;
3967                         break;
3968                 case 'V':
3969                         cb.cb_version = strtoll(optarg, &end, 10);
3970                         if (*end != '\0' || cb.cb_version > SPA_VERSION ||
3971                             cb.cb_version < SPA_VERSION_1) {
3972                                 (void) fprintf(stderr,
3973                                     gettext("invalid version '%s'\n"), optarg);
3974                                 usage(B_FALSE);
3975                         }
3976                         break;
3977                 case ':':
3978                         (void) fprintf(stderr, gettext("missing argument for "
3979                             "'%c' option\n"), optopt);
3980                         usage(B_FALSE);
3981                         break;
3982                 case '?':
3983                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
3984                             optopt);
3985                         usage(B_FALSE);
3986                 }
3987         }
3988
3989         cb.cb_argc = argc;
3990         cb.cb_argv = argv;
3991         argc -= optind;
3992         argv += optind;
3993
3994         if (cb.cb_version == 0) {
3995                 cb.cb_version = SPA_VERSION;
3996         } else if (!cb.cb_all && argc == 0) {
3997                 (void) fprintf(stderr, gettext("-V option is "
3998                     "incompatible with other arguments\n"));
3999                 usage(B_FALSE);
4000         }
4001
4002         if (showversions) {
4003                 if (cb.cb_all || argc != 0) {
4004                         (void) fprintf(stderr, gettext("-v option is "
4005                             "incompatible with other arguments\n"));
4006                         usage(B_FALSE);
4007                 }
4008         } else if (cb.cb_all) {
4009                 if (argc != 0) {
4010                         (void) fprintf(stderr, gettext("-a option should not "
4011                             "be used along with a pool name\n"));
4012                         usage(B_FALSE);
4013                 }
4014         }
4015
4016         (void) printf(gettext("This system is currently running "
4017             "ZFS pool version %llu.\n\n"), SPA_VERSION);
4018         cb.cb_first = B_TRUE;
4019         if (showversions) {
4020                 (void) printf(gettext("The following versions are "
4021                     "supported:\n\n"));
4022                 (void) printf(gettext("VER  DESCRIPTION\n"));
4023                 (void) printf("---  -----------------------------------------"
4024                     "---------------\n");
4025                 (void) printf(gettext(" 1   Initial ZFS version\n"));
4026                 (void) printf(gettext(" 2   Ditto blocks "
4027                     "(replicated metadata)\n"));
4028                 (void) printf(gettext(" 3   Hot spares and double parity "
4029                     "RAID-Z\n"));
4030                 (void) printf(gettext(" 4   zpool history\n"));
4031                 (void) printf(gettext(" 5   Compression using the gzip "
4032                     "algorithm\n"));
4033                 (void) printf(gettext(" 6   bootfs pool property\n"));
4034                 (void) printf(gettext(" 7   Separate intent log devices\n"));
4035                 (void) printf(gettext(" 8   Delegated administration\n"));
4036                 (void) printf(gettext(" 9   refquota and refreservation "
4037                     "properties\n"));
4038                 (void) printf(gettext(" 10  Cache devices\n"));
4039                 (void) printf(gettext(" 11  Improved scrub performance\n"));
4040                 (void) printf(gettext(" 12  Snapshot properties\n"));
4041                 (void) printf(gettext(" 13  snapused property\n"));
4042                 (void) printf(gettext(" 14  passthrough-x aclinherit\n"));
4043                 (void) printf(gettext(" 15  user/group space accounting\n"));
4044                 (void) printf(gettext(" 16  stmf property support\n"));
4045                 (void) printf(gettext(" 17  Triple-parity RAID-Z\n"));
4046                 (void) printf(gettext(" 18  Snapshot user holds\n"));
4047                 (void) printf(gettext(" 19  Log device removal\n"));
4048                 (void) printf(gettext(" 20  Compression using zle "
4049                     "(zero-length encoding)\n"));
4050                 (void) printf(gettext(" 21  Deduplication\n"));
4051                 (void) printf(gettext(" 22  Received properties\n"));
4052                 (void) printf(gettext(" 23  Slim ZIL\n"));
4053                 (void) printf(gettext(" 24  System attributes\n"));
4054                 (void) printf(gettext(" 25  Improved scrub stats\n"));
4055                 (void) printf(gettext(" 26  Improved snapshot deletion "
4056                     "performance\n"));
4057                 (void) printf(gettext(" 27  Improved snapshot creation "
4058                     "performance\n"));
4059                 (void) printf(gettext(" 28  Multiple vdev replacements\n"));
4060                 (void) printf(gettext("\nFor more information on a particular "
4061                     "version, including supported releases,\n"));
4062                 (void) printf(gettext("see the ZFS Administration Guide.\n\n"));
4063         } else if (argc == 0) {
4064                 int notfound;
4065
4066                 ret = zpool_iter(g_zfs, upgrade_cb, &cb);
4067                 notfound = cb.cb_first;
4068
4069                 if (!cb.cb_all && ret == 0) {
4070                         if (!cb.cb_first)
4071                                 (void) printf("\n");
4072                         cb.cb_first = B_TRUE;
4073                         cb.cb_newer = B_TRUE;
4074                         ret = zpool_iter(g_zfs, upgrade_cb, &cb);
4075                         if (!cb.cb_first) {
4076                                 notfound = B_FALSE;
4077                                 (void) printf("\n");
4078                         }
4079                 }
4080
4081                 if (ret == 0) {
4082                         if (notfound)
4083                                 (void) printf(gettext("All pools are formatted "
4084                                     "using this version.\n"));
4085                         else if (!cb.cb_all)
4086                                 (void) printf(gettext("Use 'zpool upgrade -v' "
4087                                     "for a list of available versions and "
4088                                     "their associated\nfeatures.\n"));
4089                 }
4090         } else {
4091                 ret = for_each_pool(argc, argv, B_FALSE, NULL,
4092                     upgrade_one, &cb);
4093         }
4094
4095         return (ret);
4096 }
4097
4098 typedef struct hist_cbdata {
4099         boolean_t first;
4100         int longfmt;
4101         int internal;
4102 } hist_cbdata_t;
4103
4104 /*
4105  * Print out the command history for a specific pool.
4106  */
4107 static int
4108 get_history_one(zpool_handle_t *zhp, void *data)
4109 {
4110         nvlist_t *nvhis;
4111         nvlist_t **records;
4112         uint_t numrecords;
4113         char *cmdstr;
4114         char *pathstr;
4115         uint64_t dst_time;
4116         time_t tsec;
4117         struct tm t;
4118         char tbuf[30];
4119         int ret, i;
4120         uint64_t who;
4121         struct passwd *pwd;
4122         char *hostname;
4123         char *zonename;
4124         char internalstr[MAXPATHLEN];
4125         hist_cbdata_t *cb = (hist_cbdata_t *)data;
4126         uint64_t txg;
4127         uint64_t ievent;
4128
4129         cb->first = B_FALSE;
4130
4131         (void) printf(gettext("History for '%s':\n"), zpool_get_name(zhp));
4132
4133         if ((ret = zpool_get_history(zhp, &nvhis)) != 0)
4134                 return (ret);
4135
4136         verify(nvlist_lookup_nvlist_array(nvhis, ZPOOL_HIST_RECORD,
4137             &records, &numrecords) == 0);
4138         for (i = 0; i < numrecords; i++) {
4139                 if (nvlist_lookup_uint64(records[i], ZPOOL_HIST_TIME,
4140                     &dst_time) != 0)
4141                         continue;
4142
4143                 /* is it an internal event or a standard event? */
4144                 if (nvlist_lookup_string(records[i], ZPOOL_HIST_CMD,
4145                     &cmdstr) != 0) {
4146                         if (cb->internal == 0)
4147                                 continue;
4148
4149                         if (nvlist_lookup_uint64(records[i],
4150                             ZPOOL_HIST_INT_EVENT, &ievent) != 0)
4151                                 continue;
4152                         verify(nvlist_lookup_uint64(records[i],
4153                             ZPOOL_HIST_TXG, &txg) == 0);
4154                         verify(nvlist_lookup_string(records[i],
4155                             ZPOOL_HIST_INT_STR, &pathstr) == 0);
4156                         if (ievent >= LOG_END)
4157                                 continue;
4158                         (void) snprintf(internalstr,
4159                             sizeof (internalstr),
4160                             "[internal %s txg:%llu] %s",
4161                             zfs_history_event_names[ievent], (u_longlong_t)txg,
4162                             pathstr);
4163                         cmdstr = internalstr;
4164                 }
4165                 tsec = dst_time;
4166                 (void) localtime_r(&tsec, &t);
4167                 (void) strftime(tbuf, sizeof (tbuf), "%F.%T", &t);
4168                 (void) printf("%s %s", tbuf, cmdstr);
4169
4170                 if (!cb->longfmt) {
4171                         (void) printf("\n");
4172                         continue;
4173                 }
4174                 (void) printf(" [");
4175                 if (nvlist_lookup_uint64(records[i],
4176                     ZPOOL_HIST_WHO, &who) == 0) {
4177                         pwd = getpwuid((uid_t)who);
4178                         if (pwd)
4179                                 (void) printf("user %s on",
4180                                     pwd->pw_name);
4181                         else
4182                                 (void) printf("user %d on",
4183                                     (int)who);
4184                 } else {
4185                         (void) printf(gettext("no info]\n"));
4186                         continue;
4187                 }
4188                 if (nvlist_lookup_string(records[i],
4189                     ZPOOL_HIST_HOST, &hostname) == 0) {
4190                         (void) printf(" %s", hostname);
4191                 }
4192                 if (nvlist_lookup_string(records[i],
4193                     ZPOOL_HIST_ZONE, &zonename) == 0) {
4194                         (void) printf(":%s", zonename);
4195                 }
4196
4197                 (void) printf("]");
4198                 (void) printf("\n");
4199         }
4200         (void) printf("\n");
4201         nvlist_free(nvhis);
4202
4203         return (ret);
4204 }
4205
4206 /*
4207  * zpool history <pool>
4208  *
4209  * Displays the history of commands that modified pools.
4210  */
4211
4212
4213 int
4214 zpool_do_history(int argc, char **argv)
4215 {
4216         hist_cbdata_t cbdata = { 0 };
4217         int ret;
4218         int c;
4219
4220         cbdata.first = B_TRUE;
4221         /* check options */
4222         while ((c = getopt(argc, argv, "li")) != -1) {
4223                 switch (c) {
4224                 case 'l':
4225                         cbdata.longfmt = 1;
4226                         break;
4227                 case 'i':
4228                         cbdata.internal = 1;
4229                         break;
4230                 case '?':
4231                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
4232                             optopt);
4233                         usage(B_FALSE);
4234                 }
4235         }
4236         argc -= optind;
4237         argv += optind;
4238
4239         ret = for_each_pool(argc, argv, B_FALSE,  NULL, get_history_one,
4240             &cbdata);
4241
4242         if (argc == 0 && cbdata.first == B_TRUE) {
4243                 (void) fprintf(stderr, gettext("no pools available\n"));
4244                 return (0);
4245         }
4246
4247         return (ret);
4248 }
4249
4250 typedef struct ev_opts {
4251         int verbose;
4252         int scripted;
4253         int follow;
4254         int clear;
4255 } ev_opts_t;
4256
4257 static void
4258 zpool_do_events_short(nvlist_t *nvl)
4259 {
4260         char ctime_str[26], str[32], *ptr;
4261         int64_t *tv;
4262         uint_t n;
4263
4264         verify(nvlist_lookup_int64_array(nvl, FM_EREPORT_TIME, &tv, &n) == 0);
4265         memset(str, ' ', 32);
4266         (void) ctime_r((const time_t *)&tv[0], ctime_str);
4267         (void) strncpy(str,    ctime_str+4,  6);             /* 'Jun 30'     */
4268         (void) strncpy(str+7,  ctime_str+20, 4);             /* '1993'       */
4269         (void) strncpy(str+12, ctime_str+11, 8);             /* '21:49:08'   */
4270         (void) sprintf(str+20, ".%09lld", (longlong_t)tv[1]);/* '.123456789' */
4271         (void) printf(gettext("%s "), str);
4272
4273         verify(nvlist_lookup_string(nvl, FM_CLASS, &ptr) == 0);
4274         (void) printf(gettext("%s\n"), ptr);
4275 }
4276
4277 static void
4278 zpool_do_events_nvprint(nvlist_t *nvl, int depth)
4279 {
4280         nvpair_t *nvp;
4281
4282         for (nvp = nvlist_next_nvpair(nvl, NULL);
4283             nvp != NULL; nvp = nvlist_next_nvpair(nvl, nvp)) {
4284
4285                 data_type_t type = nvpair_type(nvp);
4286                 const char *name = nvpair_name(nvp);
4287
4288                 boolean_t b;
4289                 uint8_t i8;
4290                 uint16_t i16;
4291                 uint32_t i32;
4292                 uint64_t i64;
4293                 char *str;
4294                 nvlist_t *cnv;
4295
4296                 printf(gettext("%*s%s = "), depth, "", name);
4297
4298                 switch (type) {
4299                 case DATA_TYPE_BOOLEAN:
4300                         printf(gettext("%s"), "1");
4301                         break;
4302
4303                 case DATA_TYPE_BOOLEAN_VALUE:
4304                         (void) nvpair_value_boolean_value(nvp, &b);
4305                         printf(gettext("%s"), b ? "1" : "0");
4306                         break;
4307
4308                 case DATA_TYPE_BYTE:
4309                         (void) nvpair_value_byte(nvp, &i8);
4310                         printf(gettext("0x%x"), i8);
4311                         break;
4312
4313                 case DATA_TYPE_INT8:
4314                         (void) nvpair_value_int8(nvp, (void *)&i8);
4315                         printf(gettext("0x%x"), i8);
4316                         break;
4317
4318                 case DATA_TYPE_UINT8:
4319                         (void) nvpair_value_uint8(nvp, &i8);
4320                         printf(gettext("0x%x"), i8);
4321                         break;
4322
4323                 case DATA_TYPE_INT16:
4324                         (void) nvpair_value_int16(nvp, (void *)&i16);
4325                         printf(gettext("0x%x"), i16);
4326                         break;
4327
4328                 case DATA_TYPE_UINT16:
4329                         (void) nvpair_value_uint16(nvp, &i16);
4330                         printf(gettext("0x%x"), i16);
4331                         break;
4332
4333                 case DATA_TYPE_INT32:
4334                         (void) nvpair_value_int32(nvp, (void *)&i32);
4335                         printf(gettext("0x%x"), i32);
4336                         break;
4337
4338                 case DATA_TYPE_UINT32:
4339                         (void) nvpair_value_uint32(nvp, &i32);
4340                         printf(gettext("0x%x"), i32);
4341                         break;
4342
4343                 case DATA_TYPE_INT64:
4344                         (void) nvpair_value_int64(nvp, (void *)&i64);
4345                         printf(gettext("0x%llx"), (u_longlong_t)i64);
4346                         break;
4347
4348                 case DATA_TYPE_UINT64:
4349                         (void) nvpair_value_uint64(nvp, &i64);
4350                         printf(gettext("0x%llx"), (u_longlong_t)i64);
4351                         break;
4352
4353                 case DATA_TYPE_HRTIME:
4354                         (void) nvpair_value_hrtime(nvp, (void *)&i64);
4355                         printf(gettext("0x%llx"), (u_longlong_t)i64);
4356                         break;
4357
4358                 case DATA_TYPE_STRING:
4359                         (void) nvpair_value_string(nvp, &str);
4360                         printf(gettext("\"%s\""), str ? str : "<NULL>");
4361                         break;
4362
4363                 case DATA_TYPE_NVLIST:
4364                         printf(gettext("(embedded nvlist)\n"));
4365                         (void) nvpair_value_nvlist(nvp, &cnv);
4366                         zpool_do_events_nvprint(cnv, depth + 8);
4367                         printf(gettext("%*s(end %s)"), depth, "", name);
4368                         break;
4369
4370                 case DATA_TYPE_NVLIST_ARRAY: {
4371                         nvlist_t **val;
4372                         uint_t i, nelem;
4373
4374                         (void) nvpair_value_nvlist_array(nvp, &val, &nelem);
4375                         printf(gettext("(%d embedded nvlists)\n"), nelem);
4376                         for (i = 0; i < nelem; i++) {
4377                                 printf(gettext("%*s%s[%d] = %s\n"),
4378                                        depth, "", name, i, "(embedded nvlist)");
4379                                 zpool_do_events_nvprint(val[i], depth + 8);
4380                                 printf(gettext("%*s(end %s[%i])\n"),
4381                                        depth, "", name, i);
4382                         }
4383                         printf(gettext("%*s(end %s)\n"), depth, "", name);
4384                         }
4385                         break;
4386
4387                 case DATA_TYPE_INT8_ARRAY: {
4388                         int8_t *val;
4389                         uint_t i, nelem;
4390
4391                         (void) nvpair_value_int8_array(nvp, &val, &nelem);
4392                         for (i = 0; i < nelem; i++)
4393                                 printf(gettext("0x%x "), val[i]);
4394
4395                         break;
4396                         }
4397
4398                 case DATA_TYPE_UINT8_ARRAY: {
4399                         uint8_t *val;
4400                         uint_t i, nelem;
4401
4402                         (void) nvpair_value_uint8_array(nvp, &val, &nelem);
4403                         for (i = 0; i < nelem; i++)
4404                                 printf(gettext("0x%x "), val[i]);
4405
4406                         break;
4407                         }
4408
4409                 case DATA_TYPE_INT16_ARRAY: {
4410                         int16_t *val;
4411                         uint_t i, nelem;
4412
4413                         (void) nvpair_value_int16_array(nvp, &val, &nelem);
4414                         for (i = 0; i < nelem; i++)
4415                                 printf(gettext("0x%x "), val[i]);
4416
4417                         break;
4418                         }
4419
4420                 case DATA_TYPE_UINT16_ARRAY: {
4421                         uint16_t *val;
4422                         uint_t i, nelem;
4423
4424                         (void) nvpair_value_uint16_array(nvp, &val, &nelem);
4425                         for (i = 0; i < nelem; i++)
4426                                 printf(gettext("0x%x "), val[i]);
4427
4428                         break;
4429                         }
4430
4431                 case DATA_TYPE_INT32_ARRAY: {
4432                         int32_t *val;
4433                         uint_t i, nelem;
4434
4435                         (void) nvpair_value_int32_array(nvp, &val, &nelem);
4436                         for (i = 0; i < nelem; i++)
4437                                 printf(gettext("0x%x "), val[i]);
4438
4439                         break;
4440                         }
4441
4442                 case DATA_TYPE_UINT32_ARRAY: {
4443                         uint32_t *val;
4444                         uint_t i, nelem;
4445
4446                         (void) nvpair_value_uint32_array(nvp, &val, &nelem);
4447                         for (i = 0; i < nelem; i++)
4448                                 printf(gettext("0x%x "), val[i]);
4449
4450                         break;
4451                         }
4452
4453                 case DATA_TYPE_INT64_ARRAY: {
4454                         int64_t *val;
4455                         uint_t i, nelem;
4456
4457                         (void) nvpair_value_int64_array(nvp, &val, &nelem);
4458                         for (i = 0; i < nelem; i++)
4459                                 printf(gettext("0x%llx "), (u_longlong_t)val[i]);
4460
4461                         break;
4462                         }
4463
4464                 case DATA_TYPE_UINT64_ARRAY: {
4465                         uint64_t *val;
4466                         uint_t i, nelem;
4467
4468                         (void) nvpair_value_uint64_array(nvp, &val, &nelem);
4469                         for (i = 0; i < nelem; i++)
4470                                 printf(gettext("0x%llx "), (u_longlong_t)val[i]);
4471
4472                         break;
4473                         }
4474
4475                 case DATA_TYPE_STRING_ARRAY:
4476                 case DATA_TYPE_BOOLEAN_ARRAY:
4477                 case DATA_TYPE_BYTE_ARRAY:
4478                 case DATA_TYPE_DOUBLE:
4479                 case DATA_TYPE_UNKNOWN:
4480                         printf(gettext("<unknown>"));
4481                         break;
4482                 }
4483
4484                 printf(gettext("\n"));
4485         }
4486 }
4487
4488 static int
4489 zpool_do_events_next(ev_opts_t *opts)
4490 {
4491         nvlist_t *nvl;
4492         int cleanup_fd, ret, dropped;
4493
4494         cleanup_fd = open(ZFS_DEV, O_RDWR);
4495         VERIFY(cleanup_fd >= 0);
4496
4497         if (!opts->scripted)
4498                 (void) printf(gettext("%-30s %s\n"), "TIME", "CLASS");
4499
4500         while (1) {
4501                 ret = zpool_events_next(g_zfs, &nvl, &dropped,
4502                     !!opts->follow, cleanup_fd);
4503                 if (ret || nvl == NULL)
4504                         break;
4505
4506                 if (dropped > 0)
4507                         (void) printf(gettext("dropped %d events\n"), dropped);
4508
4509                 zpool_do_events_short(nvl);
4510
4511                 if (opts->verbose) {
4512                         zpool_do_events_nvprint(nvl, 8);
4513                         printf(gettext("\n"));
4514                 }
4515
4516                 nvlist_free(nvl);
4517         }
4518
4519         VERIFY(0 == close(cleanup_fd));
4520
4521         return (ret);
4522 }
4523
4524 static int
4525 zpool_do_events_clear(ev_opts_t *opts)
4526 {
4527         int count, ret;
4528
4529         ret = zpool_events_clear(g_zfs, &count);
4530         if (!ret)
4531                 (void) printf(gettext("cleared %d events\n"), count);
4532
4533         return (ret);
4534 }
4535
4536 /*
4537  * zpool events [-vfc]
4538  *
4539  * Displays events logs by ZFS.
4540  */
4541 int
4542 zpool_do_events(int argc, char **argv)
4543 {
4544         ev_opts_t opts = { 0 };
4545         int ret;
4546         int c;
4547
4548         /* check options */
4549         while ((c = getopt(argc, argv, "vHfc")) != -1) {
4550                 switch (c) {
4551                 case 'v':
4552                         opts.verbose = 1;
4553                         break;
4554                 case 'H':
4555                         opts.scripted = 1;
4556                         break;
4557                 case 'f':
4558                         opts.follow = 1;
4559                         break;
4560                 case 'c':
4561                         opts.clear = 1;
4562                         break;
4563                 case '?':
4564                         (void) fprintf(stderr, gettext("invalid option '%c'\n"),
4565                             optopt);
4566                         usage(B_FALSE);
4567                 }
4568         }
4569         argc -= optind;
4570         argv += optind;
4571
4572         if (opts.clear)
4573                 ret = zpool_do_events_clear(&opts);
4574         else
4575                 ret = zpool_do_events_next(&opts);
4576
4577         return ret;
4578 }
4579
4580 static int
4581 get_callback(zpool_handle_t *zhp, void *data)
4582 {
4583         zprop_get_cbdata_t *cbp = (zprop_get_cbdata_t *)data;
4584         char value[MAXNAMELEN];
4585         zprop_source_t srctype;
4586         zprop_list_t *pl;
4587
4588         for (pl = cbp->cb_proplist; pl != NULL; pl = pl->pl_next) {
4589
4590                 /*
4591                  * Skip the special fake placeholder. This will also skip
4592                  * over the name property when 'all' is specified.
4593                  */
4594                 if (pl->pl_prop == ZPOOL_PROP_NAME &&
4595                     pl == cbp->cb_proplist)
4596                         continue;
4597
4598                 if (zpool_get_prop(zhp, pl->pl_prop,
4599                     value, sizeof (value), &srctype) != 0)
4600                         continue;
4601
4602                 zprop_print_one_property(zpool_get_name(zhp), cbp,
4603                     zpool_prop_to_name(pl->pl_prop), value, srctype, NULL,
4604                     NULL);
4605         }
4606         return (0);
4607 }
4608
4609 int
4610 zpool_do_get(int argc, char **argv)
4611 {
4612         zprop_get_cbdata_t cb = { 0 };
4613         zprop_list_t fake_name = { 0 };
4614         int ret;
4615
4616         if (argc < 3)
4617                 usage(B_FALSE);
4618
4619         cb.cb_first = B_TRUE;
4620         cb.cb_sources = ZPROP_SRC_ALL;
4621         cb.cb_columns[0] = GET_COL_NAME;
4622         cb.cb_columns[1] = GET_COL_PROPERTY;
4623         cb.cb_columns[2] = GET_COL_VALUE;
4624         cb.cb_columns[3] = GET_COL_SOURCE;
4625         cb.cb_type = ZFS_TYPE_POOL;
4626
4627         if (zprop_get_list(g_zfs, argv[1],  &cb.cb_proplist,
4628             ZFS_TYPE_POOL) != 0)
4629                 usage(B_FALSE);
4630
4631         if (cb.cb_proplist != NULL) {
4632                 fake_name.pl_prop = ZPOOL_PROP_NAME;
4633                 fake_name.pl_width = strlen(gettext("NAME"));
4634                 fake_name.pl_next = cb.cb_proplist;
4635                 cb.cb_proplist = &fake_name;
4636         }
4637
4638         ret = for_each_pool(argc - 2, argv + 2, B_TRUE, &cb.cb_proplist,
4639             get_callback, &cb);
4640
4641         if (cb.cb_proplist == &fake_name)
4642                 zprop_free_list(fake_name.pl_next);
4643         else
4644                 zprop_free_list(cb.cb_proplist);
4645
4646         return (ret);
4647 }
4648
4649 typedef struct set_cbdata {
4650         char *cb_propname;
4651         char *cb_value;
4652         boolean_t cb_any_successful;
4653 } set_cbdata_t;
4654
4655 int
4656 set_callback(zpool_handle_t *zhp, void *data)
4657 {
4658         int error;
4659         set_cbdata_t *cb = (set_cbdata_t *)data;
4660
4661         error = zpool_set_prop(zhp, cb->cb_propname, cb->cb_value);
4662
4663         if (!error)
4664                 cb->cb_any_successful = B_TRUE;
4665
4666         return (error);
4667 }
4668
4669 int
4670 zpool_do_set(int argc, char **argv)
4671 {
4672         set_cbdata_t cb = { 0 };
4673         int error;
4674
4675         if (argc > 1 && argv[1][0] == '-') {
4676                 (void) fprintf(stderr, gettext("invalid option '%c'\n"),
4677                     argv[1][1]);
4678                 usage(B_FALSE);
4679         }
4680
4681         if (argc < 2) {
4682                 (void) fprintf(stderr, gettext("missing property=value "
4683                     "argument\n"));
4684                 usage(B_FALSE);
4685         }
4686
4687         if (argc < 3) {
4688                 (void) fprintf(stderr, gettext("missing pool name\n"));
4689                 usage(B_FALSE);
4690         }
4691
4692         if (argc > 3) {
4693                 (void) fprintf(stderr, gettext("too many pool names\n"));
4694                 usage(B_FALSE);
4695         }
4696
4697         cb.cb_propname = argv[1];
4698         cb.cb_value = strchr(cb.cb_propname, '=');
4699         if (cb.cb_value == NULL) {
4700                 (void) fprintf(stderr, gettext("missing value in "
4701                     "property=value argument\n"));
4702                 usage(B_FALSE);
4703         }
4704
4705         *(cb.cb_value) = '\0';
4706         cb.cb_value++;
4707
4708         error = for_each_pool(argc - 2, argv + 2, B_TRUE, NULL,
4709             set_callback, &cb);
4710
4711         return (error);
4712 }
4713
4714 static int
4715 find_command_idx(char *command, int *idx)
4716 {
4717         int i;
4718
4719         for (i = 0; i < NCOMMAND; i++) {
4720                 if (command_table[i].name == NULL)
4721                         continue;
4722
4723                 if (strcmp(command, command_table[i].name) == 0) {
4724                         *idx = i;
4725                         return (0);
4726                 }
4727         }
4728         return (1);
4729 }
4730
4731 int
4732 main(int argc, char **argv)
4733 {
4734         int ret;
4735         int i = 0;
4736         char *cmdname;
4737
4738         (void) setlocale(LC_ALL, "");
4739         (void) textdomain(TEXT_DOMAIN);
4740
4741         opterr = 0;
4742
4743         /*
4744          * Make sure the user has specified some command.
4745          */
4746         if (argc < 2) {
4747                 (void) fprintf(stderr, gettext("missing command\n"));
4748                 usage(B_FALSE);
4749         }
4750
4751         cmdname = argv[1];
4752
4753         /*
4754          * Special case '-?'
4755          */
4756         if ((strcmp(cmdname, "-?") == 0) ||
4757              strcmp(cmdname, "--help") == 0)
4758                 usage(B_TRUE);
4759
4760         if ((g_zfs = libzfs_init()) == NULL)
4761                 return (1);
4762
4763         libzfs_print_on_error(g_zfs, B_TRUE);
4764
4765         zpool_set_history_str("zpool", argc, argv, history_str);
4766         verify(zpool_stage_history(g_zfs, history_str) == 0);
4767
4768         /*
4769          * Run the appropriate command.
4770          */
4771         if (find_command_idx(cmdname, &i) == 0) {
4772                 current_command = &command_table[i];
4773                 ret = command_table[i].func(argc - 1, argv + 1);
4774         } else if (strchr(cmdname, '=')) {
4775                 verify(find_command_idx("set", &i) == 0);
4776                 current_command = &command_table[i];
4777                 ret = command_table[i].func(argc, argv);
4778         } else if (strcmp(cmdname, "freeze") == 0 && argc == 3) {
4779                 /*
4780                  * 'freeze' is a vile debugging abomination, so we treat
4781                  * it as such.
4782                  */
4783                 char buf[16384];
4784                 int fd = open(ZFS_DEV, O_RDWR);
4785                 (void) strcpy((void *)buf, argv[2]);
4786                 return (!!ioctl(fd, ZFS_IOC_POOL_FREEZE, buf));
4787         } else {
4788                 (void) fprintf(stderr, gettext("unrecognized "
4789                     "command '%s'\n"), cmdname);
4790                 usage(B_FALSE);
4791                 ret = 1;
4792         }
4793
4794         libzfs_fini(g_zfs);
4795
4796         /*
4797          * The 'ZFS_ABORT' environment variable causes us to dump core on exit
4798          * for the purposes of running ::findleaks.
4799          */
4800         if (getenv("ZFS_ABORT") != NULL) {
4801                 (void) printf("dumping core by request\n");
4802                 abort();
4803         }
4804
4805         return (ret);
4806 }