libzfs_mount.c revision a227b7f4f323ad89c40a86c430a5e891504a8e8b
fa9e4066f08beec538e775443c5be79dd423fcabahrens * CDDL HEADER START
fa9e4066f08beec538e775443c5be79dd423fcabahrens * The contents of this file are subject to the terms of the
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * Common Development and Distribution License (the "License").
ea8dc4b6d2251b437950c0056bc626b311c73c27eschrock * 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
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Use is subject to license terms.
fa9e4066f08beec538e775443c5be79dd423fcabahrens#pragma ident "%Z%%M% %I% %E% SMI"
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Routines to manage ZFS mounts. We separate all the nasty routines that have
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * to deal with the OS. The following functions are the main entry points --
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * they are used by mount and unmount and when changing a filesystem's
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * mountpoint.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_is_mounted()
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_mount()
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_unmount()
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_unmountall()
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * This file also contains the functions used to manage sharing filesystems via
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * NFS and iSCSI:
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_is_shared()
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_share()
fa9e4066f08beec538e775443c5be79dd423fcabahrens * zfs_unshare()
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zfs_is_shared_nfs()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_is_shared_smb()
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zfs_is_shared_iscsi()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_share_proto()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_shareall();
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zfs_share_iscsi()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshare_nfs()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshare_smb()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshareall_nfs()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshareall_smb()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshareall()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * zfs_unshareall_bypath()
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zfs_unshare_iscsi()
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * The following functions are available for pool consumers, and will
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * mount/unmount and share/unshare all datasets within pool:
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zpool_enable_datasets()
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * zpool_disable_datasets()
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm#define MAXISALEN 257 /* based on sysinfo(2) man page */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwstatic int zfs_share_proto(zfs_handle_t *, zfs_share_proto_t *);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_share_type_t zfs_is_shared_proto(zfs_handle_t *, char **,
d8d59944799a436698b0d88b5e6ae6d7d2422797ahlstatic int (*iscsitgt_zfs_share)(const char *);
d8d59944799a436698b0d88b5e6ae6d7d2422797ahlstatic int (*iscsitgt_zfs_unshare)(const char *);
d8d59944799a436698b0d88b5e6ae6d7d2422797ahlstatic int (*iscsitgt_zfs_is_shared)(const char *);
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarksstatic int (*iscsitgt_svc_online)();
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * The share protocols table must be in the same order as the zfs_share_prot_t
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwtypedef struct {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw {ZFS_PROP_SHARENFS, "nfs", EZFS_SHARENFSFAILED, EZFS_UNSHARENFSFAILED},
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw {ZFS_PROP_SHARESMB, "smb", EZFS_SHARESMBFAILED, EZFS_UNSHARESMBFAILED},
d8d59944799a436698b0d88b5e6ae6d7d2422797ahlstatic void
d8d59944799a436698b0d88b5e6ae6d7d2422797ahl (iscsitgt_zfs_share = (int (*)(const char *))dlsym(libiscsitgt,
d8d59944799a436698b0d88b5e6ae6d7d2422797ahl (iscsitgt_zfs_unshare = (int (*)(const char *))dlsym(libiscsitgt,
d8d59944799a436698b0d88b5e6ae6d7d2422797ahl (iscsitgt_zfs_is_shared = (int (*)(const char *))dlsym(libiscsitgt,
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks (iscsitgt_svc_online = (int (*)(const char *))dlsym(libiscsitgt,
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Search the sharetab for the given mountpoint and protocol, returning
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * a zfs_share_type_t value.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwis_shared(libzfs_handle_t *hdl, const char *mountpoint, zfs_share_proto_t proto)
99653d4ee642c6528e88224f12409a5f23060994eschrock while (fgets(buf, sizeof (buf), hdl->libzfs_sharetab) != NULL) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* the mountpoint is the first entry on each line */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * the protocol field is the third field
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * skip over second field
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw switch (proto) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (0);
99653d4ee642c6528e88224f12409a5f23060994eschrock * Returns true if the specified directory is empty. If we can't open the
99653d4ee642c6528e88224f12409a5f23060994eschrock * directory at all, return true so that the mount can fail with a more
fa9e4066f08beec538e775443c5be79dd423fcabahrens * informative error message.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Checks to see if the mount is active. If the filesystem is mounted, we fill
fa9e4066f08beec538e775443c5be79dd423fcabahrens * in 'where' with the current mountpoint, and return 1. Otherwise, we return
55434c770c89aa1b84474f2559a106803511aba0ekis_mounted(libzfs_handle_t *zfs_hdl, const char *special, char **where)
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Search for the entry in /etc/mnttab. We don't bother getting the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * mountpoint, as we can just search for the special device. This will
fa9e4066f08beec538e775443c5be79dd423fcabahrens * also let us find mounts when the mountpoint is 'legacy'.
55434c770c89aa1b84474f2559a106803511aba0ek if (getmntany(zfs_hdl->libzfs_mnttab, &entry, &search) != 0)
55434c770c89aa1b84474f2559a106803511aba0ek return (is_mounted(zhp->zfs_hdl, zfs_get_name(zhp), where));
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock * Returns true if the given dataset is mountable, false otherwise. Returns the
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock * mountpoint in 'buf'.
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrockzfs_is_mountable(zfs_handle_t *zhp, char *buf, size_t buflen,
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock if (!zfs_prop_valid_for_type(ZFS_PROP_MOUNTPOINT, zhp->zfs_type))
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock verify(zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, buf, buflen,
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock &sourcetype, sourceloc, sizeof (sourceloc), B_FALSE) == 0);
a227b7f4f323ad89c40a86c430a5e891504a8e8bhs if (zfs_prop_get_int(zhp, ZFS_PROP_CANMOUNT) == ZFS_CANMOUNT_OFF)
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Mount the given filesystem.
fa9e4066f08beec538e775443c5be79dd423fcabahrenszfs_mount(zfs_handle_t *zhp, const char *options, int flags)
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint), NULL))
99653d4ee642c6528e88224f12409a5f23060994eschrock return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* Create the directory if it doesn't already exist */
99653d4ee642c6528e88224f12409a5f23060994eschrock "failed to create mountpoint"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Determine if the mountpoint is empty. If so, refuse to perform the
fa9e4066f08beec538e775443c5be79dd423fcabahrens * mount. We don't perform this check if MS_OVERLAY is specified, which
fa9e4066f08beec538e775443c5be79dd423fcabahrens * would defeat the point. We also avoid this check if 'remount' is
fa9e4066f08beec538e775443c5be79dd423fcabahrens * specified.
99653d4ee642c6528e88224f12409a5f23060994eschrock "directory is not empty"));
99653d4ee642c6528e88224f12409a5f23060994eschrock dgettext(TEXT_DOMAIN, "cannot mount '%s'"), mountpoint));
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* perform the mount */
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (mount(zfs_get_name(zhp), mountpoint, MS_OPTIONSTR | flags,
fa9e4066f08beec538e775443c5be79dd423fcabahrens MNTTYPE_ZFS, NULL, 0, mntopts, sizeof (mntopts)) != 0) {
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Generic errors are nasty, but there are just way too many
fa9e4066f08beec538e775443c5be79dd423fcabahrens * from mount(), and they're well-understood. We pick a few
fa9e4066f08beec538e775443c5be79dd423fcabahrens * common ones to improve upon.
99653d4ee642c6528e88224f12409a5f23060994eschrock "mountpoint or dataset is busy"));
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks "Insufficient privileges"));
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Unmount a single filesystem.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrockunmount_one(libzfs_handle_t *hdl, const char *mountpoint, int flags)
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Unmount the given filesystem.
fa9e4066f08beec538e775443c5be79dd423fcabahrenszfs_unmount(zfs_handle_t *zhp, const char *mountpoint, int flags)
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check to see if need to unmount the filesystem */
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (mountpoint != NULL || ((zfs_get_type(zhp) == ZFS_TYPE_FILESYSTEM) &&
99653d4ee642c6528e88224f12409a5f23060994eschrock getmntany(zhp->zfs_hdl->libzfs_mnttab, &entry, &search) == 0)) {
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * mountpoint may have come from a call to
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * getmnt/getmntany if it isn't NULL. If it is NULL,
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * we know it comes from getmntany which can then get
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * overwritten later. We strdup it to play it safe.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Unshare and unmount the filesystem
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (zfs_unshare_proto(zhp, mntpt, share_all_proto) != 0)
eb66cf861f74a9a3d0549a7c2a30df192f00e668th return (-1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (-1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Unmount this filesystem and any children inheriting the mountpoint property.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * To do this, just act like we're changing the mountpoint property, but don't
fa9e4066f08beec538e775443c5be79dd423fcabahrens * remount the filesystems afterwards.
fa9e4066f08beec538e775443c5be79dd423fcabahrens clp = changelist_gather(zhp, ZFS_PROP_MOUNTPOINT, flags);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (-1);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw for (curr_proto = share_all_proto; *curr_proto != PROTO_END;
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Check to see if the filesystem is currently shared.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_is_shared_proto(zfs_handle_t *zhp, char **where, zfs_share_proto_t proto)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Make sure things will work if libshare isn't installed by using
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * wrapper functions that check to see that the pointers to functions
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * initialized in _zfs_init_libshare() are actually present.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougmstatic sa_share_t (*_sa_find_share)(sa_handle_t, char *);
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougmstatic char *(*_sa_errorstr)(int);
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougmstatic int (*_sa_parse_legacy_options)(sa_group_t, char *, char *);
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougmstatic libzfs_handle_t *(*_sa_get_zfs_handle)(sa_handle_t);
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougmstatic int (*_sa_zfs_process_share)(sa_handle_t, sa_group_t, sa_share_t,
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm char *, char *, zprop_source_t, char *, char *, char *);
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * _zfs_init_libshare()
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Find the libshare.so.1 entry points that we use here and save the
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * values to be used later. This is triggered by the runtime loader.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Make sure the correct ISA version is loaded.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm#if defined(_LP64)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm if (sysinfo(SI_ARCHITECTURE_64, isa, MAXISALEN) == -1)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm if ((libshare = dlopen(path, RTLD_LAZY | RTLD_GLOBAL)) != NULL) {
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_init = (sa_handle_t (*)(int))dlsym(libshare, "sa_init");
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_fini = (void (*)(sa_handle_t))dlsym(libshare, "sa_fini");
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_find_share = (sa_share_t (*)(sa_handle_t, char *))
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_enable_share = (int (*)(sa_share_t, char *))dlsym(libshare,
d8689a57b109f75e2654627f1847266e18f5a7f2dougm "sa_enable_share");
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_disable_share = (int (*)(sa_share_t, char *))dlsym(libshare,
d8689a57b109f75e2654627f1847266e18f5a7f2dougm "sa_disable_share");
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_errorstr = (char *(*)(int))dlsym(libshare, "sa_errorstr");
d8689a57b109f75e2654627f1847266e18f5a7f2dougm _sa_parse_legacy_options = (int (*)(sa_group_t, char *, char *))
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm _sa_get_zfs_handle = (libzfs_handle_t *(*)(sa_handle_t))
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm _sa_zfs_process_share = (int (*)(sa_handle_t, sa_group_t,
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm char *, char *))dlsym(libshare, "sa_zfs_process_share");
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm _sa_needs_refresh == NULL || _sa_get_zfs_handle == NULL ||
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_init_libshare(zhandle, service)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Initialize the libshare API if it hasn't already been initialized.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * In all cases it returns 0 if it succeeded and an error if not. The
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * service value is which part(s) of the API to initialize and is a
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * direct map to the libshare sa_init(service) interface.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougmzfs_init_libshare(libzfs_handle_t *zhandle, int service)
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm if (ret == SA_OK && zhandle->libzfs_shareflags & ZFSSHARE_MISS) {
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * We had a cache miss. Most likely it is a new ZFS
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * dataset that was just created. We want to make sure
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * so check timestamps to see if a different process
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * has updated any of the configuration. If there was
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * some non-ZFS change, we need to re-initialize the
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * internal cache.
d8689a57b109f75e2654627f1847266e18f5a7f2dougm if (ret == SA_OK && zhandle && zhandle->libzfs_sharehdl == NULL)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_uninit_libshare(zhandle)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Uninitialize the libshare API if it hasn't already been
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * uninitialized. It is OK to call multiple times.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm if (zhandle != NULL && zhandle->libzfs_sharehdl != NULL) {
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_parse_options(options, proto)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Call the legacy parse interface to get the protocol specific
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * options using the NULL arg to indicate that this is a "parse" only.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_parse_options(char *options, zfs_share_proto_t proto)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_sa_find_share(handle, path)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * wrapper around sa_find_share to find a share path in the
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * configuration.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_sa_enable_share(share, proto)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Wrapper for sa_enable_share which enables a share for a specified
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * protocol.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_sa_disable_share(share, proto)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Wrapper for sa_enable_share which disables a share for a specified
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * protocol.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Share the given filesystem according to the options in the specified
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * protocol specific properties (sharenfs, sharesmb). We rely
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * on "libshare" to the dirty work for us.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_share_proto(zfs_handle_t *zhp, zfs_share_proto_t *proto)
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint), NULL))
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm if ((ret = zfs_init_libshare(hdl, SA_INIT_SHARE_API)) != SA_OK) {
d8689a57b109f75e2654627f1847266e18f5a7f2dougm return (-1);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw for (curr_proto = proto; *curr_proto != PROTO_END; curr_proto++) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Return success if there are no share options.
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm shareopts, sizeof (shareopts), &sourcetype, sourcestr,
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * If the 'zoned' property is set, then zfs_is_mountable()
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * will have already bailed out if we are in the global zone.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * But local zones cannot be NFS servers, so we ignore it for
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * local zones as well.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw share = zfs_sa_find_share(hdl->libzfs_sharehdl, mountpoint);
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * This may be a new file system that was just
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * created so isn't in the internal cache
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * (second time through). Rather than
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * reloading the entire configuration, we can
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * assume ZFS has done the checking and it is
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * safe to add this to the internal
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm * configuration.
5b6e0c463149a26dd0aeb4c1f70611c97161ff32dougm return (-1);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (-1);
d8689a57b109f75e2654627f1847266e18f5a7f2dougm return (-1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Unshare a filesystem by mountpoint.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwunshare_one(libzfs_handle_t *hdl, const char *name, const char *mountpoint,
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Mountpoint could get trashed if libshare calls getmntany
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * which id does during API initialization, so strdup the
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm /* make sure libshare initialized */
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm if ((err = zfs_init_libshare(hdl, SA_INIT_SHARE_API)) != SA_OK) {
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm share = zfs_sa_find_share(hdl->libzfs_sharehdl, mntpt);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw err = zfs_sa_disable_share(share, proto_table[proto].p_name);
d8689a57b109f75e2654627f1847266e18f5a7f2dougm dgettext(TEXT_DOMAIN, "cannot unshare '%s': not found"),
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock return (0);
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Unshare the given filesystem.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_unshare_proto(zfs_handle_t *zhp, const char *mountpoint,
fa9e4066f08beec538e775443c5be79dd423fcabahrens /* check to see if need to unmount the filesystem */
fa9e4066f08beec538e775443c5be79dd423fcabahrens if (mountpoint != NULL || ((zfs_get_type(zhp) == ZFS_TYPE_FILESYSTEM) &&
99653d4ee642c6528e88224f12409a5f23060994eschrock getmntany(zhp->zfs_hdl->libzfs_mnttab, &entry, &search) == 0)) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (-1);
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (0);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_unshare_nfs(zfs_handle_t *zhp, const char *mountpoint)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_unshare_smb(zfs_handle_t *zhp, const char *mountpoint)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Same as zfs_unmountall(), but for NFS and SMB unshares.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_unshareall_proto(zfs_handle_t *zhp, zfs_share_proto_t *proto)
fa9e4066f08beec538e775443c5be79dd423fcabahrens return (-1);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwzfs_unshareall_bypath(zfs_handle_t *zhp, const char *mountpoint)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (zfs_unshare_proto(zhp, mountpoint, share_all_proto));
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Remove the mountpoint associated with the current dataset, if necessary.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * We only remove the underlying directory if:
fa9e4066f08beec538e775443c5be79dd423fcabahrens * - The mountpoint is not 'none' or 'legacy'
fa9e4066f08beec538e775443c5be79dd423fcabahrens * - The mountpoint is non-empty
fa9e4066f08beec538e775443c5be79dd423fcabahrens * - The mountpoint is the default or inherited
fa9e4066f08beec538e775443c5be79dd423fcabahrens * - The 'zoned' property is set, or we're in a local zone
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Any other directories we leave alone.
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint),
fa9e4066f08beec538e775443c5be79dd423fcabahrens * Try to remove the directory, silently ignoring any errors.
fa9e4066f08beec538e775443c5be79dd423fcabahrens * The filesystem may have since been removed or moved around,
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock * and this error isn't really useful to the administrator in
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks * If iscsi deamon isn't running then we aren't shared
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks if (iscsitgt_svc_online && iscsitgt_svc_online() == 1)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * Return success if there are no share options.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (0);
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks if (iscsitgt_zfs_share == NULL || iscsitgt_zfs_share(dataset) != 0) {
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks * If service isn't availabele and EPERM was
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks * returned then use special error.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (0);
11d2789dce8a2752df010d0679d3db12af1f510dgw * Return if the volume is not shared
11d2789dce8a2752df010d0679d3db12af1f510dgw return (0);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * If this fails with ENODEV it indicates that zvol wasn't shared so
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * we should return success in that case.
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks (iscsitgt_zfs_unshare(dataset) != 0 && errno != ENODEV)) {
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks "Insufficient privileges to unshare iscsi"));
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl dgettext(TEXT_DOMAIN, "cannot unshare '%s'"), dataset));
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (0);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrocktypedef struct mount_cbdata {
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl if (!(zfs_get_type(zhp) & (ZFS_TYPE_FILESYSTEM | ZFS_TYPE_VOLUME))) {
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock return (0);
a227b7f4f323ad89c40a86c430a5e891504a8e8bhs if (zfs_prop_get_int(zhp, ZFS_PROP_CANMOUNT) == ZFS_CANMOUNT_NOAUTO) {
a227b7f4f323ad89c40a86c430a5e891504a8e8bhs return (0);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock return (-1);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahldataset_cmp(const void *a, const void *b)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl if ((gota = (zfs_get_type(*za) == ZFS_TYPE_FILESYSTEM)) != 0)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl if ((gotb = (zfs_get_type(*zb) == ZFS_TYPE_FILESYSTEM)) != 0)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (-1);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (1);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * Mount and share all datasets within the given pool. This assumes that no
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * datasets within the pool are currently mounted. Because users can create
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * complicated nested hierarchies of mountpoints, we first gather all the
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * datasets and mountpoints within the pool, and sort them by mountpoint. Once
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * we have the list of all filesystems, we iterate over them in order and mount
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * and/or share each one.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl#pragma weak zpool_mount_datasets = zpool_enable_datasets
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahlzpool_enable_datasets(zpool_handle_t *zhp, const char *mntopts, int flags)
d87468da622d0a816b26cc636aa7dcc08249300erm * Gather all non-snap datasets within the pool.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock if ((cb.cb_datasets = zfs_alloc(hdl, 4 * sizeof (void *))) == NULL)
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock return (-1);
990b4856d0eaada6f8140335733a1b1771ed2746lling if ((zfsp = zfs_open(hdl, zhp->zpool_name, ZFS_TYPE_DATASET)) == NULL)
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Sort the datasets by mountpoint.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl qsort(cb.cb_datasets, cb.cb_used, sizeof (void *), dataset_cmp);
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * And mount all the datasets, keeping track of which ones
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * succeeded or failed. By using zfs_alloc(), the good pointer
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * will always be non-NULL.
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm good = zfs_alloc(zhp->zpool_hdl, cb.cb_used * sizeof (int));
d8689a57b109f75e2654627f1847266e18f5a7f2dougm if (zfs_mount(cb.cb_datasets[i], mntopts, flags) != 0)
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * Then share all the ones that need to be shared. This needs
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * to be a separate pass in order to avoid excessive reloading
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * of the configuration. Good should never be NULL since
6733190958bbcc0bd6d1d601e7ae0a6994dafb45dougm * zfs_alloc is supposed to exit if memory isn't available.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * Ignore snapshots and ignore failures from non-existant datasets.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl (zhp = zfs_open(hdl, dataset, ZFS_TYPE_VOLUME)) == NULL)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (0);
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarks return (-1);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (0);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrockmountpoint_compare(const void *a, const void *b)
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock const char *mounta = *((char **)a);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock const char *mountb = *((char **)b);
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * Unshare and unmount all datasets within the given pool. We don't want to
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * rely on traversing the DSL to discover the filesystems within the pool,
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * because this may be expensive (if not all of them are mounted), and can fail
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * arbitrarily (on I/O error, for example). Instead, we walk /etc/mnttab and
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * gather all the filesystems that are currently mounted.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl#pragma weak zpool_unmount_datasets = zpool_disable_datasets
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahlzpool_disable_datasets(zpool_handle_t *zhp, boolean_t force)
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl * First unshare all zvols.
f3861e1a2ceec23a5b699c24d814b7775a9e0b52ahl return (-1);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock while (getmntent(hdl->libzfs_mnttab, &entry) == 0) {
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Ignore non-ZFS entries.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Ignore filesystems not within this pool.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock strncmp(entry.mnt_special, zhp->zpool_name, namelen) != 0 ||
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * At this point we've found a filesystem within our pool. Add
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * it to our growing list.
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock alloc * sizeof (void *),
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock alloc * sizeof (void *),
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * This is allowed to fail, in case there is some I/O error. It
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * is only used to determine if we need to remove the underlying
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * mountpoint, so failure is not fatal.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock datasets[used] = make_dataset_handle(hdl, entry.mnt_special);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * At this point, we have the entire list of filesystems, so sort it by
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * mountpoint.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock qsort(mountpoints, used, sizeof (char *), mountpoint_compare);
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Walk through and first unshare everything.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock for (i = 0; i < used; i++) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw for (curr_proto = share_all_proto; *curr_proto != PROTO_END;
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * Now unmount everything, removing the underlying directories as
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock * appropriate.
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock for (i = 0; i < used; i++) {
e9dbad6f263d5570ed7ff5443ec5b958af8c24d7eschrock for (i = 0; i < used; i++) {
3bb79bece53191f2cf27aa61a72ea1784a7ce700eschrock for (i = 0; i < used; i++) {