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.
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.
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]
22 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
23 * Copyright 2011 Nexenta Systems, Inc. All rights reserved.
24 * Copyright (c) 2012, 2018 by Delphix. All rights reserved.
29 #include <sys/zfs_acl.h>
30 #include <sys/zfs_ioctl.h>
31 #include <sys/fs/zfs.h>
41 static zprop_desc_t zpool_prop_table
[ZPOOL_NUM_PROPS
];
44 zpool_prop_get_table(void)
46 return (zpool_prop_table
);
52 static zprop_index_t boolean_table
[] = {
58 static zprop_index_t failuremode_table
[] = {
59 { "wait", ZIO_FAILURE_MODE_WAIT
},
60 { "continue", ZIO_FAILURE_MODE_CONTINUE
},
61 { "panic", ZIO_FAILURE_MODE_PANIC
},
65 /* string properties */
66 zprop_register_string(ZPOOL_PROP_ALTROOT
, "altroot", NULL
, PROP_DEFAULT
,
67 ZFS_TYPE_POOL
, "<path>", "ALTROOT");
68 zprop_register_string(ZPOOL_PROP_BOOTFS
, "bootfs", NULL
, PROP_DEFAULT
,
69 ZFS_TYPE_POOL
, "<filesystem>", "BOOTFS");
70 zprop_register_string(ZPOOL_PROP_CACHEFILE
, "cachefile", NULL
,
71 PROP_DEFAULT
, ZFS_TYPE_POOL
, "<file> | none", "CACHEFILE");
72 zprop_register_string(ZPOOL_PROP_COMMENT
, "comment", NULL
,
73 PROP_DEFAULT
, ZFS_TYPE_POOL
, "<comment-string>", "COMMENT");
75 /* readonly number properties */
76 zprop_register_number(ZPOOL_PROP_SIZE
, "size", 0, PROP_READONLY
,
77 ZFS_TYPE_POOL
, "<size>", "SIZE");
78 zprop_register_number(ZPOOL_PROP_FREE
, "free", 0, PROP_READONLY
,
79 ZFS_TYPE_POOL
, "<size>", "FREE");
80 zprop_register_number(ZPOOL_PROP_FREEING
, "freeing", 0, PROP_READONLY
,
81 ZFS_TYPE_POOL
, "<size>", "FREEING");
82 zprop_register_number(ZPOOL_PROP_CHECKPOINT
, "checkpoint", 0,
83 PROP_READONLY
, ZFS_TYPE_POOL
, "<size>", "CKPOINT");
84 zprop_register_number(ZPOOL_PROP_LEAKED
, "leaked", 0, PROP_READONLY
,
85 ZFS_TYPE_POOL
, "<size>", "LEAKED");
86 zprop_register_number(ZPOOL_PROP_ALLOCATED
, "allocated", 0,
87 PROP_READONLY
, ZFS_TYPE_POOL
, "<size>", "ALLOC");
88 zprop_register_number(ZPOOL_PROP_EXPANDSZ
, "expandsize", 0,
89 PROP_READONLY
, ZFS_TYPE_POOL
, "<size>", "EXPANDSZ");
90 zprop_register_number(ZPOOL_PROP_FRAGMENTATION
, "fragmentation", 0,
91 PROP_READONLY
, ZFS_TYPE_POOL
, "<percent>", "FRAG");
92 zprop_register_number(ZPOOL_PROP_CAPACITY
, "capacity", 0, PROP_READONLY
,
93 ZFS_TYPE_POOL
, "<size>", "CAP");
94 zprop_register_number(ZPOOL_PROP_GUID
, "guid", 0, PROP_READONLY
,
95 ZFS_TYPE_POOL
, "<guid>", "GUID");
96 zprop_register_number(ZPOOL_PROP_LOAD_GUID
, "load_guid", 0,
97 PROP_READONLY
, ZFS_TYPE_POOL
, "<load_guid>", "LOAD_GUID");
98 zprop_register_number(ZPOOL_PROP_HEALTH
, "health", 0, PROP_READONLY
,
99 ZFS_TYPE_POOL
, "<state>", "HEALTH");
100 zprop_register_number(ZPOOL_PROP_DEDUPRATIO
, "dedupratio", 0,
101 PROP_READONLY
, ZFS_TYPE_POOL
, "<1.00x or higher if deduped>",
104 /* default number properties */
105 zprop_register_number(ZPOOL_PROP_VERSION
, "version", SPA_VERSION
,
106 PROP_DEFAULT
, ZFS_TYPE_POOL
, "<version>", "VERSION");
107 zprop_register_number(ZPOOL_PROP_DEDUPDITTO
, "dedupditto", 0,
108 PROP_DEFAULT
, ZFS_TYPE_POOL
, "<threshold (min 100)>", "DEDUPDITTO");
109 zprop_register_number(ZPOOL_PROP_ASHIFT
, "ashift", 0, PROP_DEFAULT
,
110 ZFS_TYPE_POOL
, "<ashift, 9-16, or 0=default>", "ASHIFT");
112 /* default index (boolean) properties */
113 zprop_register_index(ZPOOL_PROP_DELEGATION
, "delegation", 1,
114 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "DELEGATION",
116 zprop_register_index(ZPOOL_PROP_AUTOREPLACE
, "autoreplace", 0,
117 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "REPLACE", boolean_table
);
118 zprop_register_index(ZPOOL_PROP_LISTSNAPS
, "listsnapshots", 0,
119 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "LISTSNAPS",
121 zprop_register_index(ZPOOL_PROP_AUTOEXPAND
, "autoexpand", 0,
122 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "EXPAND", boolean_table
);
123 zprop_register_index(ZPOOL_PROP_READONLY
, "readonly", 0,
124 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "RDONLY", boolean_table
);
125 zprop_register_index(ZPOOL_PROP_MULTIHOST
, "multihost", 0,
126 PROP_DEFAULT
, ZFS_TYPE_POOL
, "on | off", "MULTIHOST",
129 /* default index properties */
130 zprop_register_index(ZPOOL_PROP_FAILUREMODE
, "failmode",
131 ZIO_FAILURE_MODE_WAIT
, PROP_DEFAULT
, ZFS_TYPE_POOL
,
132 "wait | continue | panic", "FAILMODE", failuremode_table
);
134 /* hidden properties */
135 zprop_register_hidden(ZPOOL_PROP_NAME
, "name", PROP_TYPE_STRING
,
136 PROP_READONLY
, ZFS_TYPE_POOL
, "NAME");
137 zprop_register_hidden(ZPOOL_PROP_MAXBLOCKSIZE
, "maxblocksize",
138 PROP_TYPE_NUMBER
, PROP_READONLY
, ZFS_TYPE_POOL
, "MAXBLOCKSIZE");
139 zprop_register_hidden(ZPOOL_PROP_TNAME
, "tname", PROP_TYPE_STRING
,
140 PROP_ONETIME
, ZFS_TYPE_POOL
, "TNAME");
141 zprop_register_hidden(ZPOOL_PROP_MAXDNODESIZE
, "maxdnodesize",
142 PROP_TYPE_NUMBER
, PROP_READONLY
, ZFS_TYPE_POOL
, "MAXDNODESIZE");
146 * Given a property name and its type, returns the corresponding property ID.
149 zpool_name_to_prop(const char *propname
)
151 return (zprop_name_to_prop(propname
, ZFS_TYPE_POOL
));
155 * Given a pool property ID, returns the corresponding name.
156 * Assuming the pool propety ID is valid.
159 zpool_prop_to_name(zpool_prop_t prop
)
161 return (zpool_prop_table
[prop
].pd_name
);
165 zpool_prop_get_type(zpool_prop_t prop
)
167 return (zpool_prop_table
[prop
].pd_proptype
);
171 zpool_prop_readonly(zpool_prop_t prop
)
173 return (zpool_prop_table
[prop
].pd_attr
== PROP_READONLY
);
177 zpool_prop_setonce(zpool_prop_t prop
)
179 return (zpool_prop_table
[prop
].pd_attr
== PROP_ONETIME
);
183 zpool_prop_default_string(zpool_prop_t prop
)
185 return (zpool_prop_table
[prop
].pd_strdefault
);
189 zpool_prop_default_numeric(zpool_prop_t prop
)
191 return (zpool_prop_table
[prop
].pd_numdefault
);
195 * Returns true if this is a valid feature@ property.
198 zpool_prop_feature(const char *name
)
200 static const char *prefix
= "feature@";
201 return (strncmp(name
, prefix
, strlen(prefix
)) == 0);
205 * Returns true if this is a valid unsupported@ property.
208 zpool_prop_unsupported(const char *name
)
210 static const char *prefix
= "unsupported@";
211 return (strncmp(name
, prefix
, strlen(prefix
)) == 0);
215 zpool_prop_string_to_index(zpool_prop_t prop
, const char *string
,
218 return (zprop_string_to_index(prop
, string
, index
, ZFS_TYPE_POOL
));
222 zpool_prop_index_to_string(zpool_prop_t prop
, uint64_t index
,
225 return (zprop_index_to_string(prop
, index
, string
, ZFS_TYPE_POOL
));
229 zpool_prop_random_value(zpool_prop_t prop
, uint64_t seed
)
231 return (zprop_random_value(prop
, seed
, ZFS_TYPE_POOL
));
237 zpool_prop_values(zpool_prop_t prop
)
239 return (zpool_prop_table
[prop
].pd_values
);
243 zpool_prop_column_name(zpool_prop_t prop
)
245 return (zpool_prop_table
[prop
].pd_colname
);
249 zpool_prop_align_right(zpool_prop_t prop
)
251 return (zpool_prop_table
[prop
].pd_rightalign
);
256 /* zpool property functions */
257 EXPORT_SYMBOL(zpool_prop_init
);
258 EXPORT_SYMBOL(zpool_prop_get_type
);
259 EXPORT_SYMBOL(zpool_prop_get_table
);
261 /* Pool property functions shared between libzfs and kernel. */
262 EXPORT_SYMBOL(zpool_name_to_prop
);
263 EXPORT_SYMBOL(zpool_prop_to_name
);
264 EXPORT_SYMBOL(zpool_prop_default_string
);
265 EXPORT_SYMBOL(zpool_prop_default_numeric
);
266 EXPORT_SYMBOL(zpool_prop_readonly
);
267 EXPORT_SYMBOL(zpool_prop_feature
);
268 EXPORT_SYMBOL(zpool_prop_unsupported
);
269 EXPORT_SYMBOL(zpool_prop_index_to_string
);
270 EXPORT_SYMBOL(zpool_prop_string_to_index
);