zpool_main.c revision 46657f8d750bdb71753495ce2919170f126b8e34
fa9e4066f08beec538e775443c5be79dd423fcabahrens * CDDL HEADER START
fa9e4066f08beec538e775443c5be79dd423fcabahrens * The contents of this file are subject to the terms of the
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling * Common Development and Distribution License (the "License").
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling * You may not use this file except in compliance with the License.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
fa9e4066f08beec538e775443c5be79dd423fcabahrens * See the License for the specific language governing permissions
fa9e4066f08beec538e775443c5be79dd423fcabahrens * and limitations under the License.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * When distributing Covered Code, include this CDDL HEADER in each
fa9e4066f08beec538e775443c5be79dd423fcabahrens * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If applicable, add the following below this CDDL HEADER, with the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * fields enclosed by brackets "[]" replaced with your own identifying
fa9e4066f08beec538e775443c5be79dd423fcabahrens * information: Portions Copyright [yyyy] [name of copyright owner]
fa9e4066f08beec538e775443c5be79dd423fcabahrens * CDDL HEADER END
39c23413b8df94a95f67b34cfd4a4dfc3fd0b48deschrock * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Use is subject to license terms.
fa9e4066f08beec538e775443c5be79dd423fcabahrens#pragma ident "%Z%%M% %I% %E% SMI"
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_create(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_destroy(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_add(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_remove(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_list(int, char **);
99653d4ee642c6528e88224f12409a5f23060994eschrockstatic int zpool_do_iostat(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_status(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_online(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_offline(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_clear(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_attach(int, char **);
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrockstatic int zpool_do_detach(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_replace(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_scrub(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_import(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_export(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_upgrade(int, char **);
fa9e4066f08beec538e775443c5be79dd423fcabahrensstatic int zpool_do_history(int, char **);
06eeb2ad640ce72d394ac521094bed7681044408ek * These libumem hooks provide a reasonable set of defaults for the allocator's
06eeb2ad640ce72d394ac521094bed7681044408ek * debugging facilities.
b1b8ab34de515a5e83206da22c3d7e563241b021llingconst char *
fa9e4066f08beec538e775443c5be79dd423fcabahrens return ("default,verbose"); /* $UMEM_DEBUG setting */
fa9e4066f08beec538e775443c5be79dd423fcabahrensconst char *
fa9e4066f08beec538e775443c5be79dd423fcabahrens return ("fail,contents"); /* $UMEM_LOGGING setting */
fa9e4066f08beec538e775443c5be79dd423fcabahrenstypedef enum {
65cd9f2809a015b46790a9c5c2ef992d56177624eschrocktypedef struct zpool_command {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock const char *name;
b1b8ab34de515a5e83206da22c3d7e563241b021lling int (*func)(int, char **);
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock * Master command table. Each ZFS command has a name, associated function, and
fa9e4066f08beec538e775443c5be79dd423fcabahrens * usage message. The usage messages need to be internationalized, so we have
fa9e4066f08beec538e775443c5be79dd423fcabahrens * to have a function to return the usage message based on a command index.
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock * These commands are organized according to how they are displayed in the usage
fa9e4066f08beec538e775443c5be79dd423fcabahrens * message. An empty command (one with a NULL name) indicates an empty line in
fa9e4066f08beec538e775443c5be79dd423fcabahrens * the generic usage message.
fa9e4066f08beec538e775443c5be79dd423fcabahrens#define NCOMMAND (sizeof (command_table) / sizeof (command_table[0]))
06eeb2ad640ce72d394ac521094bed7681044408ekstatic const char *
b1b8ab34de515a5e83206da22c3d7e563241b021lling switch (idx) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens "<new_device>\n"));
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock return (gettext("\tcreate [-fn] [-R root] [-m mountpoint] "
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock "<pool> <vdev> ...\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling "\timport [-d dir] [-D] [-f] [-o opts] [-R root] -a\n"
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock "\timport [-d dir] [-D] [-f] [-o opts] [-R root ]"
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock " <pool | id> [newpool]\n"));
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock return (gettext("\tiostat [-v] [pool] ... [interval "
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock "[count]]\n"));
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks "[pool] ...\n"));
4c58d71403cebfaa40a572ff12b17668ebd56987darrenm return (gettext("\toffline [-t] <pool> <device> ...\n"));
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock return (gettext("\tonline <pool> <device> ...\n"));
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock "[new_device]\n"));
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock "\tupgrade -v\n"
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling "\tupgrade <-a | pool>\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock /* NOTREACHED */
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock * Fields available for 'zpool list'.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrocktypedef enum {
65cd9f2809a015b46790a9c5c2ef992d56177624eschrocktypedef struct column_def {
65cd9f2809a015b46790a9c5c2ef992d56177624eschrock const char *cd_title;
b1b8ab34de515a5e83206da22c3d7e563241b021llingstatic char *column_subopts[] = {
b1b8ab34de515a5e83206da22c3d7e563241b021lling "available",
990b4856d0eaada6f8140335733a1b1771ed2746lling "capacity",
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Display usage message. If we're inside a command, display only the usage for
fa9e4066f08beec538e775443c5be79dd423fcabahrens * that command. Otherwise, iterate over the entire command table and display
99653d4ee642c6528e88224f12409a5f23060994eschrock * a complete usage message.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(fp, gettext("usage: zpool command args ...\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens gettext("where 'command' is one of the following:\n\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (i = 0; i < NCOMMAND; i++) {
b1b8ab34de515a5e83206da22c3d7e563241b021lling (void) fprintf(fp, "%s", get_usage(current_command->usage));
b1b8ab34de515a5e83206da22c3d7e563241b021lling "of the following:\n\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling * See comments at end of main().
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrockconst char *
fa9e4066f08beec538e775443c5be79dd423fcabahrensconst char *
990b4856d0eaada6f8140335733a1b1771ed2746llingprint_vdev_tree(zpool_handle_t *zhp, const char *name, nvlist_t *nv, int indent)
990b4856d0eaada6f8140335733a1b1771ed2746lling if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
990b4856d0eaada6f8140335733a1b1771ed2746lling for (c = 0; c < children; c++) {
990b4856d0eaada6f8140335733a1b1771ed2746lling * zpool add [-fn] <pool> <vdev> ...
990b4856d0eaada6f8140335733a1b1771ed2746lling * -f Force addition of devices, even if they appear in use
990b4856d0eaada6f8140335733a1b1771ed2746lling * -n Do not add the devices, but display the resulting layout if
990b4856d0eaada6f8140335733a1b1771ed2746lling * they were to be added.
990b4856d0eaada6f8140335733a1b1771ed2746lling * Adds the given vdevs to 'pool'. As with create, the bulk of this work is
990b4856d0eaada6f8140335733a1b1771ed2746lling * handled by get_vdev_spec(), which constructs the nvlist needed to pass to
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* get pool name and check number of arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name argument\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("missing vdev specification\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((config = zpool_get_config(zhp, NULL)) == NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("pool '%s' is unavailable\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
99653d4ee642c6528e88224f12409a5f23060994eschrock /* pass off to get_vdev_spec for processing */
fa9e4066f08beec538e775443c5be79dd423fcabahrens nvroot = make_root_vdev(config, force, !force, B_FALSE, argc, argv);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("would update '%s' to the following "
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * zpool remove <pool> <vdev>
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * Removes the given vdev from the pool. Currently, this only supports removing
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * spares from the pool. Eventually, we'll want to support removing leaf vdevs
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * (as an alias for 'detach') as well as toplevel vdevs.
99653d4ee642c6528e88224f12409a5f23060994eschrock /* get pool name and check number of arguments */
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("missing pool name argument\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("missing device\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock return (1);
99653d4ee642c6528e88224f12409a5f23060994eschrock zpool_log_history(g_zfs, ++argc, --argv, poolname, B_TRUE,
99653d4ee642c6528e88224f12409a5f23060994eschrock * zpool create [-fn] [-R root] [-m mountpoint] <pool> <dev> ...
99653d4ee642c6528e88224f12409a5f23060994eschrock * -f Force creation, even if devices appear in use
99653d4ee642c6528e88224f12409a5f23060994eschrock * -n Do not create the pool, but display the resulting layout if it
99653d4ee642c6528e88224f12409a5f23060994eschrock * were to be created.
99653d4ee642c6528e88224f12409a5f23060994eschrock * -R Create a pool under an alternate root
99653d4ee642c6528e88224f12409a5f23060994eschrock * -m Set default mountpoint for the root dataset. By default it's
99653d4ee642c6528e88224f12409a5f23060994eschrock * '/<pool>'
99653d4ee642c6528e88224f12409a5f23060994eschrock * Creates the the named pool according to the given vdev specification. The
99653d4ee642c6528e88224f12409a5f23060994eschrock * bulk of the vdev processing is done in get_vdev_spec() in zpool_vdev.c. Once
99653d4ee642c6528e88224f12409a5f23060994eschrock * we get the nvlist back from get_vdev_spec(), we either print out the contents
99653d4ee642c6528e88224f12409a5f23060994eschrock * (if '-n' was specified), or pass it to libzfs to do the creation.
990b4856d0eaada6f8140335733a1b1771ed2746lling /* check options */
b1b8ab34de515a5e83206da22c3d7e563241b021lling switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing argument for "
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock (void) fprintf(stderr, gettext("invalid option '%c'\n"),
99653d4ee642c6528e88224f12409a5f23060994eschrock /* get pool name and check number of arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name argument\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling (void) fprintf(stderr, gettext("missing vdev specification\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling * As a special case, check for use of '/' in the name, and direct the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * user to use 'zfs create' instead.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("cannot create '%s': invalid "
990b4856d0eaada6f8140335733a1b1771ed2746lling "create a dataset\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling return (1);
990b4856d0eaada6f8140335733a1b1771ed2746lling /* pass off to get_vdev_spec for bulk processing */
990b4856d0eaada6f8140335733a1b1771ed2746lling nvroot = make_root_vdev(NULL, force, !force, B_FALSE, argc - 1,
990b4856d0eaada6f8140335733a1b1771ed2746lling return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* make_root_vdev() allows 0 toplevel children if there are spares */
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist_array(nvroot, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens "specification: at least one toplevel vdev must be "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "specified\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid alternate root '%s': "
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Check the validity of the mountpoint and direct the user to use the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * '-m' mountpoint option if it looks like its in use.
fa9e4066f08beec538e775443c5be79dd423fcabahrens "'%s': must be an absolute path, 'legacy', or "
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens "mountpoint '%s' exists and is not "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "option to provide a different default\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * For a dry run invocation, print out a basic message and run
fa9e4066f08beec538e775443c5be79dd423fcabahrens * through all the vdevs in the list and print out in an
fa9e4066f08beec538e775443c5be79dd423fcabahrens * appropriate hierarchy.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Hand off to libzfs.
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (zpool_create(g_zfs, poolname, nvroot, altroot) == 0) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens zpool_log_history(g_zfs, argc + optind, argv - optind,
fa9e4066f08beec538e775443c5be79dd423fcabahrens } else if (libzfs_errno(g_zfs) == EZFS_INVALIDNAME) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens "been omitted\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool destroy <pool>
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -f Forcefully unmount any datasets
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Destroy the given pool. Automatically unmounts any datasets in the pool.
99653d4ee642c6528e88224f12409a5f23060994eschrock /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check arguments */
990b4856d0eaada6f8140335733a1b1771ed2746lling (void) fprintf(stderr, gettext("missing pool argument\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling (void) fprintf(stderr, gettext("too many arguments\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((zhp = zpool_open_canfail(g_zfs, pool)) == NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens * As a special case, check for use of '/' in the name, and
fa9e4066f08beec538e775443c5be79dd423fcabahrens * direct the user to use 'zfs destroy' instead.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("use 'zfs destroy' to "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "destroy a dataset\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("could not destroy '%s': "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "could not unmount datasets\n"), zpool_get_name(zhp));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens zpool_log_history(g_zfs, argc + optind, argv - optind, pool, B_TRUE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool export [-f] <pool> ...
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -f Forcefully unmount datasets
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Export the the given pools. By default, the command will attempt to cleanly
fa9e4066f08beec538e775443c5be79dd423fcabahrens * unmount any active datasets within the pool. If the '-f' flag is specified,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * then the datasets will be forcefully unmounted.
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool argument\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (i = 0; i < argc; i++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((zhp = zpool_open_canfail(g_zfs, argv[i])) == NULL) {
99653d4ee642c6528e88224f12409a5f23060994eschrock zpool_log_history(g_zfs, argc + optind, argv - optind, argv[i],
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Given a vdev configuration, determine the maximum width needed for the device
fa9e4066f08beec538e775443c5be79dd423fcabahrens * name column.
fa9e4066f08beec538e775443c5be79dd423fcabahrensmax_width(zpool_handle_t *zhp, nvlist_t *nv, int depth, int max)
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_SPARES,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++)
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++)
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Print the configuration of an exported pool. Iterate over all vdevs in the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * pool, printing out the name and status for each one.
c67d9675bbc8392fe45f3a7dfbda1ad4daa1eb07eschrockprint_import_config(const char *name, nvlist_t *nv, int namewidth, int depth)
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_string(nv, ZPOOL_CONFIG_TYPE, &type) == 0);
afefbcddfd8caf5f3b2da510d9439471ab225040eschrock verify(nvlist_lookup_uint64_array(nv, ZPOOL_CONFIG_STATS,
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf("\t%*s%-*s", depth, "", namewidth - depth, name);
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_SPARES,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Display the status for the given pool.
fa9e4066f08beec538e775443c5be79dd423fcabahrens const char *health;
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_string(config, ZPOOL_CONFIG_POOL_NAME,
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_GUID,
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_STATE,
afefbcddfd8caf5f3b2da510d9439471ab225040eschrock verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin verify(nvlist_lookup_uint64_array(nvroot, ZPOOL_CONFIG_STATS,
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin (void) printf(gettext(" id: %llu\n"), (u_longlong_t)guid);
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext("status: One or more devices are missing "
99653d4ee642c6528e88224f12409a5f23060994eschrock "from the system.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: One or more devices contains "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "corrupted data.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool data is corrupted.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens "are offlined.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool metadata is "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "corrupted.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool is formatted using an "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "older on-disk version.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool is formatted using an "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "incompatible version.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * No other status can be seen when importing pools.
b1b8ab34de515a5e83206da22c3d7e563241b021lling * Print out an action according to the overall state of the pool.
fa9e4066f08beec538e775443c5be79dd423fcabahrens "imported using its name or numeric identifier, "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "though\n\tsome features will not be available "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "without an explicit 'zpool upgrade'.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens "imported using its name or numeric "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "identifier.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: The pool can be imported "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "despite missing or damaged devices. The\n\tfault "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "tolerance of the pool may be compromised if imported.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens "imported. Access the pool on a system running "
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling "newer\n\tsoftware, or recreate the pool from "
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling "backup.\n"));
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock (void) printf(gettext("action: The pool cannot be "
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock "imported. Attach the missing\n\tdevices and try "
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock "again.\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("action: The pool cannot be "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "imported due to damaged devices or data.\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * If the state is "closed" or "can't open", and the aux state
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * is "corrupt data":
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock "but can be imported using the '-Df' flags.\n"));
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock (void) printf(gettext("\tThe pool may be active on "
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock "on another system, but can be imported using\n\t"
fa9e4066f08beec538e775443c5be79dd423fcabahrens "the '-f' flag.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext(" see: http://www.sun.com/msg/%s\n"),
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("\n\tAdditional devices are known to "
95173954d2b811ceb583a9012c3b16e1d0dd6438ek "be part of this pool, though their\n\texact "
95173954d2b811ceb583a9012c3b16e1d0dd6438ek "configuration cannot be determined.\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Perform the import for the given configuration. This passes the heavy
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * lifting off to zpool_import(), and then mounts the datasets contained within
46657f8d750bdb71753495ce2919170f126b8e34mmusante * the pool.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrockdo_import(nvlist_t *config, const char *newname, const char *mntopts,
fa9e4066f08beec538e775443c5be79dd423fcabahrens const char *altroot, int force, int argc, char **argv)
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock verify(nvlist_lookup_string(config, ZPOOL_CONFIG_POOL_NAME,
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) fprintf(stderr, gettext("cannot import '%s': pool "
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock } else if (state != POOL_STATE_EXPORTED && !force) {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) fprintf(stderr, gettext("cannot import '%s': pool "
46657f8d750bdb71753495ce2919170f126b8e34mmusante (void) fprintf(stderr, gettext("use '-f' to import anyway\n"));
46657f8d750bdb71753495ce2919170f126b8e34mmusante return (1);
46657f8d750bdb71753495ce2919170f126b8e34mmusante if (zpool_import(g_zfs, config, newname, altroot) != 0)
46657f8d750bdb71753495ce2919170f126b8e34mmusante return (1);
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock zpool_log_history(g_zfs, argc, argv, name, B_TRUE, B_FALSE);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool import [-d dir] [-D]
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * import [-R root] [-D] [-d dir] [-f] -a
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * import [-R root] [-D] [-d dir] [-f] <pool | id> [newpool]
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * -d Scan in a specific directory, other than /dev/dsk. More than
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * one directory can be specified using multiple '-d' options.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -D Scan for previously destroyed pools or import all or only
fa9e4066f08beec538e775443c5be79dd423fcabahrens * specified destroyed pools.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -R Temporarily import the pool, with all mountpoints relative to
46657f8d750bdb71753495ce2919170f126b8e34mmusante * the given root. The pool will remain exported when the machine
fa9e4066f08beec538e775443c5be79dd423fcabahrens * is rebooted.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -f Force import, even if it appears that the pool is active.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -a Import all pools found.
990b4856d0eaada6f8140335733a1b1771ed2746lling * The import command scans for pools to import, and import pools based on pool
fa9e4066f08beec538e775443c5be79dd423fcabahrens * name and GUID. The pool can also be renamed as part of the import process.
95173954d2b811ceb583a9012c3b16e1d0dd6438ek /* check options */
95173954d2b811ceb583a9012c3b16e1d0dd6438ek switch (c) {
95173954d2b811ceb583a9012c3b16e1d0dd6438ek sizeof (char *));
95173954d2b811ceb583a9012c3b16e1d0dd6438ek sizeof (char *));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing argument for "
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock /* check argument count */
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock if (argc != 0) {
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock (void) fprintf(stderr, gettext("too many arguments\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("too many arguments\n"));
4c58d71403cebfaa40a572ff12b17668ebd56987darrenm * Check for the SYS_CONFIG privilege. We do this explicitly
fa9e4066f08beec538e775443c5be79dd423fcabahrens * here because otherwise any attempt to discover pools will
fa9e4066f08beec538e775443c5be79dd423fcabahrens * silently fail.
fa9e4066f08beec538e775443c5be79dd423fcabahrens "discover pools: permission denied\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((pools = zpool_find_import(g_zfs, nsearch, searchdirs)) == NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * We now have a list of all available pools in the given directories.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Depending on the arguments given, we do one of the following:
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock * <none> Iterate through all pools and display information about
99653d4ee642c6528e88224f12409a5f23060994eschrock * each one.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -a Iterate through all pools and try to import each one.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * <id> Find the pool that corresponds to the given GUID/pool
fa9e4066f08beec538e775443c5be79dd423fcabahrens * name and import that one.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -D Above options applies only to destroyed pools.
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (argc != 0) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens while ((elem = nvlist_next_nvpair(pools, elem)) != NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_POOL_STATE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (!do_destroyed && pool_state == POOL_STATE_DESTROYED)
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (do_destroyed && pool_state != POOL_STATE_DESTROYED)
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (argc == 0) {
990b4856d0eaada6f8140335733a1b1771ed2746lling * We are searching for a pool based on name.
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock "cannot import '%s': more than "
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock "import by numeric ID instead\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Search for a pool by guid.
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock * If we were searching for a specific pool, verify that we found a
2f8aaab38e6371ad39ed90a1211ba8921acbb4d5eschrock * pool, and then do the import.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("cannot import '%s': "
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If we were just looking for pools, report an error if none were
99653d4ee642c6528e88224f12409a5f23060994eschrocktypedef struct iostat_cbdata {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(" ----- ----- ----- ----- ----- -----\n");
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf("%-*s used avail read write read write\n",
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Display a single statistic.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Print out all the statistics for the given vdev. This can either be the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * toplevel configuration, or called recursively. If 'name' is NULL, then this
fa9e4066f08beec538e775443c5be79dd423fcabahrens * is a verbose output, and we don't want to display the toplevel pool stats.
fa9e4066f08beec538e775443c5be79dd423fcabahrensprint_vdev_stats(zpool_handle_t *zhp, const char *name, nvlist_t *oldnv,
99653d4ee642c6528e88224f12409a5f23060994eschrock verify(nvlist_lookup_uint64_array(oldnv, ZPOOL_CONFIG_STATS,
990b4856d0eaada6f8140335733a1b1771ed2746lling verify(nvlist_lookup_uint64_array(newnv, ZPOOL_CONFIG_STATS,
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* only toplevel vdevs have capacity stats */
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_one_stat((uint64_t)(scale * (newvs->vs_ops[ZIO_TYPE_READ] -
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_one_stat((uint64_t)(scale * (newvs->vs_ops[ZIO_TYPE_WRITE] -
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_one_stat((uint64_t)(scale * (newvs->vs_bytes[ZIO_TYPE_READ] -
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_one_stat((uint64_t)(scale * (newvs->vs_bytes[ZIO_TYPE_WRITE] -
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(newnv, ZPOOL_CONFIG_CHILDREN,
99653d4ee642c6528e88224f12409a5f23060994eschrock if (oldnv && nvlist_lookup_nvlist_array(oldnv, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_vdev_stats(zhp, vname, oldnv ? oldchild[c] : NULL,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If the pool has disappeared, remove it from the list and continue.
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (-1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Callback to print out the iostats for the given pool.
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist(newconfig, ZPOOL_CONFIG_VDEV_TREE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist(oldconfig, ZPOOL_CONFIG_VDEV_TREE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Print out the statistics for the pool.
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_vdev_stats(zhp, zpool_get_name(zhp), oldnvroot, newnvroot, cb, 0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((config = zpool_get_config(zhp, NULL)) != NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * The width must fall into the range [10,38]. The upper limit is the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * maximum we can have and still fit in 80 columns.
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool iostat [-v] [pool] ... [interval [count]]
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -v Display statistics for individual vdevs
fa9e4066f08beec538e775443c5be79dd423fcabahrens * This command can be tricky because we want to be able to deal with pool
fa9e4066f08beec538e775443c5be79dd423fcabahrens * creation/destruction as well as vdev configuration changes. The bulk of this
fa9e4066f08beec538e775443c5be79dd423fcabahrens * processing is handled by the pool_list_* routines in zpool_iter.c. We rely
fa9e4066f08beec538e775443c5be79dd423fcabahrens * on pool_list_update() to detect the addition of new pools. Configuration
fa9e4066f08beec538e775443c5be79dd423fcabahrens * changes are all handled within libzfs.
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Determine if the last argument is an integer or a pool name
fa9e4066f08beec538e775443c5be79dd423fcabahrens "cannot be zero\n"));
94de1d4cf6ec0a3bf040dcc4b8df107c4ed36b51eschrock * Ignore the last parameter
94de1d4cf6ec0a3bf040dcc4b8df107c4ed36b51eschrock * If this is not a valid number, just plow on. The
94de1d4cf6ec0a3bf040dcc4b8df107c4ed36b51eschrock * user will get a more informative error message later
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If the last argument is also an integer, then we have both a count
fa9e4066f08beec538e775443c5be79dd423fcabahrens * and an integer.
fa9e4066f08beec538e775443c5be79dd423fcabahrens "cannot be zero\n"));
088e9d477eee66081e407fbc5a33c4da25f66f6aeschrock * Ignore the last parameter
c67d9675bbc8392fe45f3a7dfbda1ad4daa1eb07eschrock * Construct the list of all interesting pools.
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((list = pool_list_get(argc, argv, &ret)) == NULL)
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("no pools available\n"));
088e9d477eee66081e407fbc5a33c4da25f66f6aeschrock return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Enter the main iostat loop.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Refresh all statistics. This is done as an explicit step
fa9e4066f08beec538e775443c5be79dd423fcabahrens * before calculating the maximum name width, so that any
fa9e4066f08beec538e775443c5be79dd423fcabahrens * configuration changes are properly accounted for.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) pool_list_iter(list, B_FALSE, refresh_iostat, &cb);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Iterate over all pools to determine the maximum width
fa9e4066f08beec538e775443c5be79dd423fcabahrens * for the pool / device name column across all pools.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) pool_list_iter(list, B_FALSE, get_namewidth, &cb);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If it's the first time, or verbose mode, print the header.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) pool_list_iter(list, B_FALSE, print_iostat, &cb);
99653d4ee642c6528e88224f12409a5f23060994eschrock * If there's more than one pool, and we're not in verbose mode
fa9e4066f08beec538e775443c5be79dd423fcabahrens * (which prints a separator for us), then print a separator.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Flush the output so that redirection to a file isn't buffered
fa9e4066f08beec538e775443c5be79dd423fcabahrens * indefinitely.
fa9e4066f08beec538e775443c5be79dd423fcabahrenstypedef struct list_cbdata {
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Given a list of columns to display, output appropriate headers for each one.
fa9e4066f08beec538e775443c5be79dd423fcabahrens const char *fmt;
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (i = 0; i < count; i++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (i != 0)
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(fmt, i == count - 1 ? strlen(col->cd_title) :
fa9e4066f08beec538e775443c5be79dd423fcabahrens const char *fmt;
99653d4ee642c6528e88224f12409a5f23060994eschrock if (i != 0) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) strlcpy(buf, zpool_get_name(zhp), sizeof (buf));
fa9e4066f08beec538e775443c5be79dd423fcabahrens else if (zpool_get_root(zhp, buf, sizeof (buf)) != 0)
990b4856d0eaada6f8140335733a1b1771ed2746lling return (0);
990b4856d0eaada6f8140335733a1b1771ed2746lling * zpool list [-H] [-o field[,field]*] [pool] ...
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -H Scripted mode. Don't display headers, and separate fields by
990b4856d0eaada6f8140335733a1b1771ed2746lling * a single tab.
990b4856d0eaada6f8140335733a1b1771ed2746lling * -o List of fields to display. Defaults to all fields, or
990b4856d0eaada6f8140335733a1b1771ed2746lling * "name,size,used,available,capacity,health,root"
fa9e4066f08beec538e775443c5be79dd423fcabahrens * List all pools in the system, whether or not they're healthy. Output space
990b4856d0eaada6f8140335733a1b1771ed2746lling * statistics for each one, as well as health status summary.
fa9e4066f08beec538e775443c5be79dd423fcabahrens static char default_fields[] =
fa9e4066f08beec538e775443c5be79dd423fcabahrens "name,size,used,available,capacity,health,root";
990b4856d0eaada6f8140335733a1b1771ed2746lling /* check options */
990b4856d0eaada6f8140335733a1b1771ed2746lling switch (c) {
990b4856d0eaada6f8140335733a1b1771ed2746lling (void) fprintf(stderr, gettext("missing argument for "
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
990b4856d0eaada6f8140335733a1b1771ed2746lling "properties given to -o option\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling if ((cb.cb_fields[cb.cb_fieldcount] = getsubopt(&fields,
990b4856d0eaada6f8140335733a1b1771ed2746lling ret = for_each_pool(argc, argv, B_TRUE, list_callback, &cb);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
990b4856d0eaada6f8140335733a1b1771ed2746lling if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_string(nv, ZPOOL_CONFIG_PATH, &path) == 0);
990b4856d0eaada6f8140335733a1b1771ed2746lling for (c = 0; c < children; c++)
990b4856d0eaada6f8140335733a1b1771ed2746lling if ((match = zpool_get_vdev_by_name(child[c], name)) != NULL)
fa9e4066f08beec538e775443c5be79dd423fcabahrenszpool_do_attach_or_replace(int argc, char **argv, int replacing)
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
99653d4ee642c6528e88224f12409a5f23060994eschrock switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* get pool name and check number of arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name argument\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("too many arguments\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens if ((config = zpool_get_config(zhp, NULL)) == NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("pool '%s' is unavailable\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens nvroot = make_root_vdev(config, force, B_FALSE, replacing, argc, argv);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
99653d4ee642c6528e88224f12409a5f23060994eschrock ret = zpool_vdev_attach(zhp, old_disk, new_disk, nvroot, replacing);
fa9e4066f08beec538e775443c5be79dd423fcabahrens zpool_log_history(g_zfs, log_argc, log_argv, poolname, B_TRUE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool replace [-f] <pool> <device> <new_device>
99653d4ee642c6528e88224f12409a5f23060994eschrock * -f Force attach, even if <new_device> appears to be in use.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Replace <device> with <new_device>.
fa9e4066f08beec538e775443c5be79dd423fcabahrens/* ARGSUSED */
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (zpool_do_attach_or_replace(argc, argv, B_TRUE));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool attach [-f] <pool> <device> <new_device>
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -f Force attach, even if <new_device> appears to be in use.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Attach <new_device> to the mirror containing <device>. If <device> is not
fa9e4066f08beec538e775443c5be79dd423fcabahrens * part of a mirror, then <device> will be transformed into a mirror of
99653d4ee642c6528e88224f12409a5f23060994eschrock * <device> and <new_device>. In either case, <new_device> will begin life
fa9e4066f08beec538e775443c5be79dd423fcabahrens * with a DTL of [0, now], and will immediately begin to resilver itself.
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (zpool_do_attach_or_replace(argc, argv, B_FALSE));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool detach [-f] <pool> <device>
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -f Force detach of <device>, even if DTLs argue against it
fa9e4066f08beec538e775443c5be79dd423fcabahrens * (not supported yet)
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Detach a device from a mirror. The operation will be refused if <device>
fa9e4066f08beec538e775443c5be79dd423fcabahrens * is the last device in the mirror, or if the DTLs indicate that this device
fa9e4066f08beec538e775443c5be79dd423fcabahrens * has the only valid copy of some data.
fa9e4066f08beec538e775443c5be79dd423fcabahrens/* ARGSUSED */
8488aeb5df27784d479c16cde06a9e25cd9a1152taylor /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
99653d4ee642c6528e88224f12409a5f23060994eschrock /* get pool name and check number of arguments */
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("missing pool name argument\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens zpool_log_history(g_zfs, argc + optind, argv - optind, poolname,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool online <pool> <device> ...
fa9e4066f08beec538e775443c5be79dd423fcabahrens/* ARGSUSED */
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* get pool name and check number of arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing device name\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("Bringing device %s online\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens zpool_log_history(g_zfs, argc + optind, argv - optind, poolname,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool offline [-ft] <pool> <device> ...
99653d4ee642c6528e88224f12409a5f23060994eschrock * -f Force the device into the offline state, even if doing
99653d4ee642c6528e88224f12409a5f23060994eschrock * so would appear to compromise pool availability.
99653d4ee642c6528e88224f12409a5f23060994eschrock * (not supported yet)
fa9e4066f08beec538e775443c5be79dd423fcabahrens * -t Only take the device off-line temporarily. The offline
fa9e4066f08beec538e775443c5be79dd423fcabahrens * state will not be persistent across reboots.
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling/* ARGSUSED */
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* get pool name and check number of arguments */
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing device name\n"));
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock return (1);
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock (void) printf(gettext("Bringing device %s offline\n"),
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock zpool_log_history(g_zfs, argc + optind, argv - optind, poolname,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zpool clear <pool> [device]
99653d4ee642c6528e88224f12409a5f23060994eschrock * Clear all errors associated with a pool or a particular device.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("missing pool name\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("too many arguments\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
441d80aa4f613b6298fc8bd3151f4be02dbf84fclling zpool_log_history(g_zfs, argc, argv, pool, B_TRUE, B_FALSE);
fa9e4066f08beec538e775443c5be79dd423fcabahrenstypedef struct scrub_cbdata {
99653d4ee642c6528e88224f12409a5f23060994eschrock * Ignore faulted pools.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("cannot scrub '%s': pool is "
99653d4ee642c6528e88224f12409a5f23060994eschrock return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (err != 0);
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * zpool scrub [-s] <pool> ...
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * -s Stop. Stops any in-progress scrub.
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock /* check options */
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock switch (c) {
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock (void) fprintf(stderr, gettext("invalid option '%c'\n"),
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock (void) fprintf(stderr, gettext("missing pool name argument\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (for_each_pool(argc, argv, B_TRUE, scrub_callback, &cb));
06eeb2ad640ce72d394ac521094bed7681044408ektypedef struct status_cbdata {
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * Print out detailed scrub status.
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64_array(nvroot, ZPOOL_CONFIG_STATS,
fa9e4066f08beec538e775443c5be79dd423fcabahrens * If there's never been a scrub, there's not much to say.
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (vs->vs_scrub_end == 0 && vs->vs_scrub_type == POOL_SCRUB_NONE) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens scrub_type = (vs->vs_scrub_type == POOL_SCRUB_RESILVER) ?
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (end != 0) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("%s %s with %llu errors on %s"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens scrub_type, vs->vs_scrub_complete ? "completed" : "stopped",
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("%s in progress, %.2f%% done, %lluh%um to go\n"),
b1b8ab34de515a5e83206da22c3d7e563241b021lling (u_longlong_t)(minutes_left / 60), (uint_t)(minutes_left % 60));
fa9e4066f08beec538e775443c5be79dd423fcabahrenstypedef struct spare_cbdata {
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_uint64(nv, ZPOOL_CONFIG_GUID, &guid) == 0 &&
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (c = 0; c < children; c++)
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Print out configuration state as requested by status_callback.
fa9e4066f08beec538e775443c5be79dd423fcabahrensprint_status_config(zpool_handle_t *zhp, const char *name, nvlist_t *nv,
fa9e4066f08beec538e775443c5be79dd423fcabahrens const char *state;
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64_array(nv, ZPOOL_CONFIG_STATS,
99653d4ee642c6528e88224f12409a5f23060994eschrock if (nvlist_lookup_nvlist_array(nv, ZPOOL_CONFIG_CHILDREN,
99653d4ee642c6528e88224f12409a5f23060994eschrock * For hot spares, we use the terms 'INUSE' and 'AVAILABLE' for
99653d4ee642c6528e88224f12409a5f23060994eschrock * online drives.
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf("\t%*s%-*s %-8s", depth, "", namewidth - depth,
99653d4ee642c6528e88224f12409a5f23060994eschrock zfs_nicenum(vs->vs_read_errors, rbuf, sizeof (rbuf));
99653d4ee642c6528e88224f12409a5f23060994eschrock zfs_nicenum(vs->vs_write_errors, wbuf, sizeof (wbuf));
99653d4ee642c6528e88224f12409a5f23060994eschrock zfs_nicenum(vs->vs_checksum_errors, cbuf, sizeof (cbuf));
99653d4ee642c6528e88224f12409a5f23060994eschrock if (nvlist_lookup_uint64(nv, ZPOOL_CONFIG_NOT_PRESENT,
99653d4ee642c6528e88224f12409a5f23060994eschrock verify(nvlist_lookup_string(nv, ZPOOL_CONFIG_PATH, &path) == 0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens "pool '%s'"),
99653d4ee642c6528e88224f12409a5f23060994eschrock } else if (vs->vs_scrub_repaired != 0 && children == 0) {
99653d4ee642c6528e88224f12409a5f23060994eschrock * Report bytes resilvered/repaired on leaf devices.
99653d4ee642c6528e88224f12409a5f23060994eschrock zfs_nicenum(vs->vs_scrub_repaired, repaired, sizeof (repaired));
99653d4ee642c6528e88224f12409a5f23060994eschrock for (c = 0; c < children; c++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens "(insufficient privileges)\n");
fa9e4066f08beec538e775443c5be79dd423fcabahrens "detected in the following files:\n\n");
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock while ((elem = nvlist_next_nvpair(nverrlist, elem)) != NULL) {
99653d4ee642c6528e88224f12409a5f23060994eschrockprint_spares(zpool_handle_t *zhp, nvlist_t **spares, uint_t nspares,
fa9e4066f08beec538e775443c5be79dd423fcabahrens for (i = 0; i < nspares; i++) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Display a summary of pool status. Displays a summary such as:
afefbcddfd8caf5f3b2da510d9439471ab225040eschrock * pool: tank
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * status: DEGRADED
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * reason: One or more devices ...
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * mirror DEGRADED
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * c1t0d0 OK
99653d4ee642c6528e88224f12409a5f23060994eschrock * c2t0d0 UNAVAIL
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin * When given the '-v' option, we print out the complete config. If the '-e'
afefbcddfd8caf5f3b2da510d9439471ab225040eschrock * option is specified, then we print out error rate information as well.
55434c770c89aa1b84474f2559a106803511aba0ek const char *health;
55434c770c89aa1b84474f2559a106803511aba0ek * If we were given 'zpool status -x', only report those pools with
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * problems.
55434c770c89aa1b84474f2559a106803511aba0ek return (0);
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock verify(nvlist_lookup_nvlist(config, ZPOOL_CONFIG_VDEV_TREE,
99653d4ee642c6528e88224f12409a5f23060994eschrock verify(nvlist_lookup_uint64_array(nvroot, ZPOOL_CONFIG_STATS,
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext(" pool: %s\n"), zpool_get_name(zhp));
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext("status: One or more devices could not "
99653d4ee642c6528e88224f12409a5f23060994eschrock "be opened. Sufficient replicas exist for\n\tthe pool to "
99653d4ee642c6528e88224f12409a5f23060994eschrock "continue functioning in a degraded state.\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext("action: Attach the missing device and "
99653d4ee642c6528e88224f12409a5f23060994eschrock "online it using 'zpool online'.\n"));
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext("status: One or more devices could not "
99653d4ee642c6528e88224f12409a5f23060994eschrock "be opened. There are insufficient\n\treplicas for the "
99653d4ee642c6528e88224f12409a5f23060994eschrock "pool to continue functioning.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Attach the missing device and "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "online it using 'zpool online'.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: One or more devices could not "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "be used because the label is missing or\n\tinvalid. "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "Sufficient replicas exist for the pool to continue\n\t"
fa9e4066f08beec538e775443c5be79dd423fcabahrens "functioning in a degraded state.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Replace the device using "
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock "'zpool replace'.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: One or more devices could not "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "be used because the the label is missing \n\tor invalid. "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "There are insufficient replicas for the pool to "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "continue\n\tfunctioning.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Destroy and re-create the pool "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "from a backup source.\n"));
46657f8d750bdb71753495ce2919170f126b8e34mmusante (void) printf(gettext("status: One or more devices has "
46657f8d750bdb71753495ce2919170f126b8e34mmusante "experienced an unrecoverable error. An\n\tattempt was "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "made to correct the error. Applications are "
088e9d477eee66081e407fbc5a33c4da25f66f6aeschrock "unaffected.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Determine if the device needs "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "to be replaced, and clear the errors\n\tusing "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "'zpool clear' or replace the device with 'zpool "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "replace'.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: One or more devices has "
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock "been taken offline by the administrator.\n\tSufficient "
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock "replicas exist for the pool to continue functioning in "
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock "a\n\tdegraded state.\n"));
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock (void) printf(gettext("action: Online the device using "
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock "'zpool online' or replace the device with\n\t'zpool "
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock "replace'.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: One or more devices is "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "currently being resilvered. The pool will\n\tcontinue "
99653d4ee642c6528e88224f12409a5f23060994eschrock "to function, possibly in a degraded state.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Wait for the resilver to "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "complete.\n"));
46657f8d750bdb71753495ce2919170f126b8e34mmusante (void) printf(gettext("status: One or more devices has "
46657f8d750bdb71753495ce2919170f126b8e34mmusante "experienced an error resulting in data\n\tcorruption. "
990b4856d0eaada6f8140335733a1b1771ed2746lling "Applications may be affected.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Restore the file in question "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "if possible. Otherwise restore the\n\tentire pool from "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "backup.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool metadata is corrupted "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "and the pool cannot be opened.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Destroy and re-create the pool "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "from a backup source.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool is formatted using an "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "older on-disk format. The pool can\n\tstill be used, but "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "some features are unavailable.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Upgrade the pool using 'zpool "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "upgrade'. Once this is done, the\n\tpool will no longer "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "be accessible on older software versions.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("status: The pool has been upgraded to a "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "newer, incompatible on-disk version.\n\tThe pool cannot "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "be accessed on this system.\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("action: Access the pool from a system "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "running more recent software, or\n\trestore the pool from "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "backup.\n"));
b1b8ab34de515a5e83206da22c3d7e563241b021lling * The remaining errors can't actually be generated, yet.
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext(" see: http://www.sun.com/msg/%s\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) printf(gettext("\t%-*s %-8s %5s %5s %5s\n"), namewidth,
fa9e4066f08beec538e775443c5be79dd423fcabahrens print_status_config(zhp, zpool_get_name(zhp), nvroot,
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_nvlist_array(nvroot, ZPOOL_CONFIG_SPARES,
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (nvlist_lookup_uint64(config, ZPOOL_CONFIG_ERRCOUNT,
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * If the approximate error count is small, get a
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * precise count by fetching the entire log and
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * uniquifying the results.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "errors\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "errors, use '-v' for a list\n"),
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("config: The configuration cannot be "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "determined.\n"));
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock return (0);
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock * zpool status [-vx] [pool] ...
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock * -v Display complete error logs
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock * -x Display only pools with potential problems
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock * Describes the health status of all pools or some subset.
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check options */
fa9e4066f08beec538e775443c5be79dd423fcabahrens switch (c) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens (void) fprintf(stderr, gettext("invalid option '%c'\n"),
fa9e4066f08beec538e775443c5be79dd423fcabahrens ret = for_each_pool(argc, argv, B_TRUE, status_callback, &cb);
c67d9675bbc8392fe45f3a7dfbda1ad4daa1eb07eschrock else if (cb.cb_explain && cb.cb_first && cb.cb_allpools)
99653d4ee642c6528e88224f12409a5f23060994eschrocktypedef struct upgrade_cbdata {
55434c770c89aa1b84474f2559a106803511aba0ek verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_VERSION,
55434c770c89aa1b84474f2559a106803511aba0ek "out of date, and can be upgraded. After "
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock "being\nupgraded, these pools will no "
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock "longer be accessible by older software "
99653d4ee642c6528e88224f12409a5f23060994eschrock "versions.\n\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens "formatted using a newer software version and\n"
fa9e4066f08beec538e775443c5be79dd423fcabahrens "cannot be accessed on the current system.\n\n"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens/* ARGSUSED */
fa9e4066f08beec538e775443c5be79dd423fcabahrens verify(nvlist_lookup_uint64(config, ZPOOL_CONFIG_VERSION,
99653d4ee642c6528e88224f12409a5f23060994eschrock (void) printf(gettext("Pool '%s' is already formatted "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "using the current version.\n"), zpool_get_name(zhp));
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock return (0);
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock (void) printf(gettext("Successfully upgraded '%s' "
fa9e4066f08beec538e775443c5be79dd423fcabahrens "from version %llu to version %llu\n"), zpool_get_name(zhp),
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock return (ret != 0);
06eeb2ad640ce72d394ac521094bed7681044408ek * zpool upgrade
990b4856d0eaada6f8140335733a1b1771ed2746lling * zpool upgrade -v
06eeb2ad640ce72d394ac521094bed7681044408ek * zpool upgrade <-a | pool>
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * With no arguments, display downrev'd ZFS pool available for upgrade.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Individual pools can be upgraded by specifying the pool, and '-a' will
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * upgrade all pools.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock /* check options */
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock switch (c) {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) fprintf(stderr, gettext("invalid option '%c'\n"),
e7437265dc2a4920c197ed4337665539d358b22cahrens "incompatible with other arguments\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock if (argc != 0) {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "incompatible with other arguments\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("This system is currently running ZFS version "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("The following versions are "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "supported:\n\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf("--- -----------------------------------------"
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "---------------\n");
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext(" 1 Initial ZFS version\n"));
06eeb2ad640ce72d394ac521094bed7681044408ek "(replicated metadata)\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext(" 3 Hot spares and double parity "
990b4856d0eaada6f8140335733a1b1771ed2746lling "RAID-Z\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling (void) printf(gettext("\nFor more information on a particular "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "version, including supported releases, see:\n\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf("http://www.opensolaris.org/os/community/zfs/"
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin "version/N\n\n");
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin (void) printf(gettext("Where 'N' is the version number.\n"));
8654d0253136055bd4cc2423d87378e8a37f2eb5perrin } else if (argc == 0) {
990b4856d0eaada6f8140335733a1b1771ed2746lling if (ret == 0) {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "using this version.\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "for a list of available versions and "
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock "their associated\nfeatures.\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling ret = for_each_pool(argc, argv, B_FALSE, upgrade_one, &cb);
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Print out the command history for a specific pool.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) printf(gettext("History for '%s':\n"), zpool_get_name(zhp));
990b4856d0eaada6f8140335733a1b1771ed2746lling verify(nvlist_lookup_nvlist_array(nvhis, ZPOOL_HIST_RECORD,
990b4856d0eaada6f8140335733a1b1771ed2746lling for (i = 0; i < numrecords; i++) {
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock verify(nvlist_lookup_string(records[i], ZPOOL_HIST_CMD,
351420b34707afeafa8d5c3e0c77b7bcffb1edc0lling * zpool history <pool>
351420b34707afeafa8d5c3e0c77b7bcffb1edc0lling * Displays the history of commands that modified pools.
351420b34707afeafa8d5c3e0c77b7bcffb1edc0lling ret = for_each_pool(argc, argv, B_FALSE, get_history_one, &first);
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock return (0);
c9431fa1e59a88c2f0abf611f25b97af964449e5ahl (void) fprintf(stderr, gettext("internal error: failed to "
c9431fa1e59a88c2f0abf611f25b97af964449e5ahl "initialize ZFS library\n"));
990b4856d0eaada6f8140335733a1b1771ed2746lling return (1);
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Make sure the user has specified some command.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock (void) fprintf(stderr, gettext("missing command\n"));
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Special case '-?'
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock * Run the appropriate command.
eaca9bbd5f5d1e4e554da4c7108e8a03c8c33481eschrock for (i = 0; i < NCOMMAND; i++) {
b1b8ab34de515a5e83206da22c3d7e563241b021lling * 'freeze' is a vile debugging abomination, so we treat it as such.
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks * The 'ZFS_ABORT' environment variable causes us to dump core on exit
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks * for the purposes of running ::findleaks.