libzfs_dataset.c revision 289499
1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Copyright (c) 2013, Joyent, Inc. All rights reserved.
25 * Copyright (c) 2011, 2014 by Delphix. All rights reserved.
26 * Copyright (c) 2012 DEY Storage Systems, Inc.  All rights reserved.
27 * Copyright (c) 2011-2012 Pawel Jakub Dawidek <pawel@dawidek.net>.
28 * All rights reserved.
29 * Copyright (c) 2012 Martin Matuska <mm@FreeBSD.org>. All rights reserved.
30 * Copyright (c) 2013 Steven Hartland. All rights reserved.
31 * Copyright 2013 Nexenta Systems, Inc.  All rights reserved.
32 */
33
34#include <ctype.h>
35#include <errno.h>
36#include <libintl.h>
37#include <math.h>
38#include <stdio.h>
39#include <stdlib.h>
40#include <strings.h>
41#include <unistd.h>
42#include <stddef.h>
43#include <zone.h>
44#include <fcntl.h>
45#include <sys/mntent.h>
46#include <sys/mount.h>
47#include <priv.h>
48#include <pwd.h>
49#include <grp.h>
50#include <stddef.h>
51#include <idmap.h>
52
53#include <sys/dnode.h>
54#include <sys/spa.h>
55#include <sys/zap.h>
56#include <sys/misc.h>
57#include <libzfs.h>
58
59#include "zfs_namecheck.h"
60#include "zfs_prop.h"
61#include "libzfs_impl.h"
62#include "zfs_deleg.h"
63
64static int userquota_propname_decode(const char *propname, boolean_t zoned,
65    zfs_userquota_prop_t *typep, char *domain, int domainlen, uint64_t *ridp);
66
67/*
68 * Given a single type (not a mask of types), return the type in a human
69 * readable form.
70 */
71const char *
72zfs_type_to_name(zfs_type_t type)
73{
74	switch (type) {
75	case ZFS_TYPE_FILESYSTEM:
76		return (dgettext(TEXT_DOMAIN, "filesystem"));
77	case ZFS_TYPE_SNAPSHOT:
78		return (dgettext(TEXT_DOMAIN, "snapshot"));
79	case ZFS_TYPE_VOLUME:
80		return (dgettext(TEXT_DOMAIN, "volume"));
81	}
82
83	return (NULL);
84}
85
86/*
87 * Given a path and mask of ZFS types, return a string describing this dataset.
88 * This is used when we fail to open a dataset and we cannot get an exact type.
89 * We guess what the type would have been based on the path and the mask of
90 * acceptable types.
91 */
92static const char *
93path_to_str(const char *path, int types)
94{
95	/*
96	 * When given a single type, always report the exact type.
97	 */
98	if (types == ZFS_TYPE_SNAPSHOT)
99		return (dgettext(TEXT_DOMAIN, "snapshot"));
100	if (types == ZFS_TYPE_FILESYSTEM)
101		return (dgettext(TEXT_DOMAIN, "filesystem"));
102	if (types == ZFS_TYPE_VOLUME)
103		return (dgettext(TEXT_DOMAIN, "volume"));
104
105	/*
106	 * The user is requesting more than one type of dataset.  If this is the
107	 * case, consult the path itself.  If we're looking for a snapshot, and
108	 * a '@' is found, then report it as "snapshot".  Otherwise, remove the
109	 * snapshot attribute and try again.
110	 */
111	if (types & ZFS_TYPE_SNAPSHOT) {
112		if (strchr(path, '@') != NULL)
113			return (dgettext(TEXT_DOMAIN, "snapshot"));
114		return (path_to_str(path, types & ~ZFS_TYPE_SNAPSHOT));
115	}
116
117	/*
118	 * The user has requested either filesystems or volumes.
119	 * We have no way of knowing a priori what type this would be, so always
120	 * report it as "filesystem" or "volume", our two primitive types.
121	 */
122	if (types & ZFS_TYPE_FILESYSTEM)
123		return (dgettext(TEXT_DOMAIN, "filesystem"));
124
125	assert(types & ZFS_TYPE_VOLUME);
126	return (dgettext(TEXT_DOMAIN, "volume"));
127}
128
129/*
130 * Validate a ZFS path.  This is used even before trying to open the dataset, to
131 * provide a more meaningful error message.  We call zfs_error_aux() to
132 * explain exactly why the name was not valid.
133 */
134int
135zfs_validate_name(libzfs_handle_t *hdl, const char *path, int type,
136    boolean_t modifying)
137{
138	namecheck_err_t why;
139	char what;
140
141	(void) zfs_prop_get_table();
142	if (dataset_namecheck(path, &why, &what) != 0) {
143		if (hdl != NULL) {
144			switch (why) {
145			case NAME_ERR_TOOLONG:
146				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
147				    "name is too long"));
148				break;
149
150			case NAME_ERR_LEADING_SLASH:
151				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
152				    "leading slash in name"));
153				break;
154
155			case NAME_ERR_EMPTY_COMPONENT:
156				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
157				    "empty component in name"));
158				break;
159
160			case NAME_ERR_TRAILING_SLASH:
161				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
162				    "trailing slash in name"));
163				break;
164
165			case NAME_ERR_INVALCHAR:
166				zfs_error_aux(hdl,
167				    dgettext(TEXT_DOMAIN, "invalid character "
168				    "'%c' in name"), what);
169				break;
170
171			case NAME_ERR_MULTIPLE_AT:
172				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
173				    "multiple '@' delimiters in name"));
174				break;
175
176			case NAME_ERR_NOLETTER:
177				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
178				    "pool doesn't begin with a letter"));
179				break;
180
181			case NAME_ERR_RESERVED:
182				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
183				    "name is reserved"));
184				break;
185
186			case NAME_ERR_DISKLIKE:
187				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
188				    "reserved disk name"));
189				break;
190			}
191		}
192
193		return (0);
194	}
195
196	if (!(type & ZFS_TYPE_SNAPSHOT) && strchr(path, '@') != NULL) {
197		if (hdl != NULL)
198			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
199			    "snapshot delimiter '@' in filesystem name"));
200		return (0);
201	}
202
203	if (type == ZFS_TYPE_SNAPSHOT && strchr(path, '@') == NULL) {
204		if (hdl != NULL)
205			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
206			    "missing '@' delimiter in snapshot name"));
207		return (0);
208	}
209
210	if (modifying && strchr(path, '%') != NULL) {
211		if (hdl != NULL)
212			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
213			    "invalid character %c in name"), '%');
214		return (0);
215	}
216
217	return (-1);
218}
219
220int
221zfs_name_valid(const char *name, zfs_type_t type)
222{
223	if (type == ZFS_TYPE_POOL)
224		return (zpool_name_valid(NULL, B_FALSE, name));
225	return (zfs_validate_name(NULL, name, type, B_FALSE));
226}
227
228/*
229 * This function takes the raw DSL properties, and filters out the user-defined
230 * properties into a separate nvlist.
231 */
232static nvlist_t *
233process_user_props(zfs_handle_t *zhp, nvlist_t *props)
234{
235	libzfs_handle_t *hdl = zhp->zfs_hdl;
236	nvpair_t *elem;
237	nvlist_t *propval;
238	nvlist_t *nvl;
239
240	if (nvlist_alloc(&nvl, NV_UNIQUE_NAME, 0) != 0) {
241		(void) no_memory(hdl);
242		return (NULL);
243	}
244
245	elem = NULL;
246	while ((elem = nvlist_next_nvpair(props, elem)) != NULL) {
247		if (!zfs_prop_user(nvpair_name(elem)))
248			continue;
249
250		verify(nvpair_value_nvlist(elem, &propval) == 0);
251		if (nvlist_add_nvlist(nvl, nvpair_name(elem), propval) != 0) {
252			nvlist_free(nvl);
253			(void) no_memory(hdl);
254			return (NULL);
255		}
256	}
257
258	return (nvl);
259}
260
261static zpool_handle_t *
262zpool_add_handle(zfs_handle_t *zhp, const char *pool_name)
263{
264	libzfs_handle_t *hdl = zhp->zfs_hdl;
265	zpool_handle_t *zph;
266
267	if ((zph = zpool_open_canfail(hdl, pool_name)) != NULL) {
268		if (hdl->libzfs_pool_handles != NULL)
269			zph->zpool_next = hdl->libzfs_pool_handles;
270		hdl->libzfs_pool_handles = zph;
271	}
272	return (zph);
273}
274
275static zpool_handle_t *
276zpool_find_handle(zfs_handle_t *zhp, const char *pool_name, int len)
277{
278	libzfs_handle_t *hdl = zhp->zfs_hdl;
279	zpool_handle_t *zph = hdl->libzfs_pool_handles;
280
281	while ((zph != NULL) &&
282	    (strncmp(pool_name, zpool_get_name(zph), len) != 0))
283		zph = zph->zpool_next;
284	return (zph);
285}
286
287/*
288 * Returns a handle to the pool that contains the provided dataset.
289 * If a handle to that pool already exists then that handle is returned.
290 * Otherwise, a new handle is created and added to the list of handles.
291 */
292static zpool_handle_t *
293zpool_handle(zfs_handle_t *zhp)
294{
295	char *pool_name;
296	int len;
297	zpool_handle_t *zph;
298
299	len = strcspn(zhp->zfs_name, "/@#") + 1;
300	pool_name = zfs_alloc(zhp->zfs_hdl, len);
301	(void) strlcpy(pool_name, zhp->zfs_name, len);
302
303	zph = zpool_find_handle(zhp, pool_name, len);
304	if (zph == NULL)
305		zph = zpool_add_handle(zhp, pool_name);
306
307	free(pool_name);
308	return (zph);
309}
310
311void
312zpool_free_handles(libzfs_handle_t *hdl)
313{
314	zpool_handle_t *next, *zph = hdl->libzfs_pool_handles;
315
316	while (zph != NULL) {
317		next = zph->zpool_next;
318		zpool_close(zph);
319		zph = next;
320	}
321	hdl->libzfs_pool_handles = NULL;
322}
323
324/*
325 * Utility function to gather stats (objset and zpl) for the given object.
326 */
327static int
328get_stats_ioctl(zfs_handle_t *zhp, zfs_cmd_t *zc)
329{
330	libzfs_handle_t *hdl = zhp->zfs_hdl;
331
332	(void) strlcpy(zc->zc_name, zhp->zfs_name, sizeof (zc->zc_name));
333
334	while (ioctl(hdl->libzfs_fd, ZFS_IOC_OBJSET_STATS, zc) != 0) {
335		if (errno == ENOMEM) {
336			if (zcmd_expand_dst_nvlist(hdl, zc) != 0) {
337				return (-1);
338			}
339		} else {
340			return (-1);
341		}
342	}
343	return (0);
344}
345
346/*
347 * Utility function to get the received properties of the given object.
348 */
349static int
350get_recvd_props_ioctl(zfs_handle_t *zhp)
351{
352	libzfs_handle_t *hdl = zhp->zfs_hdl;
353	nvlist_t *recvdprops;
354	zfs_cmd_t zc = { 0 };
355	int err;
356
357	if (zcmd_alloc_dst_nvlist(hdl, &zc, 0) != 0)
358		return (-1);
359
360	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
361
362	while (ioctl(hdl->libzfs_fd, ZFS_IOC_OBJSET_RECVD_PROPS, &zc) != 0) {
363		if (errno == ENOMEM) {
364			if (zcmd_expand_dst_nvlist(hdl, &zc) != 0) {
365				return (-1);
366			}
367		} else {
368			zcmd_free_nvlists(&zc);
369			return (-1);
370		}
371	}
372
373	err = zcmd_read_dst_nvlist(zhp->zfs_hdl, &zc, &recvdprops);
374	zcmd_free_nvlists(&zc);
375	if (err != 0)
376		return (-1);
377
378	nvlist_free(zhp->zfs_recvd_props);
379	zhp->zfs_recvd_props = recvdprops;
380
381	return (0);
382}
383
384static int
385put_stats_zhdl(zfs_handle_t *zhp, zfs_cmd_t *zc)
386{
387	nvlist_t *allprops, *userprops;
388
389	zhp->zfs_dmustats = zc->zc_objset_stats; /* structure assignment */
390
391	if (zcmd_read_dst_nvlist(zhp->zfs_hdl, zc, &allprops) != 0) {
392		return (-1);
393	}
394
395	/*
396	 * XXX Why do we store the user props separately, in addition to
397	 * storing them in zfs_props?
398	 */
399	if ((userprops = process_user_props(zhp, allprops)) == NULL) {
400		nvlist_free(allprops);
401		return (-1);
402	}
403
404	nvlist_free(zhp->zfs_props);
405	nvlist_free(zhp->zfs_user_props);
406
407	zhp->zfs_props = allprops;
408	zhp->zfs_user_props = userprops;
409
410	return (0);
411}
412
413static int
414get_stats(zfs_handle_t *zhp)
415{
416	int rc = 0;
417	zfs_cmd_t zc = { 0 };
418
419	if (zcmd_alloc_dst_nvlist(zhp->zfs_hdl, &zc, 0) != 0)
420		return (-1);
421	if (get_stats_ioctl(zhp, &zc) != 0)
422		rc = -1;
423	else if (put_stats_zhdl(zhp, &zc) != 0)
424		rc = -1;
425	zcmd_free_nvlists(&zc);
426	return (rc);
427}
428
429/*
430 * Refresh the properties currently stored in the handle.
431 */
432void
433zfs_refresh_properties(zfs_handle_t *zhp)
434{
435	(void) get_stats(zhp);
436}
437
438/*
439 * Makes a handle from the given dataset name.  Used by zfs_open() and
440 * zfs_iter_* to create child handles on the fly.
441 */
442static int
443make_dataset_handle_common(zfs_handle_t *zhp, zfs_cmd_t *zc)
444{
445	if (put_stats_zhdl(zhp, zc) != 0)
446		return (-1);
447
448	/*
449	 * We've managed to open the dataset and gather statistics.  Determine
450	 * the high-level type.
451	 */
452	if (zhp->zfs_dmustats.dds_type == DMU_OST_ZVOL)
453		zhp->zfs_head_type = ZFS_TYPE_VOLUME;
454	else if (zhp->zfs_dmustats.dds_type == DMU_OST_ZFS)
455		zhp->zfs_head_type = ZFS_TYPE_FILESYSTEM;
456	else
457		abort();
458
459	if (zhp->zfs_dmustats.dds_is_snapshot)
460		zhp->zfs_type = ZFS_TYPE_SNAPSHOT;
461	else if (zhp->zfs_dmustats.dds_type == DMU_OST_ZVOL)
462		zhp->zfs_type = ZFS_TYPE_VOLUME;
463	else if (zhp->zfs_dmustats.dds_type == DMU_OST_ZFS)
464		zhp->zfs_type = ZFS_TYPE_FILESYSTEM;
465	else
466		abort();	/* we should never see any other types */
467
468	if ((zhp->zpool_hdl = zpool_handle(zhp)) == NULL)
469		return (-1);
470
471	return (0);
472}
473
474zfs_handle_t *
475make_dataset_handle(libzfs_handle_t *hdl, const char *path)
476{
477	zfs_cmd_t zc = { 0 };
478
479	zfs_handle_t *zhp = calloc(sizeof (zfs_handle_t), 1);
480
481	if (zhp == NULL)
482		return (NULL);
483
484	zhp->zfs_hdl = hdl;
485	(void) strlcpy(zhp->zfs_name, path, sizeof (zhp->zfs_name));
486	if (zcmd_alloc_dst_nvlist(hdl, &zc, 0) != 0) {
487		free(zhp);
488		return (NULL);
489	}
490	if (get_stats_ioctl(zhp, &zc) == -1) {
491		zcmd_free_nvlists(&zc);
492		free(zhp);
493		return (NULL);
494	}
495	if (make_dataset_handle_common(zhp, &zc) == -1) {
496		free(zhp);
497		zhp = NULL;
498	}
499	zcmd_free_nvlists(&zc);
500	return (zhp);
501}
502
503zfs_handle_t *
504make_dataset_handle_zc(libzfs_handle_t *hdl, zfs_cmd_t *zc)
505{
506	zfs_handle_t *zhp = calloc(sizeof (zfs_handle_t), 1);
507
508	if (zhp == NULL)
509		return (NULL);
510
511	zhp->zfs_hdl = hdl;
512	(void) strlcpy(zhp->zfs_name, zc->zc_name, sizeof (zhp->zfs_name));
513	if (make_dataset_handle_common(zhp, zc) == -1) {
514		free(zhp);
515		return (NULL);
516	}
517	return (zhp);
518}
519
520zfs_handle_t *
521make_dataset_simple_handle_zc(zfs_handle_t *pzhp, zfs_cmd_t *zc)
522{
523	zfs_handle_t *zhp = calloc(sizeof (zfs_handle_t), 1);
524
525	if (zhp == NULL)
526		return (NULL);
527
528	zhp->zfs_hdl = pzhp->zfs_hdl;
529	(void) strlcpy(zhp->zfs_name, zc->zc_name, sizeof (zhp->zfs_name));
530	zhp->zfs_head_type = pzhp->zfs_type;
531	zhp->zfs_type = ZFS_TYPE_SNAPSHOT;
532	zhp->zpool_hdl = zpool_handle(zhp);
533	return (zhp);
534}
535
536zfs_handle_t *
537zfs_handle_dup(zfs_handle_t *zhp_orig)
538{
539	zfs_handle_t *zhp = calloc(sizeof (zfs_handle_t), 1);
540
541	if (zhp == NULL)
542		return (NULL);
543
544	zhp->zfs_hdl = zhp_orig->zfs_hdl;
545	zhp->zpool_hdl = zhp_orig->zpool_hdl;
546	(void) strlcpy(zhp->zfs_name, zhp_orig->zfs_name,
547	    sizeof (zhp->zfs_name));
548	zhp->zfs_type = zhp_orig->zfs_type;
549	zhp->zfs_head_type = zhp_orig->zfs_head_type;
550	zhp->zfs_dmustats = zhp_orig->zfs_dmustats;
551	if (zhp_orig->zfs_props != NULL) {
552		if (nvlist_dup(zhp_orig->zfs_props, &zhp->zfs_props, 0) != 0) {
553			(void) no_memory(zhp->zfs_hdl);
554			zfs_close(zhp);
555			return (NULL);
556		}
557	}
558	if (zhp_orig->zfs_user_props != NULL) {
559		if (nvlist_dup(zhp_orig->zfs_user_props,
560		    &zhp->zfs_user_props, 0) != 0) {
561			(void) no_memory(zhp->zfs_hdl);
562			zfs_close(zhp);
563			return (NULL);
564		}
565	}
566	if (zhp_orig->zfs_recvd_props != NULL) {
567		if (nvlist_dup(zhp_orig->zfs_recvd_props,
568		    &zhp->zfs_recvd_props, 0)) {
569			(void) no_memory(zhp->zfs_hdl);
570			zfs_close(zhp);
571			return (NULL);
572		}
573	}
574	zhp->zfs_mntcheck = zhp_orig->zfs_mntcheck;
575	if (zhp_orig->zfs_mntopts != NULL) {
576		zhp->zfs_mntopts = zfs_strdup(zhp_orig->zfs_hdl,
577		    zhp_orig->zfs_mntopts);
578	}
579	zhp->zfs_props_table = zhp_orig->zfs_props_table;
580	return (zhp);
581}
582
583boolean_t
584zfs_bookmark_exists(const char *path)
585{
586	nvlist_t *bmarks;
587	nvlist_t *props;
588	char fsname[ZFS_MAXNAMELEN];
589	char *bmark_name;
590	char *pound;
591	int err;
592	boolean_t rv;
593
594
595	(void) strlcpy(fsname, path, sizeof (fsname));
596	pound = strchr(fsname, '#');
597	if (pound == NULL)
598		return (B_FALSE);
599
600	*pound = '\0';
601	bmark_name = pound + 1;
602	props = fnvlist_alloc();
603	err = lzc_get_bookmarks(fsname, props, &bmarks);
604	nvlist_free(props);
605	if (err != 0) {
606		nvlist_free(bmarks);
607		return (B_FALSE);
608	}
609
610	rv = nvlist_exists(bmarks, bmark_name);
611	nvlist_free(bmarks);
612	return (rv);
613}
614
615zfs_handle_t *
616make_bookmark_handle(zfs_handle_t *parent, const char *path,
617    nvlist_t *bmark_props)
618{
619	zfs_handle_t *zhp = calloc(sizeof (zfs_handle_t), 1);
620
621	if (zhp == NULL)
622		return (NULL);
623
624	/* Fill in the name. */
625	zhp->zfs_hdl = parent->zfs_hdl;
626	(void) strlcpy(zhp->zfs_name, path, sizeof (zhp->zfs_name));
627
628	/* Set the property lists. */
629	if (nvlist_dup(bmark_props, &zhp->zfs_props, 0) != 0) {
630		free(zhp);
631		return (NULL);
632	}
633
634	/* Set the types. */
635	zhp->zfs_head_type = parent->zfs_head_type;
636	zhp->zfs_type = ZFS_TYPE_BOOKMARK;
637
638	if ((zhp->zpool_hdl = zpool_handle(zhp)) == NULL) {
639		nvlist_free(zhp->zfs_props);
640		free(zhp);
641		return (NULL);
642	}
643
644	return (zhp);
645}
646
647/*
648 * Opens the given snapshot, filesystem, or volume.   The 'types'
649 * argument is a mask of acceptable types.  The function will print an
650 * appropriate error message and return NULL if it can't be opened.
651 */
652zfs_handle_t *
653zfs_open(libzfs_handle_t *hdl, const char *path, int types)
654{
655	zfs_handle_t *zhp;
656	char errbuf[1024];
657
658	(void) snprintf(errbuf, sizeof (errbuf),
659	    dgettext(TEXT_DOMAIN, "cannot open '%s'"), path);
660
661	/*
662	 * Validate the name before we even try to open it.
663	 */
664	if (!zfs_validate_name(hdl, path, ZFS_TYPE_DATASET, B_FALSE)) {
665		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
666		    "invalid dataset name"));
667		(void) zfs_error(hdl, EZFS_INVALIDNAME, errbuf);
668		return (NULL);
669	}
670
671	/*
672	 * Try to get stats for the dataset, which will tell us if it exists.
673	 */
674	errno = 0;
675	if ((zhp = make_dataset_handle(hdl, path)) == NULL) {
676		(void) zfs_standard_error(hdl, errno, errbuf);
677		return (NULL);
678	}
679
680	if (zhp == NULL) {
681		char *at = strchr(path, '@');
682
683		if (at != NULL)
684			*at = '\0';
685		errno = 0;
686		if ((zhp = make_dataset_handle(hdl, path)) == NULL) {
687			(void) zfs_standard_error(hdl, errno, errbuf);
688			return (NULL);
689		}
690		if (at != NULL)
691			*at = '@';
692		(void) strlcpy(zhp->zfs_name, path, sizeof (zhp->zfs_name));
693		zhp->zfs_type = ZFS_TYPE_SNAPSHOT;
694	}
695
696	if (!(types & zhp->zfs_type)) {
697		(void) zfs_error(hdl, EZFS_BADTYPE, errbuf);
698		zfs_close(zhp);
699		return (NULL);
700	}
701
702	return (zhp);
703}
704
705/*
706 * Release a ZFS handle.  Nothing to do but free the associated memory.
707 */
708void
709zfs_close(zfs_handle_t *zhp)
710{
711	if (zhp->zfs_mntopts)
712		free(zhp->zfs_mntopts);
713	nvlist_free(zhp->zfs_props);
714	nvlist_free(zhp->zfs_user_props);
715	nvlist_free(zhp->zfs_recvd_props);
716	free(zhp);
717}
718
719typedef struct mnttab_node {
720	struct mnttab mtn_mt;
721	avl_node_t mtn_node;
722} mnttab_node_t;
723
724static int
725libzfs_mnttab_cache_compare(const void *arg1, const void *arg2)
726{
727	const mnttab_node_t *mtn1 = arg1;
728	const mnttab_node_t *mtn2 = arg2;
729	int rv;
730
731	rv = strcmp(mtn1->mtn_mt.mnt_special, mtn2->mtn_mt.mnt_special);
732
733	if (rv == 0)
734		return (0);
735	return (rv > 0 ? 1 : -1);
736}
737
738void
739libzfs_mnttab_init(libzfs_handle_t *hdl)
740{
741	assert(avl_numnodes(&hdl->libzfs_mnttab_cache) == 0);
742	avl_create(&hdl->libzfs_mnttab_cache, libzfs_mnttab_cache_compare,
743	    sizeof (mnttab_node_t), offsetof(mnttab_node_t, mtn_node));
744}
745
746void
747libzfs_mnttab_update(libzfs_handle_t *hdl)
748{
749	struct mnttab entry;
750
751	rewind(hdl->libzfs_mnttab);
752	while (getmntent(hdl->libzfs_mnttab, &entry) == 0) {
753		mnttab_node_t *mtn;
754
755		if (strcmp(entry.mnt_fstype, MNTTYPE_ZFS) != 0)
756			continue;
757		mtn = zfs_alloc(hdl, sizeof (mnttab_node_t));
758		mtn->mtn_mt.mnt_special = zfs_strdup(hdl, entry.mnt_special);
759		mtn->mtn_mt.mnt_mountp = zfs_strdup(hdl, entry.mnt_mountp);
760		mtn->mtn_mt.mnt_fstype = zfs_strdup(hdl, entry.mnt_fstype);
761		mtn->mtn_mt.mnt_mntopts = zfs_strdup(hdl, entry.mnt_mntopts);
762		avl_add(&hdl->libzfs_mnttab_cache, mtn);
763	}
764}
765
766void
767libzfs_mnttab_fini(libzfs_handle_t *hdl)
768{
769	void *cookie = NULL;
770	mnttab_node_t *mtn;
771
772	while (mtn = avl_destroy_nodes(&hdl->libzfs_mnttab_cache, &cookie)) {
773		free(mtn->mtn_mt.mnt_special);
774		free(mtn->mtn_mt.mnt_mountp);
775		free(mtn->mtn_mt.mnt_fstype);
776		free(mtn->mtn_mt.mnt_mntopts);
777		free(mtn);
778	}
779	avl_destroy(&hdl->libzfs_mnttab_cache);
780}
781
782void
783libzfs_mnttab_cache(libzfs_handle_t *hdl, boolean_t enable)
784{
785	hdl->libzfs_mnttab_enable = enable;
786}
787
788int
789libzfs_mnttab_find(libzfs_handle_t *hdl, const char *fsname,
790    struct mnttab *entry)
791{
792	mnttab_node_t find;
793	mnttab_node_t *mtn;
794
795	if (!hdl->libzfs_mnttab_enable) {
796		struct mnttab srch = { 0 };
797
798		if (avl_numnodes(&hdl->libzfs_mnttab_cache))
799			libzfs_mnttab_fini(hdl);
800		rewind(hdl->libzfs_mnttab);
801		srch.mnt_special = (char *)fsname;
802		srch.mnt_fstype = MNTTYPE_ZFS;
803		if (getmntany(hdl->libzfs_mnttab, entry, &srch) == 0)
804			return (0);
805		else
806			return (ENOENT);
807	}
808
809	if (avl_numnodes(&hdl->libzfs_mnttab_cache) == 0)
810		libzfs_mnttab_update(hdl);
811
812	find.mtn_mt.mnt_special = (char *)fsname;
813	mtn = avl_find(&hdl->libzfs_mnttab_cache, &find, NULL);
814	if (mtn) {
815		*entry = mtn->mtn_mt;
816		return (0);
817	}
818	return (ENOENT);
819}
820
821void
822libzfs_mnttab_add(libzfs_handle_t *hdl, const char *special,
823    const char *mountp, const char *mntopts)
824{
825	mnttab_node_t *mtn;
826
827	if (avl_numnodes(&hdl->libzfs_mnttab_cache) == 0)
828		return;
829	mtn = zfs_alloc(hdl, sizeof (mnttab_node_t));
830	mtn->mtn_mt.mnt_special = zfs_strdup(hdl, special);
831	mtn->mtn_mt.mnt_mountp = zfs_strdup(hdl, mountp);
832	mtn->mtn_mt.mnt_fstype = zfs_strdup(hdl, MNTTYPE_ZFS);
833	mtn->mtn_mt.mnt_mntopts = zfs_strdup(hdl, mntopts);
834	avl_add(&hdl->libzfs_mnttab_cache, mtn);
835}
836
837void
838libzfs_mnttab_remove(libzfs_handle_t *hdl, const char *fsname)
839{
840	mnttab_node_t find;
841	mnttab_node_t *ret;
842
843	find.mtn_mt.mnt_special = (char *)fsname;
844	if (ret = avl_find(&hdl->libzfs_mnttab_cache, (void *)&find, NULL)) {
845		avl_remove(&hdl->libzfs_mnttab_cache, ret);
846		free(ret->mtn_mt.mnt_special);
847		free(ret->mtn_mt.mnt_mountp);
848		free(ret->mtn_mt.mnt_fstype);
849		free(ret->mtn_mt.mnt_mntopts);
850		free(ret);
851	}
852}
853
854int
855zfs_spa_version(zfs_handle_t *zhp, int *spa_version)
856{
857	zpool_handle_t *zpool_handle = zhp->zpool_hdl;
858
859	if (zpool_handle == NULL)
860		return (-1);
861
862	*spa_version = zpool_get_prop_int(zpool_handle,
863	    ZPOOL_PROP_VERSION, NULL);
864	return (0);
865}
866
867/*
868 * The choice of reservation property depends on the SPA version.
869 */
870static int
871zfs_which_resv_prop(zfs_handle_t *zhp, zfs_prop_t *resv_prop)
872{
873	int spa_version;
874
875	if (zfs_spa_version(zhp, &spa_version) < 0)
876		return (-1);
877
878	if (spa_version >= SPA_VERSION_REFRESERVATION)
879		*resv_prop = ZFS_PROP_REFRESERVATION;
880	else
881		*resv_prop = ZFS_PROP_RESERVATION;
882
883	return (0);
884}
885
886/*
887 * Given an nvlist of properties to set, validates that they are correct, and
888 * parses any numeric properties (index, boolean, etc) if they are specified as
889 * strings.
890 */
891nvlist_t *
892zfs_valid_proplist(libzfs_handle_t *hdl, zfs_type_t type, nvlist_t *nvl,
893    uint64_t zoned, zfs_handle_t *zhp, const char *errbuf)
894{
895	nvpair_t *elem;
896	uint64_t intval;
897	char *strval;
898	zfs_prop_t prop;
899	nvlist_t *ret;
900	int chosen_normal = -1;
901	int chosen_utf = -1;
902
903	if (nvlist_alloc(&ret, NV_UNIQUE_NAME, 0) != 0) {
904		(void) no_memory(hdl);
905		return (NULL);
906	}
907
908	/*
909	 * Make sure this property is valid and applies to this type.
910	 */
911
912	elem = NULL;
913	while ((elem = nvlist_next_nvpair(nvl, elem)) != NULL) {
914		const char *propname = nvpair_name(elem);
915
916		prop = zfs_name_to_prop(propname);
917		if (prop == ZPROP_INVAL && zfs_prop_user(propname)) {
918			/*
919			 * This is a user property: make sure it's a
920			 * string, and that it's less than ZAP_MAXNAMELEN.
921			 */
922			if (nvpair_type(elem) != DATA_TYPE_STRING) {
923				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
924				    "'%s' must be a string"), propname);
925				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
926				goto error;
927			}
928
929			if (strlen(nvpair_name(elem)) >= ZAP_MAXNAMELEN) {
930				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
931				    "property name '%s' is too long"),
932				    propname);
933				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
934				goto error;
935			}
936
937			(void) nvpair_value_string(elem, &strval);
938			if (nvlist_add_string(ret, propname, strval) != 0) {
939				(void) no_memory(hdl);
940				goto error;
941			}
942			continue;
943		}
944
945		/*
946		 * Currently, only user properties can be modified on
947		 * snapshots.
948		 */
949		if (type == ZFS_TYPE_SNAPSHOT) {
950			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
951			    "this property can not be modified for snapshots"));
952			(void) zfs_error(hdl, EZFS_PROPTYPE, errbuf);
953			goto error;
954		}
955
956		if (prop == ZPROP_INVAL && zfs_prop_userquota(propname)) {
957			zfs_userquota_prop_t uqtype;
958			char newpropname[128];
959			char domain[128];
960			uint64_t rid;
961			uint64_t valary[3];
962
963			if (userquota_propname_decode(propname, zoned,
964			    &uqtype, domain, sizeof (domain), &rid) != 0) {
965				zfs_error_aux(hdl,
966				    dgettext(TEXT_DOMAIN,
967				    "'%s' has an invalid user/group name"),
968				    propname);
969				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
970				goto error;
971			}
972
973			if (uqtype != ZFS_PROP_USERQUOTA &&
974			    uqtype != ZFS_PROP_GROUPQUOTA) {
975				zfs_error_aux(hdl,
976				    dgettext(TEXT_DOMAIN, "'%s' is readonly"),
977				    propname);
978				(void) zfs_error(hdl, EZFS_PROPREADONLY,
979				    errbuf);
980				goto error;
981			}
982
983			if (nvpair_type(elem) == DATA_TYPE_STRING) {
984				(void) nvpair_value_string(elem, &strval);
985				if (strcmp(strval, "none") == 0) {
986					intval = 0;
987				} else if (zfs_nicestrtonum(hdl,
988				    strval, &intval) != 0) {
989					(void) zfs_error(hdl,
990					    EZFS_BADPROP, errbuf);
991					goto error;
992				}
993			} else if (nvpair_type(elem) ==
994			    DATA_TYPE_UINT64) {
995				(void) nvpair_value_uint64(elem, &intval);
996				if (intval == 0) {
997					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
998					    "use 'none' to disable "
999					    "userquota/groupquota"));
1000					goto error;
1001				}
1002			} else {
1003				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1004				    "'%s' must be a number"), propname);
1005				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1006				goto error;
1007			}
1008
1009			/*
1010			 * Encode the prop name as
1011			 * userquota@<hex-rid>-domain, to make it easy
1012			 * for the kernel to decode.
1013			 */
1014			(void) snprintf(newpropname, sizeof (newpropname),
1015			    "%s%llx-%s", zfs_userquota_prop_prefixes[uqtype],
1016			    (longlong_t)rid, domain);
1017			valary[0] = uqtype;
1018			valary[1] = rid;
1019			valary[2] = intval;
1020			if (nvlist_add_uint64_array(ret, newpropname,
1021			    valary, 3) != 0) {
1022				(void) no_memory(hdl);
1023				goto error;
1024			}
1025			continue;
1026		} else if (prop == ZPROP_INVAL && zfs_prop_written(propname)) {
1027			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1028			    "'%s' is readonly"),
1029			    propname);
1030			(void) zfs_error(hdl, EZFS_PROPREADONLY, errbuf);
1031			goto error;
1032		}
1033
1034		if (prop == ZPROP_INVAL) {
1035			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1036			    "invalid property '%s'"), propname);
1037			(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1038			goto error;
1039		}
1040
1041		if (!zfs_prop_valid_for_type(prop, type)) {
1042			zfs_error_aux(hdl,
1043			    dgettext(TEXT_DOMAIN, "'%s' does not "
1044			    "apply to datasets of this type"), propname);
1045			(void) zfs_error(hdl, EZFS_PROPTYPE, errbuf);
1046			goto error;
1047		}
1048
1049		if (zfs_prop_readonly(prop) &&
1050		    (!zfs_prop_setonce(prop) || zhp != NULL)) {
1051			zfs_error_aux(hdl,
1052			    dgettext(TEXT_DOMAIN, "'%s' is readonly"),
1053			    propname);
1054			(void) zfs_error(hdl, EZFS_PROPREADONLY, errbuf);
1055			goto error;
1056		}
1057
1058		if (zprop_parse_value(hdl, elem, prop, type, ret,
1059		    &strval, &intval, errbuf) != 0)
1060			goto error;
1061
1062		/*
1063		 * Perform some additional checks for specific properties.
1064		 */
1065		switch (prop) {
1066		case ZFS_PROP_VERSION:
1067		{
1068			int version;
1069
1070			if (zhp == NULL)
1071				break;
1072			version = zfs_prop_get_int(zhp, ZFS_PROP_VERSION);
1073			if (intval < version) {
1074				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1075				    "Can not downgrade; already at version %u"),
1076				    version);
1077				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1078				goto error;
1079			}
1080			break;
1081		}
1082
1083		case ZFS_PROP_VOLBLOCKSIZE:
1084		case ZFS_PROP_RECORDSIZE:
1085		{
1086			int maxbs = SPA_MAXBLOCKSIZE;
1087			if (zhp != NULL) {
1088				maxbs = zpool_get_prop_int(zhp->zpool_hdl,
1089				    ZPOOL_PROP_MAXBLOCKSIZE, NULL);
1090			}
1091			/*
1092			 * Volumes are limited to a volblocksize of 128KB,
1093			 * because they typically service workloads with
1094			 * small random writes, which incur a large performance
1095			 * penalty with large blocks.
1096			 */
1097			if (prop == ZFS_PROP_VOLBLOCKSIZE)
1098				maxbs = SPA_OLD_MAXBLOCKSIZE;
1099			/*
1100			 * The value must be a power of two between
1101			 * SPA_MINBLOCKSIZE and maxbs.
1102			 */
1103			if (intval < SPA_MINBLOCKSIZE ||
1104			    intval > maxbs || !ISP2(intval)) {
1105				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1106				    "'%s' must be power of 2 from 512B "
1107				    "to %uKB"), propname, maxbs >> 10);
1108				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1109				goto error;
1110			}
1111			break;
1112		}
1113		case ZFS_PROP_MLSLABEL:
1114		{
1115#ifdef illumos
1116			/*
1117			 * Verify the mlslabel string and convert to
1118			 * internal hex label string.
1119			 */
1120
1121			m_label_t *new_sl;
1122			char *hex = NULL;	/* internal label string */
1123
1124			/* Default value is already OK. */
1125			if (strcasecmp(strval, ZFS_MLSLABEL_DEFAULT) == 0)
1126				break;
1127
1128			/* Verify the label can be converted to binary form */
1129			if (((new_sl = m_label_alloc(MAC_LABEL)) == NULL) ||
1130			    (str_to_label(strval, &new_sl, MAC_LABEL,
1131			    L_NO_CORRECTION, NULL) == -1)) {
1132				goto badlabel;
1133			}
1134
1135			/* Now translate to hex internal label string */
1136			if (label_to_str(new_sl, &hex, M_INTERNAL,
1137			    DEF_NAMES) != 0) {
1138				if (hex)
1139					free(hex);
1140				goto badlabel;
1141			}
1142			m_label_free(new_sl);
1143
1144			/* If string is already in internal form, we're done. */
1145			if (strcmp(strval, hex) == 0) {
1146				free(hex);
1147				break;
1148			}
1149
1150			/* Replace the label string with the internal form. */
1151			(void) nvlist_remove(ret, zfs_prop_to_name(prop),
1152			    DATA_TYPE_STRING);
1153			verify(nvlist_add_string(ret, zfs_prop_to_name(prop),
1154			    hex) == 0);
1155			free(hex);
1156
1157			break;
1158
1159badlabel:
1160			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1161			    "invalid mlslabel '%s'"), strval);
1162			(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1163			m_label_free(new_sl);	/* OK if null */
1164#else	/* !illumos */
1165			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1166			    "mlslabel is not supported on FreeBSD"));
1167			(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1168#endif	/* illumos */
1169			goto error;
1170
1171		}
1172
1173		case ZFS_PROP_MOUNTPOINT:
1174		{
1175			namecheck_err_t why;
1176
1177			if (strcmp(strval, ZFS_MOUNTPOINT_NONE) == 0 ||
1178			    strcmp(strval, ZFS_MOUNTPOINT_LEGACY) == 0)
1179				break;
1180
1181			if (mountpoint_namecheck(strval, &why)) {
1182				switch (why) {
1183				case NAME_ERR_LEADING_SLASH:
1184					zfs_error_aux(hdl,
1185					    dgettext(TEXT_DOMAIN,
1186					    "'%s' must be an absolute path, "
1187					    "'none', or 'legacy'"), propname);
1188					break;
1189				case NAME_ERR_TOOLONG:
1190					zfs_error_aux(hdl,
1191					    dgettext(TEXT_DOMAIN,
1192					    "component of '%s' is too long"),
1193					    propname);
1194					break;
1195				}
1196				(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1197				goto error;
1198			}
1199		}
1200
1201			/*FALLTHRU*/
1202
1203		case ZFS_PROP_SHARESMB:
1204		case ZFS_PROP_SHARENFS:
1205			/*
1206			 * For the mountpoint and sharenfs or sharesmb
1207			 * properties, check if it can be set in a
1208			 * global/non-global zone based on
1209			 * the zoned property value:
1210			 *
1211			 *		global zone	    non-global zone
1212			 * --------------------------------------------------
1213			 * zoned=on	mountpoint (no)	    mountpoint (yes)
1214			 *		sharenfs (no)	    sharenfs (no)
1215			 *		sharesmb (no)	    sharesmb (no)
1216			 *
1217			 * zoned=off	mountpoint (yes)	N/A
1218			 *		sharenfs (yes)
1219			 *		sharesmb (yes)
1220			 */
1221			if (zoned) {
1222				if (getzoneid() == GLOBAL_ZONEID) {
1223					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1224					    "'%s' cannot be set on "
1225					    "dataset in a non-global zone"),
1226					    propname);
1227					(void) zfs_error(hdl, EZFS_ZONED,
1228					    errbuf);
1229					goto error;
1230				} else if (prop == ZFS_PROP_SHARENFS ||
1231				    prop == ZFS_PROP_SHARESMB) {
1232					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1233					    "'%s' cannot be set in "
1234					    "a non-global zone"), propname);
1235					(void) zfs_error(hdl, EZFS_ZONED,
1236					    errbuf);
1237					goto error;
1238				}
1239			} else if (getzoneid() != GLOBAL_ZONEID) {
1240				/*
1241				 * If zoned property is 'off', this must be in
1242				 * a global zone. If not, something is wrong.
1243				 */
1244				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1245				    "'%s' cannot be set while dataset "
1246				    "'zoned' property is set"), propname);
1247				(void) zfs_error(hdl, EZFS_ZONED, errbuf);
1248				goto error;
1249			}
1250
1251			/*
1252			 * At this point, it is legitimate to set the
1253			 * property. Now we want to make sure that the
1254			 * property value is valid if it is sharenfs.
1255			 */
1256			if ((prop == ZFS_PROP_SHARENFS ||
1257			    prop == ZFS_PROP_SHARESMB) &&
1258			    strcmp(strval, "on") != 0 &&
1259			    strcmp(strval, "off") != 0) {
1260				zfs_share_proto_t proto;
1261
1262				if (prop == ZFS_PROP_SHARESMB)
1263					proto = PROTO_SMB;
1264				else
1265					proto = PROTO_NFS;
1266
1267				/*
1268				 * Must be an valid sharing protocol
1269				 * option string so init the libshare
1270				 * in order to enable the parser and
1271				 * then parse the options. We use the
1272				 * control API since we don't care about
1273				 * the current configuration and don't
1274				 * want the overhead of loading it
1275				 * until we actually do something.
1276				 */
1277
1278				if (zfs_init_libshare(hdl,
1279				    SA_INIT_CONTROL_API) != SA_OK) {
1280					/*
1281					 * An error occurred so we can't do
1282					 * anything
1283					 */
1284					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1285					    "'%s' cannot be set: problem "
1286					    "in share initialization"),
1287					    propname);
1288					(void) zfs_error(hdl, EZFS_BADPROP,
1289					    errbuf);
1290					goto error;
1291				}
1292
1293				if (zfs_parse_options(strval, proto) != SA_OK) {
1294					/*
1295					 * There was an error in parsing so
1296					 * deal with it by issuing an error
1297					 * message and leaving after
1298					 * uninitializing the the libshare
1299					 * interface.
1300					 */
1301					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1302					    "'%s' cannot be set to invalid "
1303					    "options"), propname);
1304					(void) zfs_error(hdl, EZFS_BADPROP,
1305					    errbuf);
1306					zfs_uninit_libshare(hdl);
1307					goto error;
1308				}
1309				zfs_uninit_libshare(hdl);
1310			}
1311
1312			break;
1313		case ZFS_PROP_UTF8ONLY:
1314			chosen_utf = (int)intval;
1315			break;
1316		case ZFS_PROP_NORMALIZE:
1317			chosen_normal = (int)intval;
1318			break;
1319		}
1320
1321		/*
1322		 * For changes to existing volumes, we have some additional
1323		 * checks to enforce.
1324		 */
1325		if (type == ZFS_TYPE_VOLUME && zhp != NULL) {
1326			uint64_t volsize = zfs_prop_get_int(zhp,
1327			    ZFS_PROP_VOLSIZE);
1328			uint64_t blocksize = zfs_prop_get_int(zhp,
1329			    ZFS_PROP_VOLBLOCKSIZE);
1330			char buf[64];
1331
1332			switch (prop) {
1333			case ZFS_PROP_RESERVATION:
1334			case ZFS_PROP_REFRESERVATION:
1335				if (intval > volsize) {
1336					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1337					    "'%s' is greater than current "
1338					    "volume size"), propname);
1339					(void) zfs_error(hdl, EZFS_BADPROP,
1340					    errbuf);
1341					goto error;
1342				}
1343				break;
1344
1345			case ZFS_PROP_VOLSIZE:
1346				if (intval % blocksize != 0) {
1347					zfs_nicenum(blocksize, buf,
1348					    sizeof (buf));
1349					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1350					    "'%s' must be a multiple of "
1351					    "volume block size (%s)"),
1352					    propname, buf);
1353					(void) zfs_error(hdl, EZFS_BADPROP,
1354					    errbuf);
1355					goto error;
1356				}
1357
1358				if (intval == 0) {
1359					zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1360					    "'%s' cannot be zero"),
1361					    propname);
1362					(void) zfs_error(hdl, EZFS_BADPROP,
1363					    errbuf);
1364					goto error;
1365				}
1366				break;
1367			}
1368		}
1369	}
1370
1371	/*
1372	 * If normalization was chosen, but no UTF8 choice was made,
1373	 * enforce rejection of non-UTF8 names.
1374	 *
1375	 * If normalization was chosen, but rejecting non-UTF8 names
1376	 * was explicitly not chosen, it is an error.
1377	 */
1378	if (chosen_normal > 0 && chosen_utf < 0) {
1379		if (nvlist_add_uint64(ret,
1380		    zfs_prop_to_name(ZFS_PROP_UTF8ONLY), 1) != 0) {
1381			(void) no_memory(hdl);
1382			goto error;
1383		}
1384	} else if (chosen_normal > 0 && chosen_utf == 0) {
1385		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1386		    "'%s' must be set 'on' if normalization chosen"),
1387		    zfs_prop_to_name(ZFS_PROP_UTF8ONLY));
1388		(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1389		goto error;
1390	}
1391	return (ret);
1392
1393error:
1394	nvlist_free(ret);
1395	return (NULL);
1396}
1397
1398int
1399zfs_add_synthetic_resv(zfs_handle_t *zhp, nvlist_t *nvl)
1400{
1401	uint64_t old_volsize;
1402	uint64_t new_volsize;
1403	uint64_t old_reservation;
1404	uint64_t new_reservation;
1405	zfs_prop_t resv_prop;
1406	nvlist_t *props;
1407
1408	/*
1409	 * If this is an existing volume, and someone is setting the volsize,
1410	 * make sure that it matches the reservation, or add it if necessary.
1411	 */
1412	old_volsize = zfs_prop_get_int(zhp, ZFS_PROP_VOLSIZE);
1413	if (zfs_which_resv_prop(zhp, &resv_prop) < 0)
1414		return (-1);
1415	old_reservation = zfs_prop_get_int(zhp, resv_prop);
1416
1417	props = fnvlist_alloc();
1418	fnvlist_add_uint64(props, zfs_prop_to_name(ZFS_PROP_VOLBLOCKSIZE),
1419	    zfs_prop_get_int(zhp, ZFS_PROP_VOLBLOCKSIZE));
1420
1421	if ((zvol_volsize_to_reservation(old_volsize, props) !=
1422	    old_reservation) || nvlist_exists(nvl,
1423	    zfs_prop_to_name(resv_prop))) {
1424		fnvlist_free(props);
1425		return (0);
1426	}
1427	if (nvlist_lookup_uint64(nvl, zfs_prop_to_name(ZFS_PROP_VOLSIZE),
1428	    &new_volsize) != 0) {
1429		fnvlist_free(props);
1430		return (-1);
1431	}
1432	new_reservation = zvol_volsize_to_reservation(new_volsize, props);
1433	fnvlist_free(props);
1434
1435	if (nvlist_add_uint64(nvl, zfs_prop_to_name(resv_prop),
1436	    new_reservation) != 0) {
1437		(void) no_memory(zhp->zfs_hdl);
1438		return (-1);
1439	}
1440	return (1);
1441}
1442
1443void
1444zfs_setprop_error(libzfs_handle_t *hdl, zfs_prop_t prop, int err,
1445    char *errbuf)
1446{
1447	switch (err) {
1448
1449	case ENOSPC:
1450		/*
1451		 * For quotas and reservations, ENOSPC indicates
1452		 * something different; setting a quota or reservation
1453		 * doesn't use any disk space.
1454		 */
1455		switch (prop) {
1456		case ZFS_PROP_QUOTA:
1457		case ZFS_PROP_REFQUOTA:
1458			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1459			    "size is less than current used or "
1460			    "reserved space"));
1461			(void) zfs_error(hdl, EZFS_PROPSPACE, errbuf);
1462			break;
1463
1464		case ZFS_PROP_RESERVATION:
1465		case ZFS_PROP_REFRESERVATION:
1466			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1467			    "size is greater than available space"));
1468			(void) zfs_error(hdl, EZFS_PROPSPACE, errbuf);
1469			break;
1470
1471		default:
1472			(void) zfs_standard_error(hdl, err, errbuf);
1473			break;
1474		}
1475		break;
1476
1477	case EBUSY:
1478		(void) zfs_standard_error(hdl, EBUSY, errbuf);
1479		break;
1480
1481	case EROFS:
1482		(void) zfs_error(hdl, EZFS_DSREADONLY, errbuf);
1483		break;
1484
1485	case E2BIG:
1486		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1487		    "property value too long"));
1488		(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1489		break;
1490
1491	case ENOTSUP:
1492		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1493		    "pool and or dataset must be upgraded to set this "
1494		    "property or value"));
1495		(void) zfs_error(hdl, EZFS_BADVERSION, errbuf);
1496		break;
1497
1498	case ERANGE:
1499	case EDOM:
1500		if (prop == ZFS_PROP_COMPRESSION ||
1501		    prop == ZFS_PROP_RECORDSIZE) {
1502			(void) zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1503			    "property setting is not allowed on "
1504			    "bootable datasets"));
1505			(void) zfs_error(hdl, EZFS_NOTSUP, errbuf);
1506		} else if (prop == ZFS_PROP_CHECKSUM ||
1507		    prop == ZFS_PROP_DEDUP) {
1508			(void) zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1509			    "property setting is not allowed on "
1510			    "root pools"));
1511			(void) zfs_error(hdl, EZFS_NOTSUP, errbuf);
1512		} else {
1513			(void) zfs_standard_error(hdl, err, errbuf);
1514		}
1515		break;
1516
1517	case EINVAL:
1518		if (prop == ZPROP_INVAL) {
1519			(void) zfs_error(hdl, EZFS_BADPROP, errbuf);
1520		} else {
1521			(void) zfs_standard_error(hdl, err, errbuf);
1522		}
1523		break;
1524
1525	case EOVERFLOW:
1526		/*
1527		 * This platform can't address a volume this big.
1528		 */
1529#ifdef _ILP32
1530		if (prop == ZFS_PROP_VOLSIZE) {
1531			(void) zfs_error(hdl, EZFS_VOLTOOBIG, errbuf);
1532			break;
1533		}
1534#endif
1535		/* FALLTHROUGH */
1536	default:
1537		(void) zfs_standard_error(hdl, err, errbuf);
1538	}
1539}
1540
1541/*
1542 * Given a property name and value, set the property for the given dataset.
1543 */
1544int
1545zfs_prop_set(zfs_handle_t *zhp, const char *propname, const char *propval)
1546{
1547	int ret = -1;
1548	char errbuf[1024];
1549	libzfs_handle_t *hdl = zhp->zfs_hdl;
1550	nvlist_t *nvl = NULL;
1551
1552	(void) snprintf(errbuf, sizeof (errbuf),
1553	    dgettext(TEXT_DOMAIN, "cannot set property for '%s'"),
1554	    zhp->zfs_name);
1555
1556	if (nvlist_alloc(&nvl, NV_UNIQUE_NAME, 0) != 0 ||
1557	    nvlist_add_string(nvl, propname, propval) != 0) {
1558		(void) no_memory(hdl);
1559		goto error;
1560	}
1561
1562	ret = zfs_prop_set_list(zhp, nvl);
1563
1564error:
1565	nvlist_free(nvl);
1566	return (ret);
1567}
1568
1569
1570
1571/*
1572 * Given an nvlist of property names and values, set the properties for the
1573 * given dataset.
1574 */
1575int
1576zfs_prop_set_list(zfs_handle_t *zhp, nvlist_t *props)
1577{
1578	zfs_cmd_t zc = { 0 };
1579	int ret = -1;
1580	prop_changelist_t **cls = NULL;
1581	int cl_idx;
1582	char errbuf[1024];
1583	libzfs_handle_t *hdl = zhp->zfs_hdl;
1584	nvlist_t *nvl;
1585	int nvl_len;
1586	int added_resv;
1587
1588	(void) snprintf(errbuf, sizeof (errbuf),
1589	    dgettext(TEXT_DOMAIN, "cannot set property for '%s'"),
1590	    zhp->zfs_name);
1591
1592	if ((nvl = zfs_valid_proplist(hdl, zhp->zfs_type, props,
1593	    zfs_prop_get_int(zhp, ZFS_PROP_ZONED), zhp, errbuf)) == NULL)
1594		goto error;
1595
1596	/*
1597	 * We have to check for any extra properties which need to be added
1598	 * before computing the length of the nvlist.
1599	 */
1600	for (nvpair_t *elem = nvlist_next_nvpair(nvl, NULL);
1601	    elem != NULL;
1602	    elem = nvlist_next_nvpair(nvl, elem)) {
1603		if (zfs_name_to_prop(nvpair_name(elem)) == ZFS_PROP_VOLSIZE &&
1604		    (added_resv = zfs_add_synthetic_resv(zhp, nvl)) == -1) {
1605			goto error;
1606		}
1607	}
1608	/*
1609	 * Check how many properties we're setting and allocate an array to
1610	 * store changelist pointers for postfix().
1611	 */
1612	nvl_len = 0;
1613	for (nvpair_t *elem = nvlist_next_nvpair(nvl, NULL);
1614	    elem != NULL;
1615	    elem = nvlist_next_nvpair(nvl, elem))
1616		nvl_len++;
1617	if ((cls = calloc(nvl_len, sizeof (prop_changelist_t *))) == NULL)
1618		goto error;
1619
1620	cl_idx = 0;
1621	for (nvpair_t *elem = nvlist_next_nvpair(nvl, NULL);
1622	    elem != NULL;
1623	    elem = nvlist_next_nvpair(nvl, elem)) {
1624
1625		zfs_prop_t prop = zfs_name_to_prop(nvpair_name(elem));
1626
1627		assert(cl_idx < nvl_len);
1628		/*
1629		 * We don't want to unmount & remount the dataset when changing
1630		 * its canmount property to 'on' or 'noauto'.  We only use
1631		 * the changelist logic to unmount when setting canmount=off.
1632		 */
1633		if (!(prop == ZFS_PROP_CANMOUNT &&
1634		    fnvpair_value_uint64(elem) != ZFS_CANMOUNT_OFF)) {
1635			cls[cl_idx] = changelist_gather(zhp, prop, 0, 0);
1636			if (cls[cl_idx] == NULL)
1637				goto error;
1638		}
1639
1640		if (prop == ZFS_PROP_MOUNTPOINT &&
1641		    changelist_haszonedchild(cls[cl_idx])) {
1642			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1643			    "child dataset with inherited mountpoint is used "
1644			    "in a non-global zone"));
1645			ret = zfs_error(hdl, EZFS_ZONED, errbuf);
1646			goto error;
1647		}
1648
1649		/* We don't support those properties on FreeBSD. */
1650		switch (prop) {
1651		case ZFS_PROP_DEVICES:
1652		case ZFS_PROP_ISCSIOPTIONS:
1653		case ZFS_PROP_XATTR:
1654		case ZFS_PROP_VSCAN:
1655		case ZFS_PROP_NBMAND:
1656		case ZFS_PROP_MLSLABEL:
1657			(void) snprintf(errbuf, sizeof (errbuf),
1658			    "property '%s' not supported on FreeBSD",
1659			    nvpair_name(elem));
1660			ret = zfs_error(hdl, EZFS_PERM, errbuf);
1661			goto error;
1662		}
1663
1664		if (cls[cl_idx] != NULL &&
1665		    (ret = changelist_prefix(cls[cl_idx])) != 0)
1666			goto error;
1667
1668		cl_idx++;
1669	}
1670	assert(cl_idx == nvl_len);
1671
1672	/*
1673	 * Execute the corresponding ioctl() to set this list of properties.
1674	 */
1675	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
1676
1677	if ((ret = zcmd_write_src_nvlist(hdl, &zc, nvl)) != 0 ||
1678	    (ret = zcmd_alloc_dst_nvlist(hdl, &zc, 0)) != 0)
1679		goto error;
1680
1681	ret = zfs_ioctl(hdl, ZFS_IOC_SET_PROP, &zc);
1682
1683	if (ret != 0) {
1684		/* Get the list of unset properties back and report them. */
1685		nvlist_t *errorprops = NULL;
1686		if (zcmd_read_dst_nvlist(hdl, &zc, &errorprops) != 0)
1687			goto error;
1688		for (nvpair_t *elem = nvlist_next_nvpair(nvl, NULL);
1689		    elem != NULL;
1690		    elem = nvlist_next_nvpair(nvl, elem)) {
1691			zfs_prop_t prop = zfs_name_to_prop(nvpair_name(elem));
1692			zfs_setprop_error(hdl, prop, errno, errbuf);
1693		}
1694		nvlist_free(errorprops);
1695
1696		if (added_resv && errno == ENOSPC) {
1697			/* clean up the volsize property we tried to set */
1698			uint64_t old_volsize = zfs_prop_get_int(zhp,
1699			    ZFS_PROP_VOLSIZE);
1700			nvlist_free(nvl);
1701			nvl = NULL;
1702			zcmd_free_nvlists(&zc);
1703
1704			if (nvlist_alloc(&nvl, NV_UNIQUE_NAME, 0) != 0)
1705				goto error;
1706			if (nvlist_add_uint64(nvl,
1707			    zfs_prop_to_name(ZFS_PROP_VOLSIZE),
1708			    old_volsize) != 0)
1709				goto error;
1710			if (zcmd_write_src_nvlist(hdl, &zc, nvl) != 0)
1711				goto error;
1712			(void) zfs_ioctl(hdl, ZFS_IOC_SET_PROP, &zc);
1713		}
1714	} else {
1715		for (cl_idx = 0; cl_idx < nvl_len; cl_idx++) {
1716			if (cls[cl_idx] != NULL) {
1717				int clp_err = changelist_postfix(cls[cl_idx]);
1718				if (clp_err != 0)
1719					ret = clp_err;
1720			}
1721		}
1722
1723		/*
1724		 * Refresh the statistics so the new property value
1725		 * is reflected.
1726		 */
1727		if (ret == 0)
1728			(void) get_stats(zhp);
1729	}
1730
1731error:
1732	nvlist_free(nvl);
1733	zcmd_free_nvlists(&zc);
1734	if (cls != NULL) {
1735		for (cl_idx = 0; cl_idx < nvl_len; cl_idx++) {
1736			if (cls[cl_idx] != NULL)
1737				changelist_free(cls[cl_idx]);
1738		}
1739		free(cls);
1740	}
1741	return (ret);
1742}
1743
1744/*
1745 * Given a property, inherit the value from the parent dataset, or if received
1746 * is TRUE, revert to the received value, if any.
1747 */
1748int
1749zfs_prop_inherit(zfs_handle_t *zhp, const char *propname, boolean_t received)
1750{
1751	zfs_cmd_t zc = { 0 };
1752	int ret;
1753	prop_changelist_t *cl;
1754	libzfs_handle_t *hdl = zhp->zfs_hdl;
1755	char errbuf[1024];
1756	zfs_prop_t prop;
1757
1758	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
1759	    "cannot inherit %s for '%s'"), propname, zhp->zfs_name);
1760
1761	zc.zc_cookie = received;
1762	if ((prop = zfs_name_to_prop(propname)) == ZPROP_INVAL) {
1763		/*
1764		 * For user properties, the amount of work we have to do is very
1765		 * small, so just do it here.
1766		 */
1767		if (!zfs_prop_user(propname)) {
1768			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1769			    "invalid property"));
1770			return (zfs_error(hdl, EZFS_BADPROP, errbuf));
1771		}
1772
1773		(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
1774		(void) strlcpy(zc.zc_value, propname, sizeof (zc.zc_value));
1775
1776		if (zfs_ioctl(zhp->zfs_hdl, ZFS_IOC_INHERIT_PROP, &zc) != 0)
1777			return (zfs_standard_error(hdl, errno, errbuf));
1778
1779		return (0);
1780	}
1781
1782	/*
1783	 * Verify that this property is inheritable.
1784	 */
1785	if (zfs_prop_readonly(prop))
1786		return (zfs_error(hdl, EZFS_PROPREADONLY, errbuf));
1787
1788	if (!zfs_prop_inheritable(prop) && !received)
1789		return (zfs_error(hdl, EZFS_PROPNONINHERIT, errbuf));
1790
1791	/*
1792	 * Check to see if the value applies to this type
1793	 */
1794	if (!zfs_prop_valid_for_type(prop, zhp->zfs_type))
1795		return (zfs_error(hdl, EZFS_PROPTYPE, errbuf));
1796
1797	/*
1798	 * Normalize the name, to get rid of shorthand abbreviations.
1799	 */
1800	propname = zfs_prop_to_name(prop);
1801	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
1802	(void) strlcpy(zc.zc_value, propname, sizeof (zc.zc_value));
1803
1804	if (prop == ZFS_PROP_MOUNTPOINT && getzoneid() == GLOBAL_ZONEID &&
1805	    zfs_prop_get_int(zhp, ZFS_PROP_ZONED)) {
1806		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1807		    "dataset is used in a non-global zone"));
1808		return (zfs_error(hdl, EZFS_ZONED, errbuf));
1809	}
1810
1811	/*
1812	 * Determine datasets which will be affected by this change, if any.
1813	 */
1814	if ((cl = changelist_gather(zhp, prop, 0, 0)) == NULL)
1815		return (-1);
1816
1817	if (prop == ZFS_PROP_MOUNTPOINT && changelist_haszonedchild(cl)) {
1818		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
1819		    "child dataset with inherited mountpoint is used "
1820		    "in a non-global zone"));
1821		ret = zfs_error(hdl, EZFS_ZONED, errbuf);
1822		goto error;
1823	}
1824
1825	if ((ret = changelist_prefix(cl)) != 0)
1826		goto error;
1827
1828	if ((ret = zfs_ioctl(zhp->zfs_hdl, ZFS_IOC_INHERIT_PROP, &zc)) != 0) {
1829		return (zfs_standard_error(hdl, errno, errbuf));
1830	} else {
1831
1832		if ((ret = changelist_postfix(cl)) != 0)
1833			goto error;
1834
1835		/*
1836		 * Refresh the statistics so the new property is reflected.
1837		 */
1838		(void) get_stats(zhp);
1839	}
1840
1841error:
1842	changelist_free(cl);
1843	return (ret);
1844}
1845
1846/*
1847 * True DSL properties are stored in an nvlist.  The following two functions
1848 * extract them appropriately.
1849 */
1850static uint64_t
1851getprop_uint64(zfs_handle_t *zhp, zfs_prop_t prop, char **source)
1852{
1853	nvlist_t *nv;
1854	uint64_t value;
1855
1856	*source = NULL;
1857	if (nvlist_lookup_nvlist(zhp->zfs_props,
1858	    zfs_prop_to_name(prop), &nv) == 0) {
1859		verify(nvlist_lookup_uint64(nv, ZPROP_VALUE, &value) == 0);
1860		(void) nvlist_lookup_string(nv, ZPROP_SOURCE, source);
1861	} else {
1862		verify(!zhp->zfs_props_table ||
1863		    zhp->zfs_props_table[prop] == B_TRUE);
1864		value = zfs_prop_default_numeric(prop);
1865		*source = "";
1866	}
1867
1868	return (value);
1869}
1870
1871static const char *
1872getprop_string(zfs_handle_t *zhp, zfs_prop_t prop, char **source)
1873{
1874	nvlist_t *nv;
1875	const char *value;
1876
1877	*source = NULL;
1878	if (nvlist_lookup_nvlist(zhp->zfs_props,
1879	    zfs_prop_to_name(prop), &nv) == 0) {
1880		value = fnvlist_lookup_string(nv, ZPROP_VALUE);
1881		(void) nvlist_lookup_string(nv, ZPROP_SOURCE, source);
1882	} else {
1883		verify(!zhp->zfs_props_table ||
1884		    zhp->zfs_props_table[prop] == B_TRUE);
1885		value = zfs_prop_default_string(prop);
1886		*source = "";
1887	}
1888
1889	return (value);
1890}
1891
1892static boolean_t
1893zfs_is_recvd_props_mode(zfs_handle_t *zhp)
1894{
1895	return (zhp->zfs_props == zhp->zfs_recvd_props);
1896}
1897
1898static void
1899zfs_set_recvd_props_mode(zfs_handle_t *zhp, uint64_t *cookie)
1900{
1901	*cookie = (uint64_t)(uintptr_t)zhp->zfs_props;
1902	zhp->zfs_props = zhp->zfs_recvd_props;
1903}
1904
1905static void
1906zfs_unset_recvd_props_mode(zfs_handle_t *zhp, uint64_t *cookie)
1907{
1908	zhp->zfs_props = (nvlist_t *)(uintptr_t)*cookie;
1909	*cookie = 0;
1910}
1911
1912/*
1913 * Internal function for getting a numeric property.  Both zfs_prop_get() and
1914 * zfs_prop_get_int() are built using this interface.
1915 *
1916 * Certain properties can be overridden using 'mount -o'.  In this case, scan
1917 * the contents of the /etc/mnttab entry, searching for the appropriate options.
1918 * If they differ from the on-disk values, report the current values and mark
1919 * the source "temporary".
1920 */
1921static int
1922get_numeric_property(zfs_handle_t *zhp, zfs_prop_t prop, zprop_source_t *src,
1923    char **source, uint64_t *val)
1924{
1925	zfs_cmd_t zc = { 0 };
1926	nvlist_t *zplprops = NULL;
1927	struct mnttab mnt;
1928	char *mntopt_on = NULL;
1929	char *mntopt_off = NULL;
1930	boolean_t received = zfs_is_recvd_props_mode(zhp);
1931
1932	*source = NULL;
1933
1934	switch (prop) {
1935	case ZFS_PROP_ATIME:
1936		mntopt_on = MNTOPT_ATIME;
1937		mntopt_off = MNTOPT_NOATIME;
1938		break;
1939
1940	case ZFS_PROP_DEVICES:
1941		mntopt_on = MNTOPT_DEVICES;
1942		mntopt_off = MNTOPT_NODEVICES;
1943		break;
1944
1945	case ZFS_PROP_EXEC:
1946		mntopt_on = MNTOPT_EXEC;
1947		mntopt_off = MNTOPT_NOEXEC;
1948		break;
1949
1950	case ZFS_PROP_READONLY:
1951		mntopt_on = MNTOPT_RO;
1952		mntopt_off = MNTOPT_RW;
1953		break;
1954
1955	case ZFS_PROP_SETUID:
1956		mntopt_on = MNTOPT_SETUID;
1957		mntopt_off = MNTOPT_NOSETUID;
1958		break;
1959
1960	case ZFS_PROP_XATTR:
1961		mntopt_on = MNTOPT_XATTR;
1962		mntopt_off = MNTOPT_NOXATTR;
1963		break;
1964
1965	case ZFS_PROP_NBMAND:
1966		mntopt_on = MNTOPT_NBMAND;
1967		mntopt_off = MNTOPT_NONBMAND;
1968		break;
1969	}
1970
1971	/*
1972	 * Because looking up the mount options is potentially expensive
1973	 * (iterating over all of /etc/mnttab), we defer its calculation until
1974	 * we're looking up a property which requires its presence.
1975	 */
1976	if (!zhp->zfs_mntcheck &&
1977	    (mntopt_on != NULL || prop == ZFS_PROP_MOUNTED)) {
1978		libzfs_handle_t *hdl = zhp->zfs_hdl;
1979		struct mnttab entry;
1980
1981		if (libzfs_mnttab_find(hdl, zhp->zfs_name, &entry) == 0) {
1982			zhp->zfs_mntopts = zfs_strdup(hdl,
1983			    entry.mnt_mntopts);
1984			if (zhp->zfs_mntopts == NULL)
1985				return (-1);
1986		}
1987
1988		zhp->zfs_mntcheck = B_TRUE;
1989	}
1990
1991	if (zhp->zfs_mntopts == NULL)
1992		mnt.mnt_mntopts = "";
1993	else
1994		mnt.mnt_mntopts = zhp->zfs_mntopts;
1995
1996	switch (prop) {
1997	case ZFS_PROP_ATIME:
1998	case ZFS_PROP_DEVICES:
1999	case ZFS_PROP_EXEC:
2000	case ZFS_PROP_READONLY:
2001	case ZFS_PROP_SETUID:
2002	case ZFS_PROP_XATTR:
2003	case ZFS_PROP_NBMAND:
2004		*val = getprop_uint64(zhp, prop, source);
2005
2006		if (received)
2007			break;
2008
2009		if (hasmntopt(&mnt, mntopt_on) && !*val) {
2010			*val = B_TRUE;
2011			if (src)
2012				*src = ZPROP_SRC_TEMPORARY;
2013		} else if (hasmntopt(&mnt, mntopt_off) && *val) {
2014			*val = B_FALSE;
2015			if (src)
2016				*src = ZPROP_SRC_TEMPORARY;
2017		}
2018		break;
2019
2020	case ZFS_PROP_CANMOUNT:
2021	case ZFS_PROP_VOLSIZE:
2022	case ZFS_PROP_QUOTA:
2023	case ZFS_PROP_REFQUOTA:
2024	case ZFS_PROP_RESERVATION:
2025	case ZFS_PROP_REFRESERVATION:
2026	case ZFS_PROP_FILESYSTEM_LIMIT:
2027	case ZFS_PROP_SNAPSHOT_LIMIT:
2028	case ZFS_PROP_FILESYSTEM_COUNT:
2029	case ZFS_PROP_SNAPSHOT_COUNT:
2030		*val = getprop_uint64(zhp, prop, source);
2031
2032		if (*source == NULL) {
2033			/* not default, must be local */
2034			*source = zhp->zfs_name;
2035		}
2036		break;
2037
2038	case ZFS_PROP_MOUNTED:
2039		*val = (zhp->zfs_mntopts != NULL);
2040		break;
2041
2042	case ZFS_PROP_NUMCLONES:
2043		*val = zhp->zfs_dmustats.dds_num_clones;
2044		break;
2045
2046	case ZFS_PROP_VERSION:
2047	case ZFS_PROP_NORMALIZE:
2048	case ZFS_PROP_UTF8ONLY:
2049	case ZFS_PROP_CASE:
2050		if (!zfs_prop_valid_for_type(prop, zhp->zfs_head_type) ||
2051		    zcmd_alloc_dst_nvlist(zhp->zfs_hdl, &zc, 0) != 0)
2052			return (-1);
2053		(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
2054		if (zfs_ioctl(zhp->zfs_hdl, ZFS_IOC_OBJSET_ZPLPROPS, &zc)) {
2055			zcmd_free_nvlists(&zc);
2056			return (-1);
2057		}
2058		if (zcmd_read_dst_nvlist(zhp->zfs_hdl, &zc, &zplprops) != 0 ||
2059		    nvlist_lookup_uint64(zplprops, zfs_prop_to_name(prop),
2060		    val) != 0) {
2061			zcmd_free_nvlists(&zc);
2062			return (-1);
2063		}
2064		if (zplprops)
2065			nvlist_free(zplprops);
2066		zcmd_free_nvlists(&zc);
2067		break;
2068
2069	case ZFS_PROP_INCONSISTENT:
2070		*val = zhp->zfs_dmustats.dds_inconsistent;
2071		break;
2072
2073	default:
2074		switch (zfs_prop_get_type(prop)) {
2075		case PROP_TYPE_NUMBER:
2076		case PROP_TYPE_INDEX:
2077			*val = getprop_uint64(zhp, prop, source);
2078			/*
2079			 * If we tried to use a default value for a
2080			 * readonly property, it means that it was not
2081			 * present.
2082			 */
2083			if (zfs_prop_readonly(prop) &&
2084			    *source != NULL && (*source)[0] == '\0') {
2085				*source = NULL;
2086			}
2087			break;
2088
2089		case PROP_TYPE_STRING:
2090		default:
2091			zfs_error_aux(zhp->zfs_hdl, dgettext(TEXT_DOMAIN,
2092			    "cannot get non-numeric property"));
2093			return (zfs_error(zhp->zfs_hdl, EZFS_BADPROP,
2094			    dgettext(TEXT_DOMAIN, "internal error")));
2095		}
2096	}
2097
2098	return (0);
2099}
2100
2101/*
2102 * Calculate the source type, given the raw source string.
2103 */
2104static void
2105get_source(zfs_handle_t *zhp, zprop_source_t *srctype, char *source,
2106    char *statbuf, size_t statlen)
2107{
2108	if (statbuf == NULL || *srctype == ZPROP_SRC_TEMPORARY)
2109		return;
2110
2111	if (source == NULL) {
2112		*srctype = ZPROP_SRC_NONE;
2113	} else if (source[0] == '\0') {
2114		*srctype = ZPROP_SRC_DEFAULT;
2115	} else if (strstr(source, ZPROP_SOURCE_VAL_RECVD) != NULL) {
2116		*srctype = ZPROP_SRC_RECEIVED;
2117	} else {
2118		if (strcmp(source, zhp->zfs_name) == 0) {
2119			*srctype = ZPROP_SRC_LOCAL;
2120		} else {
2121			(void) strlcpy(statbuf, source, statlen);
2122			*srctype = ZPROP_SRC_INHERITED;
2123		}
2124	}
2125
2126}
2127
2128int
2129zfs_prop_get_recvd(zfs_handle_t *zhp, const char *propname, char *propbuf,
2130    size_t proplen, boolean_t literal)
2131{
2132	zfs_prop_t prop;
2133	int err = 0;
2134
2135	if (zhp->zfs_recvd_props == NULL)
2136		if (get_recvd_props_ioctl(zhp) != 0)
2137			return (-1);
2138
2139	prop = zfs_name_to_prop(propname);
2140
2141	if (prop != ZPROP_INVAL) {
2142		uint64_t cookie;
2143		if (!nvlist_exists(zhp->zfs_recvd_props, propname))
2144			return (-1);
2145		zfs_set_recvd_props_mode(zhp, &cookie);
2146		err = zfs_prop_get(zhp, prop, propbuf, proplen,
2147		    NULL, NULL, 0, literal);
2148		zfs_unset_recvd_props_mode(zhp, &cookie);
2149	} else {
2150		nvlist_t *propval;
2151		char *recvdval;
2152		if (nvlist_lookup_nvlist(zhp->zfs_recvd_props,
2153		    propname, &propval) != 0)
2154			return (-1);
2155		verify(nvlist_lookup_string(propval, ZPROP_VALUE,
2156		    &recvdval) == 0);
2157		(void) strlcpy(propbuf, recvdval, proplen);
2158	}
2159
2160	return (err == 0 ? 0 : -1);
2161}
2162
2163static int
2164get_clones_string(zfs_handle_t *zhp, char *propbuf, size_t proplen)
2165{
2166	nvlist_t *value;
2167	nvpair_t *pair;
2168
2169	value = zfs_get_clones_nvl(zhp);
2170	if (value == NULL)
2171		return (-1);
2172
2173	propbuf[0] = '\0';
2174	for (pair = nvlist_next_nvpair(value, NULL); pair != NULL;
2175	    pair = nvlist_next_nvpair(value, pair)) {
2176		if (propbuf[0] != '\0')
2177			(void) strlcat(propbuf, ",", proplen);
2178		(void) strlcat(propbuf, nvpair_name(pair), proplen);
2179	}
2180
2181	return (0);
2182}
2183
2184struct get_clones_arg {
2185	uint64_t numclones;
2186	nvlist_t *value;
2187	const char *origin;
2188	char buf[ZFS_MAXNAMELEN];
2189};
2190
2191int
2192get_clones_cb(zfs_handle_t *zhp, void *arg)
2193{
2194	struct get_clones_arg *gca = arg;
2195
2196	if (gca->numclones == 0) {
2197		zfs_close(zhp);
2198		return (0);
2199	}
2200
2201	if (zfs_prop_get(zhp, ZFS_PROP_ORIGIN, gca->buf, sizeof (gca->buf),
2202	    NULL, NULL, 0, B_TRUE) != 0)
2203		goto out;
2204	if (strcmp(gca->buf, gca->origin) == 0) {
2205		fnvlist_add_boolean(gca->value, zfs_get_name(zhp));
2206		gca->numclones--;
2207	}
2208
2209out:
2210	(void) zfs_iter_children(zhp, get_clones_cb, gca);
2211	zfs_close(zhp);
2212	return (0);
2213}
2214
2215nvlist_t *
2216zfs_get_clones_nvl(zfs_handle_t *zhp)
2217{
2218	nvlist_t *nv, *value;
2219
2220	if (nvlist_lookup_nvlist(zhp->zfs_props,
2221	    zfs_prop_to_name(ZFS_PROP_CLONES), &nv) != 0) {
2222		struct get_clones_arg gca;
2223
2224		/*
2225		 * if this is a snapshot, then the kernel wasn't able
2226		 * to get the clones.  Do it by slowly iterating.
2227		 */
2228		if (zhp->zfs_type != ZFS_TYPE_SNAPSHOT)
2229			return (NULL);
2230		if (nvlist_alloc(&nv, NV_UNIQUE_NAME, 0) != 0)
2231			return (NULL);
2232		if (nvlist_alloc(&value, NV_UNIQUE_NAME, 0) != 0) {
2233			nvlist_free(nv);
2234			return (NULL);
2235		}
2236
2237		gca.numclones = zfs_prop_get_int(zhp, ZFS_PROP_NUMCLONES);
2238		gca.value = value;
2239		gca.origin = zhp->zfs_name;
2240
2241		if (gca.numclones != 0) {
2242			zfs_handle_t *root;
2243			char pool[ZFS_MAXNAMELEN];
2244			char *cp = pool;
2245
2246			/* get the pool name */
2247			(void) strlcpy(pool, zhp->zfs_name, sizeof (pool));
2248			(void) strsep(&cp, "/@");
2249			root = zfs_open(zhp->zfs_hdl, pool,
2250			    ZFS_TYPE_FILESYSTEM);
2251
2252			(void) get_clones_cb(root, &gca);
2253		}
2254
2255		if (gca.numclones != 0 ||
2256		    nvlist_add_nvlist(nv, ZPROP_VALUE, value) != 0 ||
2257		    nvlist_add_nvlist(zhp->zfs_props,
2258		    zfs_prop_to_name(ZFS_PROP_CLONES), nv) != 0) {
2259			nvlist_free(nv);
2260			nvlist_free(value);
2261			return (NULL);
2262		}
2263		nvlist_free(nv);
2264		nvlist_free(value);
2265		verify(0 == nvlist_lookup_nvlist(zhp->zfs_props,
2266		    zfs_prop_to_name(ZFS_PROP_CLONES), &nv));
2267	}
2268
2269	verify(nvlist_lookup_nvlist(nv, ZPROP_VALUE, &value) == 0);
2270
2271	return (value);
2272}
2273
2274/*
2275 * Retrieve a property from the given object.  If 'literal' is specified, then
2276 * numbers are left as exact values.  Otherwise, numbers are converted to a
2277 * human-readable form.
2278 *
2279 * Returns 0 on success, or -1 on error.
2280 */
2281int
2282zfs_prop_get(zfs_handle_t *zhp, zfs_prop_t prop, char *propbuf, size_t proplen,
2283    zprop_source_t *src, char *statbuf, size_t statlen, boolean_t literal)
2284{
2285	char *source = NULL;
2286	uint64_t val;
2287	const char *str;
2288	const char *strval;
2289	boolean_t received = zfs_is_recvd_props_mode(zhp);
2290
2291	/*
2292	 * Check to see if this property applies to our object
2293	 */
2294	if (!zfs_prop_valid_for_type(prop, zhp->zfs_type))
2295		return (-1);
2296
2297	if (received && zfs_prop_readonly(prop))
2298		return (-1);
2299
2300	if (src)
2301		*src = ZPROP_SRC_NONE;
2302
2303	switch (prop) {
2304	case ZFS_PROP_CREATION:
2305		/*
2306		 * 'creation' is a time_t stored in the statistics.  We convert
2307		 * this into a string unless 'literal' is specified.
2308		 */
2309		{
2310			val = getprop_uint64(zhp, prop, &source);
2311			time_t time = (time_t)val;
2312			struct tm t;
2313
2314			if (literal ||
2315			    localtime_r(&time, &t) == NULL ||
2316			    strftime(propbuf, proplen, "%a %b %e %k:%M %Y",
2317			    &t) == 0)
2318				(void) snprintf(propbuf, proplen, "%llu", val);
2319		}
2320		break;
2321
2322	case ZFS_PROP_MOUNTPOINT:
2323		/*
2324		 * Getting the precise mountpoint can be tricky.
2325		 *
2326		 *  - for 'none' or 'legacy', return those values.
2327		 *  - for inherited mountpoints, we want to take everything
2328		 *    after our ancestor and append it to the inherited value.
2329		 *
2330		 * If the pool has an alternate root, we want to prepend that
2331		 * root to any values we return.
2332		 */
2333
2334		str = getprop_string(zhp, prop, &source);
2335
2336		if (str[0] == '/') {
2337			char buf[MAXPATHLEN];
2338			char *root = buf;
2339			const char *relpath;
2340
2341			/*
2342			 * If we inherit the mountpoint, even from a dataset
2343			 * with a received value, the source will be the path of
2344			 * the dataset we inherit from. If source is
2345			 * ZPROP_SOURCE_VAL_RECVD, the received value is not
2346			 * inherited.
2347			 */
2348			if (strcmp(source, ZPROP_SOURCE_VAL_RECVD) == 0) {
2349				relpath = "";
2350			} else {
2351				relpath = zhp->zfs_name + strlen(source);
2352				if (relpath[0] == '/')
2353					relpath++;
2354			}
2355
2356			if ((zpool_get_prop(zhp->zpool_hdl,
2357			    ZPOOL_PROP_ALTROOT, buf, MAXPATHLEN, NULL,
2358			    B_FALSE)) || (strcmp(root, "-") == 0))
2359				root[0] = '\0';
2360			/*
2361			 * Special case an alternate root of '/'. This will
2362			 * avoid having multiple leading slashes in the
2363			 * mountpoint path.
2364			 */
2365			if (strcmp(root, "/") == 0)
2366				root++;
2367
2368			/*
2369			 * If the mountpoint is '/' then skip over this
2370			 * if we are obtaining either an alternate root or
2371			 * an inherited mountpoint.
2372			 */
2373			if (str[1] == '\0' && (root[0] != '\0' ||
2374			    relpath[0] != '\0'))
2375				str++;
2376
2377			if (relpath[0] == '\0')
2378				(void) snprintf(propbuf, proplen, "%s%s",
2379				    root, str);
2380			else
2381				(void) snprintf(propbuf, proplen, "%s%s%s%s",
2382				    root, str, relpath[0] == '@' ? "" : "/",
2383				    relpath);
2384		} else {
2385			/* 'legacy' or 'none' */
2386			(void) strlcpy(propbuf, str, proplen);
2387		}
2388
2389		break;
2390
2391	case ZFS_PROP_ORIGIN:
2392		str = getprop_string(zhp, prop, &source);
2393		if (str == NULL)
2394			return (-1);
2395		(void) strlcpy(propbuf, str, proplen);
2396		break;
2397
2398	case ZFS_PROP_CLONES:
2399		if (get_clones_string(zhp, propbuf, proplen) != 0)
2400			return (-1);
2401		break;
2402
2403	case ZFS_PROP_QUOTA:
2404	case ZFS_PROP_REFQUOTA:
2405	case ZFS_PROP_RESERVATION:
2406	case ZFS_PROP_REFRESERVATION:
2407
2408		if (get_numeric_property(zhp, prop, src, &source, &val) != 0)
2409			return (-1);
2410
2411		/*
2412		 * If quota or reservation is 0, we translate this into 'none'
2413		 * (unless literal is set), and indicate that it's the default
2414		 * value.  Otherwise, we print the number nicely and indicate
2415		 * that its set locally.
2416		 */
2417		if (val == 0) {
2418			if (literal)
2419				(void) strlcpy(propbuf, "0", proplen);
2420			else
2421				(void) strlcpy(propbuf, "none", proplen);
2422		} else {
2423			if (literal)
2424				(void) snprintf(propbuf, proplen, "%llu",
2425				    (u_longlong_t)val);
2426			else
2427				zfs_nicenum(val, propbuf, proplen);
2428		}
2429		break;
2430
2431	case ZFS_PROP_FILESYSTEM_LIMIT:
2432	case ZFS_PROP_SNAPSHOT_LIMIT:
2433	case ZFS_PROP_FILESYSTEM_COUNT:
2434	case ZFS_PROP_SNAPSHOT_COUNT:
2435
2436		if (get_numeric_property(zhp, prop, src, &source, &val) != 0)
2437			return (-1);
2438
2439		/*
2440		 * If limit is UINT64_MAX, we translate this into 'none' (unless
2441		 * literal is set), and indicate that it's the default value.
2442		 * Otherwise, we print the number nicely and indicate that it's
2443		 * set locally.
2444		 */
2445		if (literal) {
2446			(void) snprintf(propbuf, proplen, "%llu",
2447			    (u_longlong_t)val);
2448		} else if (val == UINT64_MAX) {
2449			(void) strlcpy(propbuf, "none", proplen);
2450		} else {
2451			zfs_nicenum(val, propbuf, proplen);
2452		}
2453		break;
2454
2455	case ZFS_PROP_REFRATIO:
2456	case ZFS_PROP_COMPRESSRATIO:
2457		if (get_numeric_property(zhp, prop, src, &source, &val) != 0)
2458			return (-1);
2459		(void) snprintf(propbuf, proplen, "%llu.%02llux",
2460		    (u_longlong_t)(val / 100),
2461		    (u_longlong_t)(val % 100));
2462		break;
2463
2464	case ZFS_PROP_TYPE:
2465		switch (zhp->zfs_type) {
2466		case ZFS_TYPE_FILESYSTEM:
2467			str = "filesystem";
2468			break;
2469		case ZFS_TYPE_VOLUME:
2470			str = "volume";
2471			break;
2472		case ZFS_TYPE_SNAPSHOT:
2473			str = "snapshot";
2474			break;
2475		case ZFS_TYPE_BOOKMARK:
2476			str = "bookmark";
2477			break;
2478		default:
2479			abort();
2480		}
2481		(void) snprintf(propbuf, proplen, "%s", str);
2482		break;
2483
2484	case ZFS_PROP_MOUNTED:
2485		/*
2486		 * The 'mounted' property is a pseudo-property that described
2487		 * whether the filesystem is currently mounted.  Even though
2488		 * it's a boolean value, the typical values of "on" and "off"
2489		 * don't make sense, so we translate to "yes" and "no".
2490		 */
2491		if (get_numeric_property(zhp, ZFS_PROP_MOUNTED,
2492		    src, &source, &val) != 0)
2493			return (-1);
2494		if (val)
2495			(void) strlcpy(propbuf, "yes", proplen);
2496		else
2497			(void) strlcpy(propbuf, "no", proplen);
2498		break;
2499
2500	case ZFS_PROP_NAME:
2501		/*
2502		 * The 'name' property is a pseudo-property derived from the
2503		 * dataset name.  It is presented as a real property to simplify
2504		 * consumers.
2505		 */
2506		(void) strlcpy(propbuf, zhp->zfs_name, proplen);
2507		break;
2508
2509	case ZFS_PROP_MLSLABEL:
2510		{
2511#ifdef illumos
2512			m_label_t *new_sl = NULL;
2513			char *ascii = NULL;	/* human readable label */
2514
2515			(void) strlcpy(propbuf,
2516			    getprop_string(zhp, prop, &source), proplen);
2517
2518			if (literal || (strcasecmp(propbuf,
2519			    ZFS_MLSLABEL_DEFAULT) == 0))
2520				break;
2521
2522			/*
2523			 * Try to translate the internal hex string to
2524			 * human-readable output.  If there are any
2525			 * problems just use the hex string.
2526			 */
2527
2528			if (str_to_label(propbuf, &new_sl, MAC_LABEL,
2529			    L_NO_CORRECTION, NULL) == -1) {
2530				m_label_free(new_sl);
2531				break;
2532			}
2533
2534			if (label_to_str(new_sl, &ascii, M_LABEL,
2535			    DEF_NAMES) != 0) {
2536				if (ascii)
2537					free(ascii);
2538				m_label_free(new_sl);
2539				break;
2540			}
2541			m_label_free(new_sl);
2542
2543			(void) strlcpy(propbuf, ascii, proplen);
2544			free(ascii);
2545#else	/* !illumos */
2546			propbuf[0] = '\0';
2547#endif	/* illumos */
2548		}
2549		break;
2550
2551	case ZFS_PROP_GUID:
2552		/*
2553		 * GUIDs are stored as numbers, but they are identifiers.
2554		 * We don't want them to be pretty printed, because pretty
2555		 * printing mangles the ID into a truncated and useless value.
2556		 */
2557		if (get_numeric_property(zhp, prop, src, &source, &val) != 0)
2558			return (-1);
2559		(void) snprintf(propbuf, proplen, "%llu", (u_longlong_t)val);
2560		break;
2561
2562	default:
2563		switch (zfs_prop_get_type(prop)) {
2564		case PROP_TYPE_NUMBER:
2565			if (get_numeric_property(zhp, prop, src,
2566			    &source, &val) != 0)
2567				return (-1);
2568			if (literal)
2569				(void) snprintf(propbuf, proplen, "%llu",
2570				    (u_longlong_t)val);
2571			else
2572				zfs_nicenum(val, propbuf, proplen);
2573			break;
2574
2575		case PROP_TYPE_STRING:
2576			str = getprop_string(zhp, prop, &source);
2577			if (str == NULL)
2578				return (-1);
2579			(void) strlcpy(propbuf, str, proplen);
2580			break;
2581
2582		case PROP_TYPE_INDEX:
2583			if (get_numeric_property(zhp, prop, src,
2584			    &source, &val) != 0)
2585				return (-1);
2586			if (zfs_prop_index_to_string(prop, val, &strval) != 0)
2587				return (-1);
2588			(void) strlcpy(propbuf, strval, proplen);
2589			break;
2590
2591		default:
2592			abort();
2593		}
2594	}
2595
2596	get_source(zhp, src, source, statbuf, statlen);
2597
2598	return (0);
2599}
2600
2601/*
2602 * Utility function to get the given numeric property.  Does no validation that
2603 * the given property is the appropriate type; should only be used with
2604 * hard-coded property types.
2605 */
2606uint64_t
2607zfs_prop_get_int(zfs_handle_t *zhp, zfs_prop_t prop)
2608{
2609	char *source;
2610	uint64_t val;
2611
2612	(void) get_numeric_property(zhp, prop, NULL, &source, &val);
2613
2614	return (val);
2615}
2616
2617int
2618zfs_prop_set_int(zfs_handle_t *zhp, zfs_prop_t prop, uint64_t val)
2619{
2620	char buf[64];
2621
2622	(void) snprintf(buf, sizeof (buf), "%llu", (longlong_t)val);
2623	return (zfs_prop_set(zhp, zfs_prop_to_name(prop), buf));
2624}
2625
2626/*
2627 * Similar to zfs_prop_get(), but returns the value as an integer.
2628 */
2629int
2630zfs_prop_get_numeric(zfs_handle_t *zhp, zfs_prop_t prop, uint64_t *value,
2631    zprop_source_t *src, char *statbuf, size_t statlen)
2632{
2633	char *source;
2634
2635	/*
2636	 * Check to see if this property applies to our object
2637	 */
2638	if (!zfs_prop_valid_for_type(prop, zhp->zfs_type)) {
2639		return (zfs_error_fmt(zhp->zfs_hdl, EZFS_PROPTYPE,
2640		    dgettext(TEXT_DOMAIN, "cannot get property '%s'"),
2641		    zfs_prop_to_name(prop)));
2642	}
2643
2644	if (src)
2645		*src = ZPROP_SRC_NONE;
2646
2647	if (get_numeric_property(zhp, prop, src, &source, value) != 0)
2648		return (-1);
2649
2650	get_source(zhp, src, source, statbuf, statlen);
2651
2652	return (0);
2653}
2654
2655static int
2656idmap_id_to_numeric_domain_rid(uid_t id, boolean_t isuser,
2657    char **domainp, idmap_rid_t *ridp)
2658{
2659#ifdef illumos
2660	idmap_get_handle_t *get_hdl = NULL;
2661	idmap_stat status;
2662	int err = EINVAL;
2663
2664	if (idmap_get_create(&get_hdl) != IDMAP_SUCCESS)
2665		goto out;
2666
2667	if (isuser) {
2668		err = idmap_get_sidbyuid(get_hdl, id,
2669		    IDMAP_REQ_FLG_USE_CACHE, domainp, ridp, &status);
2670	} else {
2671		err = idmap_get_sidbygid(get_hdl, id,
2672		    IDMAP_REQ_FLG_USE_CACHE, domainp, ridp, &status);
2673	}
2674	if (err == IDMAP_SUCCESS &&
2675	    idmap_get_mappings(get_hdl) == IDMAP_SUCCESS &&
2676	    status == IDMAP_SUCCESS)
2677		err = 0;
2678	else
2679		err = EINVAL;
2680out:
2681	if (get_hdl)
2682		idmap_get_destroy(get_hdl);
2683	return (err);
2684#else	/* !illumos */
2685	assert(!"invalid code path");
2686	return (EINVAL); // silence compiler warning
2687#endif	/* illumos */
2688}
2689
2690/*
2691 * convert the propname into parameters needed by kernel
2692 * Eg: userquota@ahrens -> ZFS_PROP_USERQUOTA, "", 126829
2693 * Eg: userused@matt@domain -> ZFS_PROP_USERUSED, "S-1-123-456", 789
2694 */
2695static int
2696userquota_propname_decode(const char *propname, boolean_t zoned,
2697    zfs_userquota_prop_t *typep, char *domain, int domainlen, uint64_t *ridp)
2698{
2699	zfs_userquota_prop_t type;
2700	char *cp, *end;
2701	char *numericsid = NULL;
2702	boolean_t isuser;
2703
2704	domain[0] = '\0';
2705	*ridp = 0;
2706	/* Figure out the property type ({user|group}{quota|space}) */
2707	for (type = 0; type < ZFS_NUM_USERQUOTA_PROPS; type++) {
2708		if (strncmp(propname, zfs_userquota_prop_prefixes[type],
2709		    strlen(zfs_userquota_prop_prefixes[type])) == 0)
2710			break;
2711	}
2712	if (type == ZFS_NUM_USERQUOTA_PROPS)
2713		return (EINVAL);
2714	*typep = type;
2715
2716	isuser = (type == ZFS_PROP_USERQUOTA ||
2717	    type == ZFS_PROP_USERUSED);
2718
2719	cp = strchr(propname, '@') + 1;
2720
2721	if (strchr(cp, '@')) {
2722#ifdef illumos
2723		/*
2724		 * It's a SID name (eg "user@domain") that needs to be
2725		 * turned into S-1-domainID-RID.
2726		 */
2727		int flag = 0;
2728		idmap_stat stat, map_stat;
2729		uid_t pid;
2730		idmap_rid_t rid;
2731		idmap_get_handle_t *gh = NULL;
2732
2733		stat = idmap_get_create(&gh);
2734		if (stat != IDMAP_SUCCESS) {
2735			idmap_get_destroy(gh);
2736			return (ENOMEM);
2737		}
2738		if (zoned && getzoneid() == GLOBAL_ZONEID)
2739			return (ENOENT);
2740		if (isuser) {
2741			stat = idmap_getuidbywinname(cp, NULL, flag, &pid);
2742			if (stat < 0)
2743				return (ENOENT);
2744			stat = idmap_get_sidbyuid(gh, pid, flag, &numericsid,
2745			    &rid, &map_stat);
2746		} else {
2747			stat = idmap_getgidbywinname(cp, NULL, flag, &pid);
2748			if (stat < 0)
2749				return (ENOENT);
2750			stat = idmap_get_sidbygid(gh, pid, flag, &numericsid,
2751			    &rid, &map_stat);
2752		}
2753		if (stat < 0) {
2754			idmap_get_destroy(gh);
2755			return (ENOENT);
2756		}
2757		stat = idmap_get_mappings(gh);
2758		idmap_get_destroy(gh);
2759
2760		if (stat < 0) {
2761			return (ENOENT);
2762		}
2763		if (numericsid == NULL)
2764			return (ENOENT);
2765		cp = numericsid;
2766		*ridp = rid;
2767		/* will be further decoded below */
2768#else	/* !illumos */
2769		return (ENOENT);
2770#endif	/* illumos */
2771	}
2772
2773	if (strncmp(cp, "S-1-", 4) == 0) {
2774		/* It's a numeric SID (eg "S-1-234-567-89") */
2775		(void) strlcpy(domain, cp, domainlen);
2776		errno = 0;
2777		if (*ridp == 0) {
2778			cp = strrchr(domain, '-');
2779			*cp = '\0';
2780			cp++;
2781			*ridp = strtoull(cp, &end, 10);
2782		} else {
2783			end = "";
2784		}
2785		if (numericsid) {
2786			free(numericsid);
2787			numericsid = NULL;
2788		}
2789		if (errno != 0 || *end != '\0')
2790			return (EINVAL);
2791	} else if (!isdigit(*cp)) {
2792		/*
2793		 * It's a user/group name (eg "user") that needs to be
2794		 * turned into a uid/gid
2795		 */
2796		if (zoned && getzoneid() == GLOBAL_ZONEID)
2797			return (ENOENT);
2798		if (isuser) {
2799			struct passwd *pw;
2800			pw = getpwnam(cp);
2801			if (pw == NULL)
2802				return (ENOENT);
2803			*ridp = pw->pw_uid;
2804		} else {
2805			struct group *gr;
2806			gr = getgrnam(cp);
2807			if (gr == NULL)
2808				return (ENOENT);
2809			*ridp = gr->gr_gid;
2810		}
2811	} else {
2812		/* It's a user/group ID (eg "12345"). */
2813		uid_t id = strtoul(cp, &end, 10);
2814		idmap_rid_t rid;
2815		char *mapdomain;
2816
2817		if (*end != '\0')
2818			return (EINVAL);
2819		if (id > MAXUID) {
2820			/* It's an ephemeral ID. */
2821			if (idmap_id_to_numeric_domain_rid(id, isuser,
2822			    &mapdomain, &rid) != 0)
2823				return (ENOENT);
2824			(void) strlcpy(domain, mapdomain, domainlen);
2825			*ridp = rid;
2826		} else {
2827			*ridp = id;
2828		}
2829	}
2830
2831	ASSERT3P(numericsid, ==, NULL);
2832	return (0);
2833}
2834
2835static int
2836zfs_prop_get_userquota_common(zfs_handle_t *zhp, const char *propname,
2837    uint64_t *propvalue, zfs_userquota_prop_t *typep)
2838{
2839	int err;
2840	zfs_cmd_t zc = { 0 };
2841
2842	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
2843
2844	err = userquota_propname_decode(propname,
2845	    zfs_prop_get_int(zhp, ZFS_PROP_ZONED),
2846	    typep, zc.zc_value, sizeof (zc.zc_value), &zc.zc_guid);
2847	zc.zc_objset_type = *typep;
2848	if (err)
2849		return (err);
2850
2851	err = ioctl(zhp->zfs_hdl->libzfs_fd, ZFS_IOC_USERSPACE_ONE, &zc);
2852	if (err)
2853		return (err);
2854
2855	*propvalue = zc.zc_cookie;
2856	return (0);
2857}
2858
2859int
2860zfs_prop_get_userquota_int(zfs_handle_t *zhp, const char *propname,
2861    uint64_t *propvalue)
2862{
2863	zfs_userquota_prop_t type;
2864
2865	return (zfs_prop_get_userquota_common(zhp, propname, propvalue,
2866	    &type));
2867}
2868
2869int
2870zfs_prop_get_userquota(zfs_handle_t *zhp, const char *propname,
2871    char *propbuf, int proplen, boolean_t literal)
2872{
2873	int err;
2874	uint64_t propvalue;
2875	zfs_userquota_prop_t type;
2876
2877	err = zfs_prop_get_userquota_common(zhp, propname, &propvalue,
2878	    &type);
2879
2880	if (err)
2881		return (err);
2882
2883	if (literal) {
2884		(void) snprintf(propbuf, proplen, "%llu", propvalue);
2885	} else if (propvalue == 0 &&
2886	    (type == ZFS_PROP_USERQUOTA || type == ZFS_PROP_GROUPQUOTA)) {
2887		(void) strlcpy(propbuf, "none", proplen);
2888	} else {
2889		zfs_nicenum(propvalue, propbuf, proplen);
2890	}
2891	return (0);
2892}
2893
2894int
2895zfs_prop_get_written_int(zfs_handle_t *zhp, const char *propname,
2896    uint64_t *propvalue)
2897{
2898	int err;
2899	zfs_cmd_t zc = { 0 };
2900	const char *snapname;
2901
2902	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
2903
2904	snapname = strchr(propname, '@') + 1;
2905	if (strchr(snapname, '@')) {
2906		(void) strlcpy(zc.zc_value, snapname, sizeof (zc.zc_value));
2907	} else {
2908		/* snapname is the short name, append it to zhp's fsname */
2909		char *cp;
2910
2911		(void) strlcpy(zc.zc_value, zhp->zfs_name,
2912		    sizeof (zc.zc_value));
2913		cp = strchr(zc.zc_value, '@');
2914		if (cp != NULL)
2915			*cp = '\0';
2916		(void) strlcat(zc.zc_value, "@", sizeof (zc.zc_value));
2917		(void) strlcat(zc.zc_value, snapname, sizeof (zc.zc_value));
2918	}
2919
2920	err = ioctl(zhp->zfs_hdl->libzfs_fd, ZFS_IOC_SPACE_WRITTEN, &zc);
2921	if (err)
2922		return (err);
2923
2924	*propvalue = zc.zc_cookie;
2925	return (0);
2926}
2927
2928int
2929zfs_prop_get_written(zfs_handle_t *zhp, const char *propname,
2930    char *propbuf, int proplen, boolean_t literal)
2931{
2932	int err;
2933	uint64_t propvalue;
2934
2935	err = zfs_prop_get_written_int(zhp, propname, &propvalue);
2936
2937	if (err)
2938		return (err);
2939
2940	if (literal) {
2941		(void) snprintf(propbuf, proplen, "%llu", propvalue);
2942	} else {
2943		zfs_nicenum(propvalue, propbuf, proplen);
2944	}
2945	return (0);
2946}
2947
2948/*
2949 * Returns the name of the given zfs handle.
2950 */
2951const char *
2952zfs_get_name(const zfs_handle_t *zhp)
2953{
2954	return (zhp->zfs_name);
2955}
2956
2957/*
2958 * Returns the type of the given zfs handle.
2959 */
2960zfs_type_t
2961zfs_get_type(const zfs_handle_t *zhp)
2962{
2963	return (zhp->zfs_type);
2964}
2965
2966/*
2967 * Is one dataset name a child dataset of another?
2968 *
2969 * Needs to handle these cases:
2970 * Dataset 1	"a/foo"		"a/foo"		"a/foo"		"a/foo"
2971 * Dataset 2	"a/fo"		"a/foobar"	"a/bar/baz"	"a/foo/bar"
2972 * Descendant?	No.		No.		No.		Yes.
2973 */
2974static boolean_t
2975is_descendant(const char *ds1, const char *ds2)
2976{
2977	size_t d1len = strlen(ds1);
2978
2979	/* ds2 can't be a descendant if it's smaller */
2980	if (strlen(ds2) < d1len)
2981		return (B_FALSE);
2982
2983	/* otherwise, compare strings and verify that there's a '/' char */
2984	return (ds2[d1len] == '/' && (strncmp(ds1, ds2, d1len) == 0));
2985}
2986
2987/*
2988 * Given a complete name, return just the portion that refers to the parent.
2989 * Will return -1 if there is no parent (path is just the name of the
2990 * pool).
2991 */
2992static int
2993parent_name(const char *path, char *buf, size_t buflen)
2994{
2995	char *slashp;
2996
2997	(void) strlcpy(buf, path, buflen);
2998
2999	if ((slashp = strrchr(buf, '/')) == NULL)
3000		return (-1);
3001	*slashp = '\0';
3002
3003	return (0);
3004}
3005
3006/*
3007 * If accept_ancestor is false, then check to make sure that the given path has
3008 * a parent, and that it exists.  If accept_ancestor is true, then find the
3009 * closest existing ancestor for the given path.  In prefixlen return the
3010 * length of already existing prefix of the given path.  We also fetch the
3011 * 'zoned' property, which is used to validate property settings when creating
3012 * new datasets.
3013 */
3014static int
3015check_parents(libzfs_handle_t *hdl, const char *path, uint64_t *zoned,
3016    boolean_t accept_ancestor, int *prefixlen)
3017{
3018	zfs_cmd_t zc = { 0 };
3019	char parent[ZFS_MAXNAMELEN];
3020	char *slash;
3021	zfs_handle_t *zhp;
3022	char errbuf[1024];
3023	uint64_t is_zoned;
3024
3025	(void) snprintf(errbuf, sizeof (errbuf),
3026	    dgettext(TEXT_DOMAIN, "cannot create '%s'"), path);
3027
3028	/* get parent, and check to see if this is just a pool */
3029	if (parent_name(path, parent, sizeof (parent)) != 0) {
3030		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3031		    "missing dataset name"));
3032		return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3033	}
3034
3035	/* check to see if the pool exists */
3036	if ((slash = strchr(parent, '/')) == NULL)
3037		slash = parent + strlen(parent);
3038	(void) strncpy(zc.zc_name, parent, slash - parent);
3039	zc.zc_name[slash - parent] = '\0';
3040	if (ioctl(hdl->libzfs_fd, ZFS_IOC_OBJSET_STATS, &zc) != 0 &&
3041	    errno == ENOENT) {
3042		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3043		    "no such pool '%s'"), zc.zc_name);
3044		return (zfs_error(hdl, EZFS_NOENT, errbuf));
3045	}
3046
3047	/* check to see if the parent dataset exists */
3048	while ((zhp = make_dataset_handle(hdl, parent)) == NULL) {
3049		if (errno == ENOENT && accept_ancestor) {
3050			/*
3051			 * Go deeper to find an ancestor, give up on top level.
3052			 */
3053			if (parent_name(parent, parent, sizeof (parent)) != 0) {
3054				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3055				    "no such pool '%s'"), zc.zc_name);
3056				return (zfs_error(hdl, EZFS_NOENT, errbuf));
3057			}
3058		} else if (errno == ENOENT) {
3059			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3060			    "parent does not exist"));
3061			return (zfs_error(hdl, EZFS_NOENT, errbuf));
3062		} else
3063			return (zfs_standard_error(hdl, errno, errbuf));
3064	}
3065
3066	is_zoned = zfs_prop_get_int(zhp, ZFS_PROP_ZONED);
3067	if (zoned != NULL)
3068		*zoned = is_zoned;
3069
3070	/* we are in a non-global zone, but parent is in the global zone */
3071	if (getzoneid() != GLOBAL_ZONEID && !is_zoned) {
3072		(void) zfs_standard_error(hdl, EPERM, errbuf);
3073		zfs_close(zhp);
3074		return (-1);
3075	}
3076
3077	/* make sure parent is a filesystem */
3078	if (zfs_get_type(zhp) != ZFS_TYPE_FILESYSTEM) {
3079		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3080		    "parent is not a filesystem"));
3081		(void) zfs_error(hdl, EZFS_BADTYPE, errbuf);
3082		zfs_close(zhp);
3083		return (-1);
3084	}
3085
3086	zfs_close(zhp);
3087	if (prefixlen != NULL)
3088		*prefixlen = strlen(parent);
3089	return (0);
3090}
3091
3092/*
3093 * Finds whether the dataset of the given type(s) exists.
3094 */
3095boolean_t
3096zfs_dataset_exists(libzfs_handle_t *hdl, const char *path, zfs_type_t types)
3097{
3098	zfs_handle_t *zhp;
3099
3100	if (!zfs_validate_name(hdl, path, types, B_FALSE))
3101		return (B_FALSE);
3102
3103	/*
3104	 * Try to get stats for the dataset, which will tell us if it exists.
3105	 */
3106	if ((zhp = make_dataset_handle(hdl, path)) != NULL) {
3107		int ds_type = zhp->zfs_type;
3108
3109		zfs_close(zhp);
3110		if (types & ds_type)
3111			return (B_TRUE);
3112	}
3113	return (B_FALSE);
3114}
3115
3116/*
3117 * Given a path to 'target', create all the ancestors between
3118 * the prefixlen portion of the path, and the target itself.
3119 * Fail if the initial prefixlen-ancestor does not already exist.
3120 */
3121int
3122create_parents(libzfs_handle_t *hdl, char *target, int prefixlen)
3123{
3124	zfs_handle_t *h;
3125	char *cp;
3126	const char *opname;
3127
3128	/* make sure prefix exists */
3129	cp = target + prefixlen;
3130	if (*cp != '/') {
3131		assert(strchr(cp, '/') == NULL);
3132		h = zfs_open(hdl, target, ZFS_TYPE_FILESYSTEM);
3133	} else {
3134		*cp = '\0';
3135		h = zfs_open(hdl, target, ZFS_TYPE_FILESYSTEM);
3136		*cp = '/';
3137	}
3138	if (h == NULL)
3139		return (-1);
3140	zfs_close(h);
3141
3142	/*
3143	 * Attempt to create, mount, and share any ancestor filesystems,
3144	 * up to the prefixlen-long one.
3145	 */
3146	for (cp = target + prefixlen + 1;
3147	    cp = strchr(cp, '/'); *cp = '/', cp++) {
3148
3149		*cp = '\0';
3150
3151		h = make_dataset_handle(hdl, target);
3152		if (h) {
3153			/* it already exists, nothing to do here */
3154			zfs_close(h);
3155			continue;
3156		}
3157
3158		if (zfs_create(hdl, target, ZFS_TYPE_FILESYSTEM,
3159		    NULL) != 0) {
3160			opname = dgettext(TEXT_DOMAIN, "create");
3161			goto ancestorerr;
3162		}
3163
3164		h = zfs_open(hdl, target, ZFS_TYPE_FILESYSTEM);
3165		if (h == NULL) {
3166			opname = dgettext(TEXT_DOMAIN, "open");
3167			goto ancestorerr;
3168		}
3169
3170		if (zfs_mount(h, NULL, 0) != 0) {
3171			opname = dgettext(TEXT_DOMAIN, "mount");
3172			goto ancestorerr;
3173		}
3174
3175		if (zfs_share(h) != 0) {
3176			opname = dgettext(TEXT_DOMAIN, "share");
3177			goto ancestorerr;
3178		}
3179
3180		zfs_close(h);
3181	}
3182
3183	return (0);
3184
3185ancestorerr:
3186	zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3187	    "failed to %s ancestor '%s'"), opname, target);
3188	return (-1);
3189}
3190
3191/*
3192 * Creates non-existing ancestors of the given path.
3193 */
3194int
3195zfs_create_ancestors(libzfs_handle_t *hdl, const char *path)
3196{
3197	int prefix;
3198	char *path_copy;
3199	int rc;
3200
3201	if (check_parents(hdl, path, NULL, B_TRUE, &prefix) != 0)
3202		return (-1);
3203
3204	if ((path_copy = strdup(path)) != NULL) {
3205		rc = create_parents(hdl, path_copy, prefix);
3206		free(path_copy);
3207	}
3208	if (path_copy == NULL || rc != 0)
3209		return (-1);
3210
3211	return (0);
3212}
3213
3214/*
3215 * Create a new filesystem or volume.
3216 */
3217int
3218zfs_create(libzfs_handle_t *hdl, const char *path, zfs_type_t type,
3219    nvlist_t *props)
3220{
3221	int ret;
3222	uint64_t size = 0;
3223	uint64_t blocksize = zfs_prop_default_numeric(ZFS_PROP_VOLBLOCKSIZE);
3224	char errbuf[1024];
3225	uint64_t zoned;
3226	dmu_objset_type_t ost;
3227
3228	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3229	    "cannot create '%s'"), path);
3230
3231	/* validate the path, taking care to note the extended error message */
3232	if (!zfs_validate_name(hdl, path, type, B_TRUE))
3233		return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3234
3235	/* validate parents exist */
3236	if (check_parents(hdl, path, &zoned, B_FALSE, NULL) != 0)
3237		return (-1);
3238
3239	/*
3240	 * The failure modes when creating a dataset of a different type over
3241	 * one that already exists is a little strange.  In particular, if you
3242	 * try to create a dataset on top of an existing dataset, the ioctl()
3243	 * will return ENOENT, not EEXIST.  To prevent this from happening, we
3244	 * first try to see if the dataset exists.
3245	 */
3246	if (zfs_dataset_exists(hdl, path, ZFS_TYPE_DATASET)) {
3247		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3248		    "dataset already exists"));
3249		return (zfs_error(hdl, EZFS_EXISTS, errbuf));
3250	}
3251
3252	if (type == ZFS_TYPE_VOLUME)
3253		ost = DMU_OST_ZVOL;
3254	else
3255		ost = DMU_OST_ZFS;
3256
3257	if (props && (props = zfs_valid_proplist(hdl, type, props,
3258	    zoned, NULL, errbuf)) == 0)
3259		return (-1);
3260
3261	if (type == ZFS_TYPE_VOLUME) {
3262		/*
3263		 * If we are creating a volume, the size and block size must
3264		 * satisfy a few restraints.  First, the blocksize must be a
3265		 * valid block size between SPA_{MIN,MAX}BLOCKSIZE.  Second, the
3266		 * volsize must be a multiple of the block size, and cannot be
3267		 * zero.
3268		 */
3269		if (props == NULL || nvlist_lookup_uint64(props,
3270		    zfs_prop_to_name(ZFS_PROP_VOLSIZE), &size) != 0) {
3271			nvlist_free(props);
3272			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3273			    "missing volume size"));
3274			return (zfs_error(hdl, EZFS_BADPROP, errbuf));
3275		}
3276
3277		if ((ret = nvlist_lookup_uint64(props,
3278		    zfs_prop_to_name(ZFS_PROP_VOLBLOCKSIZE),
3279		    &blocksize)) != 0) {
3280			if (ret == ENOENT) {
3281				blocksize = zfs_prop_default_numeric(
3282				    ZFS_PROP_VOLBLOCKSIZE);
3283			} else {
3284				nvlist_free(props);
3285				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3286				    "missing volume block size"));
3287				return (zfs_error(hdl, EZFS_BADPROP, errbuf));
3288			}
3289		}
3290
3291		if (size == 0) {
3292			nvlist_free(props);
3293			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3294			    "volume size cannot be zero"));
3295			return (zfs_error(hdl, EZFS_BADPROP, errbuf));
3296		}
3297
3298		if (size % blocksize != 0) {
3299			nvlist_free(props);
3300			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3301			    "volume size must be a multiple of volume block "
3302			    "size"));
3303			return (zfs_error(hdl, EZFS_BADPROP, errbuf));
3304		}
3305	}
3306
3307	/* create the dataset */
3308	ret = lzc_create(path, ost, props);
3309	nvlist_free(props);
3310
3311	/* check for failure */
3312	if (ret != 0) {
3313		char parent[ZFS_MAXNAMELEN];
3314		(void) parent_name(path, parent, sizeof (parent));
3315
3316		switch (errno) {
3317		case ENOENT:
3318			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3319			    "no such parent '%s'"), parent);
3320			return (zfs_error(hdl, EZFS_NOENT, errbuf));
3321
3322		case EINVAL:
3323			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3324			    "parent '%s' is not a filesystem"), parent);
3325			return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
3326
3327		case EDOM:
3328			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3329			    "volume block size must be power of 2 from "
3330			    "512B to 128KB"));
3331
3332			return (zfs_error(hdl, EZFS_BADPROP, errbuf));
3333
3334		case ENOTSUP:
3335			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3336			    "pool must be upgraded to set this "
3337			    "property or value"));
3338			return (zfs_error(hdl, EZFS_BADVERSION, errbuf));
3339#ifdef _ILP32
3340		case EOVERFLOW:
3341			/*
3342			 * This platform can't address a volume this big.
3343			 */
3344			if (type == ZFS_TYPE_VOLUME)
3345				return (zfs_error(hdl, EZFS_VOLTOOBIG,
3346				    errbuf));
3347#endif
3348			/* FALLTHROUGH */
3349		default:
3350			return (zfs_standard_error(hdl, errno, errbuf));
3351		}
3352	}
3353
3354	return (0);
3355}
3356
3357/*
3358 * Destroys the given dataset.  The caller must make sure that the filesystem
3359 * isn't mounted, and that there are no active dependents. If the file system
3360 * does not exist this function does nothing.
3361 */
3362int
3363zfs_destroy(zfs_handle_t *zhp, boolean_t defer)
3364{
3365	zfs_cmd_t zc = { 0 };
3366
3367	if (zhp->zfs_type == ZFS_TYPE_BOOKMARK) {
3368		nvlist_t *nv = fnvlist_alloc();
3369		fnvlist_add_boolean(nv, zhp->zfs_name);
3370		int error = lzc_destroy_bookmarks(nv, NULL);
3371		fnvlist_free(nv);
3372		if (error != 0) {
3373			return (zfs_standard_error_fmt(zhp->zfs_hdl, errno,
3374			    dgettext(TEXT_DOMAIN, "cannot destroy '%s'"),
3375			    zhp->zfs_name));
3376		}
3377		return (0);
3378	}
3379
3380	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
3381
3382	if (ZFS_IS_VOLUME(zhp)) {
3383		zc.zc_objset_type = DMU_OST_ZVOL;
3384	} else {
3385		zc.zc_objset_type = DMU_OST_ZFS;
3386	}
3387
3388	zc.zc_defer_destroy = defer;
3389	if (zfs_ioctl(zhp->zfs_hdl, ZFS_IOC_DESTROY, &zc) != 0 &&
3390	    errno != ENOENT) {
3391		return (zfs_standard_error_fmt(zhp->zfs_hdl, errno,
3392		    dgettext(TEXT_DOMAIN, "cannot destroy '%s'"),
3393		    zhp->zfs_name));
3394	}
3395
3396	remove_mountpoint(zhp);
3397
3398	return (0);
3399}
3400
3401struct destroydata {
3402	nvlist_t *nvl;
3403	const char *snapname;
3404};
3405
3406static int
3407zfs_check_snap_cb(zfs_handle_t *zhp, void *arg)
3408{
3409	struct destroydata *dd = arg;
3410	char name[ZFS_MAXNAMELEN];
3411	int rv = 0;
3412
3413	(void) snprintf(name, sizeof (name),
3414	    "%s@%s", zhp->zfs_name, dd->snapname);
3415
3416	if (lzc_exists(name))
3417		verify(nvlist_add_boolean(dd->nvl, name) == 0);
3418
3419	rv = zfs_iter_filesystems(zhp, zfs_check_snap_cb, dd);
3420	zfs_close(zhp);
3421	return (rv);
3422}
3423
3424/*
3425 * Destroys all snapshots with the given name in zhp & descendants.
3426 */
3427int
3428zfs_destroy_snaps(zfs_handle_t *zhp, char *snapname, boolean_t defer)
3429{
3430	int ret;
3431	struct destroydata dd = { 0 };
3432
3433	dd.snapname = snapname;
3434	verify(nvlist_alloc(&dd.nvl, NV_UNIQUE_NAME, 0) == 0);
3435	(void) zfs_check_snap_cb(zfs_handle_dup(zhp), &dd);
3436
3437	if (nvlist_empty(dd.nvl)) {
3438		ret = zfs_standard_error_fmt(zhp->zfs_hdl, ENOENT,
3439		    dgettext(TEXT_DOMAIN, "cannot destroy '%s@%s'"),
3440		    zhp->zfs_name, snapname);
3441	} else {
3442		ret = zfs_destroy_snaps_nvl(zhp->zfs_hdl, dd.nvl, defer);
3443	}
3444	nvlist_free(dd.nvl);
3445	return (ret);
3446}
3447
3448/*
3449 * Destroys all the snapshots named in the nvlist.
3450 */
3451int
3452zfs_destroy_snaps_nvl(libzfs_handle_t *hdl, nvlist_t *snaps, boolean_t defer)
3453{
3454	int ret;
3455	nvlist_t *errlist;
3456
3457	ret = lzc_destroy_snaps(snaps, defer, &errlist);
3458
3459	if (ret == 0)
3460		return (0);
3461
3462	if (nvlist_empty(errlist)) {
3463		char errbuf[1024];
3464		(void) snprintf(errbuf, sizeof (errbuf),
3465		    dgettext(TEXT_DOMAIN, "cannot destroy snapshots"));
3466
3467		ret = zfs_standard_error(hdl, ret, errbuf);
3468	}
3469	for (nvpair_t *pair = nvlist_next_nvpair(errlist, NULL);
3470	    pair != NULL; pair = nvlist_next_nvpair(errlist, pair)) {
3471		char errbuf[1024];
3472		(void) snprintf(errbuf, sizeof (errbuf),
3473		    dgettext(TEXT_DOMAIN, "cannot destroy snapshot %s"),
3474		    nvpair_name(pair));
3475
3476		switch (fnvpair_value_int32(pair)) {
3477		case EEXIST:
3478			zfs_error_aux(hdl,
3479			    dgettext(TEXT_DOMAIN, "snapshot is cloned"));
3480			ret = zfs_error(hdl, EZFS_EXISTS, errbuf);
3481			break;
3482		default:
3483			ret = zfs_standard_error(hdl, errno, errbuf);
3484			break;
3485		}
3486	}
3487
3488	return (ret);
3489}
3490
3491/*
3492 * Clones the given dataset.  The target must be of the same type as the source.
3493 */
3494int
3495zfs_clone(zfs_handle_t *zhp, const char *target, nvlist_t *props)
3496{
3497	char parent[ZFS_MAXNAMELEN];
3498	int ret;
3499	char errbuf[1024];
3500	libzfs_handle_t *hdl = zhp->zfs_hdl;
3501	uint64_t zoned;
3502
3503	assert(zhp->zfs_type == ZFS_TYPE_SNAPSHOT);
3504
3505	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3506	    "cannot create '%s'"), target);
3507
3508	/* validate the target/clone name */
3509	if (!zfs_validate_name(hdl, target, ZFS_TYPE_FILESYSTEM, B_TRUE))
3510		return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3511
3512	/* validate parents exist */
3513	if (check_parents(hdl, target, &zoned, B_FALSE, NULL) != 0)
3514		return (-1);
3515
3516	(void) parent_name(target, parent, sizeof (parent));
3517
3518	/* do the clone */
3519
3520	if (props) {
3521		zfs_type_t type;
3522		if (ZFS_IS_VOLUME(zhp)) {
3523			type = ZFS_TYPE_VOLUME;
3524		} else {
3525			type = ZFS_TYPE_FILESYSTEM;
3526		}
3527		if ((props = zfs_valid_proplist(hdl, type, props, zoned,
3528		    zhp, errbuf)) == NULL)
3529			return (-1);
3530	}
3531
3532	ret = lzc_clone(target, zhp->zfs_name, props);
3533	nvlist_free(props);
3534
3535	if (ret != 0) {
3536		switch (errno) {
3537
3538		case ENOENT:
3539			/*
3540			 * The parent doesn't exist.  We should have caught this
3541			 * above, but there may a race condition that has since
3542			 * destroyed the parent.
3543			 *
3544			 * At this point, we don't know whether it's the source
3545			 * that doesn't exist anymore, or whether the target
3546			 * dataset doesn't exist.
3547			 */
3548			zfs_error_aux(zhp->zfs_hdl, dgettext(TEXT_DOMAIN,
3549			    "no such parent '%s'"), parent);
3550			return (zfs_error(zhp->zfs_hdl, EZFS_NOENT, errbuf));
3551
3552		case EXDEV:
3553			zfs_error_aux(zhp->zfs_hdl, dgettext(TEXT_DOMAIN,
3554			    "source and target pools differ"));
3555			return (zfs_error(zhp->zfs_hdl, EZFS_CROSSTARGET,
3556			    errbuf));
3557
3558		default:
3559			return (zfs_standard_error(zhp->zfs_hdl, errno,
3560			    errbuf));
3561		}
3562	}
3563
3564	return (ret);
3565}
3566
3567/*
3568 * Promotes the given clone fs to be the clone parent.
3569 */
3570int
3571zfs_promote(zfs_handle_t *zhp)
3572{
3573	libzfs_handle_t *hdl = zhp->zfs_hdl;
3574	zfs_cmd_t zc = { 0 };
3575	char parent[MAXPATHLEN];
3576	int ret;
3577	char errbuf[1024];
3578
3579	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3580	    "cannot promote '%s'"), zhp->zfs_name);
3581
3582	if (zhp->zfs_type == ZFS_TYPE_SNAPSHOT) {
3583		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3584		    "snapshots can not be promoted"));
3585		return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
3586	}
3587
3588	(void) strlcpy(parent, zhp->zfs_dmustats.dds_origin, sizeof (parent));
3589	if (parent[0] == '\0') {
3590		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3591		    "not a cloned filesystem"));
3592		return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
3593	}
3594
3595	(void) strlcpy(zc.zc_value, zhp->zfs_dmustats.dds_origin,
3596	    sizeof (zc.zc_value));
3597	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
3598	ret = zfs_ioctl(hdl, ZFS_IOC_PROMOTE, &zc);
3599
3600	if (ret != 0) {
3601		int save_errno = errno;
3602
3603		switch (save_errno) {
3604		case EEXIST:
3605			/* There is a conflicting snapshot name. */
3606			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3607			    "conflicting snapshot '%s' from parent '%s'"),
3608			    zc.zc_string, parent);
3609			return (zfs_error(hdl, EZFS_EXISTS, errbuf));
3610
3611		default:
3612			return (zfs_standard_error(hdl, save_errno, errbuf));
3613		}
3614	}
3615	return (ret);
3616}
3617
3618typedef struct snapdata {
3619	nvlist_t *sd_nvl;
3620	const char *sd_snapname;
3621} snapdata_t;
3622
3623static int
3624zfs_snapshot_cb(zfs_handle_t *zhp, void *arg)
3625{
3626	snapdata_t *sd = arg;
3627	char name[ZFS_MAXNAMELEN];
3628	int rv = 0;
3629
3630	if (zfs_prop_get_int(zhp, ZFS_PROP_INCONSISTENT) == 0) {
3631		(void) snprintf(name, sizeof (name),
3632		    "%s@%s", zfs_get_name(zhp), sd->sd_snapname);
3633
3634		fnvlist_add_boolean(sd->sd_nvl, name);
3635
3636		rv = zfs_iter_filesystems(zhp, zfs_snapshot_cb, sd);
3637	}
3638	zfs_close(zhp);
3639
3640	return (rv);
3641}
3642
3643/*
3644 * Creates snapshots.  The keys in the snaps nvlist are the snapshots to be
3645 * created.
3646 */
3647int
3648zfs_snapshot_nvl(libzfs_handle_t *hdl, nvlist_t *snaps, nvlist_t *props)
3649{
3650	int ret;
3651	char errbuf[1024];
3652	nvpair_t *elem;
3653	nvlist_t *errors;
3654
3655	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3656	    "cannot create snapshots "));
3657
3658	elem = NULL;
3659	while ((elem = nvlist_next_nvpair(snaps, elem)) != NULL) {
3660		const char *snapname = nvpair_name(elem);
3661
3662		/* validate the target name */
3663		if (!zfs_validate_name(hdl, snapname, ZFS_TYPE_SNAPSHOT,
3664		    B_TRUE)) {
3665			(void) snprintf(errbuf, sizeof (errbuf),
3666			    dgettext(TEXT_DOMAIN,
3667			    "cannot create snapshot '%s'"), snapname);
3668			return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3669		}
3670	}
3671
3672	if (props != NULL &&
3673	    (props = zfs_valid_proplist(hdl, ZFS_TYPE_SNAPSHOT,
3674	    props, B_FALSE, NULL, errbuf)) == NULL) {
3675		return (-1);
3676	}
3677
3678	ret = lzc_snapshot(snaps, props, &errors);
3679
3680	if (ret != 0) {
3681		boolean_t printed = B_FALSE;
3682		for (elem = nvlist_next_nvpair(errors, NULL);
3683		    elem != NULL;
3684		    elem = nvlist_next_nvpair(errors, elem)) {
3685			(void) snprintf(errbuf, sizeof (errbuf),
3686			    dgettext(TEXT_DOMAIN,
3687			    "cannot create snapshot '%s'"), nvpair_name(elem));
3688			(void) zfs_standard_error(hdl,
3689			    fnvpair_value_int32(elem), errbuf);
3690			printed = B_TRUE;
3691		}
3692		if (!printed) {
3693			switch (ret) {
3694			case EXDEV:
3695				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3696				    "multiple snapshots of same "
3697				    "fs not allowed"));
3698				(void) zfs_error(hdl, EZFS_EXISTS, errbuf);
3699
3700				break;
3701			default:
3702				(void) zfs_standard_error(hdl, ret, errbuf);
3703			}
3704		}
3705	}
3706
3707	nvlist_free(props);
3708	nvlist_free(errors);
3709	return (ret);
3710}
3711
3712int
3713zfs_snapshot(libzfs_handle_t *hdl, const char *path, boolean_t recursive,
3714    nvlist_t *props)
3715{
3716	int ret;
3717	snapdata_t sd = { 0 };
3718	char fsname[ZFS_MAXNAMELEN];
3719	char *cp;
3720	zfs_handle_t *zhp;
3721	char errbuf[1024];
3722
3723	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3724	    "cannot snapshot %s"), path);
3725
3726	if (!zfs_validate_name(hdl, path, ZFS_TYPE_SNAPSHOT, B_TRUE))
3727		return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3728
3729	(void) strlcpy(fsname, path, sizeof (fsname));
3730	cp = strchr(fsname, '@');
3731	*cp = '\0';
3732	sd.sd_snapname = cp + 1;
3733
3734	if ((zhp = zfs_open(hdl, fsname, ZFS_TYPE_FILESYSTEM |
3735	    ZFS_TYPE_VOLUME)) == NULL) {
3736		return (-1);
3737	}
3738
3739	verify(nvlist_alloc(&sd.sd_nvl, NV_UNIQUE_NAME, 0) == 0);
3740	if (recursive) {
3741		(void) zfs_snapshot_cb(zfs_handle_dup(zhp), &sd);
3742	} else {
3743		fnvlist_add_boolean(sd.sd_nvl, path);
3744	}
3745
3746	ret = zfs_snapshot_nvl(hdl, sd.sd_nvl, props);
3747	nvlist_free(sd.sd_nvl);
3748	zfs_close(zhp);
3749	return (ret);
3750}
3751
3752/*
3753 * Destroy any more recent snapshots.  We invoke this callback on any dependents
3754 * of the snapshot first.  If the 'cb_dependent' member is non-zero, then this
3755 * is a dependent and we should just destroy it without checking the transaction
3756 * group.
3757 */
3758typedef struct rollback_data {
3759	const char	*cb_target;		/* the snapshot */
3760	uint64_t	cb_create;		/* creation time reference */
3761	boolean_t	cb_error;
3762	boolean_t	cb_force;
3763} rollback_data_t;
3764
3765static int
3766rollback_destroy_dependent(zfs_handle_t *zhp, void *data)
3767{
3768	rollback_data_t *cbp = data;
3769	prop_changelist_t *clp;
3770
3771	/* We must destroy this clone; first unmount it */
3772	clp = changelist_gather(zhp, ZFS_PROP_NAME, 0,
3773	    cbp->cb_force ? MS_FORCE: 0);
3774	if (clp == NULL || changelist_prefix(clp) != 0) {
3775		cbp->cb_error = B_TRUE;
3776		zfs_close(zhp);
3777		return (0);
3778	}
3779	if (zfs_destroy(zhp, B_FALSE) != 0)
3780		cbp->cb_error = B_TRUE;
3781	else
3782		changelist_remove(clp, zhp->zfs_name);
3783	(void) changelist_postfix(clp);
3784	changelist_free(clp);
3785
3786	zfs_close(zhp);
3787	return (0);
3788}
3789
3790static int
3791rollback_destroy(zfs_handle_t *zhp, void *data)
3792{
3793	rollback_data_t *cbp = data;
3794
3795	if (zfs_prop_get_int(zhp, ZFS_PROP_CREATETXG) > cbp->cb_create) {
3796		cbp->cb_error |= zfs_iter_dependents(zhp, B_FALSE,
3797		    rollback_destroy_dependent, cbp);
3798
3799		cbp->cb_error |= zfs_destroy(zhp, B_FALSE);
3800	}
3801
3802	zfs_close(zhp);
3803	return (0);
3804}
3805
3806/*
3807 * Given a dataset, rollback to a specific snapshot, discarding any
3808 * data changes since then and making it the active dataset.
3809 *
3810 * Any snapshots and bookmarks more recent than the target are
3811 * destroyed, along with their dependents (i.e. clones).
3812 */
3813int
3814zfs_rollback(zfs_handle_t *zhp, zfs_handle_t *snap, boolean_t force)
3815{
3816	rollback_data_t cb = { 0 };
3817	int err;
3818	boolean_t restore_resv = 0;
3819	uint64_t old_volsize, new_volsize;
3820	zfs_prop_t resv_prop;
3821
3822	assert(zhp->zfs_type == ZFS_TYPE_FILESYSTEM ||
3823	    zhp->zfs_type == ZFS_TYPE_VOLUME);
3824
3825	/*
3826	 * Destroy all recent snapshots and their dependents.
3827	 */
3828	cb.cb_force = force;
3829	cb.cb_target = snap->zfs_name;
3830	cb.cb_create = zfs_prop_get_int(snap, ZFS_PROP_CREATETXG);
3831	(void) zfs_iter_snapshots(zhp, B_FALSE, rollback_destroy, &cb);
3832	(void) zfs_iter_bookmarks(zhp, rollback_destroy, &cb);
3833
3834	if (cb.cb_error)
3835		return (-1);
3836
3837	/*
3838	 * Now that we have verified that the snapshot is the latest,
3839	 * rollback to the given snapshot.
3840	 */
3841
3842	if (zhp->zfs_type == ZFS_TYPE_VOLUME) {
3843		if (zfs_which_resv_prop(zhp, &resv_prop) < 0)
3844			return (-1);
3845		old_volsize = zfs_prop_get_int(zhp, ZFS_PROP_VOLSIZE);
3846		restore_resv =
3847		    (old_volsize == zfs_prop_get_int(zhp, resv_prop));
3848	}
3849
3850	/*
3851	 * We rely on zfs_iter_children() to verify that there are no
3852	 * newer snapshots for the given dataset.  Therefore, we can
3853	 * simply pass the name on to the ioctl() call.  There is still
3854	 * an unlikely race condition where the user has taken a
3855	 * snapshot since we verified that this was the most recent.
3856	 */
3857	err = lzc_rollback(zhp->zfs_name, NULL, 0);
3858	if (err != 0) {
3859		(void) zfs_standard_error_fmt(zhp->zfs_hdl, errno,
3860		    dgettext(TEXT_DOMAIN, "cannot rollback '%s'"),
3861		    zhp->zfs_name);
3862		return (err);
3863	}
3864
3865	/*
3866	 * For volumes, if the pre-rollback volsize matched the pre-
3867	 * rollback reservation and the volsize has changed then set
3868	 * the reservation property to the post-rollback volsize.
3869	 * Make a new handle since the rollback closed the dataset.
3870	 */
3871	if ((zhp->zfs_type == ZFS_TYPE_VOLUME) &&
3872	    (zhp = make_dataset_handle(zhp->zfs_hdl, zhp->zfs_name))) {
3873		if (restore_resv) {
3874			new_volsize = zfs_prop_get_int(zhp, ZFS_PROP_VOLSIZE);
3875			if (old_volsize != new_volsize)
3876				err = zfs_prop_set_int(zhp, resv_prop,
3877				    new_volsize);
3878		}
3879		zfs_close(zhp);
3880	}
3881	return (err);
3882}
3883
3884/*
3885 * Renames the given dataset.
3886 */
3887int
3888zfs_rename(zfs_handle_t *zhp, const char *source, const char *target,
3889    renameflags_t flags)
3890{
3891	int ret;
3892	zfs_cmd_t zc = { 0 };
3893	char *delim;
3894	prop_changelist_t *cl = NULL;
3895	zfs_handle_t *zhrp = NULL;
3896	char *parentname = NULL;
3897	char parent[ZFS_MAXNAMELEN];
3898	char property[ZFS_MAXPROPLEN];
3899	libzfs_handle_t *hdl = zhp->zfs_hdl;
3900	char errbuf[1024];
3901
3902	/* if we have the same exact name, just return success */
3903	if (strcmp(zhp->zfs_name, target) == 0)
3904		return (0);
3905
3906	(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
3907	    "cannot rename to '%s'"), target);
3908
3909	if (source != NULL) {
3910		/*
3911		 * This is recursive snapshots rename, put snapshot name
3912		 * (that might not exist) into zfs_name.
3913		 */
3914		assert(flags.recurse);
3915
3916		(void) strlcat(zhp->zfs_name, "@", sizeof(zhp->zfs_name));
3917		(void) strlcat(zhp->zfs_name, source, sizeof(zhp->zfs_name));
3918		zhp->zfs_type = ZFS_TYPE_SNAPSHOT;
3919	}
3920
3921	/*
3922	 * Make sure the target name is valid
3923	 */
3924	if (zhp->zfs_type == ZFS_TYPE_SNAPSHOT) {
3925		if ((strchr(target, '@') == NULL) ||
3926		    *target == '@') {
3927			/*
3928			 * Snapshot target name is abbreviated,
3929			 * reconstruct full dataset name
3930			 */
3931			(void) strlcpy(parent, zhp->zfs_name,
3932			    sizeof (parent));
3933			delim = strchr(parent, '@');
3934			if (strchr(target, '@') == NULL)
3935				*(++delim) = '\0';
3936			else
3937				*delim = '\0';
3938			(void) strlcat(parent, target, sizeof (parent));
3939			target = parent;
3940		} else {
3941			/*
3942			 * Make sure we're renaming within the same dataset.
3943			 */
3944			delim = strchr(target, '@');
3945			if (strncmp(zhp->zfs_name, target, delim - target)
3946			    != 0 || zhp->zfs_name[delim - target] != '@') {
3947				zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3948				    "snapshots must be part of same "
3949				    "dataset"));
3950				return (zfs_error(hdl, EZFS_CROSSTARGET,
3951				    errbuf));
3952			}
3953		}
3954		if (!zfs_validate_name(hdl, target, zhp->zfs_type, B_TRUE))
3955			return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3956	} else {
3957		if (flags.recurse) {
3958			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3959			    "recursive rename must be a snapshot"));
3960			return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
3961		}
3962
3963		if (!zfs_validate_name(hdl, target, zhp->zfs_type, B_TRUE))
3964			return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3965
3966		/* validate parents */
3967		if (check_parents(hdl, target, NULL, B_FALSE, NULL) != 0)
3968			return (-1);
3969
3970		/* make sure we're in the same pool */
3971		verify((delim = strchr(target, '/')) != NULL);
3972		if (strncmp(zhp->zfs_name, target, delim - target) != 0 ||
3973		    zhp->zfs_name[delim - target] != '/') {
3974			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3975			    "datasets must be within same pool"));
3976			return (zfs_error(hdl, EZFS_CROSSTARGET, errbuf));
3977		}
3978
3979		/* new name cannot be a child of the current dataset name */
3980		if (is_descendant(zhp->zfs_name, target)) {
3981			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3982			    "New dataset name cannot be a descendant of "
3983			    "current dataset name"));
3984			return (zfs_error(hdl, EZFS_INVALIDNAME, errbuf));
3985		}
3986	}
3987
3988	(void) snprintf(errbuf, sizeof (errbuf),
3989	    dgettext(TEXT_DOMAIN, "cannot rename '%s'"), zhp->zfs_name);
3990
3991	if (getzoneid() == GLOBAL_ZONEID &&
3992	    zfs_prop_get_int(zhp, ZFS_PROP_ZONED)) {
3993		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
3994		    "dataset is used in a non-global zone"));
3995		return (zfs_error(hdl, EZFS_ZONED, errbuf));
3996	}
3997
3998	/*
3999	 * Avoid unmounting file systems with mountpoint property set to
4000	 * 'legacy' or 'none' even if -u option is not given.
4001	 */
4002	if (zhp->zfs_type == ZFS_TYPE_FILESYSTEM &&
4003	    !flags.recurse && !flags.nounmount &&
4004	    zfs_prop_get(zhp, ZFS_PROP_MOUNTPOINT, property,
4005	    sizeof (property), NULL, NULL, 0, B_FALSE) == 0 &&
4006	    (strcmp(property, "legacy") == 0 ||
4007	     strcmp(property, "none") == 0)) {
4008		flags.nounmount = B_TRUE;
4009	}
4010	if (flags.recurse) {
4011
4012		parentname = zfs_strdup(zhp->zfs_hdl, zhp->zfs_name);
4013		if (parentname == NULL) {
4014			ret = -1;
4015			goto error;
4016		}
4017		delim = strchr(parentname, '@');
4018		*delim = '\0';
4019		zhrp = zfs_open(zhp->zfs_hdl, parentname, ZFS_TYPE_DATASET);
4020		if (zhrp == NULL) {
4021			ret = -1;
4022			goto error;
4023		}
4024	} else if (zhp->zfs_type != ZFS_TYPE_SNAPSHOT) {
4025		if ((cl = changelist_gather(zhp, ZFS_PROP_NAME,
4026		    flags.nounmount ? CL_GATHER_DONT_UNMOUNT : 0,
4027		    flags.forceunmount ? MS_FORCE : 0)) == NULL) {
4028			return (-1);
4029		}
4030
4031		if (changelist_haszonedchild(cl)) {
4032			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4033			    "child dataset with inherited mountpoint is used "
4034			    "in a non-global zone"));
4035			(void) zfs_error(hdl, EZFS_ZONED, errbuf);
4036			goto error;
4037		}
4038
4039		if ((ret = changelist_prefix(cl)) != 0)
4040			goto error;
4041	}
4042
4043	if (ZFS_IS_VOLUME(zhp))
4044		zc.zc_objset_type = DMU_OST_ZVOL;
4045	else
4046		zc.zc_objset_type = DMU_OST_ZFS;
4047
4048	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
4049	(void) strlcpy(zc.zc_value, target, sizeof (zc.zc_value));
4050
4051	zc.zc_cookie = flags.recurse ? 1 : 0;
4052	if (flags.nounmount)
4053		zc.zc_cookie |= 2;
4054
4055	if ((ret = zfs_ioctl(zhp->zfs_hdl, ZFS_IOC_RENAME, &zc)) != 0) {
4056		/*
4057		 * if it was recursive, the one that actually failed will
4058		 * be in zc.zc_name
4059		 */
4060		(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
4061		    "cannot rename '%s'"), zc.zc_name);
4062
4063		if (flags.recurse && errno == EEXIST) {
4064			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4065			    "a child dataset already has a snapshot "
4066			    "with the new name"));
4067			(void) zfs_error(hdl, EZFS_EXISTS, errbuf);
4068		} else {
4069			(void) zfs_standard_error(zhp->zfs_hdl, errno, errbuf);
4070		}
4071
4072		/*
4073		 * On failure, we still want to remount any filesystems that
4074		 * were previously mounted, so we don't alter the system state.
4075		 */
4076		if (cl != NULL)
4077			(void) changelist_postfix(cl);
4078	} else {
4079		if (cl != NULL) {
4080			changelist_rename(cl, zfs_get_name(zhp), target);
4081			ret = changelist_postfix(cl);
4082		}
4083	}
4084
4085error:
4086	if (parentname != NULL) {
4087		free(parentname);
4088	}
4089	if (zhrp != NULL) {
4090		zfs_close(zhrp);
4091	}
4092	if (cl != NULL) {
4093		changelist_free(cl);
4094	}
4095	return (ret);
4096}
4097
4098nvlist_t *
4099zfs_get_user_props(zfs_handle_t *zhp)
4100{
4101	return (zhp->zfs_user_props);
4102}
4103
4104nvlist_t *
4105zfs_get_recvd_props(zfs_handle_t *zhp)
4106{
4107	if (zhp->zfs_recvd_props == NULL)
4108		if (get_recvd_props_ioctl(zhp) != 0)
4109			return (NULL);
4110	return (zhp->zfs_recvd_props);
4111}
4112
4113/*
4114 * This function is used by 'zfs list' to determine the exact set of columns to
4115 * display, and their maximum widths.  This does two main things:
4116 *
4117 *      - If this is a list of all properties, then expand the list to include
4118 *        all native properties, and set a flag so that for each dataset we look
4119 *        for new unique user properties and add them to the list.
4120 *
4121 *      - For non fixed-width properties, keep track of the maximum width seen
4122 *        so that we can size the column appropriately. If the user has
4123 *        requested received property values, we also need to compute the width
4124 *        of the RECEIVED column.
4125 */
4126int
4127zfs_expand_proplist(zfs_handle_t *zhp, zprop_list_t **plp, boolean_t received,
4128    boolean_t literal)
4129{
4130	libzfs_handle_t *hdl = zhp->zfs_hdl;
4131	zprop_list_t *entry;
4132	zprop_list_t **last, **start;
4133	nvlist_t *userprops, *propval;
4134	nvpair_t *elem;
4135	char *strval;
4136	char buf[ZFS_MAXPROPLEN];
4137
4138	if (zprop_expand_list(hdl, plp, ZFS_TYPE_DATASET) != 0)
4139		return (-1);
4140
4141	userprops = zfs_get_user_props(zhp);
4142
4143	entry = *plp;
4144	if (entry->pl_all && nvlist_next_nvpair(userprops, NULL) != NULL) {
4145		/*
4146		 * Go through and add any user properties as necessary.  We
4147		 * start by incrementing our list pointer to the first
4148		 * non-native property.
4149		 */
4150		start = plp;
4151		while (*start != NULL) {
4152			if ((*start)->pl_prop == ZPROP_INVAL)
4153				break;
4154			start = &(*start)->pl_next;
4155		}
4156
4157		elem = NULL;
4158		while ((elem = nvlist_next_nvpair(userprops, elem)) != NULL) {
4159			/*
4160			 * See if we've already found this property in our list.
4161			 */
4162			for (last = start; *last != NULL;
4163			    last = &(*last)->pl_next) {
4164				if (strcmp((*last)->pl_user_prop,
4165				    nvpair_name(elem)) == 0)
4166					break;
4167			}
4168
4169			if (*last == NULL) {
4170				if ((entry = zfs_alloc(hdl,
4171				    sizeof (zprop_list_t))) == NULL ||
4172				    ((entry->pl_user_prop = zfs_strdup(hdl,
4173				    nvpair_name(elem)))) == NULL) {
4174					free(entry);
4175					return (-1);
4176				}
4177
4178				entry->pl_prop = ZPROP_INVAL;
4179				entry->pl_width = strlen(nvpair_name(elem));
4180				entry->pl_all = B_TRUE;
4181				*last = entry;
4182			}
4183		}
4184	}
4185
4186	/*
4187	 * Now go through and check the width of any non-fixed columns
4188	 */
4189	for (entry = *plp; entry != NULL; entry = entry->pl_next) {
4190		if (entry->pl_fixed && !literal)
4191			continue;
4192
4193		if (entry->pl_prop != ZPROP_INVAL) {
4194			if (zfs_prop_get(zhp, entry->pl_prop,
4195			    buf, sizeof (buf), NULL, NULL, 0, literal) == 0) {
4196				if (strlen(buf) > entry->pl_width)
4197					entry->pl_width = strlen(buf);
4198			}
4199			if (received && zfs_prop_get_recvd(zhp,
4200			    zfs_prop_to_name(entry->pl_prop),
4201			    buf, sizeof (buf), literal) == 0)
4202				if (strlen(buf) > entry->pl_recvd_width)
4203					entry->pl_recvd_width = strlen(buf);
4204		} else {
4205			if (nvlist_lookup_nvlist(userprops, entry->pl_user_prop,
4206			    &propval) == 0) {
4207				verify(nvlist_lookup_string(propval,
4208				    ZPROP_VALUE, &strval) == 0);
4209				if (strlen(strval) > entry->pl_width)
4210					entry->pl_width = strlen(strval);
4211			}
4212			if (received && zfs_prop_get_recvd(zhp,
4213			    entry->pl_user_prop,
4214			    buf, sizeof (buf), literal) == 0)
4215				if (strlen(buf) > entry->pl_recvd_width)
4216					entry->pl_recvd_width = strlen(buf);
4217		}
4218	}
4219
4220	return (0);
4221}
4222
4223int
4224zfs_deleg_share_nfs(libzfs_handle_t *hdl, char *dataset, char *path,
4225    char *resource, void *export, void *sharetab,
4226    int sharemax, zfs_share_op_t operation)
4227{
4228	zfs_cmd_t zc = { 0 };
4229	int error;
4230
4231	(void) strlcpy(zc.zc_name, dataset, sizeof (zc.zc_name));
4232	(void) strlcpy(zc.zc_value, path, sizeof (zc.zc_value));
4233	if (resource)
4234		(void) strlcpy(zc.zc_string, resource, sizeof (zc.zc_string));
4235	zc.zc_share.z_sharedata = (uint64_t)(uintptr_t)sharetab;
4236	zc.zc_share.z_exportdata = (uint64_t)(uintptr_t)export;
4237	zc.zc_share.z_sharetype = operation;
4238	zc.zc_share.z_sharemax = sharemax;
4239	error = ioctl(hdl->libzfs_fd, ZFS_IOC_SHARE, &zc);
4240	return (error);
4241}
4242
4243void
4244zfs_prune_proplist(zfs_handle_t *zhp, uint8_t *props)
4245{
4246	nvpair_t *curr;
4247
4248	/*
4249	 * Keep a reference to the props-table against which we prune the
4250	 * properties.
4251	 */
4252	zhp->zfs_props_table = props;
4253
4254	curr = nvlist_next_nvpair(zhp->zfs_props, NULL);
4255
4256	while (curr) {
4257		zfs_prop_t zfs_prop = zfs_name_to_prop(nvpair_name(curr));
4258		nvpair_t *next = nvlist_next_nvpair(zhp->zfs_props, curr);
4259
4260		/*
4261		 * User properties will result in ZPROP_INVAL, and since we
4262		 * only know how to prune standard ZFS properties, we always
4263		 * leave these in the list.  This can also happen if we
4264		 * encounter an unknown DSL property (when running older
4265		 * software, for example).
4266		 */
4267		if (zfs_prop != ZPROP_INVAL && props[zfs_prop] == B_FALSE)
4268			(void) nvlist_remove(zhp->zfs_props,
4269			    nvpair_name(curr), nvpair_type(curr));
4270		curr = next;
4271	}
4272}
4273
4274#ifdef illumos
4275static int
4276zfs_smb_acl_mgmt(libzfs_handle_t *hdl, char *dataset, char *path,
4277    zfs_smb_acl_op_t cmd, char *resource1, char *resource2)
4278{
4279	zfs_cmd_t zc = { 0 };
4280	nvlist_t *nvlist = NULL;
4281	int error;
4282
4283	(void) strlcpy(zc.zc_name, dataset, sizeof (zc.zc_name));
4284	(void) strlcpy(zc.zc_value, path, sizeof (zc.zc_value));
4285	zc.zc_cookie = (uint64_t)cmd;
4286
4287	if (cmd == ZFS_SMB_ACL_RENAME) {
4288		if (nvlist_alloc(&nvlist, NV_UNIQUE_NAME, 0) != 0) {
4289			(void) no_memory(hdl);
4290			return (0);
4291		}
4292	}
4293
4294	switch (cmd) {
4295	case ZFS_SMB_ACL_ADD:
4296	case ZFS_SMB_ACL_REMOVE:
4297		(void) strlcpy(zc.zc_string, resource1, sizeof (zc.zc_string));
4298		break;
4299	case ZFS_SMB_ACL_RENAME:
4300		if (nvlist_add_string(nvlist, ZFS_SMB_ACL_SRC,
4301		    resource1) != 0) {
4302				(void) no_memory(hdl);
4303				return (-1);
4304		}
4305		if (nvlist_add_string(nvlist, ZFS_SMB_ACL_TARGET,
4306		    resource2) != 0) {
4307				(void) no_memory(hdl);
4308				return (-1);
4309		}
4310		if (zcmd_write_src_nvlist(hdl, &zc, nvlist) != 0) {
4311			nvlist_free(nvlist);
4312			return (-1);
4313		}
4314		break;
4315	case ZFS_SMB_ACL_PURGE:
4316		break;
4317	default:
4318		return (-1);
4319	}
4320	error = ioctl(hdl->libzfs_fd, ZFS_IOC_SMB_ACL, &zc);
4321	if (nvlist)
4322		nvlist_free(nvlist);
4323	return (error);
4324}
4325
4326int
4327zfs_smb_acl_add(libzfs_handle_t *hdl, char *dataset,
4328    char *path, char *resource)
4329{
4330	return (zfs_smb_acl_mgmt(hdl, dataset, path, ZFS_SMB_ACL_ADD,
4331	    resource, NULL));
4332}
4333
4334int
4335zfs_smb_acl_remove(libzfs_handle_t *hdl, char *dataset,
4336    char *path, char *resource)
4337{
4338	return (zfs_smb_acl_mgmt(hdl, dataset, path, ZFS_SMB_ACL_REMOVE,
4339	    resource, NULL));
4340}
4341
4342int
4343zfs_smb_acl_purge(libzfs_handle_t *hdl, char *dataset, char *path)
4344{
4345	return (zfs_smb_acl_mgmt(hdl, dataset, path, ZFS_SMB_ACL_PURGE,
4346	    NULL, NULL));
4347}
4348
4349int
4350zfs_smb_acl_rename(libzfs_handle_t *hdl, char *dataset, char *path,
4351    char *oldname, char *newname)
4352{
4353	return (zfs_smb_acl_mgmt(hdl, dataset, path, ZFS_SMB_ACL_RENAME,
4354	    oldname, newname));
4355}
4356#endif	/* illumos */
4357
4358int
4359zfs_userspace(zfs_handle_t *zhp, zfs_userquota_prop_t type,
4360    zfs_userspace_cb_t func, void *arg)
4361{
4362	zfs_cmd_t zc = { 0 };
4363	zfs_useracct_t buf[100];
4364	libzfs_handle_t *hdl = zhp->zfs_hdl;
4365	int ret;
4366
4367	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
4368
4369	zc.zc_objset_type = type;
4370	zc.zc_nvlist_dst = (uintptr_t)buf;
4371
4372	for (;;) {
4373		zfs_useracct_t *zua = buf;
4374
4375		zc.zc_nvlist_dst_size = sizeof (buf);
4376		if (zfs_ioctl(hdl, ZFS_IOC_USERSPACE_MANY, &zc) != 0) {
4377			char errbuf[1024];
4378
4379			(void) snprintf(errbuf, sizeof (errbuf),
4380			    dgettext(TEXT_DOMAIN,
4381			    "cannot get used/quota for %s"), zc.zc_name);
4382			return (zfs_standard_error_fmt(hdl, errno, errbuf));
4383		}
4384		if (zc.zc_nvlist_dst_size == 0)
4385			break;
4386
4387		while (zc.zc_nvlist_dst_size > 0) {
4388			if ((ret = func(arg, zua->zu_domain, zua->zu_rid,
4389			    zua->zu_space)) != 0)
4390				return (ret);
4391			zua++;
4392			zc.zc_nvlist_dst_size -= sizeof (zfs_useracct_t);
4393		}
4394	}
4395
4396	return (0);
4397}
4398
4399struct holdarg {
4400	nvlist_t *nvl;
4401	const char *snapname;
4402	const char *tag;
4403	boolean_t recursive;
4404	int error;
4405};
4406
4407static int
4408zfs_hold_one(zfs_handle_t *zhp, void *arg)
4409{
4410	struct holdarg *ha = arg;
4411	char name[ZFS_MAXNAMELEN];
4412	int rv = 0;
4413
4414	(void) snprintf(name, sizeof (name),
4415	    "%s@%s", zhp->zfs_name, ha->snapname);
4416
4417	if (lzc_exists(name))
4418		fnvlist_add_string(ha->nvl, name, ha->tag);
4419
4420	if (ha->recursive)
4421		rv = zfs_iter_filesystems(zhp, zfs_hold_one, ha);
4422	zfs_close(zhp);
4423	return (rv);
4424}
4425
4426int
4427zfs_hold(zfs_handle_t *zhp, const char *snapname, const char *tag,
4428    boolean_t recursive, int cleanup_fd)
4429{
4430	int ret;
4431	struct holdarg ha;
4432
4433	ha.nvl = fnvlist_alloc();
4434	ha.snapname = snapname;
4435	ha.tag = tag;
4436	ha.recursive = recursive;
4437	(void) zfs_hold_one(zfs_handle_dup(zhp), &ha);
4438
4439	if (nvlist_empty(ha.nvl)) {
4440		char errbuf[1024];
4441
4442		fnvlist_free(ha.nvl);
4443		ret = ENOENT;
4444		(void) snprintf(errbuf, sizeof (errbuf),
4445		    dgettext(TEXT_DOMAIN,
4446		    "cannot hold snapshot '%s@%s'"),
4447		    zhp->zfs_name, snapname);
4448		(void) zfs_standard_error(zhp->zfs_hdl, ret, errbuf);
4449		return (ret);
4450	}
4451
4452	ret = zfs_hold_nvl(zhp, cleanup_fd, ha.nvl);
4453	fnvlist_free(ha.nvl);
4454
4455	return (ret);
4456}
4457
4458int
4459zfs_hold_nvl(zfs_handle_t *zhp, int cleanup_fd, nvlist_t *holds)
4460{
4461	int ret;
4462	nvlist_t *errors;
4463	libzfs_handle_t *hdl = zhp->zfs_hdl;
4464	char errbuf[1024];
4465	nvpair_t *elem;
4466
4467	errors = NULL;
4468	ret = lzc_hold(holds, cleanup_fd, &errors);
4469
4470	if (ret == 0) {
4471		/* There may be errors even in the success case. */
4472		fnvlist_free(errors);
4473		return (0);
4474	}
4475
4476	if (nvlist_empty(errors)) {
4477		/* no hold-specific errors */
4478		(void) snprintf(errbuf, sizeof (errbuf),
4479		    dgettext(TEXT_DOMAIN, "cannot hold"));
4480		switch (ret) {
4481		case ENOTSUP:
4482			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4483			    "pool must be upgraded"));
4484			(void) zfs_error(hdl, EZFS_BADVERSION, errbuf);
4485			break;
4486		case EINVAL:
4487			(void) zfs_error(hdl, EZFS_BADTYPE, errbuf);
4488			break;
4489		default:
4490			(void) zfs_standard_error(hdl, ret, errbuf);
4491		}
4492	}
4493
4494	for (elem = nvlist_next_nvpair(errors, NULL);
4495	    elem != NULL;
4496	    elem = nvlist_next_nvpair(errors, elem)) {
4497		(void) snprintf(errbuf, sizeof (errbuf),
4498		    dgettext(TEXT_DOMAIN,
4499		    "cannot hold snapshot '%s'"), nvpair_name(elem));
4500		switch (fnvpair_value_int32(elem)) {
4501		case E2BIG:
4502			/*
4503			 * Temporary tags wind up having the ds object id
4504			 * prepended. So even if we passed the length check
4505			 * above, it's still possible for the tag to wind
4506			 * up being slightly too long.
4507			 */
4508			(void) zfs_error(hdl, EZFS_TAGTOOLONG, errbuf);
4509			break;
4510		case EINVAL:
4511			(void) zfs_error(hdl, EZFS_BADTYPE, errbuf);
4512			break;
4513		case EEXIST:
4514			(void) zfs_error(hdl, EZFS_REFTAG_HOLD, errbuf);
4515			break;
4516		default:
4517			(void) zfs_standard_error(hdl,
4518			    fnvpair_value_int32(elem), errbuf);
4519		}
4520	}
4521
4522	fnvlist_free(errors);
4523	return (ret);
4524}
4525
4526static int
4527zfs_release_one(zfs_handle_t *zhp, void *arg)
4528{
4529	struct holdarg *ha = arg;
4530	char name[ZFS_MAXNAMELEN];
4531	int rv = 0;
4532	nvlist_t *existing_holds;
4533
4534	(void) snprintf(name, sizeof (name),
4535	    "%s@%s", zhp->zfs_name, ha->snapname);
4536
4537	if (lzc_get_holds(name, &existing_holds) != 0) {
4538		ha->error = ENOENT;
4539	} else if (!nvlist_exists(existing_holds, ha->tag)) {
4540		ha->error = ESRCH;
4541	} else {
4542		nvlist_t *torelease = fnvlist_alloc();
4543		fnvlist_add_boolean(torelease, ha->tag);
4544		fnvlist_add_nvlist(ha->nvl, name, torelease);
4545		fnvlist_free(torelease);
4546	}
4547
4548	if (ha->recursive)
4549		rv = zfs_iter_filesystems(zhp, zfs_release_one, ha);
4550	zfs_close(zhp);
4551	return (rv);
4552}
4553
4554int
4555zfs_release(zfs_handle_t *zhp, const char *snapname, const char *tag,
4556    boolean_t recursive)
4557{
4558	int ret;
4559	struct holdarg ha;
4560	nvlist_t *errors = NULL;
4561	nvpair_t *elem;
4562	libzfs_handle_t *hdl = zhp->zfs_hdl;
4563	char errbuf[1024];
4564
4565	ha.nvl = fnvlist_alloc();
4566	ha.snapname = snapname;
4567	ha.tag = tag;
4568	ha.recursive = recursive;
4569	ha.error = 0;
4570	(void) zfs_release_one(zfs_handle_dup(zhp), &ha);
4571
4572	if (nvlist_empty(ha.nvl)) {
4573		fnvlist_free(ha.nvl);
4574		ret = ha.error;
4575		(void) snprintf(errbuf, sizeof (errbuf),
4576		    dgettext(TEXT_DOMAIN,
4577		    "cannot release hold from snapshot '%s@%s'"),
4578		    zhp->zfs_name, snapname);
4579		if (ret == ESRCH) {
4580			(void) zfs_error(hdl, EZFS_REFTAG_RELE, errbuf);
4581		} else {
4582			(void) zfs_standard_error(hdl, ret, errbuf);
4583		}
4584		return (ret);
4585	}
4586
4587	ret = lzc_release(ha.nvl, &errors);
4588	fnvlist_free(ha.nvl);
4589
4590	if (ret == 0) {
4591		/* There may be errors even in the success case. */
4592		fnvlist_free(errors);
4593		return (0);
4594	}
4595
4596	if (nvlist_empty(errors)) {
4597		/* no hold-specific errors */
4598		(void) snprintf(errbuf, sizeof (errbuf), dgettext(TEXT_DOMAIN,
4599		    "cannot release"));
4600		switch (errno) {
4601		case ENOTSUP:
4602			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4603			    "pool must be upgraded"));
4604			(void) zfs_error(hdl, EZFS_BADVERSION, errbuf);
4605			break;
4606		default:
4607			(void) zfs_standard_error_fmt(hdl, errno, errbuf);
4608		}
4609	}
4610
4611	for (elem = nvlist_next_nvpair(errors, NULL);
4612	    elem != NULL;
4613	    elem = nvlist_next_nvpair(errors, elem)) {
4614		(void) snprintf(errbuf, sizeof (errbuf),
4615		    dgettext(TEXT_DOMAIN,
4616		    "cannot release hold from snapshot '%s'"),
4617		    nvpair_name(elem));
4618		switch (fnvpair_value_int32(elem)) {
4619		case ESRCH:
4620			(void) zfs_error(hdl, EZFS_REFTAG_RELE, errbuf);
4621			break;
4622		case EINVAL:
4623			(void) zfs_error(hdl, EZFS_BADTYPE, errbuf);
4624			break;
4625		default:
4626			(void) zfs_standard_error_fmt(hdl,
4627			    fnvpair_value_int32(elem), errbuf);
4628		}
4629	}
4630
4631	fnvlist_free(errors);
4632	return (ret);
4633}
4634
4635int
4636zfs_get_fsacl(zfs_handle_t *zhp, nvlist_t **nvl)
4637{
4638	zfs_cmd_t zc = { 0 };
4639	libzfs_handle_t *hdl = zhp->zfs_hdl;
4640	int nvsz = 2048;
4641	void *nvbuf;
4642	int err = 0;
4643	char errbuf[1024];
4644
4645	assert(zhp->zfs_type == ZFS_TYPE_VOLUME ||
4646	    zhp->zfs_type == ZFS_TYPE_FILESYSTEM);
4647
4648tryagain:
4649
4650	nvbuf = malloc(nvsz);
4651	if (nvbuf == NULL) {
4652		err = (zfs_error(hdl, EZFS_NOMEM, strerror(errno)));
4653		goto out;
4654	}
4655
4656	zc.zc_nvlist_dst_size = nvsz;
4657	zc.zc_nvlist_dst = (uintptr_t)nvbuf;
4658
4659	(void) strlcpy(zc.zc_name, zhp->zfs_name, ZFS_MAXNAMELEN);
4660
4661	if (ioctl(hdl->libzfs_fd, ZFS_IOC_GET_FSACL, &zc) != 0) {
4662		(void) snprintf(errbuf, sizeof (errbuf),
4663		    dgettext(TEXT_DOMAIN, "cannot get permissions on '%s'"),
4664		    zc.zc_name);
4665		switch (errno) {
4666		case ENOMEM:
4667			free(nvbuf);
4668			nvsz = zc.zc_nvlist_dst_size;
4669			goto tryagain;
4670
4671		case ENOTSUP:
4672			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4673			    "pool must be upgraded"));
4674			err = zfs_error(hdl, EZFS_BADVERSION, errbuf);
4675			break;
4676		case EINVAL:
4677			err = zfs_error(hdl, EZFS_BADTYPE, errbuf);
4678			break;
4679		case ENOENT:
4680			err = zfs_error(hdl, EZFS_NOENT, errbuf);
4681			break;
4682		default:
4683			err = zfs_standard_error_fmt(hdl, errno, errbuf);
4684			break;
4685		}
4686	} else {
4687		/* success */
4688		int rc = nvlist_unpack(nvbuf, zc.zc_nvlist_dst_size, nvl, 0);
4689		if (rc) {
4690			(void) snprintf(errbuf, sizeof (errbuf), dgettext(
4691			    TEXT_DOMAIN, "cannot get permissions on '%s'"),
4692			    zc.zc_name);
4693			err = zfs_standard_error_fmt(hdl, rc, errbuf);
4694		}
4695	}
4696
4697	free(nvbuf);
4698out:
4699	return (err);
4700}
4701
4702int
4703zfs_set_fsacl(zfs_handle_t *zhp, boolean_t un, nvlist_t *nvl)
4704{
4705	zfs_cmd_t zc = { 0 };
4706	libzfs_handle_t *hdl = zhp->zfs_hdl;
4707	char *nvbuf;
4708	char errbuf[1024];
4709	size_t nvsz;
4710	int err;
4711
4712	assert(zhp->zfs_type == ZFS_TYPE_VOLUME ||
4713	    zhp->zfs_type == ZFS_TYPE_FILESYSTEM);
4714
4715	err = nvlist_size(nvl, &nvsz, NV_ENCODE_NATIVE);
4716	assert(err == 0);
4717
4718	nvbuf = malloc(nvsz);
4719
4720	err = nvlist_pack(nvl, &nvbuf, &nvsz, NV_ENCODE_NATIVE, 0);
4721	assert(err == 0);
4722
4723	zc.zc_nvlist_src_size = nvsz;
4724	zc.zc_nvlist_src = (uintptr_t)nvbuf;
4725	zc.zc_perm_action = un;
4726
4727	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
4728
4729	if (zfs_ioctl(hdl, ZFS_IOC_SET_FSACL, &zc) != 0) {
4730		(void) snprintf(errbuf, sizeof (errbuf),
4731		    dgettext(TEXT_DOMAIN, "cannot set permissions on '%s'"),
4732		    zc.zc_name);
4733		switch (errno) {
4734		case ENOTSUP:
4735			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4736			    "pool must be upgraded"));
4737			err = zfs_error(hdl, EZFS_BADVERSION, errbuf);
4738			break;
4739		case EINVAL:
4740			err = zfs_error(hdl, EZFS_BADTYPE, errbuf);
4741			break;
4742		case ENOENT:
4743			err = zfs_error(hdl, EZFS_NOENT, errbuf);
4744			break;
4745		default:
4746			err = zfs_standard_error_fmt(hdl, errno, errbuf);
4747			break;
4748		}
4749	}
4750
4751	free(nvbuf);
4752
4753	return (err);
4754}
4755
4756int
4757zfs_get_holds(zfs_handle_t *zhp, nvlist_t **nvl)
4758{
4759	int err;
4760	char errbuf[1024];
4761
4762	err = lzc_get_holds(zhp->zfs_name, nvl);
4763
4764	if (err != 0) {
4765		libzfs_handle_t *hdl = zhp->zfs_hdl;
4766
4767		(void) snprintf(errbuf, sizeof (errbuf),
4768		    dgettext(TEXT_DOMAIN, "cannot get holds for '%s'"),
4769		    zhp->zfs_name);
4770		switch (err) {
4771		case ENOTSUP:
4772			zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4773			    "pool must be upgraded"));
4774			err = zfs_error(hdl, EZFS_BADVERSION, errbuf);
4775			break;
4776		case EINVAL:
4777			err = zfs_error(hdl, EZFS_BADTYPE, errbuf);
4778			break;
4779		case ENOENT:
4780			err = zfs_error(hdl, EZFS_NOENT, errbuf);
4781			break;
4782		default:
4783			err = zfs_standard_error_fmt(hdl, errno, errbuf);
4784			break;
4785		}
4786	}
4787
4788	return (err);
4789}
4790
4791/*
4792 * Convert the zvol's volume size to an appropriate reservation.
4793 * Note: If this routine is updated, it is necessary to update the ZFS test
4794 * suite's shell version in reservation.kshlib.
4795 */
4796uint64_t
4797zvol_volsize_to_reservation(uint64_t volsize, nvlist_t *props)
4798{
4799	uint64_t numdb;
4800	uint64_t nblocks, volblocksize;
4801	int ncopies;
4802	char *strval;
4803
4804	if (nvlist_lookup_string(props,
4805	    zfs_prop_to_name(ZFS_PROP_COPIES), &strval) == 0)
4806		ncopies = atoi(strval);
4807	else
4808		ncopies = 1;
4809	if (nvlist_lookup_uint64(props,
4810	    zfs_prop_to_name(ZFS_PROP_VOLBLOCKSIZE),
4811	    &volblocksize) != 0)
4812		volblocksize = ZVOL_DEFAULT_BLOCKSIZE;
4813	nblocks = volsize/volblocksize;
4814	/* start with metadnode L0-L6 */
4815	numdb = 7;
4816	/* calculate number of indirects */
4817	while (nblocks > 1) {
4818		nblocks += DNODES_PER_LEVEL - 1;
4819		nblocks /= DNODES_PER_LEVEL;
4820		numdb += nblocks;
4821	}
4822	numdb *= MIN(SPA_DVAS_PER_BP, ncopies + 1);
4823	volsize *= ncopies;
4824	/*
4825	 * this is exactly DN_MAX_INDBLKSHIFT when metadata isn't
4826	 * compressed, but in practice they compress down to about
4827	 * 1100 bytes
4828	 */
4829	numdb *= 1ULL << DN_MAX_INDBLKSHIFT;
4830	volsize += numdb;
4831	return (volsize);
4832}
4833
4834/*
4835 * Attach/detach the given filesystem to/from the given jail.
4836 */
4837int
4838zfs_jail(zfs_handle_t *zhp, int jailid, int attach)
4839{
4840	libzfs_handle_t *hdl = zhp->zfs_hdl;
4841	zfs_cmd_t zc = { 0 };
4842	char errbuf[1024];
4843	unsigned long cmd;
4844	int ret;
4845
4846	if (attach) {
4847		(void) snprintf(errbuf, sizeof (errbuf),
4848		    dgettext(TEXT_DOMAIN, "cannot jail '%s'"), zhp->zfs_name);
4849	} else {
4850		(void) snprintf(errbuf, sizeof (errbuf),
4851		    dgettext(TEXT_DOMAIN, "cannot unjail '%s'"), zhp->zfs_name);
4852	}
4853
4854	switch (zhp->zfs_type) {
4855	case ZFS_TYPE_VOLUME:
4856		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4857		    "volumes can not be jailed"));
4858		return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
4859	case ZFS_TYPE_SNAPSHOT:
4860		zfs_error_aux(hdl, dgettext(TEXT_DOMAIN,
4861		    "snapshots can not be jailed"));
4862		return (zfs_error(hdl, EZFS_BADTYPE, errbuf));
4863	}
4864	assert(zhp->zfs_type == ZFS_TYPE_FILESYSTEM);
4865
4866	(void) strlcpy(zc.zc_name, zhp->zfs_name, sizeof (zc.zc_name));
4867	zc.zc_objset_type = DMU_OST_ZFS;
4868	zc.zc_jailid = jailid;
4869
4870	cmd = attach ? ZFS_IOC_JAIL : ZFS_IOC_UNJAIL;
4871	if ((ret = ioctl(hdl->libzfs_fd, cmd, &zc)) != 0)
4872		zfs_standard_error(hdl, errno, errbuf);
4873
4874	return (ret);
4875}
4876