/*

 * CDDL HEADER START

 *

 * The contents of this file are subject to the terms of the

 * Common Development and Distribution License (the "License").

 * You may not use this file except in compliance with the License.

 *

 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

 * or http://www.opensolaris.org/os/licensing.

 * See the License for the specific language governing permissions

 * and limitations under the License.

 *

 * When distributing Covered Code, include this CDDL HEADER in each

 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.

 * If applicable, add the following below this CDDL HEADER, with the

 * fields enclosed by brackets "[]" replaced with your own identifying

 * information: Portions Copyright [yyyy] [name of copyright owner]

 *

 * CDDL HEADER END

 */

/*

 * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.

 * Use is subject to license terms.

 */

#ifndef	_SYS_FS_ZFS_H

#define	_SYS_FS_ZFS_H

#pragma ident	"%Z%%M%	%I%	%E% SMI"

#include <sys/types.h>

#ifdef	__cplusplus

extern "C" {

#endif

/*

 * Types and constants shared between userland and the kernel.

 */

/*

 * Each dataset can be one of the following types.  These constants can be

 * combined into masks that can be passed to various functions.

 */

typedef enum {

	ZFS_TYPE_FILESYSTEM	= 0x1,

	ZFS_TYPE_SNAPSHOT	= 0x2,

	ZFS_TYPE_VOLUME		= 0x4

} zfs_type_t;

#define	ZFS_TYPE_ANY	\

	(ZFS_TYPE_FILESYSTEM | ZFS_TYPE_VOLUME | ZFS_TYPE_SNAPSHOT)

/*

 * Properties are identified by these constants.  They are arranged in order of

 * how they should be displayed by 'zfs get'.  If you make any changes to this

 * list, be sure to update the property table in usr/src/common/zfs/zfs_prop.c.

 */

typedef enum {

	ZFS_PROP_INVAL = -1,

	ZFS_PROP_TYPE,

	ZFS_PROP_CREATION,

	ZFS_PROP_USED,

	ZFS_PROP_AVAILABLE,

	ZFS_PROP_REFERENCED,

	ZFS_PROP_COMPRESSRATIO,

	ZFS_PROP_MOUNTED,

	ZFS_PROP_ORIGIN,

	ZFS_PROP_QUOTA,

	ZFS_PROP_RESERVATION,

	ZFS_PROP_VOLSIZE,

	ZFS_PROP_VOLBLOCKSIZE,

	ZFS_PROP_RECORDSIZE,

	ZFS_PROP_MOUNTPOINT,

	ZFS_PROP_SHARENFS,

	ZFS_PROP_CHECKSUM,

	ZFS_PROP_COMPRESSION,

	ZFS_PROP_ATIME,

	ZFS_PROP_DEVICES,

	ZFS_PROP_EXEC,

	ZFS_PROP_SETUID,

	ZFS_PROP_READONLY,

	ZFS_PROP_ZONED,

	ZFS_PROP_SNAPDIR,

	ZFS_PROP_ACLMODE,

	ZFS_PROP_ACLINHERIT,

	/*

	 * The following properties are not exposed to the user, but are

	 * accessible by libzfs clients.

	 */

	ZFS_PROP_CREATETXG,

	ZFS_PROP_NAME,

	ZFS_NPROP_ALL

} zfs_prop_t;

#define	ZFS_NPROP_VISIBLE	ZFS_PROP_CREATETXG

#define	ZFS_PROP_VALUE		"value"

#define	ZFS_PROP_SOURCE		"source"

/*

 * The following functions are shared between libzfs and the kernel.

 */

zfs_prop_t zfs_name_to_prop(const char *);

int zfs_prop_readonly(zfs_prop_t);

const char *zfs_prop_default_string(zfs_prop_t);

uint64_t zfs_prop_default_numeric(zfs_prop_t);

/*

 * The following are configuration names used in the nvlist describing a pool's

 * configuration.

 */

#define	ZPOOL_CONFIG_VERSION		"version"

#define	ZPOOL_CONFIG_POOL_NAME		"name"

#define	ZPOOL_CONFIG_POOL_STATE		"state"

#define	ZPOOL_CONFIG_POOL_TXG		"txg"

#define	ZPOOL_CONFIG_POOL_GUID		"pool_guid"

#define	ZPOOL_CONFIG_CREATE_TXG		"create_txg"

#define	ZPOOL_CONFIG_TOP_GUID		"top_guid"

#define	ZPOOL_CONFIG_POOL_HEALTH	"pool_health"

#define	ZPOOL_CONFIG_VDEV_TREE		"vdev_tree"

#define	ZPOOL_CONFIG_TYPE		"type"

#define	ZPOOL_CONFIG_CHILDREN		"children"

#define	ZPOOL_CONFIG_ID			"id"

#define	ZPOOL_CONFIG_GUID		"guid"

#define	ZPOOL_CONFIG_PATH		"path"

#define	ZPOOL_CONFIG_DEVID		"devid"

#define	ZPOOL_CONFIG_METASLAB_ARRAY	"metaslab_array"

#define	ZPOOL_CONFIG_METASLAB_SHIFT	"metaslab_shift"

#define	ZPOOL_CONFIG_ASHIFT		"ashift"

#define	ZPOOL_CONFIG_ASIZE		"asize"

#define	ZPOOL_CONFIG_DTL		"DTL"

#define	ZPOOL_CONFIG_STATS		"stats"

#define	ZPOOL_CONFIG_WHOLE_DISK		"whole_disk"

#define	ZPOOL_CONFIG_OFFLINE		"offline"

#define	VDEV_TYPE_ROOT			"root"

#define	VDEV_TYPE_MIRROR		"mirror"

#define	VDEV_TYPE_REPLACING		"replacing"

#define	VDEV_TYPE_RAIDZ			"raidz"

#define	VDEV_TYPE_DISK			"disk"

#define	VDEV_TYPE_FILE			"file"

#define	VDEV_TYPE_MISSING		"missing"

/*

 * This is needed in userland to report the minimum necessary device size.

 */

#define	SPA_MINDEVSIZE		(64ULL << 20)

/*

 * The location of the pool configuration repository, shared between kernel and

 * userland.

 */

#define	ZPOOL_CACHE_DIR		"/etc/zfs"

#define	ZPOOL_CACHE_FILE	"zpool.cache"

#define	ZPOOL_CACHE_TMP		".zpool.cache"

#define	ZPOOL_CACHE		ZPOOL_CACHE_DIR "/" ZPOOL_CACHE_FILE

/*

 * vdev states are ordered from least to most healthy.

 * A vdev that's CANT_OPEN or below is considered unusable.

 */

typedef enum vdev_state {

	VDEV_STATE_UNKNOWN = 0,	/* Uninitialized vdev			*/

	VDEV_STATE_CLOSED,	/* Not currently open			*/

	VDEV_STATE_OFFLINE,	/* Not allowed to open			*/

	VDEV_STATE_CANT_OPEN,	/* Tried to open, but failed		*/

	VDEV_STATE_DEGRADED,	/* Replicated vdev with unhealthy kids	*/

	VDEV_STATE_HEALTHY	/* Presumed good			*/

} vdev_state_t;

/*

 * vdev aux states.  When a vdev is in the CANT_OPEN state, the aux field

 * of the vdev stats structure uses these constants to distinguish why.

 */

typedef enum vdev_aux {

	VDEV_AUX_NONE,		/* no error				*/

	VDEV_AUX_OPEN_FAILED,	/* ldi_open_*() or vn_open() failed	*/

	VDEV_AUX_CORRUPT_DATA,	/* bad label or disk contents		*/

	VDEV_AUX_NO_REPLICAS,	/* insufficient number of replicas	*/

	VDEV_AUX_BAD_GUID_SUM,	/* vdev guid sum doesn't match		*/

	VDEV_AUX_TOO_SMALL,	/* vdev size is too small		*/

	VDEV_AUX_BAD_LABEL	/* the label is OK but invalid		*/

} vdev_aux_t;

/*

 * pool state.  The following states are written to disk as part of the normal

 * SPA lifecycle: ACTIVE, EXPORTED, DESTROYED.  The remaining states are

 * software abstractions used at various levels to communicate pool state.

 */

typedef enum pool_state {

	POOL_STATE_ACTIVE = 0,		/* In active use		*/

	POOL_STATE_EXPORTED,		/* Explicitly exported		*/

	POOL_STATE_DESTROYED,		/* Explicitly destroyed		*/

	POOL_STATE_UNINITIALIZED,	/* Internal spa_t state		*/

	POOL_STATE_UNAVAIL,		/* Internal libzfs state	*/

	POOL_STATE_POTENTIALLY_ACTIVE	/* Internal libzfs state	*/

} pool_state_t;

/*

 * Scrub types.

 */

typedef enum pool_scrub_type {

	POOL_SCRUB_NONE,

	POOL_SCRUB_RESILVER,

	POOL_SCRUB_EVERYTHING,

	POOL_SCRUB_TYPES

} pool_scrub_type_t;

/*

 * ZIO types.  Needed to interpret vdev statistics below.

 */

typedef enum zio_type {

	ZIO_TYPE_NULL = 0,

	ZIO_TYPE_READ,

	ZIO_TYPE_WRITE,

	ZIO_TYPE_FREE,

	ZIO_TYPE_CLAIM,

	ZIO_TYPE_IOCTL,

	ZIO_TYPES

} zio_type_t;

/*

 * Vdev statistics.  Note: all fields should be 64-bit because this

 * is passed between kernel and userland as an nvlist uint64 array.

 */

typedef struct vdev_stat {

	hrtime_t	vs_timestamp;		/* time since vdev load	*/

	uint64_t	vs_state;		/* vdev state		*/

	uint64_t	vs_aux;			/* see vdev_aux_t	*/

	uint64_t	vs_alloc;		/* space allocated	*/

	uint64_t	vs_space;		/* total capacity	*/

	uint64_t	vs_rsize;		/* replaceable dev size */

	uint64_t	vs_ops[ZIO_TYPES];	/* operation count	*/

	uint64_t	vs_bytes[ZIO_TYPES];	/* bytes read/written	*/

	uint64_t	vs_read_errors;		/* read errors		*/

	uint64_t	vs_write_errors;	/* write errors		*/

	uint64_t	vs_checksum_errors;	/* checksum errors	*/

	uint64_t	vs_self_healed;		/* self-healed bytes	*/

	uint64_t	vs_scrub_type;		/* pool_scrub_type_t	*/

	uint64_t	vs_scrub_complete;	/* completed?		*/

	uint64_t	vs_scrub_examined;	/* bytes examined; top	*/

	uint64_t	vs_scrub_repaired;	/* bytes repaired; leaf	*/

	uint64_t	vs_scrub_errors;	/* errors during scrub	*/

	uint64_t	vs_scrub_start;		/* UTC scrub start time	*/

	uint64_t	vs_scrub_end;		/* UTC scrub end time	*/

} vdev_stat_t;

#define	ZFS_DRIVER	"zfs"

#define	ZFS_DEV		"/dev/zfs"

/*

 * zvol paths.  Irritatingly, the devfsadm interfaces want all these

 * paths without the /dev prefix, but for some things, we want the

 * /dev prefix.  Below are the names without /dev.

 */

#define	ZVOL_DEV_DIR	"zvol/dsk"

#define	ZVOL_RDEV_DIR	"zvol/rdsk"

/*

 * And here are the things we need with /dev, etc. in front of them.

 */

#define	ZVOL_PSEUDO_DEV		"/devices/pseudo/zvol@0:"

#define	ZVOL_FULL_DEV_DIR	"/dev/" ZVOL_DEV_DIR

#define	ZVOL_PROP_NAME		"name"

/*

 * /dev/zfs ioctl numbers.

 */

#define	ZFS_IOC		('Z' << 8)

typedef enum zfs_ioc {

	ZFS_IOC_POOL_CREATE = ZFS_IOC,

	ZFS_IOC_POOL_DESTROY,

	ZFS_IOC_POOL_IMPORT,

	ZFS_IOC_POOL_EXPORT,

	ZFS_IOC_POOL_CONFIGS,

	ZFS_IOC_POOL_GUID,

	ZFS_IOC_POOL_STATS,

	ZFS_IOC_POOL_TRYIMPORT,

	ZFS_IOC_POOL_SCRUB,

	ZFS_IOC_POOL_FREEZE,

	ZFS_IOC_VDEV_ADD,

	ZFS_IOC_VDEV_REMOVE,

	ZFS_IOC_VDEV_ONLINE,

	ZFS_IOC_VDEV_OFFLINE,

	ZFS_IOC_VDEV_ATTACH,

	ZFS_IOC_VDEV_DETACH,

	ZFS_IOC_VDEV_SETPATH,

	ZFS_IOC_OBJSET_STATS,

	ZFS_IOC_DATASET_LIST_NEXT,

	ZFS_IOC_SNAPSHOT_LIST_NEXT,

	ZFS_IOC_SET_PROP,

	ZFS_IOC_SET_QUOTA,

	ZFS_IOC_SET_RESERVATION,

	ZFS_IOC_SET_VOLSIZE,

	ZFS_IOC_SET_VOLBLOCKSIZE,

	ZFS_IOC_CREATE_MINOR,

	ZFS_IOC_REMOVE_MINOR,

	ZFS_IOC_CREATE,

	ZFS_IOC_DESTROY,

	ZFS_IOC_ROLLBACK,

	ZFS_IOC_RENAME,

	ZFS_IOC_RECVBACKUP,

} zfs_ioc_t;

#ifdef	__cplusplus

}

#endif

#endif	/* _SYS_FS_ZFS_H */