1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. 24 * Copyright (c) 2014 by Delphix. All rights reserved. 25 */ 26 27 /* 28 * Routines to manage ZFS mounts. We separate all the nasty routines that have 29 * to deal with the OS. The following functions are the main entry points -- 30 * they are used by mount and unmount and when changing a filesystem's 31 * mountpoint. 32 * 33 * zfs_is_mounted() 34 * zfs_mount() 35 * zfs_unmount() 36 * zfs_unmountall() 37 * 38 * This file also contains the functions used to manage sharing filesystems via 39 * NFS and iSCSI: 40 * 41 * zfs_is_shared() 42 * zfs_share() 43 * zfs_unshare() 44 * 45 * zfs_is_shared_nfs() 46 * zfs_is_shared_smb() 47 * zfs_share_proto() 48 * zfs_shareall(); 49 * zfs_unshare_nfs() 50 * zfs_unshare_smb() 51 * zfs_unshareall_nfs() 52 * zfs_unshareall_smb() 53 * zfs_unshareall() 54 * zfs_unshareall_bypath() 55 * 56 * The following functions are available for pool consumers, and will 57 * mount/unmount and share/unshare all datasets within pool: 58 * 59 * zpool_enable_datasets() 60 * zpool_disable_datasets() 61 */ 62 63 #include <dirent.h> 64 #include <dlfcn.h> 65 #include <errno.h> 66 #include <libgen.h> 67 #include <libintl.h> 68 #include <stdio.h> 69 #include <stdlib.h> 70 #include <strings.h> 71 #include <unistd.h> 72 #include <zone.h> 73 #include <sys/mntent.h> 74 #include <sys/mount.h> 75 #include <sys/stat.h> 76 77 #include <libzfs.h> 78 79 #include "libzfs_impl.h" 80 81 #include <libshare.h> 82 #include <sys/systeminfo.h> 83 #define MAXISALEN 257 /* based on sysinfo(2) man page */ 84 85 static int zfs_share_proto(zfs_handle_t *, zfs_share_proto_t *); 86 zfs_share_type_t zfs_is_shared_proto(zfs_handle_t *, char **, 87 zfs_share_proto_t); 88 89 /* 90 * The share protocols table must be in the same order as the zfs_share_prot_t 91 * enum in libzfs_impl.h 92 */ 93 typedef struct { 94 zfs_prop_t p_prop; 95 char *p_name; 96 int p_share_err; 97 int p_unshare_err; 98 } proto_table_t; 99 100 proto_table_t proto_table[PROTO_END] = { 101 {ZFS_PROP_SHARENFS, "nfs", EZFS_SHARENFSFAILED, EZFS_UNSHARENFSFAILED}, 102 {ZFS_PROP_SHARESMB, "smb", EZFS_SHARESMBFAILED, EZFS_UNSHARESMBFAILED}, 103 }; 104 105 zfs_share_proto_t nfs_only[] = { 106 PROTO_NFS, 107 PROTO_END 108 }; 109 110 zfs_share_proto_t smb_only[] = { 111 PROTO_SMB, 112 PROTO_END 113 }; 114 zfs_share_proto_t share_all_proto[] = { 115 PROTO_NFS, 116 PROTO_SMB, 117 PROTO_END 118 }; 119 120 /* 121 * Search the sharetab for the given mountpoint and protocol, returning 122 * a zfs_share_type_t value. 123 */ 124 static zfs_share_type_t 125 is_shared(libzfs_handle_t *hdl, const char *mountpoint, zfs_share_proto_t proto) 126 { 127 char buf[MAXPATHLEN], *tab; 128 char *ptr; 129 130 if (hdl->libzfs_sharetab == NULL) 131 return (SHARED_NOT_SHARED); 132 133 (void) fseek(hdl->libzfs_sharetab, 0, SEEK_SET); 134 135 while (fgets(buf, sizeof (buf), hdl->libzfs_sharetab) != NULL) { 136 137 /* the mountpoint is the first entry on each line */ 138 if ((tab = strchr(buf, '\t')) == NULL) 139 continue; 140 141 *tab = '\0'; 142 if (strcmp(buf, mountpoint) == 0) { 143 /* 144 * the protocol field is the third field 145 * skip over second field 146 */ 147 ptr = ++tab; 148 if ((tab = strchr(ptr, '\t')) == NULL) 149 continue; 150 ptr = ++tab; 151 if ((tab = strchr(ptr, '\t')) == NULL) 152 continue; 153 *tab = '\0'; 154 if (strcmp(ptr, 155 proto_table[proto].p_name) == 0) { 156 switch (proto) { 157 case PROTO_NFS: 158 return (SHARED_NFS); 159 case PROTO_SMB: 160 return (SHARED_SMB); 161 default: 162 return (0); 163 } 164 } 165 } 166 } 167 168 return (SHARED_NOT_SHARED); 169 } 170 171 /* 172 * Returns true if the specified directory is empty. If we can't open the 173 * directory at all, return true so that the mount can fail with a more 174 * informative error message. 175 */ 176 static boolean_t 177 dir_is_empty(const char *dirname) 178 { 179 DIR *dirp; 180 struct dirent64 *dp; 181 182 if ((dirp = opendir(dirname)) == NULL) 183 return (B_TRUE); 184 185 while ((dp = readdir64(dirp)) != NULL) { 186 187 if (strcmp(dp->d_name, ".") == 0 || 188 strcmp(dp->d_name, "..") == 0) 189 continue; 190 191 (void) closedir(dirp); 192 return (B_FALSE); 193 } 194 195 (void) closedir(dirp); 196 return (B_TRUE); 197 } 198 199 /* 200 * Checks to see if the mount is active. If the filesystem is mounted, we fill 201 * in 'where' with the current mountpoint, and return 1. Otherwise, we return 202 * 0. 203 */ 204 boolean_t 205 is_mounted(libzfs_handle_t *zfs_hdl, const char *special, char **where) 206 { 207 struct mnttab entry; 208 209 if (libzfs_mnttab_find(zfs_hdl, special, &entry) != 0) 210 return (B_FALSE); 211 212 if (where != NULL) 213 *where = zfs_strdup(zfs_hdl, entry.mnt_mountp); 214 215 return (B_TRUE); 216 } 217 218 boolean_t 219 zfs_is_mounted(zfs_handle_t *zhp, char **where) 220 { 221 return (is_mounted(zhp->zfs_hdl, zfs_get_name(zhp), where)); 222 } 223 224 /* 225 * Returns true if the given dataset is mountable, false otherwise. Returns the 226 * mountpoint in 'buf'. 227 */ 228 static boolean_t 229 zfs_is_mountable(zfs_handle_t *zhp, char *buf, size_t buflen, 230 zprop_source_t *source) 231 { 232 char sourceloc[ZFS_MAXNAMELEN]; 233 zprop_source_t sourcetype; 234 235 if (!zfs_prop_valid_for_type(ZFS_PROP_MOUNTPOINT, zhp->zfs_type)) 236 return (B_FALSE); 237 238 verify(zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, buf, buflen, 239 &sourcetype, sourceloc, sizeof (sourceloc), B_FALSE) == 0); 240 241 if (strcmp(buf, ZFS_MOUNTPOINT_NONE) == 0 || 242 strcmp(buf, ZFS_MOUNTPOINT_LEGACY) == 0) 243 return (B_FALSE); 244 245 if (zfs_prop_get_int(zhp, ZFS_PROP_CANMOUNT) == ZFS_CANMOUNT_OFF) 246 return (B_FALSE); 247 248 if (zfs_prop_get_int(zhp, ZFS_PROP_ZONED) && 249 getzoneid() == GLOBAL_ZONEID) 250 return (B_FALSE); 251 252 if (source) 253 *source = sourcetype; 254 255 return (B_TRUE); 256 } 257 258 /* 259 * Mount the given filesystem. 260 */ 261 int 262 zfs_mount(zfs_handle_t *zhp, const char *options, int flags) 263 { 264 struct stat buf; 265 char mountpoint[ZFS_MAXPROPLEN]; 266 char mntopts[MNT_LINE_MAX]; 267 libzfs_handle_t *hdl = zhp->zfs_hdl; 268 269 if (options == NULL) 270 mntopts[0] = '\0'; 271 else 272 (void) strlcpy(mntopts, options, sizeof (mntopts)); 273 274 /* 275 * If the pool is imported read-only then all mounts must be read-only 276 */ 277 if (zpool_get_prop_int(zhp->zpool_hdl, ZPOOL_PROP_READONLY, NULL)) 278 flags |= MS_RDONLY; 279 280 if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint), NULL)) 281 return (0); 282 283 /* Create the directory if it doesn't already exist */ 284 if (lstat(mountpoint, &buf) != 0) { 285 if (mkdirp(mountpoint, 0755) != 0) { 286 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 287 "failed to create mountpoint")); 288 return (zfs_error_fmt(hdl, EZFS_MOUNTFAILED, 289 dgettext(TEXT_DOMAIN, "cannot mount '%s'"), 290 mountpoint)); 291 } 292 } 293 294 /* 295 * Determine if the mountpoint is empty. If so, refuse to perform the 296 * mount. We don't perform this check if MS_OVERLAY is specified, which 297 * would defeat the point. We also avoid this check if 'remount' is 298 * specified. 299 */ 300 if ((flags & MS_OVERLAY) == 0 && 301 strstr(mntopts, MNTOPT_REMOUNT) == NULL && 302 !dir_is_empty(mountpoint)) { 303 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 304 "directory is not empty")); 305 return (zfs_error_fmt(hdl, EZFS_MOUNTFAILED, 306 dgettext(TEXT_DOMAIN, "cannot mount '%s'"), mountpoint)); 307 } 308 309 /* perform the mount */ 310 if (mount(zfs_get_name(zhp), mountpoint, MS_OPTIONSTR | flags, 311 MNTTYPE_ZFS, NULL, 0, mntopts, sizeof (mntopts)) != 0) { 312 /* 313 * Generic errors are nasty, but there are just way too many 314 * from mount(), and they're well-understood. We pick a few 315 * common ones to improve upon. 316 */ 317 if (errno == EBUSY) { 318 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 319 "mountpoint or dataset is busy")); 320 } else if (errno == EPERM) { 321 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 322 "Insufficient privileges")); 323 } else if (errno == ENOTSUP) { 324 char buf[256]; 325 int spa_version; 326 327 VERIFY(zfs_spa_version(zhp, &spa_version) == 0); 328 (void) snprintf(buf, sizeof (buf), 329 dgettext(TEXT_DOMAIN, "Can't mount a version %lld " 330 "file system on a version %d pool. Pool must be" 331 " upgraded to mount this file system."), 332 (u_longlong_t)zfs_prop_get_int(zhp, 333 ZFS_PROP_VERSION), spa_version); 334 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, buf)); 335 } else { 336 zfs_error_aux(hdl, strerror(errno)); 337 } 338 return (zfs_error_fmt(hdl, EZFS_MOUNTFAILED, 339 dgettext(TEXT_DOMAIN, "cannot mount '%s'"), 340 zhp->zfs_name)); 341 } 342 343 /* add the mounted entry into our cache */ 344 libzfs_mnttab_add(hdl, zfs_get_name(zhp), mountpoint, 345 mntopts); 346 return (0); 347 } 348 349 /* 350 * Unmount a single filesystem. 351 */ 352 static int 353 unmount_one(libzfs_handle_t *hdl, const char *mountpoint, int flags) 354 { 355 if (umount2(mountpoint, flags) != 0) { 356 zfs_error_aux(hdl, strerror(errno)); 357 return (zfs_error_fmt(hdl, EZFS_UMOUNTFAILED, 358 dgettext(TEXT_DOMAIN, "cannot unmount '%s'"), 359 mountpoint)); 360 } 361 362 return (0); 363 } 364 365 /* 366 * Unmount the given filesystem. 367 */ 368 int 369 zfs_unmount(zfs_handle_t *zhp, const char *mountpoint, int flags) 370 { 371 libzfs_handle_t *hdl = zhp->zfs_hdl; 372 struct mnttab entry; 373 char *mntpt = NULL; 374 375 /* check to see if we need to unmount the filesystem */ 376 if (mountpoint != NULL || ((zfs_get_type(zhp) == ZFS_TYPE_FILESYSTEM) && 377 libzfs_mnttab_find(hdl, zhp->zfs_name, &entry) == 0)) { 378 /* 379 * mountpoint may have come from a call to 380 * getmnt/getmntany if it isn't NULL. If it is NULL, 381 * we know it comes from libzfs_mnttab_find which can 382 * then get freed later. We strdup it to play it safe. 383 */ 384 if (mountpoint == NULL) 385 mntpt = zfs_strdup(hdl, entry.mnt_mountp); 386 else 387 mntpt = zfs_strdup(hdl, mountpoint); 388 389 /* 390 * Unshare and unmount the filesystem 391 */ 392 if (zfs_unshare_proto(zhp, mntpt, share_all_proto) != 0) 393 return (-1); 394 395 if (unmount_one(hdl, mntpt, flags) != 0) { 396 free(mntpt); 397 (void) zfs_shareall(zhp); 398 return (-1); 399 } 400 libzfs_mnttab_remove(hdl, zhp->zfs_name); 401 free(mntpt); 402 } 403 404 return (0); 405 } 406 407 /* 408 * Unmount this filesystem and any children inheriting the mountpoint property. 409 * To do this, just act like we're changing the mountpoint property, but don't 410 * remount the filesystems afterwards. 411 */ 412 int 413 zfs_unmountall(zfs_handle_t *zhp, int flags) 414 { 415 prop_changelist_t *clp; 416 int ret; 417 418 clp = changelist_gather(zhp, ZFS_PROP_MOUNTPOINT, 0, flags); 419 if (clp == NULL) 420 return (-1); 421 422 ret = changelist_prefix(clp); 423 changelist_free(clp); 424 425 return (ret); 426 } 427 428 boolean_t 429 zfs_is_shared(zfs_handle_t *zhp) 430 { 431 zfs_share_type_t rc = 0; 432 zfs_share_proto_t *curr_proto; 433 434 if (ZFS_IS_VOLUME(zhp)) 435 return (B_FALSE); 436 437 for (curr_proto = share_all_proto; *curr_proto != PROTO_END; 438 curr_proto++) 439 rc |= zfs_is_shared_proto(zhp, NULL, *curr_proto); 440 441 return (rc ? B_TRUE : B_FALSE); 442 } 443 444 int 445 zfs_share(zfs_handle_t *zhp) 446 { 447 assert(!ZFS_IS_VOLUME(zhp)); 448 return (zfs_share_proto(zhp, share_all_proto)); 449 } 450 451 int 452 zfs_unshare(zfs_handle_t *zhp) 453 { 454 assert(!ZFS_IS_VOLUME(zhp)); 455 return (zfs_unshareall(zhp)); 456 } 457 458 /* 459 * Check to see if the filesystem is currently shared. 460 */ 461 zfs_share_type_t 462 zfs_is_shared_proto(zfs_handle_t *zhp, char **where, zfs_share_proto_t proto) 463 { 464 char *mountpoint; 465 zfs_share_type_t rc; 466 467 if (!zfs_is_mounted(zhp, &mountpoint)) 468 return (SHARED_NOT_SHARED); 469 470 if (rc = is_shared(zhp->zfs_hdl, mountpoint, proto)) { 471 if (where != NULL) 472 *where = mountpoint; 473 else 474 free(mountpoint); 475 return (rc); 476 } else { 477 free(mountpoint); 478 return (SHARED_NOT_SHARED); 479 } 480 } 481 482 boolean_t 483 zfs_is_shared_nfs(zfs_handle_t *zhp, char **where) 484 { 485 return (zfs_is_shared_proto(zhp, where, 486 PROTO_NFS) != SHARED_NOT_SHARED); 487 } 488 489 boolean_t 490 zfs_is_shared_smb(zfs_handle_t *zhp, char **where) 491 { 492 return (zfs_is_shared_proto(zhp, where, 493 PROTO_SMB) != SHARED_NOT_SHARED); 494 } 495 496 /* 497 * Make sure things will work if libshare isn't installed by using 498 * wrapper functions that check to see that the pointers to functions 499 * initialized in _zfs_init_libshare() are actually present. 500 */ 501 502 static sa_handle_t (*_sa_init)(int); 503 static void (*_sa_fini)(sa_handle_t); 504 static sa_share_t (*_sa_find_share)(sa_handle_t, char *); 505 static int (*_sa_enable_share)(sa_share_t, char *); 506 static int (*_sa_disable_share)(sa_share_t, char *); 507 static char *(*_sa_errorstr)(int); 508 static int (*_sa_parse_legacy_options)(sa_group_t, char *, char *); 509 static boolean_t (*_sa_needs_refresh)(sa_handle_t *); 510 static libzfs_handle_t *(*_sa_get_zfs_handle)(sa_handle_t); 511 static int (*_sa_zfs_process_share)(sa_handle_t, sa_group_t, sa_share_t, 512 char *, char *, zprop_source_t, char *, char *, char *); 513 static void (*_sa_update_sharetab_ts)(sa_handle_t); 514 515 /* 516 * _zfs_init_libshare() 517 * 518 * Find the libshare.so.1 entry points that we use here and save the 519 * values to be used later. This is triggered by the runtime loader. 520 * Make sure the correct ISA version is loaded. 521 */ 522 523 #pragma init(_zfs_init_libshare) 524 static void 525 _zfs_init_libshare(void) 526 { 527 void *libshare; 528 char path[MAXPATHLEN]; 529 char isa[MAXISALEN]; 530 531 #if defined(_LP64) 532 if (sysinfo(SI_ARCHITECTURE_64, isa, MAXISALEN) == -1) 533 isa[0] = '\0'; 534 #else 535 isa[0] = '\0'; 536 #endif 537 (void) snprintf(path, MAXPATHLEN, 538 "/usr/lib/%s/libshare.so.1", isa); 539 540 if ((libshare = dlopen(path, RTLD_LAZY | RTLD_GLOBAL)) != NULL) { 541 _sa_init = (sa_handle_t (*)(int))dlsym(libshare, "sa_init"); 542 _sa_fini = (void (*)(sa_handle_t))dlsym(libshare, "sa_fini"); 543 _sa_find_share = (sa_share_t (*)(sa_handle_t, char *)) 544 dlsym(libshare, "sa_find_share"); 545 _sa_enable_share = (int (*)(sa_share_t, char *))dlsym(libshare, 546 "sa_enable_share"); 547 _sa_disable_share = (int (*)(sa_share_t, char *))dlsym(libshare, 548 "sa_disable_share"); 549 _sa_errorstr = (char *(*)(int))dlsym(libshare, "sa_errorstr"); 550 _sa_parse_legacy_options = (int (*)(sa_group_t, char *, char *)) 551 dlsym(libshare, "sa_parse_legacy_options"); 552 _sa_needs_refresh = (boolean_t (*)(sa_handle_t *)) 553 dlsym(libshare, "sa_needs_refresh"); 554 _sa_get_zfs_handle = (libzfs_handle_t *(*)(sa_handle_t)) 555 dlsym(libshare, "sa_get_zfs_handle"); 556 _sa_zfs_process_share = (int (*)(sa_handle_t, sa_group_t, 557 sa_share_t, char *, char *, zprop_source_t, char *, 558 char *, char *))dlsym(libshare, "sa_zfs_process_share"); 559 _sa_update_sharetab_ts = (void (*)(sa_handle_t)) 560 dlsym(libshare, "sa_update_sharetab_ts"); 561 if (_sa_init == NULL || _sa_fini == NULL || 562 _sa_find_share == NULL || _sa_enable_share == NULL || 563 _sa_disable_share == NULL || _sa_errorstr == NULL || 564 _sa_parse_legacy_options == NULL || 565 _sa_needs_refresh == NULL || _sa_get_zfs_handle == NULL || 566 _sa_zfs_process_share == NULL || 567 _sa_update_sharetab_ts == NULL) { 568 _sa_init = NULL; 569 _sa_fini = NULL; 570 _sa_disable_share = NULL; 571 _sa_enable_share = NULL; 572 _sa_errorstr = NULL; 573 _sa_parse_legacy_options = NULL; 574 (void) dlclose(libshare); 575 _sa_needs_refresh = NULL; 576 _sa_get_zfs_handle = NULL; 577 _sa_zfs_process_share = NULL; 578 _sa_update_sharetab_ts = NULL; 579 } 580 } 581 } 582 583 /* 584 * zfs_init_libshare(zhandle, service) 585 * 586 * Initialize the libshare API if it hasn't already been initialized. 587 * In all cases it returns 0 if it succeeded and an error if not. The 588 * service value is which part(s) of the API to initialize and is a 589 * direct map to the libshare sa_init(service) interface. 590 */ 591 int 592 zfs_init_libshare(libzfs_handle_t *zhandle, int service) 593 { 594 int ret = SA_OK; 595 596 if (_sa_init == NULL) 597 ret = SA_CONFIG_ERR; 598 599 if (ret == SA_OK && zhandle->libzfs_shareflags & ZFSSHARE_MISS) { 600 /* 601 * We had a cache miss. Most likely it is a new ZFS 602 * dataset that was just created. We want to make sure 603 * so check timestamps to see if a different process 604 * has updated any of the configuration. If there was 605 * some non-ZFS change, we need to re-initialize the 606 * internal cache. 607 */ 608 zhandle->libzfs_shareflags &= ~ZFSSHARE_MISS; 609 if (_sa_needs_refresh != NULL && 610 _sa_needs_refresh(zhandle->libzfs_sharehdl)) { 611 zfs_uninit_libshare(zhandle); 612 zhandle->libzfs_sharehdl = _sa_init(service); 613 } 614 } 615 616 if (ret == SA_OK && zhandle && zhandle->libzfs_sharehdl == NULL) 617 zhandle->libzfs_sharehdl = _sa_init(service); 618 619 if (ret == SA_OK && zhandle->libzfs_sharehdl == NULL) 620 ret = SA_NO_MEMORY; 621 622 return (ret); 623 } 624 625 /* 626 * zfs_uninit_libshare(zhandle) 627 * 628 * Uninitialize the libshare API if it hasn't already been 629 * uninitialized. It is OK to call multiple times. 630 */ 631 void 632 zfs_uninit_libshare(libzfs_handle_t *zhandle) 633 { 634 if (zhandle != NULL && zhandle->libzfs_sharehdl != NULL) { 635 if (_sa_fini != NULL) 636 _sa_fini(zhandle->libzfs_sharehdl); 637 zhandle->libzfs_sharehdl = NULL; 638 } 639 } 640 641 /* 642 * zfs_parse_options(options, proto) 643 * 644 * Call the legacy parse interface to get the protocol specific 645 * options using the NULL arg to indicate that this is a "parse" only. 646 */ 647 int 648 zfs_parse_options(char *options, zfs_share_proto_t proto) 649 { 650 if (_sa_parse_legacy_options != NULL) { 651 return (_sa_parse_legacy_options(NULL, options, 652 proto_table[proto].p_name)); 653 } 654 return (SA_CONFIG_ERR); 655 } 656 657 /* 658 * zfs_sa_find_share(handle, path) 659 * 660 * wrapper around sa_find_share to find a share path in the 661 * configuration. 662 */ 663 static sa_share_t 664 zfs_sa_find_share(sa_handle_t handle, char *path) 665 { 666 if (_sa_find_share != NULL) 667 return (_sa_find_share(handle, path)); 668 return (NULL); 669 } 670 671 /* 672 * zfs_sa_enable_share(share, proto) 673 * 674 * Wrapper for sa_enable_share which enables a share for a specified 675 * protocol. 676 */ 677 static int 678 zfs_sa_enable_share(sa_share_t share, char *proto) 679 { 680 if (_sa_enable_share != NULL) 681 return (_sa_enable_share(share, proto)); 682 return (SA_CONFIG_ERR); 683 } 684 685 /* 686 * zfs_sa_disable_share(share, proto) 687 * 688 * Wrapper for sa_enable_share which disables a share for a specified 689 * protocol. 690 */ 691 static int 692 zfs_sa_disable_share(sa_share_t share, char *proto) 693 { 694 if (_sa_disable_share != NULL) 695 return (_sa_disable_share(share, proto)); 696 return (SA_CONFIG_ERR); 697 } 698 699 /* 700 * Share the given filesystem according to the options in the specified 701 * protocol specific properties (sharenfs, sharesmb). We rely 702 * on "libshare" to the dirty work for us. 703 */ 704 static int 705 zfs_share_proto(zfs_handle_t *zhp, zfs_share_proto_t *proto) 706 { 707 char mountpoint[ZFS_MAXPROPLEN]; 708 char shareopts[ZFS_MAXPROPLEN]; 709 char sourcestr[ZFS_MAXPROPLEN]; 710 libzfs_handle_t *hdl = zhp->zfs_hdl; 711 sa_share_t share; 712 zfs_share_proto_t *curr_proto; 713 zprop_source_t sourcetype; 714 int ret; 715 716 if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint), NULL)) 717 return (0); 718 719 for (curr_proto = proto; *curr_proto != PROTO_END; curr_proto++) { 720 /* 721 * Return success if there are no share options. 722 */ 723 if (zfs_prop_get(zhp, proto_table[*curr_proto].p_prop, 724 shareopts, sizeof (shareopts), &sourcetype, sourcestr, 725 ZFS_MAXPROPLEN, B_FALSE) != 0 || 726 strcmp(shareopts, "off") == 0) 727 continue; 728 729 ret = zfs_init_libshare(hdl, SA_INIT_SHARE_API); 730 if (ret != SA_OK) { 731 (void) zfs_error_fmt(hdl, EZFS_SHARENFSFAILED, 732 dgettext(TEXT_DOMAIN, "cannot share '%s': %s"), 733 zfs_get_name(zhp), _sa_errorstr != NULL ? 734 _sa_errorstr(ret) : ""); 735 return (-1); 736 } 737 738 /* 739 * If the 'zoned' property is set, then zfs_is_mountable() 740 * will have already bailed out if we are in the global zone. 741 * But local zones cannot be NFS servers, so we ignore it for 742 * local zones as well. 743 */ 744 if (zfs_prop_get_int(zhp, ZFS_PROP_ZONED)) 745 continue; 746 747 share = zfs_sa_find_share(hdl->libzfs_sharehdl, mountpoint); 748 if (share == NULL) { 749 /* 750 * This may be a new file system that was just 751 * created so isn't in the internal cache 752 * (second time through). Rather than 753 * reloading the entire configuration, we can 754 * assume ZFS has done the checking and it is 755 * safe to add this to the internal 756 * configuration. 757 */ 758 if (_sa_zfs_process_share(hdl->libzfs_sharehdl, 759 NULL, NULL, mountpoint, 760 proto_table[*curr_proto].p_name, sourcetype, 761 shareopts, sourcestr, zhp->zfs_name) != SA_OK) { 762 (void) zfs_error_fmt(hdl, 763 proto_table[*curr_proto].p_share_err, 764 dgettext(TEXT_DOMAIN, "cannot share '%s'"), 765 zfs_get_name(zhp)); 766 return (-1); 767 } 768 hdl->libzfs_shareflags |= ZFSSHARE_MISS; 769 share = zfs_sa_find_share(hdl->libzfs_sharehdl, 770 mountpoint); 771 } 772 if (share != NULL) { 773 int err; 774 err = zfs_sa_enable_share(share, 775 proto_table[*curr_proto].p_name); 776 if (err != SA_OK) { 777 (void) zfs_error_fmt(hdl, 778 proto_table[*curr_proto].p_share_err, 779 dgettext(TEXT_DOMAIN, "cannot share '%s'"), 780 zfs_get_name(zhp)); 781 return (-1); 782 } 783 } else { 784 (void) zfs_error_fmt(hdl, 785 proto_table[*curr_proto].p_share_err, 786 dgettext(TEXT_DOMAIN, "cannot share '%s'"), 787 zfs_get_name(zhp)); 788 return (-1); 789 } 790 791 } 792 return (0); 793 } 794 795 796 int 797 zfs_share_nfs(zfs_handle_t *zhp) 798 { 799 return (zfs_share_proto(zhp, nfs_only)); 800 } 801 802 int 803 zfs_share_smb(zfs_handle_t *zhp) 804 { 805 return (zfs_share_proto(zhp, smb_only)); 806 } 807 808 int 809 zfs_shareall(zfs_handle_t *zhp) 810 { 811 return (zfs_share_proto(zhp, share_all_proto)); 812 } 813 814 /* 815 * Unshare a filesystem by mountpoint. 816 */ 817 static int 818 unshare_one(libzfs_handle_t *hdl, const char *name, const char *mountpoint, 819 zfs_share_proto_t proto) 820 { 821 sa_share_t share; 822 int err; 823 char *mntpt; 824 /* 825 * Mountpoint could get trashed if libshare calls getmntany 826 * which it does during API initialization, so strdup the 827 * value. 828 */ 829 mntpt = zfs_strdup(hdl, mountpoint); 830 831 /* make sure libshare initialized */ 832 if ((err = zfs_init_libshare(hdl, SA_INIT_SHARE_API)) != SA_OK) { 833 free(mntpt); /* don't need the copy anymore */ 834 return (zfs_error_fmt(hdl, EZFS_SHARENFSFAILED, 835 dgettext(TEXT_DOMAIN, "cannot unshare '%s': %s"), 836 name, _sa_errorstr(err))); 837 } 838 839 share = zfs_sa_find_share(hdl->libzfs_sharehdl, mntpt); 840 free(mntpt); /* don't need the copy anymore */ 841 842 if (share != NULL) { 843 err = zfs_sa_disable_share(share, proto_table[proto].p_name); 844 if (err != SA_OK) { 845 return (zfs_error_fmt(hdl, EZFS_UNSHARENFSFAILED, 846 dgettext(TEXT_DOMAIN, "cannot unshare '%s': %s"), 847 name, _sa_errorstr(err))); 848 } 849 } else { 850 return (zfs_error_fmt(hdl, EZFS_UNSHARENFSFAILED, 851 dgettext(TEXT_DOMAIN, "cannot unshare '%s': not found"), 852 name)); 853 } 854 return (0); 855 } 856 857 /* 858 * Unshare the given filesystem. 859 */ 860 int 861 zfs_unshare_proto(zfs_handle_t *zhp, const char *mountpoint, 862 zfs_share_proto_t *proto) 863 { 864 libzfs_handle_t *hdl = zhp->zfs_hdl; 865 struct mnttab entry; 866 char *mntpt = NULL; 867 868 /* check to see if need to unmount the filesystem */ 869 rewind(zhp->zfs_hdl->libzfs_mnttab); 870 if (mountpoint != NULL) 871 mountpoint = mntpt = zfs_strdup(hdl, mountpoint); 872 873 if (mountpoint != NULL || ((zfs_get_type(zhp) == ZFS_TYPE_FILESYSTEM) && 874 libzfs_mnttab_find(hdl, zfs_get_name(zhp), &entry) == 0)) { 875 zfs_share_proto_t *curr_proto; 876 877 if (mountpoint == NULL) 878 mntpt = zfs_strdup(zhp->zfs_hdl, entry.mnt_mountp); 879 880 for (curr_proto = proto; *curr_proto != PROTO_END; 881 curr_proto++) { 882 883 if (is_shared(hdl, mntpt, *curr_proto) && 884 unshare_one(hdl, zhp->zfs_name, 885 mntpt, *curr_proto) != 0) { 886 if (mntpt != NULL) 887 free(mntpt); 888 return (-1); 889 } 890 } 891 } 892 if (mntpt != NULL) 893 free(mntpt); 894 895 return (0); 896 } 897 898 int 899 zfs_unshare_nfs(zfs_handle_t *zhp, const char *mountpoint) 900 { 901 return (zfs_unshare_proto(zhp, mountpoint, nfs_only)); 902 } 903 904 int 905 zfs_unshare_smb(zfs_handle_t *zhp, const char *mountpoint) 906 { 907 return (zfs_unshare_proto(zhp, mountpoint, smb_only)); 908 } 909 910 /* 911 * Same as zfs_unmountall(), but for NFS and SMB unshares. 912 */ 913 int 914 zfs_unshareall_proto(zfs_handle_t *zhp, zfs_share_proto_t *proto) 915 { 916 prop_changelist_t *clp; 917 int ret; 918 919 clp = changelist_gather(zhp, ZFS_PROP_SHARENFS, 0, 0); 920 if (clp == NULL) 921 return (-1); 922 923 ret = changelist_unshare(clp, proto); 924 changelist_free(clp); 925 926 return (ret); 927 } 928 929 int 930 zfs_unshareall_nfs(zfs_handle_t *zhp) 931 { 932 return (zfs_unshareall_proto(zhp, nfs_only)); 933 } 934 935 int 936 zfs_unshareall_smb(zfs_handle_t *zhp) 937 { 938 return (zfs_unshareall_proto(zhp, smb_only)); 939 } 940 941 int 942 zfs_unshareall(zfs_handle_t *zhp) 943 { 944 return (zfs_unshareall_proto(zhp, share_all_proto)); 945 } 946 947 int 948 zfs_unshareall_bypath(zfs_handle_t *zhp, const char *mountpoint) 949 { 950 return (zfs_unshare_proto(zhp, mountpoint, share_all_proto)); 951 } 952 953 /* 954 * Remove the mountpoint associated with the current dataset, if necessary. 955 * We only remove the underlying directory if: 956 * 957 * - The mountpoint is not 'none' or 'legacy' 958 * - The mountpoint is non-empty 959 * - The mountpoint is the default or inherited 960 * - The 'zoned' property is set, or we're in a local zone 961 * 962 * Any other directories we leave alone. 963 */ 964 void 965 remove_mountpoint(zfs_handle_t *zhp) 966 { 967 char mountpoint[ZFS_MAXPROPLEN]; 968 zprop_source_t source; 969 970 if (!zfs_is_mountable(zhp, mountpoint, sizeof (mountpoint), 971 &source)) 972 return; 973 974 if (source == ZPROP_SRC_DEFAULT || 975 source == ZPROP_SRC_INHERITED) { 976 /* 977 * Try to remove the directory, silently ignoring any errors. 978 * The filesystem may have since been removed or moved around, 979 * and this error isn't really useful to the administrator in 980 * any way. 981 */ 982 (void) rmdir(mountpoint); 983 } 984 } 985 986 void 987 libzfs_add_handle(get_all_cb_t *cbp, zfs_handle_t *zhp) 988 { 989 if (cbp->cb_alloc == cbp->cb_used) { 990 size_t newsz; 991 void *ptr; 992 993 newsz = cbp->cb_alloc ? cbp->cb_alloc * 2 : 64; 994 ptr = zfs_realloc(zhp->zfs_hdl, 995 cbp->cb_handles, cbp->cb_alloc * sizeof (void *), 996 newsz * sizeof (void *)); 997 cbp->cb_handles = ptr; 998 cbp->cb_alloc = newsz; 999 } 1000 cbp->cb_handles[cbp->cb_used++] = zhp; 1001 } 1002 1003 static int 1004 mount_cb(zfs_handle_t *zhp, void *data) 1005 { 1006 get_all_cb_t *cbp = data; 1007 1008 if (!(zfs_get_type(zhp) & ZFS_TYPE_FILESYSTEM)) { 1009 zfs_close(zhp); 1010 return (0); 1011 } 1012 1013 if (zfs_prop_get_int(zhp, ZFS_PROP_CANMOUNT) == ZFS_CANMOUNT_NOAUTO) { 1014 zfs_close(zhp); 1015 return (0); 1016 } 1017 1018 libzfs_add_handle(cbp, zhp); 1019 if (zfs_iter_filesystems(zhp, mount_cb, cbp) != 0) { 1020 zfs_close(zhp); 1021 return (-1); 1022 } 1023 return (0); 1024 } 1025 1026 int 1027 libzfs_dataset_cmp(const void *a, const void *b) 1028 { 1029 zfs_handle_t **za = (zfs_handle_t **)a; 1030 zfs_handle_t **zb = (zfs_handle_t **)b; 1031 char mounta[MAXPATHLEN]; 1032 char mountb[MAXPATHLEN]; 1033 boolean_t gota, gotb; 1034 1035 if ((gota = (zfs_get_type(*za) == ZFS_TYPE_FILESYSTEM)) != 0) 1036 verify(zfs_prop_get(*za, ZFS_PROP_MOUNTPOINT, mounta, 1037 sizeof (mounta), NULL, NULL, 0, B_FALSE) == 0); 1038 if ((gotb = (zfs_get_type(*zb) == ZFS_TYPE_FILESYSTEM)) != 0) 1039 verify(zfs_prop_get(*zb, ZFS_PROP_MOUNTPOINT, mountb, 1040 sizeof (mountb), NULL, NULL, 0, B_FALSE) == 0); 1041 1042 if (gota && gotb) 1043 return (strcmp(mounta, mountb)); 1044 1045 if (gota) 1046 return (-1); 1047 if (gotb) 1048 return (1); 1049 1050 return (strcmp(zfs_get_name(a), zfs_get_name(b))); 1051 } 1052 1053 /* 1054 * Mount and share all datasets within the given pool. This assumes that no 1055 * datasets within the pool are currently mounted. Because users can create 1056 * complicated nested hierarchies of mountpoints, we first gather all the 1057 * datasets and mountpoints within the pool, and sort them by mountpoint. Once 1058 * we have the list of all filesystems, we iterate over them in order and mount 1059 * and/or share each one. 1060 */ 1061 #pragma weak zpool_mount_datasets = zpool_enable_datasets 1062 int 1063 zpool_enable_datasets(zpool_handle_t *zhp, const char *mntopts, int flags) 1064 { 1065 get_all_cb_t cb = { 0 }; 1066 libzfs_handle_t *hdl = zhp->zpool_hdl; 1067 zfs_handle_t *zfsp; 1068 int i, ret = -1; 1069 int *good; 1070 1071 /* 1072 * Gather all non-snap datasets within the pool. 1073 */ 1074 if ((zfsp = zfs_open(hdl, zhp->zpool_name, ZFS_TYPE_DATASET)) == NULL) 1075 goto out; 1076 1077 libzfs_add_handle(&cb, zfsp); 1078 if (zfs_iter_filesystems(zfsp, mount_cb, &cb) != 0) 1079 goto out; 1080 /* 1081 * Sort the datasets by mountpoint. 1082 */ 1083 qsort(cb.cb_handles, cb.cb_used, sizeof (void *), 1084 libzfs_dataset_cmp); 1085 1086 /* 1087 * And mount all the datasets, keeping track of which ones 1088 * succeeded or failed. 1089 */ 1090 if ((good = zfs_alloc(zhp->zpool_hdl, 1091 cb.cb_used * sizeof (int))) == NULL) 1092 goto out; 1093 1094 ret = 0; 1095 for (i = 0; i < cb.cb_used; i++) { 1096 if (zfs_mount(cb.cb_handles[i], mntopts, flags) != 0) 1097 ret = -1; 1098 else 1099 good[i] = 1; 1100 } 1101 1102 /* 1103 * Then share all the ones that need to be shared. This needs 1104 * to be a separate pass in order to avoid excessive reloading 1105 * of the configuration. Good should never be NULL since 1106 * zfs_alloc is supposed to exit if memory isn't available. 1107 */ 1108 for (i = 0; i < cb.cb_used; i++) { 1109 if (good[i] && zfs_share(cb.cb_handles[i]) != 0) 1110 ret = -1; 1111 } 1112 1113 free(good); 1114 1115 out: 1116 for (i = 0; i < cb.cb_used; i++) 1117 zfs_close(cb.cb_handles[i]); 1118 free(cb.cb_handles); 1119 1120 return (ret); 1121 } 1122 1123 static int 1124 mountpoint_compare(const void *a, const void *b) 1125 { 1126 const char *mounta = *((char **)a); 1127 const char *mountb = *((char **)b); 1128 1129 return (strcmp(mountb, mounta)); 1130 } 1131 1132 /* alias for 2002/240 */ 1133 #pragma weak zpool_unmount_datasets = zpool_disable_datasets 1134 /* 1135 * Unshare and unmount all datasets within the given pool. We don't want to 1136 * rely on traversing the DSL to discover the filesystems within the pool, 1137 * because this may be expensive (if not all of them are mounted), and can fail 1138 * arbitrarily (on I/O error, for example). Instead, we walk /etc/mnttab and 1139 * gather all the filesystems that are currently mounted. 1140 */ 1141 int 1142 zpool_disable_datasets(zpool_handle_t *zhp, boolean_t force) 1143 { 1144 int used, alloc; 1145 struct mnttab entry; 1146 size_t namelen; 1147 char **mountpoints = NULL; 1148 zfs_handle_t **datasets = NULL; 1149 libzfs_handle_t *hdl = zhp->zpool_hdl; 1150 int i; 1151 int ret = -1; 1152 int flags = (force ? MS_FORCE : 0); 1153 1154 namelen = strlen(zhp->zpool_name); 1155 1156 rewind(hdl->libzfs_mnttab); 1157 used = alloc = 0; 1158 while (getmntent(hdl->libzfs_mnttab, &entry) == 0) { 1159 /* 1160 * Ignore non-ZFS entries. 1161 */ 1162 if (entry.mnt_fstype == NULL || 1163 strcmp(entry.mnt_fstype, MNTTYPE_ZFS) != 0) 1164 continue; 1165 1166 /* 1167 * Ignore filesystems not within this pool. 1168 */ 1169 if (entry.mnt_mountp == NULL || 1170 strncmp(entry.mnt_special, zhp->zpool_name, namelen) != 0 || 1171 (entry.mnt_special[namelen] != '/' && 1172 entry.mnt_special[namelen] != '\0')) 1173 continue; 1174 1175 /* 1176 * At this point we've found a filesystem within our pool. Add 1177 * it to our growing list. 1178 */ 1179 if (used == alloc) { 1180 if (alloc == 0) { 1181 if ((mountpoints = zfs_alloc(hdl, 1182 8 * sizeof (void *))) == NULL) 1183 goto out; 1184 1185 if ((datasets = zfs_alloc(hdl, 1186 8 * sizeof (void *))) == NULL) 1187 goto out; 1188 1189 alloc = 8; 1190 } else { 1191 void *ptr; 1192 1193 if ((ptr = zfs_realloc(hdl, mountpoints, 1194 alloc * sizeof (void *), 1195 alloc * 2 * sizeof (void *))) == NULL) 1196 goto out; 1197 mountpoints = ptr; 1198 1199 if ((ptr = zfs_realloc(hdl, datasets, 1200 alloc * sizeof (void *), 1201 alloc * 2 * sizeof (void *))) == NULL) 1202 goto out; 1203 datasets = ptr; 1204 1205 alloc *= 2; 1206 } 1207 } 1208 1209 if ((mountpoints[used] = zfs_strdup(hdl, 1210 entry.mnt_mountp)) == NULL) 1211 goto out; 1212 1213 /* 1214 * This is allowed to fail, in case there is some I/O error. It 1215 * is only used to determine if we need to remove the underlying 1216 * mountpoint, so failure is not fatal. 1217 */ 1218 datasets[used] = make_dataset_handle(hdl, entry.mnt_special); 1219 1220 used++; 1221 } 1222 1223 /* 1224 * At this point, we have the entire list of filesystems, so sort it by 1225 * mountpoint. 1226 */ 1227 qsort(mountpoints, used, sizeof (char *), mountpoint_compare); 1228 1229 /* 1230 * Walk through and first unshare everything. 1231 */ 1232 for (i = 0; i < used; i++) { 1233 zfs_share_proto_t *curr_proto; 1234 for (curr_proto = share_all_proto; *curr_proto != PROTO_END; 1235 curr_proto++) { 1236 if (is_shared(hdl, mountpoints[i], *curr_proto) && 1237 unshare_one(hdl, mountpoints[i], 1238 mountpoints[i], *curr_proto) != 0) 1239 goto out; 1240 } 1241 } 1242 1243 /* 1244 * Now unmount everything, removing the underlying directories as 1245 * appropriate. 1246 */ 1247 for (i = 0; i < used; i++) { 1248 if (unmount_one(hdl, mountpoints[i], flags) != 0) 1249 goto out; 1250 } 1251 1252 for (i = 0; i < used; i++) { 1253 if (datasets[i]) 1254 remove_mountpoint(datasets[i]); 1255 } 1256 1257 ret = 0; 1258 out: 1259 for (i = 0; i < used; i++) { 1260 if (datasets[i]) 1261 zfs_close(datasets[i]); 1262 free(mountpoints[i]); 1263 } 1264 free(datasets); 1265 free(mountpoints); 1266 1267 return (ret); 1268 } 1269