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