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