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