xref: /illumos-gate/usr/src/uts/common/sys/fs/zfs.h (revision 581cede61ac9c14d8d4ea452562a567189eead78)
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 2009 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_SYS_FS_ZFS_H
28 #define	_SYS_FS_ZFS_H
29 
30 #include <sys/time.h>
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 /*
37  * Types and constants shared between userland and the kernel.
38  */
39 
40 /*
41  * Each dataset can be one of the following types.  These constants can be
42  * combined into masks that can be passed to various functions.
43  */
44 typedef enum {
45 	ZFS_TYPE_FILESYSTEM	= 0x1,
46 	ZFS_TYPE_SNAPSHOT	= 0x2,
47 	ZFS_TYPE_VOLUME		= 0x4,
48 	ZFS_TYPE_POOL		= 0x8
49 } zfs_type_t;
50 
51 #define	ZFS_TYPE_DATASET	\
52 	(ZFS_TYPE_FILESYSTEM | ZFS_TYPE_VOLUME | ZFS_TYPE_SNAPSHOT)
53 
54 #define	ZAP_MAXNAMELEN 256
55 #define	ZAP_MAXVALUELEN (1024 * 8)
56 #define	ZAP_OLDMAXVALUELEN 1024
57 
58 /*
59  * Dataset properties are identified by these constants and must be added to
60  * the end of this list to ensure that external consumers are not affected
61  * by the change. If you make any changes to this list, be sure to update
62  * the property table in usr/src/common/zfs/zfs_prop.c.
63  */
64 typedef enum {
65 	ZFS_PROP_TYPE,
66 	ZFS_PROP_CREATION,
67 	ZFS_PROP_USED,
68 	ZFS_PROP_AVAILABLE,
69 	ZFS_PROP_REFERENCED,
70 	ZFS_PROP_COMPRESSRATIO,
71 	ZFS_PROP_MOUNTED,
72 	ZFS_PROP_ORIGIN,
73 	ZFS_PROP_QUOTA,
74 	ZFS_PROP_RESERVATION,
75 	ZFS_PROP_VOLSIZE,
76 	ZFS_PROP_VOLBLOCKSIZE,
77 	ZFS_PROP_RECORDSIZE,
78 	ZFS_PROP_MOUNTPOINT,
79 	ZFS_PROP_SHARENFS,
80 	ZFS_PROP_CHECKSUM,
81 	ZFS_PROP_COMPRESSION,
82 	ZFS_PROP_ATIME,
83 	ZFS_PROP_DEVICES,
84 	ZFS_PROP_EXEC,
85 	ZFS_PROP_SETUID,
86 	ZFS_PROP_READONLY,
87 	ZFS_PROP_ZONED,
88 	ZFS_PROP_SNAPDIR,
89 	ZFS_PROP_ACLMODE,
90 	ZFS_PROP_ACLINHERIT,
91 	ZFS_PROP_CREATETXG,		/* not exposed to the user */
92 	ZFS_PROP_NAME,			/* not exposed to the user */
93 	ZFS_PROP_CANMOUNT,
94 	ZFS_PROP_SHAREISCSI,
95 	ZFS_PROP_ISCSIOPTIONS,		/* not exposed to the user */
96 	ZFS_PROP_XATTR,
97 	ZFS_PROP_NUMCLONES,		/* not exposed to the user */
98 	ZFS_PROP_COPIES,
99 	ZFS_PROP_VERSION,
100 	ZFS_PROP_UTF8ONLY,
101 	ZFS_PROP_NORMALIZE,
102 	ZFS_PROP_CASE,
103 	ZFS_PROP_VSCAN,
104 	ZFS_PROP_NBMAND,
105 	ZFS_PROP_SHARESMB,
106 	ZFS_PROP_REFQUOTA,
107 	ZFS_PROP_REFRESERVATION,
108 	ZFS_PROP_GUID,
109 	ZFS_PROP_PRIMARYCACHE,
110 	ZFS_PROP_SECONDARYCACHE,
111 	ZFS_PROP_USEDSNAP,
112 	ZFS_PROP_USEDDS,
113 	ZFS_PROP_USEDCHILD,
114 	ZFS_PROP_USEDREFRESERV,
115 	ZFS_PROP_USERACCOUNTING,	/* not exposed to the user */
116 	ZFS_PROP_STMF_SHAREINFO,	/* not exposed to the user */
117 	ZFS_PROP_DEFER_DESTROY,
118 	ZFS_PROP_USERREFS,
119 	ZFS_PROP_LOGBIAS,
120 	ZFS_NUM_PROPS
121 } zfs_prop_t;
122 
123 typedef enum {
124 	ZFS_PROP_USERUSED,
125 	ZFS_PROP_USERQUOTA,
126 	ZFS_PROP_GROUPUSED,
127 	ZFS_PROP_GROUPQUOTA,
128 	ZFS_NUM_USERQUOTA_PROPS
129 } zfs_userquota_prop_t;
130 
131 extern const char *zfs_userquota_prop_prefixes[ZFS_NUM_USERQUOTA_PROPS];
132 
133 /*
134  * Pool properties are identified by these constants and must be added to the
135  * end of this list to ensure that external consumers are not affected
136  * by the change. If you make any changes to this list, be sure to update
137  * the property table in usr/src/common/zfs/zpool_prop.c.
138  */
139 typedef enum {
140 	ZPOOL_PROP_NAME,
141 	ZPOOL_PROP_SIZE,
142 	ZPOOL_PROP_USED,
143 	ZPOOL_PROP_AVAILABLE,
144 	ZPOOL_PROP_CAPACITY,
145 	ZPOOL_PROP_ALTROOT,
146 	ZPOOL_PROP_HEALTH,
147 	ZPOOL_PROP_GUID,
148 	ZPOOL_PROP_VERSION,
149 	ZPOOL_PROP_BOOTFS,
150 	ZPOOL_PROP_DELEGATION,
151 	ZPOOL_PROP_AUTOREPLACE,
152 	ZPOOL_PROP_CACHEFILE,
153 	ZPOOL_PROP_FAILUREMODE,
154 	ZPOOL_PROP_LISTSNAPS,
155 	ZPOOL_PROP_AUTOEXPAND,
156 	ZPOOL_NUM_PROPS
157 } zpool_prop_t;
158 
159 #define	ZPROP_CONT		-2
160 #define	ZPROP_INVAL		-1
161 
162 #define	ZPROP_VALUE		"value"
163 #define	ZPROP_SOURCE		"source"
164 
165 typedef enum {
166 	ZPROP_SRC_NONE = 0x1,
167 	ZPROP_SRC_DEFAULT = 0x2,
168 	ZPROP_SRC_TEMPORARY = 0x4,
169 	ZPROP_SRC_LOCAL = 0x8,
170 	ZPROP_SRC_INHERITED = 0x10
171 } zprop_source_t;
172 
173 #define	ZPROP_SRC_ALL	0x1f
174 
175 typedef int (*zprop_func)(int, void *);
176 
177 /*
178  * Properties to be set on the root file system of a new pool
179  * are stuffed into their own nvlist, which is then included in
180  * the properties nvlist with the pool properties.
181  */
182 #define	ZPOOL_ROOTFS_PROPS	"root-props-nvl"
183 
184 /*
185  * Dataset property functions shared between libzfs and kernel.
186  */
187 const char *zfs_prop_default_string(zfs_prop_t);
188 uint64_t zfs_prop_default_numeric(zfs_prop_t);
189 boolean_t zfs_prop_readonly(zfs_prop_t);
190 boolean_t zfs_prop_inheritable(zfs_prop_t);
191 boolean_t zfs_prop_setonce(zfs_prop_t);
192 const char *zfs_prop_to_name(zfs_prop_t);
193 zfs_prop_t zfs_name_to_prop(const char *);
194 boolean_t zfs_prop_user(const char *);
195 boolean_t zfs_prop_userquota(const char *name);
196 int zfs_prop_index_to_string(zfs_prop_t, uint64_t, const char **);
197 int zfs_prop_string_to_index(zfs_prop_t, const char *, uint64_t *);
198 boolean_t zfs_prop_valid_for_type(int, zfs_type_t);
199 
200 /*
201  * Pool property functions shared between libzfs and kernel.
202  */
203 zpool_prop_t zpool_name_to_prop(const char *);
204 const char *zpool_prop_to_name(zpool_prop_t);
205 const char *zpool_prop_default_string(zpool_prop_t);
206 uint64_t zpool_prop_default_numeric(zpool_prop_t);
207 boolean_t zpool_prop_readonly(zpool_prop_t);
208 int zpool_prop_index_to_string(zpool_prop_t, uint64_t, const char **);
209 int zpool_prop_string_to_index(zpool_prop_t, const char *, uint64_t *);
210 
211 /*
212  * Definitions for the Delegation.
213  */
214 typedef enum {
215 	ZFS_DELEG_WHO_UNKNOWN = 0,
216 	ZFS_DELEG_USER = 'u',
217 	ZFS_DELEG_USER_SETS = 'U',
218 	ZFS_DELEG_GROUP = 'g',
219 	ZFS_DELEG_GROUP_SETS = 'G',
220 	ZFS_DELEG_EVERYONE = 'e',
221 	ZFS_DELEG_EVERYONE_SETS = 'E',
222 	ZFS_DELEG_CREATE = 'c',
223 	ZFS_DELEG_CREATE_SETS = 'C',
224 	ZFS_DELEG_NAMED_SET = 's',
225 	ZFS_DELEG_NAMED_SET_SETS = 'S'
226 } zfs_deleg_who_type_t;
227 
228 typedef enum {
229 	ZFS_DELEG_NONE = 0,
230 	ZFS_DELEG_PERM_LOCAL = 1,
231 	ZFS_DELEG_PERM_DESCENDENT = 2,
232 	ZFS_DELEG_PERM_LOCALDESCENDENT = 3,
233 	ZFS_DELEG_PERM_CREATE = 4
234 } zfs_deleg_inherit_t;
235 
236 #define	ZFS_DELEG_PERM_UID	"uid"
237 #define	ZFS_DELEG_PERM_GID	"gid"
238 #define	ZFS_DELEG_PERM_GROUPS	"groups"
239 
240 #define	ZFS_SMB_ACL_SRC		"src"
241 #define	ZFS_SMB_ACL_TARGET	"target"
242 
243 typedef enum {
244 	ZFS_CANMOUNT_OFF = 0,
245 	ZFS_CANMOUNT_ON = 1,
246 	ZFS_CANMOUNT_NOAUTO = 2
247 } zfs_canmount_type_t;
248 
249 typedef enum {
250 	ZFS_LOGBIAS_LATENCY = 0,
251 	ZFS_LOGBIAS_THROUGHPUT = 1
252 } zfs_logbias_op_t;
253 
254 typedef enum zfs_share_op {
255 	ZFS_SHARE_NFS = 0,
256 	ZFS_UNSHARE_NFS = 1,
257 	ZFS_SHARE_SMB = 2,
258 	ZFS_UNSHARE_SMB = 3
259 } zfs_share_op_t;
260 
261 typedef enum zfs_smb_acl_op {
262 	ZFS_SMB_ACL_ADD,
263 	ZFS_SMB_ACL_REMOVE,
264 	ZFS_SMB_ACL_RENAME,
265 	ZFS_SMB_ACL_PURGE
266 } zfs_smb_acl_op_t;
267 
268 typedef enum zfs_cache_type {
269 	ZFS_CACHE_NONE = 0,
270 	ZFS_CACHE_METADATA = 1,
271 	ZFS_CACHE_ALL = 2
272 } zfs_cache_type_t;
273 
274 
275 /*
276  * On-disk version number.
277  */
278 #define	SPA_VERSION_1			1ULL
279 #define	SPA_VERSION_2			2ULL
280 #define	SPA_VERSION_3			3ULL
281 #define	SPA_VERSION_4			4ULL
282 #define	SPA_VERSION_5			5ULL
283 #define	SPA_VERSION_6			6ULL
284 #define	SPA_VERSION_7			7ULL
285 #define	SPA_VERSION_8			8ULL
286 #define	SPA_VERSION_9			9ULL
287 #define	SPA_VERSION_10			10ULL
288 #define	SPA_VERSION_11			11ULL
289 #define	SPA_VERSION_12			12ULL
290 #define	SPA_VERSION_13			13ULL
291 #define	SPA_VERSION_14			14ULL
292 #define	SPA_VERSION_15			15ULL
293 #define	SPA_VERSION_16			16ULL
294 #define	SPA_VERSION_17			17ULL
295 #define	SPA_VERSION_18			18ULL
296 /*
297  * When bumping up SPA_VERSION, make sure GRUB ZFS understands the on-disk
298  * format change. Go to usr/src/grub/grub-0.97/stage2/{zfs-include/, fsys_zfs*},
299  * and do the appropriate changes.  Also bump the version number in
300  * usr/src/grub/capability.
301  */
302 #define	SPA_VERSION			SPA_VERSION_18
303 #define	SPA_VERSION_STRING		"18"
304 
305 /*
306  * Symbolic names for the changes that caused a SPA_VERSION switch.
307  * Used in the code when checking for presence or absence of a feature.
308  * Feel free to define multiple symbolic names for each version if there
309  * were multiple changes to on-disk structures during that version.
310  *
311  * NOTE: When checking the current SPA_VERSION in your code, be sure
312  *       to use spa_version() since it reports the version of the
313  *       last synced uberblock.  Checking the in-flight version can
314  *       be dangerous in some cases.
315  */
316 #define	SPA_VERSION_INITIAL		SPA_VERSION_1
317 #define	SPA_VERSION_DITTO_BLOCKS	SPA_VERSION_2
318 #define	SPA_VERSION_SPARES		SPA_VERSION_3
319 #define	SPA_VERSION_RAIDZ2		SPA_VERSION_3
320 #define	SPA_VERSION_BPLIST_ACCOUNT	SPA_VERSION_3
321 #define	SPA_VERSION_RAIDZ_DEFLATE	SPA_VERSION_3
322 #define	SPA_VERSION_DNODE_BYTES		SPA_VERSION_3
323 #define	SPA_VERSION_ZPOOL_HISTORY	SPA_VERSION_4
324 #define	SPA_VERSION_GZIP_COMPRESSION	SPA_VERSION_5
325 #define	SPA_VERSION_BOOTFS		SPA_VERSION_6
326 #define	SPA_VERSION_SLOGS		SPA_VERSION_7
327 #define	SPA_VERSION_DELEGATED_PERMS	SPA_VERSION_8
328 #define	SPA_VERSION_FUID		SPA_VERSION_9
329 #define	SPA_VERSION_REFRESERVATION	SPA_VERSION_9
330 #define	SPA_VERSION_REFQUOTA		SPA_VERSION_9
331 #define	SPA_VERSION_UNIQUE_ACCURATE	SPA_VERSION_9
332 #define	SPA_VERSION_L2CACHE		SPA_VERSION_10
333 #define	SPA_VERSION_NEXT_CLONES		SPA_VERSION_11
334 #define	SPA_VERSION_ORIGIN		SPA_VERSION_11
335 #define	SPA_VERSION_DSL_SCRUB		SPA_VERSION_11
336 #define	SPA_VERSION_SNAP_PROPS		SPA_VERSION_12
337 #define	SPA_VERSION_USED_BREAKDOWN	SPA_VERSION_13
338 #define	SPA_VERSION_PASSTHROUGH_X	SPA_VERSION_14
339 #define	SPA_VERSION_USERSPACE		SPA_VERSION_15
340 #define	SPA_VERSION_STMF_PROP		SPA_VERSION_16
341 #define	SPA_VERSION_RAIDZ3		SPA_VERSION_17
342 #define	SPA_VERSION_USERREFS		SPA_VERSION_18
343 
344 /*
345  * ZPL version - rev'd whenever an incompatible on-disk format change
346  * occurs.  This is independent of SPA/DMU/ZAP versioning.  You must
347  * also update the version_table[] and help message in zfs_prop.c.
348  *
349  * When changing, be sure to teach GRUB how to read the new format!
350  * See usr/src/grub/grub-0.97/stage2/{zfs-include/,fsys_zfs*}
351  */
352 #define	ZPL_VERSION_1			1ULL
353 #define	ZPL_VERSION_2			2ULL
354 #define	ZPL_VERSION_3			3ULL
355 #define	ZPL_VERSION_4			4ULL
356 #define	ZPL_VERSION			ZPL_VERSION_4
357 #define	ZPL_VERSION_STRING		"4"
358 
359 #define	ZPL_VERSION_INITIAL		ZPL_VERSION_1
360 #define	ZPL_VERSION_DIRENT_TYPE		ZPL_VERSION_2
361 #define	ZPL_VERSION_FUID		ZPL_VERSION_3
362 #define	ZPL_VERSION_NORMALIZATION	ZPL_VERSION_3
363 #define	ZPL_VERSION_SYSATTR		ZPL_VERSION_3
364 #define	ZPL_VERSION_USERSPACE		ZPL_VERSION_4
365 
366 /*
367  * The following are configuration names used in the nvlist describing a pool's
368  * configuration.
369  */
370 #define	ZPOOL_CONFIG_VERSION		"version"
371 #define	ZPOOL_CONFIG_POOL_NAME		"name"
372 #define	ZPOOL_CONFIG_POOL_STATE		"state"
373 #define	ZPOOL_CONFIG_POOL_TXG		"txg"
374 #define	ZPOOL_CONFIG_POOL_GUID		"pool_guid"
375 #define	ZPOOL_CONFIG_CREATE_TXG		"create_txg"
376 #define	ZPOOL_CONFIG_TOP_GUID		"top_guid"
377 #define	ZPOOL_CONFIG_VDEV_TREE		"vdev_tree"
378 #define	ZPOOL_CONFIG_TYPE		"type"
379 #define	ZPOOL_CONFIG_CHILDREN		"children"
380 #define	ZPOOL_CONFIG_ID			"id"
381 #define	ZPOOL_CONFIG_GUID		"guid"
382 #define	ZPOOL_CONFIG_PATH		"path"
383 #define	ZPOOL_CONFIG_DEVID		"devid"
384 #define	ZPOOL_CONFIG_METASLAB_ARRAY	"metaslab_array"
385 #define	ZPOOL_CONFIG_METASLAB_SHIFT	"metaslab_shift"
386 #define	ZPOOL_CONFIG_ASHIFT		"ashift"
387 #define	ZPOOL_CONFIG_ASIZE		"asize"
388 #define	ZPOOL_CONFIG_DTL		"DTL"
389 #define	ZPOOL_CONFIG_STATS		"stats"
390 #define	ZPOOL_CONFIG_WHOLE_DISK		"whole_disk"
391 #define	ZPOOL_CONFIG_ERRCOUNT		"error_count"
392 #define	ZPOOL_CONFIG_NOT_PRESENT	"not_present"
393 #define	ZPOOL_CONFIG_SPARES		"spares"
394 #define	ZPOOL_CONFIG_IS_SPARE		"is_spare"
395 #define	ZPOOL_CONFIG_NPARITY		"nparity"
396 #define	ZPOOL_CONFIG_HOSTID		"hostid"
397 #define	ZPOOL_CONFIG_HOSTNAME		"hostname"
398 #define	ZPOOL_CONFIG_UNSPARE		"unspare"
399 #define	ZPOOL_CONFIG_PHYS_PATH		"phys_path"
400 #define	ZPOOL_CONFIG_IS_LOG		"is_log"
401 #define	ZPOOL_CONFIG_L2CACHE		"l2cache"
402 #define	ZPOOL_CONFIG_SUSPENDED		"suspended"	/* not stored on disk */
403 #define	ZPOOL_CONFIG_TIMESTAMP		"timestamp"	/* not stored on disk */
404 #define	ZPOOL_CONFIG_BOOTFS		"bootfs"	/* not stored on disk */
405 /*
406  * The persistent vdev state is stored as separate values rather than a single
407  * 'vdev_state' entry.  This is because a device can be in multiple states, such
408  * as offline and degraded.
409  */
410 #define	ZPOOL_CONFIG_OFFLINE		"offline"
411 #define	ZPOOL_CONFIG_FAULTED		"faulted"
412 #define	ZPOOL_CONFIG_DEGRADED		"degraded"
413 #define	ZPOOL_CONFIG_REMOVED		"removed"
414 #define	ZPOOL_CONFIG_FRU		"fru"
415 
416 #define	VDEV_TYPE_ROOT			"root"
417 #define	VDEV_TYPE_MIRROR		"mirror"
418 #define	VDEV_TYPE_REPLACING		"replacing"
419 #define	VDEV_TYPE_RAIDZ			"raidz"
420 #define	VDEV_TYPE_DISK			"disk"
421 #define	VDEV_TYPE_FILE			"file"
422 #define	VDEV_TYPE_MISSING		"missing"
423 #define	VDEV_TYPE_SPARE			"spare"
424 #define	VDEV_TYPE_LOG			"log"
425 #define	VDEV_TYPE_L2CACHE		"l2cache"
426 
427 /*
428  * This is needed in userland to report the minimum necessary device size.
429  */
430 #define	SPA_MINDEVSIZE		(64ULL << 20)
431 
432 /*
433  * The location of the pool configuration repository, shared between kernel and
434  * userland.
435  */
436 #define	ZPOOL_CACHE		"/etc/zfs/zpool.cache"
437 
438 /*
439  * vdev states are ordered from least to most healthy.
440  * A vdev that's CANT_OPEN or below is considered unusable.
441  */
442 typedef enum vdev_state {
443 	VDEV_STATE_UNKNOWN = 0,	/* Uninitialized vdev			*/
444 	VDEV_STATE_CLOSED,	/* Not currently open			*/
445 	VDEV_STATE_OFFLINE,	/* Not allowed to open			*/
446 	VDEV_STATE_REMOVED,	/* Explicitly removed from system	*/
447 	VDEV_STATE_CANT_OPEN,	/* Tried to open, but failed		*/
448 	VDEV_STATE_FAULTED,	/* External request to fault device	*/
449 	VDEV_STATE_DEGRADED,	/* Replicated vdev with unhealthy kids	*/
450 	VDEV_STATE_HEALTHY	/* Presumed good			*/
451 } vdev_state_t;
452 
453 #define	VDEV_STATE_ONLINE	VDEV_STATE_HEALTHY
454 
455 /*
456  * vdev aux states.  When a vdev is in the CANT_OPEN state, the aux field
457  * of the vdev stats structure uses these constants to distinguish why.
458  */
459 typedef enum vdev_aux {
460 	VDEV_AUX_NONE,		/* no error				*/
461 	VDEV_AUX_OPEN_FAILED,	/* ldi_open_*() or vn_open() failed	*/
462 	VDEV_AUX_CORRUPT_DATA,	/* bad label or disk contents		*/
463 	VDEV_AUX_NO_REPLICAS,	/* insufficient number of replicas	*/
464 	VDEV_AUX_BAD_GUID_SUM,	/* vdev guid sum doesn't match		*/
465 	VDEV_AUX_TOO_SMALL,	/* vdev size is too small		*/
466 	VDEV_AUX_BAD_LABEL,	/* the label is OK but invalid		*/
467 	VDEV_AUX_VERSION_NEWER,	/* on-disk version is too new		*/
468 	VDEV_AUX_VERSION_OLDER,	/* on-disk version is too old		*/
469 	VDEV_AUX_SPARED,	/* hot spare used in another pool	*/
470 	VDEV_AUX_ERR_EXCEEDED,	/* too many errors			*/
471 	VDEV_AUX_IO_FAILURE,	/* experienced I/O failure		*/
472 	VDEV_AUX_BAD_LOG	/* cannot read log chain(s)		*/
473 } vdev_aux_t;
474 
475 /*
476  * pool state.  The following states are written to disk as part of the normal
477  * SPA lifecycle: ACTIVE, EXPORTED, DESTROYED, SPARE, L2CACHE.  The remaining
478  * states are software abstractions used at various levels to communicate
479  * pool state.
480  */
481 typedef enum pool_state {
482 	POOL_STATE_ACTIVE = 0,		/* In active use		*/
483 	POOL_STATE_EXPORTED,		/* Explicitly exported		*/
484 	POOL_STATE_DESTROYED,		/* Explicitly destroyed		*/
485 	POOL_STATE_SPARE,		/* Reserved for hot spare use	*/
486 	POOL_STATE_L2CACHE,		/* Level 2 ARC device		*/
487 	POOL_STATE_UNINITIALIZED,	/* Internal spa_t state		*/
488 	POOL_STATE_UNAVAIL,		/* Internal libzfs state	*/
489 	POOL_STATE_POTENTIALLY_ACTIVE	/* Internal libzfs state	*/
490 } pool_state_t;
491 
492 /*
493  * Scrub types.
494  */
495 typedef enum pool_scrub_type {
496 	POOL_SCRUB_NONE,
497 	POOL_SCRUB_RESILVER,
498 	POOL_SCRUB_EVERYTHING,
499 	POOL_SCRUB_TYPES
500 } pool_scrub_type_t;
501 
502 /*
503  * ZIO types.  Needed to interpret vdev statistics below.
504  */
505 typedef enum zio_type {
506 	ZIO_TYPE_NULL = 0,
507 	ZIO_TYPE_READ,
508 	ZIO_TYPE_WRITE,
509 	ZIO_TYPE_FREE,
510 	ZIO_TYPE_CLAIM,
511 	ZIO_TYPE_IOCTL,
512 	ZIO_TYPES
513 } zio_type_t;
514 
515 /*
516  * Vdev statistics.  Note: all fields should be 64-bit because this
517  * is passed between kernel and userland as an nvlist uint64 array.
518  */
519 typedef struct vdev_stat {
520 	hrtime_t	vs_timestamp;		/* time since vdev load	*/
521 	uint64_t	vs_state;		/* vdev state		*/
522 	uint64_t	vs_aux;			/* see vdev_aux_t	*/
523 	uint64_t	vs_alloc;		/* space allocated	*/
524 	uint64_t	vs_space;		/* total capacity	*/
525 	uint64_t	vs_dspace;		/* deflated capacity	*/
526 	uint64_t	vs_rsize;		/* replaceable dev size */
527 	uint64_t	vs_ops[ZIO_TYPES];	/* operation count	*/
528 	uint64_t	vs_bytes[ZIO_TYPES];	/* bytes read/written	*/
529 	uint64_t	vs_read_errors;		/* read errors		*/
530 	uint64_t	vs_write_errors;	/* write errors		*/
531 	uint64_t	vs_checksum_errors;	/* checksum errors	*/
532 	uint64_t	vs_self_healed;		/* self-healed bytes	*/
533 	uint64_t	vs_scrub_type;		/* pool_scrub_type_t	*/
534 	uint64_t	vs_scrub_complete;	/* completed?		*/
535 	uint64_t	vs_scrub_examined;	/* bytes examined; top	*/
536 	uint64_t	vs_scrub_repaired;	/* bytes repaired; leaf	*/
537 	uint64_t	vs_scrub_errors;	/* errors during scrub	*/
538 	uint64_t	vs_scrub_start;		/* UTC scrub start time	*/
539 	uint64_t	vs_scrub_end;		/* UTC scrub end time	*/
540 } vdev_stat_t;
541 
542 #define	ZVOL_DRIVER	"zvol"
543 #define	ZFS_DRIVER	"zfs"
544 #define	ZFS_DEV		"/dev/zfs"
545 
546 /*
547  * zvol paths.  Irritatingly, the devfsadm interfaces want all these
548  * paths without the /dev prefix, but for some things, we want the
549  * /dev prefix.  Below are the names without /dev.
550  */
551 #define	ZVOL_DEV_DIR	"zvol/dsk"
552 #define	ZVOL_RDEV_DIR	"zvol/rdsk"
553 
554 /*
555  * And here are the things we need with /dev, etc. in front of them.
556  */
557 #define	ZVOL_PSEUDO_DEV		"/devices/pseudo/zfs@0:"
558 #define	ZVOL_FULL_DEV_DIR	"/dev/" ZVOL_DEV_DIR "/"
559 
560 #define	ZVOL_PROP_NAME		"name"
561 
562 /*
563  * /dev/zfs ioctl numbers.
564  */
565 #define	ZFS_IOC		('Z' << 8)
566 
567 typedef enum zfs_ioc {
568 	ZFS_IOC_POOL_CREATE = ZFS_IOC,
569 	ZFS_IOC_POOL_DESTROY,
570 	ZFS_IOC_POOL_IMPORT,
571 	ZFS_IOC_POOL_EXPORT,
572 	ZFS_IOC_POOL_CONFIGS,
573 	ZFS_IOC_POOL_STATS,
574 	ZFS_IOC_POOL_TRYIMPORT,
575 	ZFS_IOC_POOL_SCRUB,
576 	ZFS_IOC_POOL_FREEZE,
577 	ZFS_IOC_POOL_UPGRADE,
578 	ZFS_IOC_POOL_GET_HISTORY,
579 	ZFS_IOC_VDEV_ADD,
580 	ZFS_IOC_VDEV_REMOVE,
581 	ZFS_IOC_VDEV_SET_STATE,
582 	ZFS_IOC_VDEV_ATTACH,
583 	ZFS_IOC_VDEV_DETACH,
584 	ZFS_IOC_VDEV_SETPATH,
585 	ZFS_IOC_VDEV_SETFRU,
586 	ZFS_IOC_OBJSET_STATS,
587 	ZFS_IOC_OBJSET_ZPLPROPS,
588 	ZFS_IOC_DATASET_LIST_NEXT,
589 	ZFS_IOC_SNAPSHOT_LIST_NEXT,
590 	ZFS_IOC_SET_PROP,
591 	ZFS_IOC_CREATE_MINOR,
592 	ZFS_IOC_REMOVE_MINOR,
593 	ZFS_IOC_CREATE,
594 	ZFS_IOC_DESTROY,
595 	ZFS_IOC_ROLLBACK,
596 	ZFS_IOC_RENAME,
597 	ZFS_IOC_RECV,
598 	ZFS_IOC_SEND,
599 	ZFS_IOC_INJECT_FAULT,
600 	ZFS_IOC_CLEAR_FAULT,
601 	ZFS_IOC_INJECT_LIST_NEXT,
602 	ZFS_IOC_ERROR_LOG,
603 	ZFS_IOC_CLEAR,
604 	ZFS_IOC_PROMOTE,
605 	ZFS_IOC_DESTROY_SNAPS,
606 	ZFS_IOC_SNAPSHOT,
607 	ZFS_IOC_DSOBJ_TO_DSNAME,
608 	ZFS_IOC_OBJ_TO_PATH,
609 	ZFS_IOC_POOL_SET_PROPS,
610 	ZFS_IOC_POOL_GET_PROPS,
611 	ZFS_IOC_SET_FSACL,
612 	ZFS_IOC_GET_FSACL,
613 	ZFS_IOC_ISCSI_PERM_CHECK,
614 	ZFS_IOC_SHARE,
615 	ZFS_IOC_INHERIT_PROP,
616 	ZFS_IOC_SMB_ACL,
617 	ZFS_IOC_USERSPACE_ONE,
618 	ZFS_IOC_USERSPACE_MANY,
619 	ZFS_IOC_USERSPACE_UPGRADE,
620 	ZFS_IOC_HOLD,
621 	ZFS_IOC_RELEASE,
622 	ZFS_IOC_GET_HOLDS
623 } zfs_ioc_t;
624 
625 /*
626  * Internal SPA load state.  Used by FMA diagnosis engine.
627  */
628 typedef enum {
629 	SPA_LOAD_NONE,		/* no load in progress */
630 	SPA_LOAD_OPEN,		/* normal open */
631 	SPA_LOAD_IMPORT,	/* import in progress */
632 	SPA_LOAD_TRYIMPORT	/* tryimport in progress */
633 } spa_load_state_t;
634 
635 /*
636  * Bookmark name values.
637  */
638 #define	ZPOOL_ERR_LIST		"error list"
639 #define	ZPOOL_ERR_DATASET	"dataset"
640 #define	ZPOOL_ERR_OBJECT	"object"
641 
642 #define	HIS_MAX_RECORD_LEN	(MAXPATHLEN + MAXPATHLEN + 1)
643 
644 /*
645  * The following are names used in the nvlist describing
646  * the pool's history log.
647  */
648 #define	ZPOOL_HIST_RECORD	"history record"
649 #define	ZPOOL_HIST_TIME		"history time"
650 #define	ZPOOL_HIST_CMD		"history command"
651 #define	ZPOOL_HIST_WHO		"history who"
652 #define	ZPOOL_HIST_ZONE		"history zone"
653 #define	ZPOOL_HIST_HOST		"history hostname"
654 #define	ZPOOL_HIST_TXG		"history txg"
655 #define	ZPOOL_HIST_INT_EVENT	"history internal event"
656 #define	ZPOOL_HIST_INT_STR	"history internal str"
657 
658 /*
659  * Flags for ZFS_IOC_VDEV_SET_STATE
660  */
661 #define	ZFS_ONLINE_CHECKREMOVE	0x1
662 #define	ZFS_ONLINE_UNSPARE	0x2
663 #define	ZFS_ONLINE_FORCEFAULT	0x4
664 #define	ZFS_ONLINE_EXPAND	0x8
665 #define	ZFS_OFFLINE_TEMPORARY	0x1
666 
667 /*
668  * Sysevent payload members.  ZFS will generate the following sysevents with the
669  * given payloads:
670  *
671  *	ESC_ZFS_RESILVER_START
672  *	ESC_ZFS_RESILVER_END
673  *	ESC_ZFS_POOL_DESTROY
674  *
675  *		ZFS_EV_POOL_NAME	DATA_TYPE_STRING
676  *		ZFS_EV_POOL_GUID	DATA_TYPE_UINT64
677  *
678  *	ESC_ZFS_VDEV_REMOVE
679  *	ESC_ZFS_VDEV_CLEAR
680  *	ESC_ZFS_VDEV_CHECK
681  *
682  *		ZFS_EV_POOL_NAME	DATA_TYPE_STRING
683  *		ZFS_EV_POOL_GUID	DATA_TYPE_UINT64
684  *		ZFS_EV_VDEV_PATH	DATA_TYPE_STRING	(optional)
685  *		ZFS_EV_VDEV_GUID	DATA_TYPE_UINT64
686  */
687 #define	ZFS_EV_POOL_NAME	"pool_name"
688 #define	ZFS_EV_POOL_GUID	"pool_guid"
689 #define	ZFS_EV_VDEV_PATH	"vdev_path"
690 #define	ZFS_EV_VDEV_GUID	"vdev_guid"
691 
692 /*
693  * Note: This is encoded on-disk, so new events must be added to the
694  * end, and unused events can not be removed.  Be sure to edit
695  * zpool_main.c: hist_event_table[].
696  */
697 typedef enum history_internal_events {
698 	LOG_NO_EVENT = 0,
699 	LOG_POOL_CREATE,
700 	LOG_POOL_VDEV_ADD,
701 	LOG_POOL_REMOVE,
702 	LOG_POOL_DESTROY,
703 	LOG_POOL_EXPORT,
704 	LOG_POOL_IMPORT,
705 	LOG_POOL_VDEV_ATTACH,
706 	LOG_POOL_VDEV_REPLACE,
707 	LOG_POOL_VDEV_DETACH,
708 	LOG_POOL_VDEV_ONLINE,
709 	LOG_POOL_VDEV_OFFLINE,
710 	LOG_POOL_UPGRADE,
711 	LOG_POOL_CLEAR,
712 	LOG_POOL_SCRUB,
713 	LOG_POOL_PROPSET,
714 	LOG_DS_CREATE,
715 	LOG_DS_CLONE,
716 	LOG_DS_DESTROY,
717 	LOG_DS_DESTROY_BEGIN,
718 	LOG_DS_INHERIT,
719 	LOG_DS_PROPSET,
720 	LOG_DS_QUOTA,
721 	LOG_DS_PERM_UPDATE,
722 	LOG_DS_PERM_REMOVE,
723 	LOG_DS_PERM_WHO_REMOVE,
724 	LOG_DS_PROMOTE,
725 	LOG_DS_RECEIVE,
726 	LOG_DS_RENAME,
727 	LOG_DS_RESERVATION,
728 	LOG_DS_REPLAY_INC_SYNC,
729 	LOG_DS_REPLAY_FULL_SYNC,
730 	LOG_DS_ROLLBACK,
731 	LOG_DS_SNAPSHOT,
732 	LOG_DS_UPGRADE,
733 	LOG_DS_REFQUOTA,
734 	LOG_DS_REFRESERV,
735 	LOG_POOL_SCRUB_DONE,
736 	LOG_DS_USER_HOLD,
737 	LOG_DS_USER_RELEASE,
738 	LOG_END
739 } history_internal_events_t;
740 
741 #ifdef	__cplusplus
742 }
743 #endif
744 
745 #endif	/* _SYS_FS_ZFS_H */
746