9804 hal-set-property should support --direct option

[unleashed.git] / usr / src / cmd / zoneadm / zfs.c

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
 * Copyright (c) 2012, 2015 by Delphix. All rights reserved.
 * Copyright (c) 2012, Joyent, Inc. All rights reserved.
 * Copyright (c) 2016 Martin Matuska. All rights reserved.
 */

/*
 * This file contains the functions used to support the ZFS integration
 * with zones.  This includes validation (e.g. zonecfg dataset), cloning,
 * file system creation and destruction.
 */

#include <stdio.h>
#include <errno.h>
#include <unistd.h>
#include <string.h>
#include <locale.h>
#include <libintl.h>
#include <sys/stat.h>
#include <sys/statvfs.h>
#include <libgen.h>
#include <libzonecfg.h>
#include <sys/mnttab.h>
#include <libzfs.h>
#include <sys/mntent.h>
#include <values.h>
#include <strings.h>
#include <assert.h>

#include "zoneadm.h"

libzfs_handle_t *g_zfs;

typedef struct zfs_mount_data {
        char            *match_name;
        zfs_handle_t    *match_handle;
} zfs_mount_data_t;

typedef struct zfs_snapshot_data {
        char    *match_name;    /* zonename@SUNWzone */
        int     len;            /* strlen of match_name */
        int     max;            /* highest digit appended to snap name */
        int     num;            /* number of snapshots to rename */
        int     cntr;           /* counter for renaming snapshots */
} zfs_snapshot_data_t;

typedef struct clone_data {
        zfs_handle_t    *clone_zhp;     /* clone dataset to promote */
        time_t          origin_creation; /* snapshot creation time of clone */
        const char      *snapshot;      /* snapshot of dataset being demoted */
} clone_data_t;

/*
 * A ZFS file system iterator call-back function which returns the
 * zfs_handle_t for a ZFS file system on the specified mount point.
 */
static int
match_mountpoint(zfs_handle_t *zhp, void *data)
{
        int                     res;
        zfs_mount_data_t        *cbp;
        char                    mp[ZFS_MAXPROPLEN];

        if (zfs_get_type(zhp) != ZFS_TYPE_FILESYSTEM) {
                zfs_close(zhp);
                return (0);
        }

        /* First check if the dataset is mounted. */
        if (zfs_prop_get(zhp, ZFS_PROP_MOUNTED, mp, sizeof (mp), NULL, NULL,
            0, B_FALSE) != 0 || strcmp(mp, "no") == 0) {
                zfs_close(zhp);
                return (0);
        }

        /* Now check mount point. */
        if (zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, mp, sizeof (mp), NULL, NULL,
            0, B_FALSE) != 0) {
                zfs_close(zhp);
                return (0);
        }

        cbp = (zfs_mount_data_t *)data;

        if (strcmp(mp, "legacy") == 0) {
                /* If legacy, must look in mnttab for mountpoint. */
                FILE            *fp;
                struct mnttab   entry;
                const char      *nm;

                nm = zfs_get_name(zhp);
                if ((fp = fopen(MNTTAB, "r")) == NULL) {
                        zfs_close(zhp);
                        return (0);
                }

                while (getmntent(fp, &entry) == 0) {
                        if (strcmp(nm, entry.mnt_special) == 0) {
                                if (strcmp(entry.mnt_mountp, cbp->match_name)
                                    == 0) {
                                        (void) fclose(fp);
                                        cbp->match_handle = zhp;
                                        return (1);
                                }
                                break;
                        }
                }
                (void) fclose(fp);

        } else if (strcmp(mp, cbp->match_name) == 0) {
                cbp->match_handle = zhp;
                return (1);
        }

        /* Iterate over any nested datasets. */
        res = zfs_iter_filesystems(zhp, match_mountpoint, data);
        zfs_close(zhp);
        return (res);
}

/*
 * Get ZFS handle for the specified mount point.
 */
static zfs_handle_t *
mount2zhandle(char *mountpoint)
{
        zfs_mount_data_t        cb;

        cb.match_name = mountpoint;
        cb.match_handle = NULL;
        (void) zfs_iter_root(g_zfs, match_mountpoint, &cb);
        return (cb.match_handle);
}

/*
 * Check if there is already a file system (zfs or any other type) mounted on
 * path.
 */
static boolean_t
is_mountpnt(char *path)
{
        FILE            *fp;
        struct mnttab   entry;

        if ((fp = fopen(MNTTAB, "r")) == NULL)
                return (B_FALSE);

        while (getmntent(fp, &entry) == 0) {
                if (strcmp(path, entry.mnt_mountp) == 0) {
                        (void) fclose(fp);
                        return (B_TRUE);
                }
        }

        (void) fclose(fp);
        return (B_FALSE);
}

/*
 * Run the brand's pre-snapshot hook before we take a ZFS snapshot of the zone.
 */
static int
pre_snapshot(char *presnapbuf)
{
        int status;

        /* No brand-specific handler */
        if (presnapbuf[0] == '\0')
                return (Z_OK);

        /* Run the hook */
        status = do_subproc(presnapbuf);
        if ((status = subproc_status(gettext("brand-specific presnapshot"),
            status, B_FALSE)) != ZONE_SUBPROC_OK)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * Run the brand's post-snapshot hook after we take a ZFS snapshot of the zone.
 */
static int
post_snapshot(char *postsnapbuf)
{
        int status;

        /* No brand-specific handler */
        if (postsnapbuf[0] == '\0')
                return (Z_OK);

        /* Run the hook */
        status = do_subproc(postsnapbuf);
        if ((status = subproc_status(gettext("brand-specific postsnapshot"),
            status, B_FALSE)) != ZONE_SUBPROC_OK)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * This is a ZFS snapshot iterator call-back function which returns the
 * highest number of SUNWzone snapshots that have been taken.
 */
static int
get_snap_max(zfs_handle_t *zhp, void *data)
{
        int                     res;
        zfs_snapshot_data_t     *cbp;

        if (zfs_get_type(zhp) != ZFS_TYPE_SNAPSHOT) {
                zfs_close(zhp);
                return (0);
        }

        cbp = (zfs_snapshot_data_t *)data;

        if (strncmp(zfs_get_name(zhp), cbp->match_name, cbp->len) == 0) {
                char    *nump;
                int     num;

                cbp->num++;
                nump = (char *)(zfs_get_name(zhp) + cbp->len);
                num = atoi(nump);
                if (num > cbp->max)
                        cbp->max = num;
        }

        res = zfs_iter_snapshots(zhp, B_FALSE, get_snap_max, data);
        zfs_close(zhp);
        return (res);
}

/*
 * Take a ZFS snapshot to be used for cloning the zone.
 */
static int
take_snapshot(zfs_handle_t *zhp, char *snapshot_name, int snap_size,
    char *presnapbuf, char *postsnapbuf)
{
        int                     res;
        char                    template[ZFS_MAX_DATASET_NAME_LEN];
        zfs_snapshot_data_t     cb;

        /*
         * First we need to figure out the next available name for the
         * zone snapshot.  Look through the list of zones snapshots for
         * this file system to determine the maximum snapshot name.
         */
        if (snprintf(template, sizeof (template), "%s@SUNWzone",
            zfs_get_name(zhp)) >=  sizeof (template))
                return (Z_ERR);

        cb.match_name = template;
        cb.len = strlen(template);
        cb.max = 0;

        if (zfs_iter_snapshots(zhp, B_FALSE, get_snap_max, &cb) != 0)
                return (Z_ERR);

        cb.max++;

        if (snprintf(snapshot_name, snap_size, "%s@SUNWzone%d",
            zfs_get_name(zhp), cb.max) >= snap_size)
                return (Z_ERR);

        if (pre_snapshot(presnapbuf) != Z_OK)
                return (Z_ERR);
        res = zfs_snapshot(g_zfs, snapshot_name, B_FALSE, NULL);
        if (post_snapshot(postsnapbuf) != Z_OK)
                return (Z_ERR);

        if (res != 0)
                return (Z_ERR);
        return (Z_OK);
}

/*
 * We are using an explicit snapshot from some earlier point in time so
 * we need to validate it.  Run the brand specific hook.
 */
static int
validate_snapshot(char *snapshot_name, char *snap_path, char *validsnapbuf)
{
        int status;
        char cmdbuf[MAXPATHLEN];

        /* No brand-specific handler */
        if (validsnapbuf[0] == '\0')
                return (Z_OK);

        /* pass args - snapshot_name & snap_path */
        if (snprintf(cmdbuf, sizeof (cmdbuf), "%s %s %s", validsnapbuf,
            snapshot_name, snap_path) >= sizeof (cmdbuf)) {
                zerror("Command line too long");
                return (Z_ERR);
        }

        /* Run the hook */
        status = do_subproc(cmdbuf);
        if ((status = subproc_status(gettext("brand-specific validatesnapshot"),
            status, B_FALSE)) != ZONE_SUBPROC_OK)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * Remove the sw inventory file from inside this zonepath that we picked up out
 * of the snapshot.
 */
static int
clean_out_clone()
{
        int err;
        zone_dochandle_t handle;

        if ((handle = zonecfg_init_handle()) == NULL) {
                zperror(cmd_to_str(CMD_CLONE), B_TRUE);
                return (Z_ERR);
        }

        if ((err = zonecfg_get_handle(target_zone, handle)) != Z_OK) {
                errno = err;
                zperror(cmd_to_str(CMD_CLONE), B_TRUE);
                zonecfg_fini_handle(handle);
                return (Z_ERR);
        }

        zonecfg_rm_detached(handle, B_FALSE);
        zonecfg_fini_handle(handle);

        return (Z_OK);
}

/*
 * Make a ZFS clone on zonepath from snapshot_name.
 */
static int
clone_snap(char *snapshot_name, char *zonepath)
{
        int             res = Z_OK;
        int             err;
        zfs_handle_t    *zhp;
        zfs_handle_t    *clone;
        nvlist_t        *props = NULL;

        if ((zhp = zfs_open(g_zfs, snapshot_name, ZFS_TYPE_SNAPSHOT)) == NULL)
                return (Z_NO_ENTRY);

        (void) printf(gettext("Cloning snapshot %s\n"), snapshot_name);

        /*
         * We turn off zfs SHARENFS and SHARESMB properties on the
         * zoneroot dataset in order to prevent the GZ from sharing
         * NGZ data by accident.
         */
        if ((nvlist_alloc(&props, NV_UNIQUE_NAME, 0) != 0) ||
            (nvlist_add_string(props, zfs_prop_to_name(ZFS_PROP_SHARENFS),
            "off") != 0) ||
            (nvlist_add_string(props, zfs_prop_to_name(ZFS_PROP_SHARESMB),
            "off") != 0)) {
                nvlist_free(props);
                (void) fprintf(stderr, gettext("could not create ZFS clone "
                    "%s: out of memory\n"), zonepath);
                return (Z_ERR);
        }

        err = zfs_clone(zhp, zonepath, props);
        zfs_close(zhp);

        nvlist_free(props);

        if (err != 0)
                return (Z_ERR);

        /* create the mountpoint if necessary */
        if ((clone = zfs_open(g_zfs, zonepath, ZFS_TYPE_DATASET)) == NULL)
                return (Z_ERR);

        /*
         * The clone has been created so we need to print a diagnostic
         * message if one of the following steps fails for some reason.
         */
        if (zfs_mount(clone, NULL, 0) != 0) {
                (void) fprintf(stderr, gettext("could not mount ZFS clone "
                    "%s\n"), zfs_get_name(clone));
                res = Z_ERR;

        } else if (clean_out_clone() != Z_OK) {
                (void) fprintf(stderr, gettext("could not remove the "
                    "software inventory from ZFS clone %s\n"),
                    zfs_get_name(clone));
                res = Z_ERR;
        }

        zfs_close(clone);
        return (res);
}

/*
 * This function takes a zonepath and attempts to determine what the ZFS
 * file system name (not mountpoint) should be for that path.  We do not
 * assume that zonepath is an existing directory or ZFS fs since we use
 * this function as part of the process of creating a new ZFS fs or clone.
 *
 * The way this works is that we look at the parent directory of the zonepath
 * to see if it is a ZFS fs.  If it is, we get the name of that ZFS fs and
 * append the last component of the zonepath to generate the ZFS name for the
 * zonepath.  This matches the algorithm that ZFS uses for automatically
 * mounting a new fs after it is created.
 *
 * Although a ZFS fs can be mounted anywhere, we don't worry about handling
 * all of the complexity that a user could possibly configure with arbitrary
 * mounts since there is no way to generate a ZFS name from a random path in
 * the file system.  We only try to handle the automatic mounts that ZFS does
 * for each file system.  ZFS restricts this so that a new fs must be created
 * in an existing parent ZFS fs.  It then automatically mounts the new fs
 * directly under the mountpoint for the parent fs using the last component
 * of the name as the mountpoint directory.
 *
 * For example:
 *    Name                      Mountpoint
 *    space/eng/dev/test/zone1  /project1/eng/dev/test/zone1
 *
 * Return Z_OK if the path mapped to a ZFS file system name, otherwise return
 * Z_ERR.
 */
static int
path2name(char *zonepath, char *zfs_name, int len)
{
        int             res;
        char            *bnm, *dnm, *dname, *bname;
        zfs_handle_t    *zhp;
        struct stat     stbuf;

        /*
         * We need two tmp strings to handle paths directly in / (e.g. /foo)
         * since dirname will overwrite the first char after "/" in this case.
         */
        if ((bnm = strdup(zonepath)) == NULL)
                return (Z_ERR);

        if ((dnm = strdup(zonepath)) == NULL) {
                free(bnm);
                return (Z_ERR);
        }

        bname = basename(bnm);
        dname = dirname(dnm);

        /*
         * This is a quick test to save iterating over all of the zfs datasets
         * on the system (which can be a lot).  If the parent dir is not in a
         * ZFS fs, then we're done.
         */
        if (stat(dname, &stbuf) != 0 || !S_ISDIR(stbuf.st_mode) ||
            strcmp(stbuf.st_fstype, MNTTYPE_ZFS) != 0) {
                free(bnm);
                free(dnm);
                return (Z_ERR);
        }

        /* See if the parent directory is its own ZFS dataset. */
        if ((zhp = mount2zhandle(dname)) == NULL) {
                /*
                 * The parent is not a ZFS dataset so we can't automatically
                 * create a dataset on the given path.
                 */
                free(bnm);
                free(dnm);
                return (Z_ERR);
        }

        res = snprintf(zfs_name, len, "%s/%s", zfs_get_name(zhp), bname);

        free(bnm);
        free(dnm);
        zfs_close(zhp);
        if (res >= len)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * A ZFS file system iterator call-back function used to determine if the
 * file system has dependents (snapshots & clones).
 */
/* ARGSUSED */
static int
has_dependent(zfs_handle_t *zhp, void *data)
{
        zfs_close(zhp);
        return (1);
}

/*
 * Given a snapshot name, get the file system path where the snapshot lives.
 * A snapshot name is of the form fs_name@snap_name.  For example, snapshot
 * pl/zones/z1@SUNWzone1 would have a path of
 * /pl/zones/z1/.zfs/snapshot/SUNWzone1.
 */
static int
snap2path(char *snap_name, char *path, int len)
{
        char            *p;
        zfs_handle_t    *zhp;
        char            mp[ZFS_MAXPROPLEN];

        if ((p = strrchr(snap_name, '@')) == NULL)
                return (Z_ERR);

        /* Get the file system name from the snap_name. */
        *p = '\0';
        zhp = zfs_open(g_zfs, snap_name, ZFS_TYPE_DATASET);
        *p = '@';
        if (zhp == NULL)
                return (Z_ERR);

        /* Get the file system mount point. */
        if (zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, mp, sizeof (mp), NULL, NULL,
            0, B_FALSE) != 0) {
                zfs_close(zhp);
                return (Z_ERR);
        }
        zfs_close(zhp);

        p++;
        if (snprintf(path, len, "%s/.zfs/snapshot/%s", mp, p) >= len)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * This callback function is used to iterate through a snapshot's dependencies
 * to find a filesystem that is a direct clone of the snapshot being iterated.
 */
static int
get_direct_clone(zfs_handle_t *zhp, void *data)
{
        clone_data_t    *cd = data;
        char            origin[ZFS_MAX_DATASET_NAME_LEN];
        char            ds_path[ZFS_MAX_DATASET_NAME_LEN];

        if (zfs_get_type(zhp) != ZFS_TYPE_FILESYSTEM) {
                zfs_close(zhp);
                return (0);
        }

        (void) strlcpy(ds_path, zfs_get_name(zhp), sizeof (ds_path));

        /* Make sure this is a direct clone of the snapshot we're iterating. */
        if (zfs_prop_get(zhp, ZFS_PROP_ORIGIN, origin, sizeof (origin), NULL,
            NULL, 0, B_FALSE) != 0 || strcmp(origin, cd->snapshot) != 0) {
                zfs_close(zhp);
                return (0);
        }

        if (cd->clone_zhp != NULL)
                zfs_close(cd->clone_zhp);

        cd->clone_zhp = zhp;
        return (1);
}

/*
 * A ZFS file system iterator call-back function used to determine the clone
 * to promote.  This function finds the youngest (i.e. last one taken) snapshot
 * that has a clone.  If found, it returns a reference to that clone in the
 * callback data.
 */
static int
find_clone(zfs_handle_t *zhp, void *data)
{
        clone_data_t    *cd = data;
        time_t          snap_creation;
        int             zret = 0;

        /* If snapshot has no clones, skip it */
        if (zfs_prop_get_int(zhp, ZFS_PROP_NUMCLONES) == 0) {
                zfs_close(zhp);
                return (0);
        }

        cd->snapshot = zfs_get_name(zhp);

        /* Get the creation time of this snapshot */
        snap_creation = (time_t)zfs_prop_get_int(zhp, ZFS_PROP_CREATION);

        /*
         * If this snapshot's creation time is greater than (i.e. younger than)
         * the current youngest snapshot found, iterate this snapshot to
         * get the right clone.
         */
        if (snap_creation >= cd->origin_creation) {
                /*
                 * Iterate the dependents of this snapshot to find a clone
                 * that's a direct dependent.
                 */
                if ((zret = zfs_iter_dependents(zhp, B_FALSE, get_direct_clone,
                    cd)) == -1) {
                        zfs_close(zhp);
                        return (1);
                } else if (zret == 1) {
                        /*
                         * Found a clone, update the origin_creation time
                         * in the callback data.
                         */
                        cd->origin_creation = snap_creation;
                }
        }

        zfs_close(zhp);
        return (0);
}

/*
 * A ZFS file system iterator call-back function used to remove standalone
 * snapshots.
 */
/* ARGSUSED */
static int
rm_snap(zfs_handle_t *zhp, void *data)
{
        /* If snapshot has clones, something is wrong */
        if (zfs_prop_get_int(zhp, ZFS_PROP_NUMCLONES) != 0) {
                zfs_close(zhp);
                return (1);
        }

        if (zfs_unmount(zhp, NULL, 0) == 0) {
                (void) zfs_destroy(zhp, B_FALSE);
        }

        zfs_close(zhp);
        return (0);
}

/*
 * A ZFS snapshot iterator call-back function which renames snapshots.
 */
static int
rename_snap(zfs_handle_t *zhp, void *data)
{
        int                     res;
        zfs_snapshot_data_t     *cbp;
        char                    template[ZFS_MAX_DATASET_NAME_LEN];

        cbp = (zfs_snapshot_data_t *)data;

        /*
         * When renaming snapshots with the iterator, the iterator can see
         * the same snapshot after we've renamed up in the namespace.  To
         * prevent this we check the count for the number of snapshots we have
         * to rename and stop at that point.
         */
        if (cbp->cntr >= cbp->num) {
                zfs_close(zhp);
                return (0);
        }

        if (zfs_get_type(zhp) != ZFS_TYPE_SNAPSHOT) {
                zfs_close(zhp);
                return (0);
        }

        /* Only rename the snapshots we automatically generate when we clone. */
        if (strncmp(zfs_get_name(zhp), cbp->match_name, cbp->len) != 0) {
                zfs_close(zhp);
                return (0);
        }

        (void) snprintf(template, sizeof (template), "%s%d", cbp->match_name,
            cbp->max++);

        res = (zfs_rename(zhp, template, B_FALSE, B_FALSE) != 0);
        if (res != 0)
                (void) fprintf(stderr, gettext("failed to rename snapshot %s "
                    "to %s: %s\n"), zfs_get_name(zhp), template,
                    libzfs_error_description(g_zfs));

        cbp->cntr++;

        zfs_close(zhp);
        return (res);
}

/*
 * Rename the source dataset's snapshots that are automatically generated when
 * we clone a zone so that there won't be a name collision when we promote the
 * cloned dataset.  Once the snapshots have been renamed, then promote the
 * clone.
 *
 * The snapshot rename process gets the highest number on the snapshot names
 * (the format is zonename@SUNWzoneXX where XX are digits) on both the source
 * and clone datasets, then renames the source dataset snapshots starting at
 * the next number.
 */
static int
promote_clone(zfs_handle_t *src_zhp, zfs_handle_t *cln_zhp)
{
        zfs_snapshot_data_t     sd;
        char                    nm[ZFS_MAX_DATASET_NAME_LEN];
        char                    template[ZFS_MAX_DATASET_NAME_LEN];

        (void) strlcpy(nm, zfs_get_name(cln_zhp), sizeof (nm));
        /*
         * Start by getting the clone's snapshot max which we use
         * during the rename of the original dataset's snapshots.
         */
        (void) snprintf(template, sizeof (template), "%s@SUNWzone", nm);
        sd.match_name = template;
        sd.len = strlen(template);
        sd.max = 0;

        if (zfs_iter_snapshots(cln_zhp, B_FALSE, get_snap_max, &sd) != 0)
                return (Z_ERR);

        /*
         * Now make sure the source's snapshot max is at least as high as
         * the clone's snapshot max.
         */
        (void) snprintf(template, sizeof (template), "%s@SUNWzone",
            zfs_get_name(src_zhp));
        sd.match_name = template;
        sd.len = strlen(template);
        sd.num = 0;

        if (zfs_iter_snapshots(src_zhp, B_FALSE, get_snap_max, &sd) != 0)
                return (Z_ERR);

        /*
         * Now rename the source dataset's snapshots so there's no
         * conflict when we promote the clone.
         */
        sd.max++;
        sd.cntr = 0;
        if (zfs_iter_snapshots(src_zhp, B_FALSE, rename_snap, &sd) != 0)
                return (Z_ERR);

        /* close and reopen the clone dataset to get the latest info */
        zfs_close(cln_zhp);
        if ((cln_zhp = zfs_open(g_zfs, nm, ZFS_TYPE_FILESYSTEM)) == NULL)
                return (Z_ERR);

        if (zfs_promote(cln_zhp) != 0) {
                (void) fprintf(stderr, gettext("failed to promote %s: %s\n"),
                    nm, libzfs_error_description(g_zfs));
                return (Z_ERR);
        }

        zfs_close(cln_zhp);
        return (Z_OK);
}

/*
 * Promote the youngest clone.  That clone will then become the origin of all
 * of the other clones that were hanging off of the source dataset.
 */
int
promote_all_clones(zfs_handle_t *zhp)
{
        clone_data_t    cd;
        char            nm[ZFS_MAX_DATASET_NAME_LEN];

        cd.clone_zhp = NULL;
        cd.origin_creation = 0;
        cd.snapshot = NULL;

        if (zfs_iter_snapshots(zhp, B_FALSE, find_clone, &cd) != 0) {
                zfs_close(zhp);
                return (Z_ERR);
        }

        /* Nothing to promote. */
        if (cd.clone_zhp == NULL)
                return (Z_OK);

        /* Found the youngest clone to promote.  Promote it. */
        if (promote_clone(zhp, cd.clone_zhp) != 0) {
                zfs_close(cd.clone_zhp);
                zfs_close(zhp);
                return (Z_ERR);
        }

        /* close and reopen the main dataset to get the latest info */
        (void) strlcpy(nm, zfs_get_name(zhp), sizeof (nm));
        zfs_close(zhp);
        if ((zhp = zfs_open(g_zfs, nm, ZFS_TYPE_FILESYSTEM)) == NULL)
                return (Z_ERR);

        return (Z_OK);
}

/*
 * Clone a pre-existing ZFS snapshot, either by making a direct ZFS clone, if
 * possible, or by copying the data from the snapshot to the zonepath.
 */
int
clone_snapshot_zfs(char *snap_name, char *zonepath, char *validatesnap)
{
        int     err = Z_OK;
        char    clone_name[MAXPATHLEN];
        char    snap_path[MAXPATHLEN];

        if (snap2path(snap_name, snap_path, sizeof (snap_path)) != Z_OK) {
                (void) fprintf(stderr, gettext("unable to find path for %s.\n"),
                    snap_name);
                return (Z_ERR);
        }

        if (validate_snapshot(snap_name, snap_path, validatesnap) != Z_OK)
                return (Z_NO_ENTRY);

        /*
         * The zonepath cannot be ZFS cloned, try to copy the data from
         * within the snapshot to the zonepath.
         */
        if (path2name(zonepath, clone_name, sizeof (clone_name)) != Z_OK) {
                if ((err = clone_copy(snap_path, zonepath)) == Z_OK)
                        if (clean_out_clone() != Z_OK)
                                (void) fprintf(stderr,
                                    gettext("could not remove the "
                                    "software inventory from %s\n"), zonepath);

                return (err);
        }

        if ((err = clone_snap(snap_name, clone_name)) != Z_OK) {
                if (err != Z_NO_ENTRY) {
                        /*
                         * Cloning the snapshot failed.  Fall back to trying
                         * to install the zone by copying from the snapshot.
                         */
                        if ((err = clone_copy(snap_path, zonepath)) == Z_OK)
                                if (clean_out_clone() != Z_OK)
                                        (void) fprintf(stderr,
                                            gettext("could not remove the "
                                            "software inventory from %s\n"),
                                            zonepath);
                } else {
                        /*
                         * The snapshot is unusable for some reason so restore
                         * the zone state to configured since we were unable to
                         * actually do anything about getting the zone
                         * installed.
                         */
                        int tmp;

                        if ((tmp = zone_set_state(target_zone,
                            ZONE_STATE_CONFIGURED)) != Z_OK) {
                                errno = tmp;
                                zperror2(target_zone,
                                    gettext("could not set state"));
                        }
                }
        }

        return (err);
}

/*
 * Attempt to clone a source_zone to a target zonepath by using a ZFS clone.
 */
int
clone_zfs(char *source_zonepath, char *zonepath, char *presnapbuf,
    char *postsnapbuf)
{
        zfs_handle_t    *zhp;
        char            clone_name[MAXPATHLEN];
        char            snap_name[MAXPATHLEN];

        /*
         * Try to get a zfs handle for the source_zonepath.  If this fails
         * the source_zonepath is not ZFS so return an error.
         */
        if ((zhp = mount2zhandle(source_zonepath)) == NULL)
                return (Z_ERR);

        /*
         * Check if there is a file system already mounted on zonepath.  If so,
         * we can't clone to the path so we should fall back to copying.
         */
        if (is_mountpnt(zonepath)) {
                zfs_close(zhp);
                (void) fprintf(stderr,
                    gettext("A file system is already mounted on %s,\n"
                    "preventing use of a ZFS clone.\n"), zonepath);
                return (Z_ERR);
        }

        /*
         * Instead of using path2name to get the clone name from the zonepath,
         * we could generate a name from the source zone ZFS name.  However,
         * this would mean we would create the clone under the ZFS fs of the
         * source instead of what the zonepath says.  For example,
         *
         * source_zonepath              zonepath
         * /pl/zones/dev/z1             /pl/zones/deploy/z2
         *
         * We don't want the clone to be under "dev", we want it under
         * "deploy", so that we can leverage the normal attribute inheritance
         * that ZFS provides in the fs hierarchy.
         */
        if (path2name(zonepath, clone_name, sizeof (clone_name)) != Z_OK) {
                zfs_close(zhp);
                return (Z_ERR);
        }

        if (take_snapshot(zhp, snap_name, sizeof (snap_name), presnapbuf,
            postsnapbuf) != Z_OK) {
                zfs_close(zhp);
                return (Z_ERR);
        }
        zfs_close(zhp);

        if (clone_snap(snap_name, clone_name) != Z_OK) {
                /* Clean up the snapshot we just took. */
                if ((zhp = zfs_open(g_zfs, snap_name, ZFS_TYPE_SNAPSHOT))
                    != NULL) {
                        if (zfs_unmount(zhp, NULL, 0) == 0)
                                (void) zfs_destroy(zhp, B_FALSE);
                        zfs_close(zhp);
                }

                return (Z_ERR);
        }

        (void) printf(gettext("Instead of copying, a ZFS clone has been "
            "created for this zone.\n"));

        return (Z_OK);
}

/*
 * Attempt to create a ZFS file system for the specified zonepath.
 * We either will successfully create a ZFS file system and get it mounted
 * on the zonepath or we don't.  The caller doesn't care since a regular
 * directory is used for the zonepath if no ZFS file system is mounted there.
 */
void
create_zfs_zonepath(char *zonepath)
{
        zfs_handle_t    *zhp;
        char            zfs_name[MAXPATHLEN];
        nvlist_t        *props = NULL;

        if (path2name(zonepath, zfs_name, sizeof (zfs_name)) != Z_OK)
                return;

        /* Check if the dataset already exists. */
        if ((zhp = zfs_open(g_zfs, zfs_name, ZFS_TYPE_DATASET)) != NULL) {
                zfs_close(zhp);
                return;
        }

        /*
         * We turn off zfs SHARENFS and SHARESMB properties on the
         * zoneroot dataset in order to prevent the GZ from sharing
         * NGZ data by accident.
         */
        if ((nvlist_alloc(&props, NV_UNIQUE_NAME, 0) != 0) ||
            (nvlist_add_string(props, zfs_prop_to_name(ZFS_PROP_SHARENFS),
            "off") != 0) ||
            (nvlist_add_string(props, zfs_prop_to_name(ZFS_PROP_SHARESMB),
            "off") != 0)) {
                nvlist_free(props);
                (void) fprintf(stderr, gettext("cannot create ZFS dataset %s: "
                    "out of memory\n"), zfs_name);
        }

        if (zfs_create(g_zfs, zfs_name, ZFS_TYPE_FILESYSTEM, props) != 0 ||
            (zhp = zfs_open(g_zfs, zfs_name, ZFS_TYPE_DATASET)) == NULL) {
                (void) fprintf(stderr, gettext("cannot create ZFS dataset %s: "
                    "%s\n"), zfs_name, libzfs_error_description(g_zfs));
                nvlist_free(props);
                return;
        }

        nvlist_free(props);

        if (zfs_mount(zhp, NULL, 0) != 0) {
                (void) fprintf(stderr, gettext("cannot mount ZFS dataset %s: "
                    "%s\n"), zfs_name, libzfs_error_description(g_zfs));
                (void) zfs_destroy(zhp, B_FALSE);
        } else {
                if (chmod(zonepath, S_IRWXU) != 0) {
                        (void) fprintf(stderr, gettext("file system %s "
                            "successfully created, but chmod %o failed: %s\n"),
                            zfs_name, S_IRWXU, strerror(errno));
                        (void) destroy_zfs(zonepath);
                } else {
                        (void) printf(gettext("A ZFS file system has been "
                            "created for this zone.\n"));
                }
        }

        zfs_close(zhp);
}

/*
 * If the zonepath is a ZFS file system, attempt to destroy it.  We return Z_OK
 * if we were able to zfs_destroy the zonepath, otherwise we return Z_ERR
 * which means the caller should clean up the zonepath in the traditional
 * way.
 */
int
destroy_zfs(char *zonepath)
{
        zfs_handle_t    *zhp;
        boolean_t       is_clone = B_FALSE;
        char            origin[ZFS_MAXPROPLEN];

        if ((zhp = mount2zhandle(zonepath)) == NULL)
                return (Z_ERR);

        if (promote_all_clones(zhp) != 0)
                return (Z_ERR);

        /* Now cleanup any snapshots remaining. */
        if (zfs_iter_snapshots(zhp, B_FALSE, rm_snap, NULL) != 0) {
                zfs_close(zhp);
                return (Z_ERR);
        }

        /*
         * We can't destroy the file system if it has still has dependents.
         * There shouldn't be any at this point, but we'll double check.
         */
        if (zfs_iter_dependents(zhp, B_TRUE, has_dependent, NULL) != 0) {
                (void) fprintf(stderr, gettext("zfs destroy %s failed: the "
                    "dataset still has dependents\n"), zfs_get_name(zhp));
                zfs_close(zhp);
                return (Z_ERR);
        }

        /*
         * This might be a clone.  Try to get the snapshot so we can attempt
         * to destroy that as well.
         */
        if (zfs_prop_get(zhp, ZFS_PROP_ORIGIN, origin, sizeof (origin), NULL,
            NULL, 0, B_FALSE) == 0)
                is_clone = B_TRUE;

        if (zfs_unmount(zhp, NULL, 0) != 0) {
                (void) fprintf(stderr, gettext("zfs unmount %s failed: %s\n"),
                    zfs_get_name(zhp), libzfs_error_description(g_zfs));
                zfs_close(zhp);
                return (Z_ERR);
        }

        if (zfs_destroy(zhp, B_FALSE) != 0) {
                /*
                 * If the destroy fails for some reason, try to remount
                 * the file system so that we can use "rm -rf" to clean up
                 * instead.
                 */
                (void) fprintf(stderr, gettext("zfs destroy %s failed: %s\n"),
                    zfs_get_name(zhp), libzfs_error_description(g_zfs));
                (void) zfs_mount(zhp, NULL, 0);
                zfs_close(zhp);
                return (Z_ERR);
        }

        /*
         * If the zone has ever been moved then the mountpoint dir will not be
         * cleaned up by the zfs_destroy().  To handle this case try to clean
         * it up now but don't worry if it fails, that will be normal.
         */
        (void) rmdir(zonepath);

        (void) printf(gettext("The ZFS file system for this zone has been "
            "destroyed.\n"));

        if (is_clone) {
                zfs_handle_t    *ohp;

                /*
                 * Try to clean up the snapshot that the clone was taken from.
                 */
                if ((ohp = zfs_open(g_zfs, origin,
                    ZFS_TYPE_SNAPSHOT)) != NULL) {
                        if (zfs_iter_dependents(ohp, B_TRUE, has_dependent,
                            NULL) == 0 && zfs_unmount(ohp, NULL, 0) == 0)
                                (void) zfs_destroy(ohp, B_FALSE);
                        zfs_close(ohp);
                }
        }

        zfs_close(zhp);
        return (Z_OK);
}

/*
 * Return true if the path is its own zfs file system.  We determine this
 * by stat-ing the path to see if it is zfs and stat-ing the parent to see
 * if it is a different fs.
 */
boolean_t
is_zonepath_zfs(char *zonepath)
{
        int res;
        char *path;
        char *parent;
        struct statvfs64 buf1, buf2;

        if (statvfs64(zonepath, &buf1) != 0)
                return (B_FALSE);

        if (strcmp(buf1.f_basetype, "zfs") != 0)
                return (B_FALSE);

        if ((path = strdup(zonepath)) == NULL)
                return (B_FALSE);

        parent = dirname(path);
        res = statvfs64(parent, &buf2);
        free(path);

        if (res != 0)
                return (B_FALSE);

        if (buf1.f_fsid == buf2.f_fsid)
                return (B_FALSE);

        return (B_TRUE);
}

/*
 * Implement the fast move of a ZFS file system by simply updating the
 * mountpoint.  Since it is file system already, we don't have the
 * issue of cross-file system copying.
 */
int
move_zfs(char *zonepath, char *new_zonepath)
{
        int             ret = Z_ERR;
        zfs_handle_t    *zhp;

        if ((zhp = mount2zhandle(zonepath)) == NULL)
                return (Z_ERR);

        if (zfs_prop_set(zhp, zfs_prop_to_name(ZFS_PROP_MOUNTPOINT),
            new_zonepath) == 0) {
                /*
                 * Clean up the old mount point.  We ignore any failure since
                 * the zone is already successfully mounted on the new path.
                 */
                (void) rmdir(zonepath);
                ret = Z_OK;
        }

        zfs_close(zhp);

        return (ret);
}

/*
 * Validate that the given dataset exists on the system, and that neither it nor
 * its children are zvols.
 *
 * Note that we don't do anything with the 'zoned' property here.  All
 * management is done in zoneadmd when the zone is actually rebooted.  This
 * allows us to automatically set the zoned property even when a zone is
 * rebooted by the administrator.
 */
int
verify_datasets(zone_dochandle_t handle)
{
        int return_code = Z_OK;
        struct zone_dstab dstab;
        zfs_handle_t *zhp;
        char propbuf[ZFS_MAXPROPLEN];
        char source[ZFS_MAX_DATASET_NAME_LEN];
        zprop_source_t srctype;

        if (zonecfg_setdsent(handle) != Z_OK) {
                /*
                 * TRANSLATION_NOTE
                 * zfs and dataset are literals that should not be translated.
                 */
                (void) fprintf(stderr, gettext("could not verify zfs datasets: "
                    "unable to enumerate datasets\n"));
                return (Z_ERR);
        }

        while (zonecfg_getdsent(handle, &dstab) == Z_OK) {

                if ((zhp = zfs_open(g_zfs, dstab.zone_dataset_name,
                    ZFS_TYPE_FILESYSTEM | ZFS_TYPE_VOLUME)) == NULL) {
                        (void) fprintf(stderr, gettext("could not verify zfs "
                            "dataset %s: %s\n"), dstab.zone_dataset_name,
                            libzfs_error_description(g_zfs));
                        return_code = Z_ERR;
                        continue;
                }

                if (zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, propbuf,
                    sizeof (propbuf), &srctype, source,
                    sizeof (source), 0) == 0 &&
                    (srctype == ZPROP_SRC_INHERITED)) {
                        (void) fprintf(stderr, gettext("could not verify zfs "
                            "dataset %s: mountpoint cannot be inherited\n"),
                            dstab.zone_dataset_name);
                        return_code = Z_ERR;
                        zfs_close(zhp);
                        continue;
                }

                zfs_close(zhp);
        }
        (void) zonecfg_enddsent(handle);

        return (return_code);
}

/*
 * Verify that the ZFS dataset exists, and its mountpoint
 * property is set to "legacy".
 */
int
verify_fs_zfs(struct zone_fstab *fstab)
{
        zfs_handle_t *zhp;
        char propbuf[ZFS_MAXPROPLEN];

        if ((zhp = zfs_open(g_zfs, fstab->zone_fs_special,
            ZFS_TYPE_DATASET)) == NULL) {
                (void) fprintf(stderr, gettext("could not verify fs %s: "
                    "could not access zfs dataset '%s'\n"),
                    fstab->zone_fs_dir, fstab->zone_fs_special);
                return (Z_ERR);
        }

        if (zfs_get_type(zhp) != ZFS_TYPE_FILESYSTEM) {
                (void) fprintf(stderr, gettext("cannot verify fs %s: "
                    "'%s' is not a file system\n"),
                    fstab->zone_fs_dir, fstab->zone_fs_special);
                zfs_close(zhp);
                return (Z_ERR);
        }

        if (zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, propbuf, sizeof (propbuf),
            NULL, NULL, 0, 0) != 0 || strcmp(propbuf, "legacy") != 0) {
                (void) fprintf(stderr, gettext("could not verify fs %s: "
                    "zfs '%s' mountpoint is not \"legacy\"\n"),
                    fstab->zone_fs_dir, fstab->zone_fs_special);
                zfs_close(zhp);
                return (Z_ERR);
        }

        zfs_close(zhp);
        return (Z_OK);
}

/*
 * Destroy the specified mnttab structure that was created by mnttab_dup().
 * NOTE: The structure's mnt_time field isn't freed.
 */
static void
mnttab_destroy(struct mnttab *tabp)
{
        assert(tabp != NULL);

        free(tabp->mnt_mountp);
        free(tabp->mnt_special);
        free(tabp->mnt_fstype);
        free(tabp->mnt_mntopts);
        free(tabp);
}

/*
 * Duplicate the specified mnttab structure.  The mnt_mountp and mnt_time
 * fields aren't duplicated.  This function returns a pointer to the new mnttab
 * structure or NULL if an error occurred.  If an error occurs, then this
 * function sets errno to reflect the error.  mnttab structures created by
 * this function should be destroyed via mnttab_destroy().
 */
static struct mnttab *
mnttab_dup(const struct mnttab *srcp)
{
        struct mnttab *retval;

        assert(srcp != NULL);

        retval = (struct mnttab *)calloc(1, sizeof (*retval));
        if (retval == NULL) {
                errno = ENOMEM;
                return (NULL);
        }
        if (srcp->mnt_special != NULL) {
                retval->mnt_special = strdup(srcp->mnt_special);
                if (retval->mnt_special == NULL)
                        goto err;
        }
        if (srcp->mnt_fstype != NULL) {
                retval->mnt_fstype = strdup(srcp->mnt_fstype);
                if (retval->mnt_fstype == NULL)
                        goto err;
        }
        retval->mnt_mntopts = (char *)malloc(MAX_MNTOPT_STR * sizeof (char));
        if (retval->mnt_mntopts == NULL)
                goto err;
        if (srcp->mnt_mntopts != NULL) {
                if (strlcpy(retval->mnt_mntopts, srcp->mnt_mntopts,
                    MAX_MNTOPT_STR * sizeof (char)) >= MAX_MNTOPT_STR *
                    sizeof (char)) {
                        mnttab_destroy(retval);
                        errno = EOVERFLOW; /* similar to mount(2) behavior */
                        return (NULL);
                }
        } else {
                retval->mnt_mntopts[0] = '\0';
        }
        return (retval);

err:
        mnttab_destroy(retval);
        errno = ENOMEM;
        return (NULL);
}

/*
 * Determine whether the specified ZFS dataset's mountpoint property is set
 * to "legacy".  If the specified dataset does not have a legacy mountpoint,
 * then the string pointer to which the mountpoint argument points is assigned
 * a dynamically-allocated string containing the dataset's mountpoint
 * property.  If the dataset's mountpoint property is "legacy" or a libzfs
 * error occurs, then the string pointer to which the mountpoint argument
 * points isn't modified.
 *
 * This function returns B_TRUE if it doesn't encounter any fatal errors.
 * It returns B_FALSE if it encounters a fatal error and sets errno to the
 * appropriate error code.
 */
static boolean_t
get_zfs_non_legacy_mountpoint(const char *dataset_name, char **mountpoint)
{
        zfs_handle_t *zhp;
        char propbuf[ZFS_MAXPROPLEN];

        assert(dataset_name != NULL);
        assert(mountpoint != NULL);

        if ((zhp = zfs_open(g_zfs, dataset_name, ZFS_TYPE_DATASET)) == NULL) {
                errno = EINVAL;
                return (B_FALSE);
        }
        if (zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, propbuf, sizeof (propbuf),
            NULL, NULL, 0, 0) != 0) {
                zfs_close(zhp);
                errno = EINVAL;
                return (B_FALSE);
        }
        zfs_close(zhp);
        if (strcmp(propbuf, "legacy") != 0) {
                if ((*mountpoint = strdup(propbuf)) == NULL) {
                        errno = ENOMEM;
                        return (B_FALSE);
                }
        }
        return (B_TRUE);
}


/*
 * This zonecfg_find_mounts() callback records information about mounts of
 * interest in a zonepath.  It also tallies the number of zone
 * root overlay mounts and the number of unexpected mounts found.
 * This function outputs errors using zerror() if it finds unexpected
 * mounts.  cookiep should point to an initialized zone_mounts_t structure.
 *
 * This function returns zero on success and a nonzero value on failure.
 */
static int
zone_mounts_cb(const struct mnttab *mountp, void *cookiep)
{
        zone_mounts_t *mounts;
        const char *zone_mount_dir;

        assert(mountp != NULL);
        assert(cookiep != NULL);

        mounts = (zone_mounts_t *)cookiep;
        zone_mount_dir = mountp->mnt_mountp + mounts->zonepath_len;
        if (strcmp(zone_mount_dir, "/root") == 0) {
                /*
                 * Check for an overlay mount.  If we already detected a /root
                 * mount, then the current mount must be an overlay mount.
                 */
                if (mounts->root_mnttab != NULL) {
                        mounts->num_root_overlay_mounts++;
                        return (0);
                }

                /*
                 * Store the root mount's mnttab information in the
                 * zone_mounts_t structure for future use.
                 */
                if ((mounts->root_mnttab = mnttab_dup(mountp)) == NULL) {
                        zperror(cmd_to_str(CMD_MOVE), B_FALSE);
                        return (-1);
                }

                /*
                 * Determine if the filesystem is a ZFS filesystem with a
                 * non-legacy mountpoint.  If it is, then set the root
                 * filesystem's mnttab's mnt_mountp field to a non-NULL
                 * value, which will serve as a flag to indicate this special
                 * condition.
                 */
                if (strcmp(mountp->mnt_fstype, MNTTYPE_ZFS) == 0 &&
                    get_zfs_non_legacy_mountpoint(mountp->mnt_special,
                    &mounts->root_mnttab->mnt_mountp) != B_TRUE) {
                        zperror(cmd_to_str(CMD_MOVE), B_FALSE);
                        return (-1);
                }
        } else {
                /*
                 * An unexpected mount was found.  Notify the user.
                 */
                if (mounts->num_unexpected_mounts == 0)
                        zerror(gettext("These file systems are mounted on "
                            "subdirectories of %s.\n"), mounts->zonepath);
                mounts->num_unexpected_mounts++;
                (void) zfm_print(mountp, NULL);
        }
        return (0);
}

/*
 * Initialize the specified zone_mounts_t structure for the given zonepath.
 * If this function succeeds, it returns zero and the specified zone_mounts_t
 * structure contains information about mounts in the specified zonepath.
 * The function returns a nonzero value if it fails.  The zone_mounts_t
 * structure doesn't need be destroyed via zone_mounts_destroy() if this
 * function fails.
 */
int
zone_mounts_init(zone_mounts_t *mounts, const char *zonepath)
{
        assert(mounts != NULL);
        assert(zonepath != NULL);

        bzero(mounts, sizeof (*mounts));
        if ((mounts->zonepath = strdup(zonepath)) == NULL) {
                zerror(gettext("the process ran out of memory while checking "
                    "for mounts in zonepath %s."), zonepath);
                return (-1);
        }
        mounts->zonepath_len = strlen(zonepath);
        if (zonecfg_find_mounts((char *)zonepath, zone_mounts_cb, mounts) ==
            -1) {
                zerror(gettext("an error occurred while checking for mounts "
                    "in zonepath %s."), zonepath);
                zone_mounts_destroy(mounts);
                return (-1);
        }
        return (0);
}

/*
 * Destroy the memory used by the specified zone_mounts_t structure's fields.
 * This function doesn't free the memory occupied by the structure itself
 * (i.e., it doesn't free the parameter).
 */
void
zone_mounts_destroy(zone_mounts_t *mounts)
{
        assert(mounts != NULL);

        free(mounts->zonepath);
        if (mounts->root_mnttab != NULL)
                mnttab_destroy(mounts->root_mnttab);
}

/*
 * Mount a moving zone's root filesystem (if it had a root filesystem mount
 * prior to the move) using the specified zonepath.  mounts should refer to
 * the zone_mounts_t structure describing the zone's mount information.
 *
 * This function returns zero if the mount succeeds and a nonzero value
 * if it doesn't.
 */
int
zone_mount_rootfs(zone_mounts_t *mounts, const char *zonepath)
{
        char zoneroot[MAXPATHLEN];
        struct mnttab *mtab;
        int flags;

        assert(mounts != NULL);
        assert(zonepath != NULL);

        /*
         * If there isn't a root filesystem, then don't do anything.
         */
        mtab = mounts->root_mnttab;
        if (mtab == NULL)
                return (0);

        /*
         * Determine the root filesystem's new mountpoint.
         */
        if (snprintf(zoneroot, sizeof (zoneroot), "%s/root", zonepath) >=
            sizeof (zoneroot)) {
                zerror(gettext("Zonepath %s is too long.\n"), zonepath);
                return (-1);
        }

        /*
         * If the root filesystem is a non-legacy ZFS filesystem (i.e., if it's
         * mnt_mountp field is non-NULL), then make the filesystem's new
         * mount point its mountpoint property and mount the filesystem.
         */
        if (mtab->mnt_mountp != NULL) {
                zfs_handle_t *zhp;

                if ((zhp = zfs_open(g_zfs, mtab->mnt_special,
                    ZFS_TYPE_DATASET)) == NULL) {
                        zerror(gettext("could not get ZFS handle for the zone's"
                            " root filesystem"));
                        return (-1);
                }
                if (zfs_prop_set(zhp, zfs_prop_to_name(ZFS_PROP_MOUNTPOINT),
                    zoneroot) != 0) {
                        zerror(gettext("could not modify zone's root "
                            "filesystem's mountpoint property"));
                        zfs_close(zhp);
                        return (-1);
                }
                if (zfs_mount(zhp, mtab->mnt_mntopts, 0) != 0) {
                        zerror(gettext("unable to mount zone root %s: %s"),
                            zoneroot, libzfs_error_description(g_zfs));
                        if (zfs_prop_set(zhp,
                            zfs_prop_to_name(ZFS_PROP_MOUNTPOINT),
                            mtab->mnt_mountp) != 0)
                                zerror(gettext("unable to restore zone's root "
                                    "filesystem's mountpoint property"));
                        zfs_close(zhp);
                        return (-1);
                }
                zfs_close(zhp);
                return (0);
        }

        /*
         * The root filesystem is either a legacy-mounted ZFS filesystem or
         * a non-ZFS filesystem.  Use mount(2) to mount the root filesystem.
         */
        if (mtab->mnt_mntopts != NULL)
                flags = MS_OPTIONSTR;
        else
                flags = 0;
        if (mount(mtab->mnt_special, zoneroot, flags, mtab->mnt_fstype, NULL, 0,
            mtab->mnt_mntopts, MAX_MNTOPT_STR * sizeof (char)) != 0) {
                flags = errno;
                zerror(gettext("unable to mount zone root %s: %s"), zoneroot,
                    strerror(flags));
                return (-1);
        }
        return (0);
}

/*
 * Unmount a moving zone's root filesystem (if such a mount exists) using the
 * specified zonepath.  mounts should refer to the zone_mounts_t structure
 * describing the zone's mount information.  If force is B_TRUE, then if the
 * unmount fails, then the function will try to forcibly unmount the zone's root
 * filesystem.
 *
 * This function returns zero if the unmount (forced or otherwise) succeeds;
 * otherwise, it returns a nonzero value.
 */
int
zone_unmount_rootfs(zone_mounts_t *mounts, const char *zonepath,
    boolean_t force)
{
        char zoneroot[MAXPATHLEN];
        struct mnttab *mtab;
        int err;

        assert(mounts != NULL);
        assert(zonepath != NULL);

        /*
         * If there isn't a root filesystem, then don't do anything.
         */
        mtab = mounts->root_mnttab;
        if (mtab == NULL)
                return (0);

        /*
         * Determine the root filesystem's mountpoint.
         */
        if (snprintf(zoneroot, sizeof (zoneroot), "%s/root", zonepath) >=
            sizeof (zoneroot)) {
                zerror(gettext("Zonepath %s is too long.\n"), zonepath);
                return (-1);
        }

        /*
         * If the root filesystem is a non-legacy ZFS fileystem, then unmount
         * the filesystem via libzfs.
         */
        if (mtab->mnt_mountp != NULL) {
                zfs_handle_t *zhp;

                if ((zhp = zfs_open(g_zfs, mtab->mnt_special,
                    ZFS_TYPE_DATASET)) == NULL) {
                        zerror(gettext("could not get ZFS handle for the zone's"
                            " root filesystem"));
                        return (-1);
                }
                if (zfs_unmount(zhp, zoneroot, 0) != 0) {
                        if (force && zfs_unmount(zhp, zoneroot, MS_FORCE) ==
                            0) {
                                zfs_close(zhp);
                                return (0);
                        }
                        zerror(gettext("unable to unmount zone root %s: %s"),
                            zoneroot, libzfs_error_description(g_zfs));
                        zfs_close(zhp);
                        return (-1);
                }
                zfs_close(zhp);
                return (0);
        }

        /*
         * Use umount(2) to unmount the root filesystem.  If this fails, then
         * forcibly unmount it if the force flag is set.
         */
        if (umount(zoneroot) != 0) {
                if (force && umount2(zoneroot, MS_FORCE) == 0)
                        return (0);
                err = errno;
                zerror(gettext("unable to unmount zone root %s: %s"), zoneroot,
                    strerror(err));
                return (-1);
        }
        return (0);
}

int
init_zfs(void)
{
        if ((g_zfs = libzfs_init()) == NULL) {
                (void) fprintf(stderr, gettext("failed to initialize ZFS "
                    "library\n"));
                return (Z_ERR);
        }

        return (Z_OK);
}