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 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 /* 27 * Internal utility routines for the ZFS library. 28 */ 29 30 #include <errno.h> 31 #include <fcntl.h> 32 #include <libintl.h> 33 #include <stdarg.h> 34 #include <stdio.h> 35 #include <stdlib.h> 36 #include <strings.h> 37 #include <unistd.h> 38 #include <ctype.h> 39 #include <math.h> 40 #include <sys/mnttab.h> 41 #include <sys/mntent.h> 42 #include <sys/types.h> 43 44 #include <libzfs.h> 45 46 #include "libzfs_impl.h" 47 #include "zfs_prop.h" 48 49 int 50 libzfs_errno(libzfs_handle_t *hdl) 51 { 52 return (hdl->libzfs_error); 53 } 54 55 const char * 56 libzfs_error_action(libzfs_handle_t *hdl) 57 { 58 return (hdl->libzfs_action); 59 } 60 61 const char * 62 libzfs_error_description(libzfs_handle_t *hdl) 63 { 64 if (hdl->libzfs_desc[0] != '\0') 65 return (hdl->libzfs_desc); 66 67 switch (hdl->libzfs_error) { 68 case EZFS_NOMEM: 69 return (dgettext(TEXT_DOMAIN, "out of memory")); 70 case EZFS_BADPROP: 71 return (dgettext(TEXT_DOMAIN, "invalid property value")); 72 case EZFS_PROPREADONLY: 73 return (dgettext(TEXT_DOMAIN, "read only property")); 74 case EZFS_PROPTYPE: 75 return (dgettext(TEXT_DOMAIN, "property doesn't apply to " 76 "datasets of this type")); 77 case EZFS_PROPNONINHERIT: 78 return (dgettext(TEXT_DOMAIN, "property cannot be inherited")); 79 case EZFS_PROPSPACE: 80 return (dgettext(TEXT_DOMAIN, "invalid quota or reservation")); 81 case EZFS_BADTYPE: 82 return (dgettext(TEXT_DOMAIN, "operation not applicable to " 83 "datasets of this type")); 84 case EZFS_BUSY: 85 return (dgettext(TEXT_DOMAIN, "pool or dataset is busy")); 86 case EZFS_EXISTS: 87 return (dgettext(TEXT_DOMAIN, "pool or dataset exists")); 88 case EZFS_NOENT: 89 return (dgettext(TEXT_DOMAIN, "no such pool or dataset")); 90 case EZFS_BADSTREAM: 91 return (dgettext(TEXT_DOMAIN, "invalid backup stream")); 92 case EZFS_DSREADONLY: 93 return (dgettext(TEXT_DOMAIN, "dataset is read only")); 94 case EZFS_VOLTOOBIG: 95 return (dgettext(TEXT_DOMAIN, "volume size exceeds limit for " 96 "this system")); 97 case EZFS_VOLHASDATA: 98 return (dgettext(TEXT_DOMAIN, "volume has data")); 99 case EZFS_INVALIDNAME: 100 return (dgettext(TEXT_DOMAIN, "invalid name")); 101 case EZFS_BADRESTORE: 102 return (dgettext(TEXT_DOMAIN, "unable to restore to " 103 "destination")); 104 case EZFS_BADBACKUP: 105 return (dgettext(TEXT_DOMAIN, "backup failed")); 106 case EZFS_BADTARGET: 107 return (dgettext(TEXT_DOMAIN, "invalid target vdev")); 108 case EZFS_NODEVICE: 109 return (dgettext(TEXT_DOMAIN, "no such device in pool")); 110 case EZFS_BADDEV: 111 return (dgettext(TEXT_DOMAIN, "invalid device")); 112 case EZFS_NOREPLICAS: 113 return (dgettext(TEXT_DOMAIN, "no valid replicas")); 114 case EZFS_RESILVERING: 115 return (dgettext(TEXT_DOMAIN, "currently resilvering")); 116 case EZFS_BADVERSION: 117 return (dgettext(TEXT_DOMAIN, "unsupported version")); 118 case EZFS_POOLUNAVAIL: 119 return (dgettext(TEXT_DOMAIN, "pool is unavailable")); 120 case EZFS_DEVOVERFLOW: 121 return (dgettext(TEXT_DOMAIN, "too many devices in one vdev")); 122 case EZFS_BADPATH: 123 return (dgettext(TEXT_DOMAIN, "must be an absolute path")); 124 case EZFS_CROSSTARGET: 125 return (dgettext(TEXT_DOMAIN, "operation crosses datasets or " 126 "pools")); 127 case EZFS_ZONED: 128 return (dgettext(TEXT_DOMAIN, "dataset in use by local zone")); 129 case EZFS_MOUNTFAILED: 130 return (dgettext(TEXT_DOMAIN, "mount failed")); 131 case EZFS_UMOUNTFAILED: 132 return (dgettext(TEXT_DOMAIN, "umount failed")); 133 case EZFS_UNSHARENFSFAILED: 134 return (dgettext(TEXT_DOMAIN, "unshare(1M) failed")); 135 case EZFS_SHARENFSFAILED: 136 return (dgettext(TEXT_DOMAIN, "share(1M) failed")); 137 case EZFS_UNSHARESMBFAILED: 138 return (dgettext(TEXT_DOMAIN, "smb remove share failed")); 139 case EZFS_SHARESMBFAILED: 140 return (dgettext(TEXT_DOMAIN, "smb add share failed")); 141 case EZFS_ISCSISVCUNAVAIL: 142 return (dgettext(TEXT_DOMAIN, 143 "iscsitgt service need to be enabled by " 144 "a privileged user")); 145 case EZFS_DEVLINKS: 146 return (dgettext(TEXT_DOMAIN, "failed to create /dev links")); 147 case EZFS_PERM: 148 return (dgettext(TEXT_DOMAIN, "permission denied")); 149 case EZFS_NOSPC: 150 return (dgettext(TEXT_DOMAIN, "out of space")); 151 case EZFS_IO: 152 return (dgettext(TEXT_DOMAIN, "I/O error")); 153 case EZFS_INTR: 154 return (dgettext(TEXT_DOMAIN, "signal received")); 155 case EZFS_ISSPARE: 156 return (dgettext(TEXT_DOMAIN, "device is reserved as a hot " 157 "spare")); 158 case EZFS_INVALCONFIG: 159 return (dgettext(TEXT_DOMAIN, "invalid vdev configuration")); 160 case EZFS_RECURSIVE: 161 return (dgettext(TEXT_DOMAIN, "recursive dataset dependency")); 162 case EZFS_NOHISTORY: 163 return (dgettext(TEXT_DOMAIN, "no history available")); 164 case EZFS_UNSHAREISCSIFAILED: 165 return (dgettext(TEXT_DOMAIN, 166 "iscsitgtd failed request to unshare")); 167 case EZFS_SHAREISCSIFAILED: 168 return (dgettext(TEXT_DOMAIN, 169 "iscsitgtd failed request to share")); 170 case EZFS_POOLPROPS: 171 return (dgettext(TEXT_DOMAIN, "failed to retrieve " 172 "pool properties")); 173 case EZFS_POOL_NOTSUP: 174 return (dgettext(TEXT_DOMAIN, "operation not supported " 175 "on this type of pool")); 176 case EZFS_POOL_INVALARG: 177 return (dgettext(TEXT_DOMAIN, "invalid argument for " 178 "this pool operation")); 179 case EZFS_NAMETOOLONG: 180 return (dgettext(TEXT_DOMAIN, "dataset name is too long")); 181 case EZFS_OPENFAILED: 182 return (dgettext(TEXT_DOMAIN, "open failed")); 183 case EZFS_NOCAP: 184 return (dgettext(TEXT_DOMAIN, 185 "disk capacity information could not be retrieved")); 186 case EZFS_LABELFAILED: 187 return (dgettext(TEXT_DOMAIN, "write of label failed")); 188 case EZFS_BADWHO: 189 return (dgettext(TEXT_DOMAIN, "invalid user/group")); 190 case EZFS_BADPERM: 191 return (dgettext(TEXT_DOMAIN, "invalid permission")); 192 case EZFS_BADPERMSET: 193 return (dgettext(TEXT_DOMAIN, "invalid permission set name")); 194 case EZFS_NODELEGATION: 195 return (dgettext(TEXT_DOMAIN, "delegated administration is " 196 "disabled on pool")); 197 case EZFS_PERMRDONLY: 198 return (dgettext(TEXT_DOMAIN, "snapshot permissions cannot be" 199 " modified")); 200 case EZFS_BADCACHE: 201 return (dgettext(TEXT_DOMAIN, "invalid or missing cache file")); 202 case EZFS_ISL2CACHE: 203 return (dgettext(TEXT_DOMAIN, "device is in use as a cache")); 204 case EZFS_VDEVNOTSUP: 205 return (dgettext(TEXT_DOMAIN, "vdev specification is not " 206 "supported")); 207 case EZFS_NOTSUP: 208 return (dgettext(TEXT_DOMAIN, "operation not supported " 209 "on this dataset")); 210 case EZFS_ACTIVE_SPARE: 211 return (dgettext(TEXT_DOMAIN, "pool has active shared spare " 212 "device")); 213 case EZFS_UNKNOWN: 214 return (dgettext(TEXT_DOMAIN, "unknown error")); 215 default: 216 assert(hdl->libzfs_error == 0); 217 return (dgettext(TEXT_DOMAIN, "no error")); 218 } 219 } 220 221 /*PRINTFLIKE2*/ 222 void 223 zfs_error_aux(libzfs_handle_t *hdl, const char *fmt, ...) 224 { 225 va_list ap; 226 227 va_start(ap, fmt); 228 229 (void) vsnprintf(hdl->libzfs_desc, sizeof (hdl->libzfs_desc), 230 fmt, ap); 231 hdl->libzfs_desc_active = 1; 232 233 va_end(ap); 234 } 235 236 static void 237 zfs_verror(libzfs_handle_t *hdl, int error, const char *fmt, va_list ap) 238 { 239 (void) vsnprintf(hdl->libzfs_action, sizeof (hdl->libzfs_action), 240 fmt, ap); 241 hdl->libzfs_error = error; 242 243 if (hdl->libzfs_desc_active) 244 hdl->libzfs_desc_active = 0; 245 else 246 hdl->libzfs_desc[0] = '\0'; 247 248 if (hdl->libzfs_printerr) { 249 if (error == EZFS_UNKNOWN) { 250 (void) fprintf(stderr, dgettext(TEXT_DOMAIN, "internal " 251 "error: %s\n"), libzfs_error_description(hdl)); 252 abort(); 253 } 254 255 (void) fprintf(stderr, "%s: %s\n", hdl->libzfs_action, 256 libzfs_error_description(hdl)); 257 if (error == EZFS_NOMEM) 258 exit(1); 259 } 260 } 261 262 int 263 zfs_error(libzfs_handle_t *hdl, int error, const char *msg) 264 { 265 return (zfs_error_fmt(hdl, error, "%s", msg)); 266 } 267 268 /*PRINTFLIKE3*/ 269 int 270 zfs_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) 271 { 272 va_list ap; 273 274 va_start(ap, fmt); 275 276 zfs_verror(hdl, error, fmt, ap); 277 278 va_end(ap); 279 280 return (-1); 281 } 282 283 static int 284 zfs_common_error(libzfs_handle_t *hdl, int error, const char *fmt, 285 va_list ap) 286 { 287 switch (error) { 288 case EPERM: 289 case EACCES: 290 zfs_verror(hdl, EZFS_PERM, fmt, ap); 291 return (-1); 292 293 case ECANCELED: 294 zfs_verror(hdl, EZFS_NODELEGATION, fmt, ap); 295 return (-1); 296 297 case EIO: 298 zfs_verror(hdl, EZFS_IO, fmt, ap); 299 return (-1); 300 301 case EINTR: 302 zfs_verror(hdl, EZFS_INTR, fmt, ap); 303 return (-1); 304 } 305 306 return (0); 307 } 308 309 int 310 zfs_standard_error(libzfs_handle_t *hdl, int error, const char *msg) 311 { 312 return (zfs_standard_error_fmt(hdl, error, "%s", msg)); 313 } 314 315 /*PRINTFLIKE3*/ 316 int 317 zfs_standard_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) 318 { 319 va_list ap; 320 321 va_start(ap, fmt); 322 323 if (zfs_common_error(hdl, error, fmt, ap) != 0) { 324 va_end(ap); 325 return (-1); 326 } 327 328 switch (error) { 329 case ENXIO: 330 case ENODEV: 331 zfs_verror(hdl, EZFS_IO, fmt, ap); 332 break; 333 334 case ENOENT: 335 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 336 "dataset does not exist")); 337 zfs_verror(hdl, EZFS_NOENT, fmt, ap); 338 break; 339 340 case ENOSPC: 341 case EDQUOT: 342 zfs_verror(hdl, EZFS_NOSPC, fmt, ap); 343 return (-1); 344 345 case EEXIST: 346 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 347 "dataset already exists")); 348 zfs_verror(hdl, EZFS_EXISTS, fmt, ap); 349 break; 350 351 case EBUSY: 352 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 353 "dataset is busy")); 354 zfs_verror(hdl, EZFS_BUSY, fmt, ap); 355 break; 356 case EROFS: 357 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 358 "snapshot permissions cannot be modified")); 359 zfs_verror(hdl, EZFS_PERMRDONLY, fmt, ap); 360 break; 361 case ENAMETOOLONG: 362 zfs_verror(hdl, EZFS_NAMETOOLONG, fmt, ap); 363 break; 364 case ENOTSUP: 365 zfs_verror(hdl, EZFS_BADVERSION, fmt, ap); 366 break; 367 default: 368 zfs_error_aux(hdl, strerror(errno)); 369 zfs_verror(hdl, EZFS_UNKNOWN, fmt, ap); 370 break; 371 } 372 373 va_end(ap); 374 return (-1); 375 } 376 377 int 378 zpool_standard_error(libzfs_handle_t *hdl, int error, const char *msg) 379 { 380 return (zpool_standard_error_fmt(hdl, error, "%s", msg)); 381 } 382 383 /*PRINTFLIKE3*/ 384 int 385 zpool_standard_error_fmt(libzfs_handle_t *hdl, int error, const char *fmt, ...) 386 { 387 va_list ap; 388 389 va_start(ap, fmt); 390 391 if (zfs_common_error(hdl, error, fmt, ap) != 0) { 392 va_end(ap); 393 return (-1); 394 } 395 396 switch (error) { 397 case ENODEV: 398 zfs_verror(hdl, EZFS_NODEVICE, fmt, ap); 399 break; 400 401 case ENOENT: 402 zfs_error_aux(hdl, 403 dgettext(TEXT_DOMAIN, "no such pool or dataset")); 404 zfs_verror(hdl, EZFS_NOENT, fmt, ap); 405 break; 406 407 case EEXIST: 408 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 409 "pool already exists")); 410 zfs_verror(hdl, EZFS_EXISTS, fmt, ap); 411 break; 412 413 case EBUSY: 414 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, "pool is busy")); 415 zfs_verror(hdl, EZFS_BUSY, fmt, ap); 416 break; 417 418 case ENXIO: 419 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 420 "one or more devices is currently unavailable")); 421 zfs_verror(hdl, EZFS_BADDEV, fmt, ap); 422 break; 423 424 case ENAMETOOLONG: 425 zfs_verror(hdl, EZFS_DEVOVERFLOW, fmt, ap); 426 break; 427 428 case ENOTSUP: 429 zfs_verror(hdl, EZFS_POOL_NOTSUP, fmt, ap); 430 break; 431 432 case EINVAL: 433 zfs_verror(hdl, EZFS_POOL_INVALARG, fmt, ap); 434 break; 435 436 case ENOSPC: 437 case EDQUOT: 438 zfs_verror(hdl, EZFS_NOSPC, fmt, ap); 439 return (-1); 440 441 default: 442 zfs_error_aux(hdl, strerror(error)); 443 zfs_verror(hdl, EZFS_UNKNOWN, fmt, ap); 444 } 445 446 va_end(ap); 447 return (-1); 448 } 449 450 /* 451 * Display an out of memory error message and abort the current program. 452 */ 453 int 454 no_memory(libzfs_handle_t *hdl) 455 { 456 return (zfs_error(hdl, EZFS_NOMEM, "internal error")); 457 } 458 459 /* 460 * A safe form of malloc() which will die if the allocation fails. 461 */ 462 void * 463 zfs_alloc(libzfs_handle_t *hdl, size_t size) 464 { 465 void *data; 466 467 if ((data = calloc(1, size)) == NULL) 468 (void) no_memory(hdl); 469 470 return (data); 471 } 472 473 /* 474 * A safe form of realloc(), which also zeroes newly allocated space. 475 */ 476 void * 477 zfs_realloc(libzfs_handle_t *hdl, void *ptr, size_t oldsize, size_t newsize) 478 { 479 void *ret; 480 481 if ((ret = realloc(ptr, newsize)) == NULL) { 482 (void) no_memory(hdl); 483 free(ptr); 484 return (NULL); 485 } 486 487 bzero((char *)ret + oldsize, (newsize - oldsize)); 488 return (ret); 489 } 490 491 /* 492 * A safe form of strdup() which will die if the allocation fails. 493 */ 494 char * 495 zfs_strdup(libzfs_handle_t *hdl, const char *str) 496 { 497 char *ret; 498 499 if ((ret = strdup(str)) == NULL) 500 (void) no_memory(hdl); 501 502 return (ret); 503 } 504 505 /* 506 * Convert a number to an appropriately human-readable output. 507 */ 508 void 509 zfs_nicenum(uint64_t num, char *buf, size_t buflen) 510 { 511 uint64_t n = num; 512 int index = 0; 513 char u; 514 515 while (n >= 1024) { 516 n /= 1024; 517 index++; 518 } 519 520 u = " KMGTPE"[index]; 521 522 if (index == 0) { 523 (void) snprintf(buf, buflen, "%llu", n); 524 } else if ((num & ((1ULL << 10 * index) - 1)) == 0) { 525 /* 526 * If this is an even multiple of the base, always display 527 * without any decimal precision. 528 */ 529 (void) snprintf(buf, buflen, "%llu%c", n, u); 530 } else { 531 /* 532 * We want to choose a precision that reflects the best choice 533 * for fitting in 5 characters. This can get rather tricky when 534 * we have numbers that are very close to an order of magnitude. 535 * For example, when displaying 10239 (which is really 9.999K), 536 * we want only a single place of precision for 10.0K. We could 537 * develop some complex heuristics for this, but it's much 538 * easier just to try each combination in turn. 539 */ 540 int i; 541 for (i = 2; i >= 0; i--) { 542 if (snprintf(buf, buflen, "%.*f%c", i, 543 (double)num / (1ULL << 10 * index), u) <= 5) 544 break; 545 } 546 } 547 } 548 549 void 550 libzfs_print_on_error(libzfs_handle_t *hdl, boolean_t printerr) 551 { 552 hdl->libzfs_printerr = printerr; 553 } 554 555 libzfs_handle_t * 556 libzfs_init(void) 557 { 558 libzfs_handle_t *hdl; 559 560 if ((hdl = calloc(sizeof (libzfs_handle_t), 1)) == NULL) { 561 return (NULL); 562 } 563 564 if ((hdl->libzfs_fd = open(ZFS_DEV, O_RDWR)) < 0) { 565 free(hdl); 566 return (NULL); 567 } 568 569 if ((hdl->libzfs_mnttab = fopen(MNTTAB, "r")) == NULL) { 570 (void) close(hdl->libzfs_fd); 571 free(hdl); 572 return (NULL); 573 } 574 575 hdl->libzfs_sharetab = fopen("/etc/dfs/sharetab", "r"); 576 577 zfs_prop_init(); 578 zpool_prop_init(); 579 580 return (hdl); 581 } 582 583 void 584 libzfs_fini(libzfs_handle_t *hdl) 585 { 586 (void) close(hdl->libzfs_fd); 587 if (hdl->libzfs_mnttab) 588 (void) fclose(hdl->libzfs_mnttab); 589 if (hdl->libzfs_sharetab) 590 (void) fclose(hdl->libzfs_sharetab); 591 zfs_uninit_libshare(hdl); 592 if (hdl->libzfs_log_str) 593 (void) free(hdl->libzfs_log_str); 594 zpool_free_handles(hdl); 595 namespace_clear(hdl); 596 free(hdl); 597 } 598 599 libzfs_handle_t * 600 zpool_get_handle(zpool_handle_t *zhp) 601 { 602 return (zhp->zpool_hdl); 603 } 604 605 libzfs_handle_t * 606 zfs_get_handle(zfs_handle_t *zhp) 607 { 608 return (zhp->zfs_hdl); 609 } 610 611 /* 612 * Given a name, determine whether or not it's a valid path 613 * (starts with '/' or "./"). If so, walk the mnttab trying 614 * to match the device number. If not, treat the path as an 615 * fs/vol/snap name. 616 */ 617 zfs_handle_t * 618 zfs_path_to_zhandle(libzfs_handle_t *hdl, char *path, zfs_type_t argtype) 619 { 620 struct stat64 statbuf; 621 struct extmnttab entry; 622 int ret; 623 624 if (path[0] != '/' && strncmp(path, "./", strlen("./")) != 0) { 625 /* 626 * It's not a valid path, assume it's a name of type 'argtype'. 627 */ 628 return (zfs_open(hdl, path, argtype)); 629 } 630 631 if (stat64(path, &statbuf) != 0) { 632 (void) fprintf(stderr, "%s: %s\n", path, strerror(errno)); 633 return (NULL); 634 } 635 636 rewind(hdl->libzfs_mnttab); 637 while ((ret = getextmntent(hdl->libzfs_mnttab, &entry, 0)) == 0) { 638 if (makedevice(entry.mnt_major, entry.mnt_minor) == 639 statbuf.st_dev) { 640 break; 641 } 642 } 643 if (ret != 0) { 644 return (NULL); 645 } 646 647 if (strcmp(entry.mnt_fstype, MNTTYPE_ZFS) != 0) { 648 (void) fprintf(stderr, gettext("'%s': not a ZFS filesystem\n"), 649 path); 650 return (NULL); 651 } 652 653 return (zfs_open(hdl, entry.mnt_special, ZFS_TYPE_FILESYSTEM)); 654 } 655 656 /* 657 * Initialize the zc_nvlist_dst member to prepare for receiving an nvlist from 658 * an ioctl(). 659 */ 660 int 661 zcmd_alloc_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, size_t len) 662 { 663 if (len == 0) 664 len = 2048; 665 zc->zc_nvlist_dst_size = len; 666 if ((zc->zc_nvlist_dst = (uint64_t)(uintptr_t) 667 zfs_alloc(hdl, zc->zc_nvlist_dst_size)) == NULL) 668 return (-1); 669 670 return (0); 671 } 672 673 /* 674 * Called when an ioctl() which returns an nvlist fails with ENOMEM. This will 675 * expand the nvlist to the size specified in 'zc_nvlist_dst_size', which was 676 * filled in by the kernel to indicate the actual required size. 677 */ 678 int 679 zcmd_expand_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc) 680 { 681 free((void *)(uintptr_t)zc->zc_nvlist_dst); 682 if ((zc->zc_nvlist_dst = (uint64_t)(uintptr_t) 683 zfs_alloc(hdl, zc->zc_nvlist_dst_size)) 684 == NULL) 685 return (-1); 686 687 return (0); 688 } 689 690 /* 691 * Called to free the src and dst nvlists stored in the command structure. 692 */ 693 void 694 zcmd_free_nvlists(zfs_cmd_t *zc) 695 { 696 free((void *)(uintptr_t)zc->zc_nvlist_conf); 697 free((void *)(uintptr_t)zc->zc_nvlist_src); 698 free((void *)(uintptr_t)zc->zc_nvlist_dst); 699 } 700 701 static int 702 zcmd_write_nvlist_com(libzfs_handle_t *hdl, uint64_t *outnv, uint64_t *outlen, 703 nvlist_t *nvl) 704 { 705 char *packed; 706 size_t len; 707 708 verify(nvlist_size(nvl, &len, NV_ENCODE_NATIVE) == 0); 709 710 if ((packed = zfs_alloc(hdl, len)) == NULL) 711 return (-1); 712 713 verify(nvlist_pack(nvl, &packed, &len, NV_ENCODE_NATIVE, 0) == 0); 714 715 *outnv = (uint64_t)(uintptr_t)packed; 716 *outlen = len; 717 718 return (0); 719 } 720 721 int 722 zcmd_write_conf_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t *nvl) 723 { 724 return (zcmd_write_nvlist_com(hdl, &zc->zc_nvlist_conf, 725 &zc->zc_nvlist_conf_size, nvl)); 726 } 727 728 int 729 zcmd_write_src_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t *nvl) 730 { 731 return (zcmd_write_nvlist_com(hdl, &zc->zc_nvlist_src, 732 &zc->zc_nvlist_src_size, nvl)); 733 } 734 735 /* 736 * Unpacks an nvlist from the ZFS ioctl command structure. 737 */ 738 int 739 zcmd_read_dst_nvlist(libzfs_handle_t *hdl, zfs_cmd_t *zc, nvlist_t **nvlp) 740 { 741 if (nvlist_unpack((void *)(uintptr_t)zc->zc_nvlist_dst, 742 zc->zc_nvlist_dst_size, nvlp, 0) != 0) 743 return (no_memory(hdl)); 744 745 return (0); 746 } 747 748 int 749 zfs_ioctl(libzfs_handle_t *hdl, int request, zfs_cmd_t *zc) 750 { 751 int error; 752 753 zc->zc_history = (uint64_t)(uintptr_t)hdl->libzfs_log_str; 754 error = ioctl(hdl->libzfs_fd, request, zc); 755 if (hdl->libzfs_log_str) { 756 free(hdl->libzfs_log_str); 757 hdl->libzfs_log_str = NULL; 758 } 759 zc->zc_history = 0; 760 761 return (error); 762 } 763 764 /* 765 * ================================================================ 766 * API shared by zfs and zpool property management 767 * ================================================================ 768 */ 769 770 static void 771 zprop_print_headers(zprop_get_cbdata_t *cbp, zfs_type_t type) 772 { 773 zprop_list_t *pl = cbp->cb_proplist; 774 int i; 775 char *title; 776 size_t len; 777 778 cbp->cb_first = B_FALSE; 779 if (cbp->cb_scripted) 780 return; 781 782 /* 783 * Start with the length of the column headers. 784 */ 785 cbp->cb_colwidths[GET_COL_NAME] = strlen(dgettext(TEXT_DOMAIN, "NAME")); 786 cbp->cb_colwidths[GET_COL_PROPERTY] = strlen(dgettext(TEXT_DOMAIN, 787 "PROPERTY")); 788 cbp->cb_colwidths[GET_COL_VALUE] = strlen(dgettext(TEXT_DOMAIN, 789 "VALUE")); 790 cbp->cb_colwidths[GET_COL_SOURCE] = strlen(dgettext(TEXT_DOMAIN, 791 "SOURCE")); 792 793 /* 794 * Go through and calculate the widths for each column. For the 795 * 'source' column, we kludge it up by taking the worst-case scenario of 796 * inheriting from the longest name. This is acceptable because in the 797 * majority of cases 'SOURCE' is the last column displayed, and we don't 798 * use the width anyway. Note that the 'VALUE' column can be oversized, 799 * if the name of the property is much longer the any values we find. 800 */ 801 for (pl = cbp->cb_proplist; pl != NULL; pl = pl->pl_next) { 802 /* 803 * 'PROPERTY' column 804 */ 805 if (pl->pl_prop != ZPROP_INVAL) { 806 const char *propname = (type == ZFS_TYPE_POOL) ? 807 zpool_prop_to_name(pl->pl_prop) : 808 zfs_prop_to_name(pl->pl_prop); 809 810 len = strlen(propname); 811 if (len > cbp->cb_colwidths[GET_COL_PROPERTY]) 812 cbp->cb_colwidths[GET_COL_PROPERTY] = len; 813 } else { 814 len = strlen(pl->pl_user_prop); 815 if (len > cbp->cb_colwidths[GET_COL_PROPERTY]) 816 cbp->cb_colwidths[GET_COL_PROPERTY] = len; 817 } 818 819 /* 820 * 'VALUE' column 821 */ 822 if ((pl->pl_prop != ZFS_PROP_NAME || !pl->pl_all) && 823 pl->pl_width > cbp->cb_colwidths[GET_COL_VALUE]) 824 cbp->cb_colwidths[GET_COL_VALUE] = pl->pl_width; 825 826 /* 827 * 'NAME' and 'SOURCE' columns 828 */ 829 if (pl->pl_prop == (type == ZFS_TYPE_POOL ? ZPOOL_PROP_NAME : 830 ZFS_PROP_NAME) && 831 pl->pl_width > cbp->cb_colwidths[GET_COL_NAME]) { 832 cbp->cb_colwidths[GET_COL_NAME] = pl->pl_width; 833 cbp->cb_colwidths[GET_COL_SOURCE] = pl->pl_width + 834 strlen(dgettext(TEXT_DOMAIN, "inherited from")); 835 } 836 } 837 838 /* 839 * Now go through and print the headers. 840 */ 841 for (i = 0; i < 4; i++) { 842 switch (cbp->cb_columns[i]) { 843 case GET_COL_NAME: 844 title = dgettext(TEXT_DOMAIN, "NAME"); 845 break; 846 case GET_COL_PROPERTY: 847 title = dgettext(TEXT_DOMAIN, "PROPERTY"); 848 break; 849 case GET_COL_VALUE: 850 title = dgettext(TEXT_DOMAIN, "VALUE"); 851 break; 852 case GET_COL_SOURCE: 853 title = dgettext(TEXT_DOMAIN, "SOURCE"); 854 break; 855 default: 856 title = NULL; 857 } 858 859 if (title != NULL) { 860 if (i == 3 || cbp->cb_columns[i + 1] == 0) 861 (void) printf("%s", title); 862 else 863 (void) printf("%-*s ", 864 cbp->cb_colwidths[cbp->cb_columns[i]], 865 title); 866 } 867 } 868 (void) printf("\n"); 869 } 870 871 /* 872 * Display a single line of output, according to the settings in the callback 873 * structure. 874 */ 875 void 876 zprop_print_one_property(const char *name, zprop_get_cbdata_t *cbp, 877 const char *propname, const char *value, zprop_source_t sourcetype, 878 const char *source) 879 { 880 int i; 881 const char *str; 882 char buf[128]; 883 884 /* 885 * Ignore those source types that the user has chosen to ignore. 886 */ 887 if ((sourcetype & cbp->cb_sources) == 0) 888 return; 889 890 if (cbp->cb_first) 891 zprop_print_headers(cbp, cbp->cb_type); 892 893 for (i = 0; i < 4; i++) { 894 switch (cbp->cb_columns[i]) { 895 case GET_COL_NAME: 896 str = name; 897 break; 898 899 case GET_COL_PROPERTY: 900 str = propname; 901 break; 902 903 case GET_COL_VALUE: 904 str = value; 905 break; 906 907 case GET_COL_SOURCE: 908 switch (sourcetype) { 909 case ZPROP_SRC_NONE: 910 str = "-"; 911 break; 912 913 case ZPROP_SRC_DEFAULT: 914 str = "default"; 915 break; 916 917 case ZPROP_SRC_LOCAL: 918 str = "local"; 919 break; 920 921 case ZPROP_SRC_TEMPORARY: 922 str = "temporary"; 923 break; 924 925 case ZPROP_SRC_INHERITED: 926 (void) snprintf(buf, sizeof (buf), 927 "inherited from %s", source); 928 str = buf; 929 break; 930 } 931 break; 932 933 default: 934 continue; 935 } 936 937 if (cbp->cb_columns[i + 1] == 0) 938 (void) printf("%s", str); 939 else if (cbp->cb_scripted) 940 (void) printf("%s\t", str); 941 else 942 (void) printf("%-*s ", 943 cbp->cb_colwidths[cbp->cb_columns[i]], 944 str); 945 946 } 947 948 (void) printf("\n"); 949 } 950 951 /* 952 * Given a numeric suffix, convert the value into a number of bits that the 953 * resulting value must be shifted. 954 */ 955 static int 956 str2shift(libzfs_handle_t *hdl, const char *buf) 957 { 958 const char *ends = "BKMGTPEZ"; 959 int i; 960 961 if (buf[0] == '\0') 962 return (0); 963 for (i = 0; i < strlen(ends); i++) { 964 if (toupper(buf[0]) == ends[i]) 965 break; 966 } 967 if (i == strlen(ends)) { 968 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 969 "invalid numeric suffix '%s'"), buf); 970 return (-1); 971 } 972 973 /* 974 * We want to allow trailing 'b' characters for 'GB' or 'Mb'. But don't 975 * allow 'BB' - that's just weird. 976 */ 977 if (buf[1] == '\0' || (toupper(buf[1]) == 'B' && buf[2] == '\0' && 978 toupper(buf[0]) != 'B')) 979 return (10*i); 980 981 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 982 "invalid numeric suffix '%s'"), buf); 983 return (-1); 984 } 985 986 /* 987 * Convert a string of the form '100G' into a real number. Used when setting 988 * properties or creating a volume. 'buf' is used to place an extended error 989 * message for the caller to use. 990 */ 991 int 992 zfs_nicestrtonum(libzfs_handle_t *hdl, const char *value, uint64_t *num) 993 { 994 char *end; 995 int shift; 996 997 *num = 0; 998 999 /* Check to see if this looks like a number. */ 1000 if ((value[0] < '0' || value[0] > '9') && value[0] != '.') { 1001 if (hdl) 1002 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1003 "bad numeric value '%s'"), value); 1004 return (-1); 1005 } 1006 1007 /* Rely on stroll() to process the numeric portion. */ 1008 errno = 0; 1009 *num = strtoll(value, &end, 10); 1010 1011 /* 1012 * Check for ERANGE, which indicates that the value is too large to fit 1013 * in a 64-bit value. 1014 */ 1015 if (errno == ERANGE) { 1016 if (hdl) 1017 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1018 "numeric value is too large")); 1019 return (-1); 1020 } 1021 1022 /* 1023 * If we have a decimal value, then do the computation with floating 1024 * point arithmetic. Otherwise, use standard arithmetic. 1025 */ 1026 if (*end == '.') { 1027 double fval = strtod(value, &end); 1028 1029 if ((shift = str2shift(hdl, end)) == -1) 1030 return (-1); 1031 1032 fval *= pow(2, shift); 1033 1034 if (fval > UINT64_MAX) { 1035 if (hdl) 1036 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1037 "numeric value is too large")); 1038 return (-1); 1039 } 1040 1041 *num = (uint64_t)fval; 1042 } else { 1043 if ((shift = str2shift(hdl, end)) == -1) 1044 return (-1); 1045 1046 /* Check for overflow */ 1047 if (shift >= 64 || (*num << shift) >> shift != *num) { 1048 if (hdl) 1049 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1050 "numeric value is too large")); 1051 return (-1); 1052 } 1053 1054 *num <<= shift; 1055 } 1056 1057 return (0); 1058 } 1059 1060 /* 1061 * Given a propname=value nvpair to set, parse any numeric properties 1062 * (index, boolean, etc) if they are specified as strings and add the 1063 * resulting nvpair to the returned nvlist. 1064 * 1065 * At the DSL layer, all properties are either 64-bit numbers or strings. 1066 * We want the user to be able to ignore this fact and specify properties 1067 * as native values (numbers, for example) or as strings (to simplify 1068 * command line utilities). This also handles converting index types 1069 * (compression, checksum, etc) from strings to their on-disk index. 1070 */ 1071 int 1072 zprop_parse_value(libzfs_handle_t *hdl, nvpair_t *elem, int prop, 1073 zfs_type_t type, nvlist_t *ret, char **svalp, uint64_t *ivalp, 1074 const char *errbuf) 1075 { 1076 data_type_t datatype = nvpair_type(elem); 1077 zprop_type_t proptype; 1078 const char *propname; 1079 char *value; 1080 boolean_t isnone = B_FALSE; 1081 1082 if (type == ZFS_TYPE_POOL) { 1083 proptype = zpool_prop_get_type(prop); 1084 propname = zpool_prop_to_name(prop); 1085 } else { 1086 proptype = zfs_prop_get_type(prop); 1087 propname = zfs_prop_to_name(prop); 1088 } 1089 1090 /* 1091 * Convert any properties to the internal DSL value types. 1092 */ 1093 *svalp = NULL; 1094 *ivalp = 0; 1095 1096 switch (proptype) { 1097 case PROP_TYPE_STRING: 1098 if (datatype != DATA_TYPE_STRING) { 1099 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1100 "'%s' must be a string"), nvpair_name(elem)); 1101 goto error; 1102 } 1103 (void) nvpair_value_string(elem, svalp); 1104 if (strlen(*svalp) >= ZFS_MAXPROPLEN) { 1105 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1106 "'%s' is too long"), nvpair_name(elem)); 1107 goto error; 1108 } 1109 break; 1110 1111 case PROP_TYPE_NUMBER: 1112 if (datatype == DATA_TYPE_STRING) { 1113 (void) nvpair_value_string(elem, &value); 1114 if (strcmp(value, "none") == 0) { 1115 isnone = B_TRUE; 1116 } else if (zfs_nicestrtonum(hdl, value, ivalp) 1117 != 0) { 1118 goto error; 1119 } 1120 } else if (datatype == DATA_TYPE_UINT64) { 1121 (void) nvpair_value_uint64(elem, ivalp); 1122 } else { 1123 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1124 "'%s' must be a number"), nvpair_name(elem)); 1125 goto error; 1126 } 1127 1128 /* 1129 * Quota special: force 'none' and don't allow 0. 1130 */ 1131 if ((type & ZFS_TYPE_DATASET) && *ivalp == 0 && !isnone && 1132 (prop == ZFS_PROP_QUOTA || prop == ZFS_PROP_REFQUOTA)) { 1133 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1134 "use 'none' to disable quota/refquota")); 1135 goto error; 1136 } 1137 break; 1138 1139 case PROP_TYPE_INDEX: 1140 if (datatype != DATA_TYPE_STRING) { 1141 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1142 "'%s' must be a string"), nvpair_name(elem)); 1143 goto error; 1144 } 1145 1146 (void) nvpair_value_string(elem, &value); 1147 1148 if (zprop_string_to_index(prop, value, ivalp, type) != 0) { 1149 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1150 "'%s' must be one of '%s'"), propname, 1151 zprop_values(prop, type)); 1152 goto error; 1153 } 1154 break; 1155 1156 default: 1157 abort(); 1158 } 1159 1160 /* 1161 * Add the result to our return set of properties. 1162 */ 1163 if (*svalp != NULL) { 1164 if (nvlist_add_string(ret, propname, *svalp) != 0) { 1165 (void) no_memory(hdl); 1166 return (-1); 1167 } 1168 } else { 1169 if (nvlist_add_uint64(ret, propname, *ivalp) != 0) { 1170 (void) no_memory(hdl); 1171 return (-1); 1172 } 1173 } 1174 1175 return (0); 1176 error: 1177 (void) zfs_error(hdl, EZFS_BADPROP, errbuf); 1178 return (-1); 1179 } 1180 1181 /* 1182 * Given a comma-separated list of properties, construct a property list 1183 * containing both user-defined and native properties. This function will 1184 * return a NULL list if 'all' is specified, which can later be expanded 1185 * by zprop_expand_list(). 1186 */ 1187 int 1188 zprop_get_list(libzfs_handle_t *hdl, char *props, zprop_list_t **listp, 1189 zfs_type_t type) 1190 { 1191 size_t len; 1192 char *s, *p; 1193 char c; 1194 int prop; 1195 zprop_list_t *entry; 1196 zprop_list_t **last; 1197 1198 *listp = NULL; 1199 last = listp; 1200 1201 /* 1202 * If 'all' is specified, return a NULL list. 1203 */ 1204 if (strcmp(props, "all") == 0) 1205 return (0); 1206 1207 /* 1208 * If no props were specified, return an error. 1209 */ 1210 if (props[0] == '\0') { 1211 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1212 "no properties specified")); 1213 return (zfs_error(hdl, EZFS_BADPROP, dgettext(TEXT_DOMAIN, 1214 "bad property list"))); 1215 } 1216 1217 /* 1218 * It would be nice to use getsubopt() here, but the inclusion of column 1219 * aliases makes this more effort than it's worth. 1220 */ 1221 s = props; 1222 while (*s != '\0') { 1223 if ((p = strchr(s, ',')) == NULL) { 1224 len = strlen(s); 1225 p = s + len; 1226 } else { 1227 len = p - s; 1228 } 1229 1230 /* 1231 * Check for empty options. 1232 */ 1233 if (len == 0) { 1234 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1235 "empty property name")); 1236 return (zfs_error(hdl, EZFS_BADPROP, 1237 dgettext(TEXT_DOMAIN, "bad property list"))); 1238 } 1239 1240 /* 1241 * Check all regular property names. 1242 */ 1243 c = s[len]; 1244 s[len] = '\0'; 1245 prop = zprop_name_to_prop(s, type); 1246 1247 if (prop != ZPROP_INVAL && !zprop_valid_for_type(prop, type)) 1248 prop = ZPROP_INVAL; 1249 1250 /* 1251 * When no property table entry can be found, return failure if 1252 * this is a pool property or if this isn't a user-defined 1253 * dataset property, 1254 */ 1255 if (prop == ZPROP_INVAL && (type == ZFS_TYPE_POOL || 1256 !zfs_prop_user(s))) { 1257 zfs_error_aux(hdl, dgettext(TEXT_DOMAIN, 1258 "invalid property '%s'"), s); 1259 return (zfs_error(hdl, EZFS_BADPROP, 1260 dgettext(TEXT_DOMAIN, "bad property list"))); 1261 } 1262 1263 if ((entry = zfs_alloc(hdl, sizeof (zprop_list_t))) == NULL) 1264 return (-1); 1265 1266 entry->pl_prop = prop; 1267 if (prop == ZPROP_INVAL) { 1268 if ((entry->pl_user_prop = zfs_strdup(hdl, s)) 1269 == NULL) { 1270 free(entry); 1271 return (-1); 1272 } 1273 entry->pl_width = strlen(s); 1274 } else { 1275 entry->pl_width = zprop_width(prop, &entry->pl_fixed, 1276 type); 1277 } 1278 1279 *last = entry; 1280 last = &entry->pl_next; 1281 1282 s = p; 1283 if (c == ',') 1284 s++; 1285 } 1286 1287 return (0); 1288 } 1289 1290 void 1291 zprop_free_list(zprop_list_t *pl) 1292 { 1293 zprop_list_t *next; 1294 1295 while (pl != NULL) { 1296 next = pl->pl_next; 1297 free(pl->pl_user_prop); 1298 free(pl); 1299 pl = next; 1300 } 1301 } 1302 1303 typedef struct expand_data { 1304 zprop_list_t **last; 1305 libzfs_handle_t *hdl; 1306 zfs_type_t type; 1307 } expand_data_t; 1308 1309 int 1310 zprop_expand_list_cb(int prop, void *cb) 1311 { 1312 zprop_list_t *entry; 1313 expand_data_t *edp = cb; 1314 1315 if ((entry = zfs_alloc(edp->hdl, sizeof (zprop_list_t))) == NULL) 1316 return (ZPROP_INVAL); 1317 1318 entry->pl_prop = prop; 1319 entry->pl_width = zprop_width(prop, &entry->pl_fixed, edp->type); 1320 entry->pl_all = B_TRUE; 1321 1322 *(edp->last) = entry; 1323 edp->last = &entry->pl_next; 1324 1325 return (ZPROP_CONT); 1326 } 1327 1328 int 1329 zprop_expand_list(libzfs_handle_t *hdl, zprop_list_t **plp, zfs_type_t type) 1330 { 1331 zprop_list_t *entry; 1332 zprop_list_t **last; 1333 expand_data_t exp; 1334 1335 if (*plp == NULL) { 1336 /* 1337 * If this is the very first time we've been called for an 'all' 1338 * specification, expand the list to include all native 1339 * properties. 1340 */ 1341 last = plp; 1342 1343 exp.last = last; 1344 exp.hdl = hdl; 1345 exp.type = type; 1346 1347 if (zprop_iter_common(zprop_expand_list_cb, &exp, B_FALSE, 1348 B_FALSE, type) == ZPROP_INVAL) 1349 return (-1); 1350 1351 /* 1352 * Add 'name' to the beginning of the list, which is handled 1353 * specially. 1354 */ 1355 if ((entry = zfs_alloc(hdl, sizeof (zprop_list_t))) == NULL) 1356 return (-1); 1357 1358 entry->pl_prop = (type == ZFS_TYPE_POOL) ? ZPOOL_PROP_NAME : 1359 ZFS_PROP_NAME; 1360 entry->pl_width = zprop_width(entry->pl_prop, 1361 &entry->pl_fixed, type); 1362 entry->pl_all = B_TRUE; 1363 entry->pl_next = *plp; 1364 *plp = entry; 1365 } 1366 return (0); 1367 } 1368 1369 int 1370 zprop_iter(zprop_func func, void *cb, boolean_t show_all, boolean_t ordered, 1371 zfs_type_t type) 1372 { 1373 return (zprop_iter_common(func, cb, show_all, ordered, type)); 1374 } 1375