[apple/xnu.git] / bsd / sys / attr.h

/*
 * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. The rights granted to you under the License
 * may not be used to create, or enable the creation or redistribution of,
 * unlawful or unlicensed copies of an Apple operating system, or to
 * circumvent, violate, or enable the circumvention or violation of, any
 * terms of an Apple operating system software license agreement.
 * 
 * Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this file.
 * 
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */

/*
 * attr.h - attribute data structures and interfaces
 *
 * Copyright (c) 1998, Apple Computer, Inc.  All Rights Reserved.
 */

#ifndef _SYS_ATTR_H_
#define _SYS_ATTR_H_

#include <sys/appleapiopts.h>

#ifdef __APPLE_API_UNSTABLE
#include <sys/types.h>
#include <sys/ucred.h>
#include <sys/time.h>
#include <sys/cdefs.h>

#define FSOPT_NOFOLLOW 		0x00000001
#define FSOPT_NOINMEMUPDATE 	0x00000002
#define FSOPT_REPORT_FULLSIZE	0x00000004

/* we currently aren't anywhere near this amount for a valid
 * fssearchblock.sizeofsearchparams1 or fssearchblock.sizeofsearchparams2
 * but we put a sanity check in to avoid abuse of the value passed in from
 * user land.
 */
#define SEARCHFS_MAX_SEARCHPARMS  4096

typedef u_int32_t text_encoding_t;

typedef u_int32_t fsobj_type_t;

typedef u_int32_t fsobj_tag_t;

typedef u_int32_t fsfile_type_t;

typedef u_int32_t fsvolid_t;

typedef struct fsobj_id {
	u_int32_t		fid_objno;
	u_int32_t		fid_generation;
} fsobj_id_t;

typedef u_int32_t attrgroup_t;

struct attrlist {
	u_short bitmapcount;			/* number of attr. bit sets in list (should be 5) */
	u_int16_t reserved;				/* (to maintain 4-byte alignment) */
	attrgroup_t commonattr;			/* common attribute group */
	attrgroup_t volattr;			/* Volume attribute group */
	attrgroup_t dirattr;			/* directory attribute group */
	attrgroup_t fileattr;			/* file attribute group */
	attrgroup_t forkattr;			/* fork attribute group */
};
#define ATTR_BIT_MAP_COUNT 5

typedef struct attribute_set {
	attrgroup_t commonattr;			/* common attribute group */
	attrgroup_t volattr;			/* Volume attribute group */
	attrgroup_t dirattr;			/* directory attribute group */
	attrgroup_t fileattr;			/* file attribute group */
	attrgroup_t forkattr;			/* fork attribute group */
} attribute_set_t;

typedef struct attrreference {
	int32_t     attr_dataoffset;
	u_int32_t   attr_length;
} attrreference_t;

/* XXX PPD This is derived from HFSVolumePriv.h and should perhaps be referenced from there? */

struct diskextent {
	u_int32_t					startblock;				/* first block allocated */
	u_int32_t					blockcount;				/* number of blocks allocated */
};

typedef struct diskextent extentrecord[8];

typedef u_int32_t vol_capabilities_set_t[4];

#define VOL_CAPABILITIES_FORMAT 0
#define VOL_CAPABILITIES_INTERFACES 1
#define VOL_CAPABILITIES_RESERVED1 2
#define VOL_CAPABILITIES_RESERVED2 3

typedef struct vol_capabilities_attr {
	vol_capabilities_set_t capabilities;
	vol_capabilities_set_t valid;
} vol_capabilities_attr_t;

/*
 * XXX this value needs to be raised - 3893388
 */
#define ATTR_MAX_BUFFER		8192

/*
 * VOL_CAP_FMT_PERSISTENTOBJECTIDS: When set, the volume has object IDs
 * that are persistent (retain their values even when the volume is
 * unmounted and remounted), and a file or directory can be looked up
 * by ID.  Volumes that support VolFS and can support Carbon File ID
 * references should set this bit.
 *
 * VOL_CAP_FMT_SYMBOLICLINKS: When set, the volume supports symbolic
 * links.  The symlink(), readlink(), and lstat() calls all use this
 * symbolic link.
 *
 * VOL_CAP_FMT_HARDLINKS: When set, the volume supports hard links.
 * The link() call creates hard links.
 *
 * VOL_CAP_FMT_JOURNAL: When set, the volume is capable of supporting
 * a journal used to speed recovery in case of unplanned shutdown
 * (such as a power outage or crash).  This bit does not necessarily
 * mean the volume is actively using a journal for recovery.
 *
 * VOL_CAP_FMT_JOURNAL_ACTIVE: When set, the volume is currently using
 * a journal for use in speeding recovery after an unplanned shutdown.
 * This bit can be set only if VOL_CAP_FMT_JOURNAL is also set.
 *
 * VOL_CAP_FMT_NO_ROOT_TIMES: When set, the volume format does not
 * store reliable times for the root directory, so you should not
 * depend on them to detect changes, etc.
 *
 * VOL_CAP_FMT_SPARSE_FILES: When set, the volume supports sparse files.
 * That is, files which can have "holes" that have never been written
 * to, and are not allocated on disk.  Sparse files may have an
 * allocated size that is less than the file's logical length.
 *
 * VOL_CAP_FMT_ZERO_RUNS: For security reasons, parts of a file (runs)
 * that have never been written to must appear to contain zeroes.  When
 * this bit is set, the volume keeps track of allocated but unwritten
 * runs of a file so that it can substitute zeroes without actually
 * writing zeroes to the media.  This provides performance similar to
 * sparse files, but not the space savings.
 *
 * VOL_CAP_FMT_CASE_SENSITIVE: When set, file and directory names are
 * case sensitive (upper and lower case are different).  When clear,
 * an upper case character is equivalent to a lower case character,
 * and you can't have two names that differ solely in the case of
 * the characters.
 *
 * VOL_CAP_FMT_CASE_PRESERVING: When set, file and directory names
 * preserve the difference between upper and lower case.  If clear,
 * the volume may change the case of some characters (typically
 * making them all upper or all lower case).  A volume that sets
 * VOL_CAP_FMT_CASE_SENSITIVE should also set VOL_CAP_FMT_CASE_PRESERVING.
 *
 * VOL_CAP_FMT_FAST_STATFS: This bit is used as a hint to upper layers
 * (especially Carbon) that statfs() is fast enough that its results
 * need not be cached by those upper layers.  A volume that caches
 * the statfs information in its in-memory structures should set this bit.
 * A volume that must always read from disk or always perform a network
 * transaction should not set this bit.  
 * 
 * VOL_CAP_FMT_2TB_FILESIZE: When set, the volume format supports file 
 * size upto 2TB.  This bit does not necessarily mean that the file 
 * system does not support file size more than 2TB.   This bit does 
 * not mean that the currently available space on the volume is 2TB. 
 */
#define VOL_CAP_FMT_PERSISTENTOBJECTIDS		0x00000001
#define VOL_CAP_FMT_SYMBOLICLINKS 		0x00000002
#define VOL_CAP_FMT_HARDLINKS      		0x00000004
#define VOL_CAP_FMT_JOURNAL       		0x00000008
#define VOL_CAP_FMT_JOURNAL_ACTIVE 		0x00000010
#define VOL_CAP_FMT_NO_ROOT_TIMES 		0x00000020
#define VOL_CAP_FMT_SPARSE_FILES 		0x00000040
#define VOL_CAP_FMT_ZERO_RUNS     		0x00000080
#define VOL_CAP_FMT_CASE_SENSITIVE 		0x00000100
#define VOL_CAP_FMT_CASE_PRESERVING		0x00000200
#define VOL_CAP_FMT_FAST_STATFS 		0x00000400
#define VOL_CAP_FMT_2TB_FILESIZE		0x00000800


/*
 * VOL_CAP_INT_SEARCHFS: When set, the volume implements the
 * searchfs() system call (the vnop_searchfs vnode operation).
 *
 * VOL_CAP_INT_ATTRLIST: When set, the volume implements the
 * getattrlist() and setattrlist() system calls (vnop_getattrlist
 * and vnop_setattrlist vnode operations) for the volume, files,
 * and directories.  The volume may or may not implement the
 * readdirattr() system call.  XXX Is there any minimum set
 * of attributes that should be supported?  To determine the
 * set of supported attributes, get the ATTR_VOL_ATTRIBUTES
 * attribute of the volume.
 *
 * VOL_CAP_INT_NFSEXPORT: When set, the volume implements exporting
 * of NFS volumes.
 *
 * VOL_CAP_INT_READDIRATTR: When set, the volume implements the
 * readdirattr() system call (vnop_readdirattr vnode operation).
 *
 * VOL_CAP_INT_EXCHANGEDATA: When set, the volume implements the
 * exchangedata() system call (VNOP_EXCHANGE vnode operation).
 *
 * VOL_CAP_INT_COPYFILE: When set, the volume implements the
 * VOP_COPYFILE vnode operation.  (XXX There should be a copyfile()
 * system call in <unistd.h>.)
 *
 * VOL_CAP_INT_ALLOCATE: When set, the volume implements the
 * VNOP_ALLOCATE vnode operation, which means it implements the
 * F_PREALLOCATE selector of fcntl(2).
 *
 * VOL_CAP_INT_VOL_RENAME: When set, the volume implements the
 * ATTR_VOL_NAME attribute for both getattrlist() and setattrlist().
 * The volume can be renamed by setting ATTR_VOL_NAME with setattrlist().
 *
 * VOL_CAP_INT_ADVLOCK: When set, the volume implements POSIX style
 * byte range locks via vnop_advlock (accessible from fcntl(2)).
 *
 * VOL_CAP_INT_FLOCK: When set, the volume implements whole-file flock(2)
 * style locks via vnop_advlock.  This includes the O_EXLOCK and O_SHLOCK
 * flags of the open(2) call.
 *
 */
#define VOL_CAP_INT_SEARCHFS			0x00000001
#define VOL_CAP_INT_ATTRLIST			0x00000002
#define VOL_CAP_INT_NFSEXPORT			0x00000004
#define VOL_CAP_INT_READDIRATTR			0x00000008
#define VOL_CAP_INT_EXCHANGEDATA		0x00000010
#define VOL_CAP_INT_COPYFILE			0x00000020
#define VOL_CAP_INT_ALLOCATE			0x00000040
#define VOL_CAP_INT_VOL_RENAME			0x00000080
#define VOL_CAP_INT_ADVLOCK			0x00000100
#define VOL_CAP_INT_FLOCK			0x00000200
#define VOL_CAP_INT_EXTENDED_SECURITY		0x00000400
#define VOL_CAP_INT_USERACCESS			0x00000800

typedef struct vol_attributes_attr {
	attribute_set_t validattr;
	attribute_set_t nativeattr;
} vol_attributes_attr_t;

#define ATTR_CMN_NAME				0x00000001
#define ATTR_CMN_DEVID				0x00000002
#define ATTR_CMN_FSID				0x00000004
#define ATTR_CMN_OBJTYPE			0x00000008
#define ATTR_CMN_OBJTAG				0x00000010
#define ATTR_CMN_OBJID				0x00000020
#define ATTR_CMN_OBJPERMANENTID			0x00000040
#define ATTR_CMN_PAROBJID			0x00000080
#define ATTR_CMN_SCRIPT				0x00000100
#define ATTR_CMN_CRTIME				0x00000200
#define ATTR_CMN_MODTIME			0x00000400
#define ATTR_CMN_CHGTIME			0x00000800
#define ATTR_CMN_ACCTIME			0x00001000
#define ATTR_CMN_BKUPTIME			0x00002000
#define ATTR_CMN_FNDRINFO			0x00004000
#define ATTR_CMN_OWNERID			0x00008000
#define ATTR_CMN_GRPID				0x00010000
#define ATTR_CMN_ACCESSMASK			0x00020000
#define ATTR_CMN_FLAGS				0x00040000
#define ATTR_CMN_USERACCESS			0x00200000
#define ATTR_CMN_EXTENDED_SECURITY		0x00400000
#define ATTR_CMN_UUID				0x00800000
#define ATTR_CMN_GRPUUID			0x01000000

#define ATTR_CMN_VALIDMASK			0x003FFFFF
#define ATTR_CMN_SETMASK			0x01C7FF00
#define ATTR_CMN_VOLSETMASK			0x00006700

#define ATTR_VOL_FSTYPE				0x00000001
#define ATTR_VOL_SIGNATURE			0x00000002
#define ATTR_VOL_SIZE				0x00000004
#define ATTR_VOL_SPACEFREE			0x00000008
#define ATTR_VOL_SPACEAVAIL			0x00000010
#define ATTR_VOL_MINALLOCATION			0x00000020
#define ATTR_VOL_ALLOCATIONCLUMP		0x00000040
#define ATTR_VOL_IOBLOCKSIZE			0x00000080
#define ATTR_VOL_OBJCOUNT			0x00000100
#define ATTR_VOL_FILECOUNT			0x00000200
#define ATTR_VOL_DIRCOUNT			0x00000400
#define ATTR_VOL_MAXOBJCOUNT			0x00000800
#define ATTR_VOL_MOUNTPOINT			0x00001000
#define ATTR_VOL_NAME				0x00002000
#define ATTR_VOL_MOUNTFLAGS			0x00004000
#define ATTR_VOL_MOUNTEDDEVICE			0x00008000
#define ATTR_VOL_ENCODINGSUSED			0x00010000
#define ATTR_VOL_CAPABILITIES			0x00020000
#define ATTR_VOL_ATTRIBUTES			0x40000000
#define ATTR_VOL_INFO				0x80000000

#define ATTR_VOL_VALIDMASK			0xC003FFFF
#define ATTR_VOL_SETMASK			0x80002000


/* File/directory attributes: */
#define ATTR_DIR_LINKCOUNT			0x00000001
#define ATTR_DIR_ENTRYCOUNT			0x00000002
#define ATTR_DIR_MOUNTSTATUS			0x00000004
#define DIR_MNTSTATUS_MNTPOINT		0x00000001

#define ATTR_DIR_VALIDMASK			0x00000007
#define ATTR_DIR_SETMASK			0x00000000

#define ATTR_FILE_LINKCOUNT			0x00000001
#define ATTR_FILE_TOTALSIZE			0x00000002
#define ATTR_FILE_ALLOCSIZE			0x00000004
#define ATTR_FILE_IOBLOCKSIZE			0x00000008
#define ATTR_FILE_DEVTYPE			0x00000020
#define ATTR_FILE_FORKCOUNT			0x00000080
#define ATTR_FILE_FORKLIST			0x00000100
#define ATTR_FILE_DATALENGTH			0x00000200
#define ATTR_FILE_DATAALLOCSIZE			0x00000400
#define ATTR_FILE_RSRCLENGTH			0x00001000
#define ATTR_FILE_RSRCALLOCSIZE			0x00002000

#define ATTR_FILE_VALIDMASK			0x00007FFF
#define ATTR_FILE_SETMASK			0x00000020

#define ATTR_FORK_TOTALSIZE			0x00000001
#define ATTR_FORK_ALLOCSIZE			0x00000002

#define ATTR_FORK_VALIDMASK			0x00000003
#define ATTR_FORK_SETMASK			0x00000000

/* Obsolete, implemented, not supported */
#define ATTR_CMN_NAMEDATTRCOUNT			0x00080000	/* not implemented */
#define ATTR_CMN_NAMEDATTRLIST			0x00100000	/* not implemented */
#define ATTR_FILE_CLUMPSIZE			0x00000010	/* obsolete */
#define ATTR_FILE_FILETYPE			0x00000040	/* always zero */
#define ATTR_FILE_DATAEXTENTS			0x00000800	/* obsolete, HFS-specific */
#define ATTR_FILE_RSRCEXTENTS			0x00004000	/* obsolete, HFS-specific */

/*
 * Searchfs
 */
#define SRCHFS_START 				0x00000001
#define SRCHFS_MATCHPARTIALNAMES 		0x00000002
#define SRCHFS_MATCHDIRS 			0x00000004
#define SRCHFS_MATCHFILES 			0x00000008
#define SRCHFS_SKIPLINKS 			0x00000010
#define SRCHFS_SKIPINVISIBLE			0x00000020
#define SRCHFS_SKIPPACKAGES			0x00000040
#define SRCHFS_SKIPINAPPROPRIATE		0x00000080

#define SRCHFS_NEGATEPARAMS 			0x80000000
#define SRCHFS_VALIDOPTIONSMASK			0x800000FF

struct fssearchblock {
	struct attrlist		*returnattrs;
	void				*returnbuffer;
	size_t				returnbuffersize;
	u_long				maxmatches;
	struct timeval		timelimit;
	void				*searchparams1;
	size_t				sizeofsearchparams1;
	void				*searchparams2;
	size_t				sizeofsearchparams2;
	struct attrlist		searchattrs;
};

#ifdef KERNEL
/* LP64 version of fssearchblock.  all pointers and longs
 * grow when we're dealing with a 64-bit process.
 * WARNING - keep in sync with fssearchblock
 */
// LP64todo - should this move?

#if __DARWIN_ALIGN_NATURAL
#pragma options align=natural
#endif

struct user_fssearchblock {
	user_addr_t         returnattrs;
	user_addr_t         returnbuffer;
	user_size_t         returnbuffersize;
	user_ulong_t        maxmatches;
	struct timeval		timelimit;
	user_addr_t         searchparams1;
	user_size_t         sizeofsearchparams1;
	user_addr_t         searchparams2;
	user_size_t         sizeofsearchparams2;
	struct attrlist		searchattrs;
};

#if __DARWIN_ALIGN_NATURAL
#pragma options align=reset
#endif


#endif // KERNEL


struct searchstate {
	u_char				reserved[556];		//	sizeof( SearchState )
};


#define FST_EOF (-1)				/* end-of-file offset */

#endif /* __APPLE_API_UNSTABLE */
#endif /* !_SYS_ATTR_H_ */
Commit	Line	Data
1c79356b	1	/*
5d5c5d0d A	2	* Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
5d5c5d0d A	3	*
8f6c56a5	4	* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
1c79356b	5	*
8f6c56a5 A	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. The rights granted to you under the License
	10	* may not be used to create, or enable the creation or redistribution of,
	11	* unlawful or unlicensed copies of an Apple operating system, or to
	12	* circumvent, violate, or enable the circumvention or violation of, any
	13	* terms of an Apple operating system software license agreement.
	14	*
	15	* Please obtain a copy of the License at
	16	* http://www.opensource.apple.com/apsl/ and read it before using this file.
	17	*
	18	* The Original Code and all software distributed under the License are
	19	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	20	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	21	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	22	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	23	* Please see the License for the specific language governing rights and
8ad349bb	24	* limitations under the License.
8f6c56a5 A	25	*
8f6c56a5 A	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b A	27	*/
	28
	29	/*
	30	* attr.h - attribute data structures and interfaces
	31	*
	32	* Copyright (c) 1998, Apple Computer, Inc. All Rights Reserved.
	33	*/
	34
	35	#ifndef _SYS_ATTR_H_
	36	#define _SYS_ATTR_H_
	37
9bccf70c A	38	#include <sys/appleapiopts.h>
	39
	40	#ifdef __APPLE_API_UNSTABLE
1c79356b	41	#include <sys/types.h>
1c79356b	42	#include <sys/ucred.h>
1c79356b	43	#include <sys/time.h>
91447636	44	#include <sys/cdefs.h>
1c79356b A	45
1c79356b A	46	#define FSOPT_NOFOLLOW 0x00000001
91447636 A	47	#define FSOPT_NOINMEMUPDATE 0x00000002
91447636 A	48	#define FSOPT_REPORT_FULLSIZE 0x00000004
1c79356b	49
a3d08fcd A	50	/* we currently aren't anywhere near this amount for a valid
	51	* fssearchblock.sizeofsearchparams1 or fssearchblock.sizeofsearchparams2
	52	* but we put a sanity check in to avoid abuse of the value passed in from
	53	* user land.
	54	*/
	55	#define SEARCHFS_MAX_SEARCHPARMS 4096
	56
1c79356b A	57	typedef u_int32_t text_encoding_t;
	58
	59	typedef u_int32_t fsobj_type_t;
	60
	61	typedef u_int32_t fsobj_tag_t;
	62
	63	typedef u_int32_t fsfile_type_t;
	64
	65	typedef u_int32_t fsvolid_t;
	66
	67	typedef struct fsobj_id {
	68	u_int32_t fid_objno;
	69	u_int32_t fid_generation;
	70	} fsobj_id_t;
	71
	72	typedef u_int32_t attrgroup_t;
	73
	74	struct attrlist {
	75	u_short bitmapcount; /* number of attr. bit sets in list (should be 5) */
	76	u_int16_t reserved; /* (to maintain 4-byte alignment) */
	77	attrgroup_t commonattr; /* common attribute group */
	78	attrgroup_t volattr; /* Volume attribute group */
	79	attrgroup_t dirattr; /* directory attribute group */
	80	attrgroup_t fileattr; /* file attribute group */
	81	attrgroup_t forkattr; /* fork attribute group */
	82	};
	83	#define ATTR_BIT_MAP_COUNT 5
	84
	85	typedef struct attribute_set {
	86	attrgroup_t commonattr; /* common attribute group */
	87	attrgroup_t volattr; /* Volume attribute group */
	88	attrgroup_t dirattr; /* directory attribute group */
	89	attrgroup_t fileattr; /* file attribute group */
	90	attrgroup_t forkattr; /* fork attribute group */
	91	} attribute_set_t;
	92
	93	typedef struct attrreference {
91447636 A	94	int32_t attr_dataoffset;
91447636 A	95	u_int32_t attr_length;
1c79356b A	96	} attrreference_t;
	97
	98	/* XXX PPD This is derived from HFSVolumePriv.h and should perhaps be referenced from there? */
	99
	100	struct diskextent {
	101	u_int32_t startblock; /* first block allocated */
	102	u_int32_t blockcount; /* number of blocks allocated */
	103	};
	104
	105	typedef struct diskextent extentrecord[8];
	106
	107	typedef u_int32_t vol_capabilities_set_t[4];
	108
	109	#define VOL_CAPABILITIES_FORMAT 0
	110	#define VOL_CAPABILITIES_INTERFACES 1
	111	#define VOL_CAPABILITIES_RESERVED1 2
	112	#define VOL_CAPABILITIES_RESERVED2 3
	113
	114	typedef struct vol_capabilities_attr {
	115	vol_capabilities_set_t capabilities;
	116	vol_capabilities_set_t valid;
	117	} vol_capabilities_attr_t;
	118
91447636 A	119	/*
	120	* XXX this value needs to be raised - 3893388
	121	*/
	122	#define ATTR_MAX_BUFFER 8192
	123
55e303ae A	124	/*
	125	* VOL_CAP_FMT_PERSISTENTOBJECTIDS: When set, the volume has object IDs
	126	* that are persistent (retain their values even when the volume is
	127	* unmounted and remounted), and a file or directory can be looked up
	128	* by ID. Volumes that support VolFS and can support Carbon File ID
	129	* references should set this bit.
	130	*
	131	* VOL_CAP_FMT_SYMBOLICLINKS: When set, the volume supports symbolic
	132	* links. The symlink(), readlink(), and lstat() calls all use this
	133	* symbolic link.
	134	*
	135	* VOL_CAP_FMT_HARDLINKS: When set, the volume supports hard links.
	136	* The link() call creates hard links.
	137	*
	138	* VOL_CAP_FMT_JOURNAL: When set, the volume is capable of supporting
	139	* a journal used to speed recovery in case of unplanned shutdown
	140	* (such as a power outage or crash). This bit does not necessarily
	141	* mean the volume is actively using a journal for recovery.
	142	*
	143	* VOL_CAP_FMT_JOURNAL_ACTIVE: When set, the volume is currently using
	144	* a journal for use in speeding recovery after an unplanned shutdown.
	145	* This bit can be set only if VOL_CAP_FMT_JOURNAL is also set.
	146	*
	147	* VOL_CAP_FMT_NO_ROOT_TIMES: When set, the volume format does not
	148	* store reliable times for the root directory, so you should not
	149	* depend on them to detect changes, etc.
	150	*
	151	* VOL_CAP_FMT_SPARSE_FILES: When set, the volume supports sparse files.
	152	* That is, files which can have "holes" that have never been written
	153	* to, and are not allocated on disk. Sparse files may have an
	154	* allocated size that is less than the file's logical length.
	155	*
	156	* VOL_CAP_FMT_ZERO_RUNS: For security reasons, parts of a file (runs)
	157	* that have never been written to must appear to contain zeroes. When
	158	* this bit is set, the volume keeps track of allocated but unwritten
	159	* runs of a file so that it can substitute zeroes without actually
	160	* writing zeroes to the media. This provides performance similar to
	161	* sparse files, but not the space savings.
	162	*
	163	* VOL_CAP_FMT_CASE_SENSITIVE: When set, file and directory names are
	164	* case sensitive (upper and lower case are different). When clear,
	165	* an upper case character is equivalent to a lower case character,
	166	* and you can't have two names that differ solely in the case of
	167	* the characters.
	168	*
	169	* VOL_CAP_FMT_CASE_PRESERVING: When set, file and directory names
	170	* preserve the difference between upper and lower case. If clear,
	171	* the volume may change the case of some characters (typically
	172	* making them all upper or all lower case). A volume that sets
	173	* VOL_CAP_FMT_CASE_SENSITIVE should also set VOL_CAP_FMT_CASE_PRESERVING.
	174	*
	175	* VOL_CAP_FMT_FAST_STATFS: This bit is used as a hint to upper layers
	176	* (especially Carbon) that statfs() is fast enough that its results
	177	* need not be cached by those upper layers. A volume that caches
	178	* the statfs information in its in-memory structures should set this bit.
	179	* A volume that must always read from disk or always perform a network
	180	* transaction should not set this bit.
91447636 A	181	*
	182	* VOL_CAP_FMT_2TB_FILESIZE: When set, the volume format supports file
	183	* size upto 2TB. This bit does not necessarily mean that the file
	184	* system does not support file size more than 2TB. This bit does
	185	* not mean that the currently available space on the volume is 2TB.
55e303ae	186	*/
91447636 A	187	#define VOL_CAP_FMT_PERSISTENTOBJECTIDS 0x00000001
	188	#define VOL_CAP_FMT_SYMBOLICLINKS 0x00000002
	189	#define VOL_CAP_FMT_HARDLINKS 0x00000004
	190	#define VOL_CAP_FMT_JOURNAL 0x00000008
	191	#define VOL_CAP_FMT_JOURNAL_ACTIVE 0x00000010
	192	#define VOL_CAP_FMT_NO_ROOT_TIMES 0x00000020
	193	#define VOL_CAP_FMT_SPARSE_FILES 0x00000040
	194	#define VOL_CAP_FMT_ZERO_RUNS 0x00000080
	195	#define VOL_CAP_FMT_CASE_SENSITIVE 0x00000100
	196	#define VOL_CAP_FMT_CASE_PRESERVING 0x00000200
	197	#define VOL_CAP_FMT_FAST_STATFS 0x00000400
	198	#define VOL_CAP_FMT_2TB_FILESIZE 0x00000800
55e303ae	199
1c79356b	200
55e303ae A	201	/*
55e303ae A	202	* VOL_CAP_INT_SEARCHFS: When set, the volume implements the
91447636	203	* searchfs() system call (the vnop_searchfs vnode operation).
55e303ae A	204	*
55e303ae A	205	* VOL_CAP_INT_ATTRLIST: When set, the volume implements the
91447636 A	206	* getattrlist() and setattrlist() system calls (vnop_getattrlist
91447636 A	207	* and vnop_setattrlist vnode operations) for the volume, files,
55e303ae A	208	* and directories. The volume may or may not implement the
	209	* readdirattr() system call. XXX Is there any minimum set
	210	* of attributes that should be supported? To determine the
	211	* set of supported attributes, get the ATTR_VOL_ATTRIBUTES
	212	* attribute of the volume.
	213	*
	214	* VOL_CAP_INT_NFSEXPORT: When set, the volume implements exporting
	215	* of NFS volumes.
	216	*
	217	* VOL_CAP_INT_READDIRATTR: When set, the volume implements the
91447636	218	* readdirattr() system call (vnop_readdirattr vnode operation).
55e303ae A	219	*
55e303ae A	220	* VOL_CAP_INT_EXCHANGEDATA: When set, the volume implements the
91447636	221	* exchangedata() system call (VNOP_EXCHANGE vnode operation).
55e303ae A	222	*
	223	* VOL_CAP_INT_COPYFILE: When set, the volume implements the
	224	* VOP_COPYFILE vnode operation. (XXX There should be a copyfile()
	225	* system call in <unistd.h>.)
	226	*
	227	* VOL_CAP_INT_ALLOCATE: When set, the volume implements the
91447636	228	* VNOP_ALLOCATE vnode operation, which means it implements the
55e303ae A	229	* F_PREALLOCATE selector of fcntl(2).
	230	*
	231	* VOL_CAP_INT_VOL_RENAME: When set, the volume implements the
	232	* ATTR_VOL_NAME attribute for both getattrlist() and setattrlist().
	233	* The volume can be renamed by setting ATTR_VOL_NAME with setattrlist().
	234	*
	235	* VOL_CAP_INT_ADVLOCK: When set, the volume implements POSIX style
91447636	236	* byte range locks via vnop_advlock (accessible from fcntl(2)).
55e303ae A	237	*
55e303ae A	238	* VOL_CAP_INT_FLOCK: When set, the volume implements whole-file flock(2)
91447636	239	* style locks via vnop_advlock. This includes the O_EXLOCK and O_SHLOCK
55e303ae A	240	* flags of the open(2) call.
	241	*
	242	*/
91447636 A	243	#define VOL_CAP_INT_SEARCHFS 0x00000001
	244	#define VOL_CAP_INT_ATTRLIST 0x00000002
	245	#define VOL_CAP_INT_NFSEXPORT 0x00000004
	246	#define VOL_CAP_INT_READDIRATTR 0x00000008
	247	#define VOL_CAP_INT_EXCHANGEDATA 0x00000010
	248	#define VOL_CAP_INT_COPYFILE 0x00000020
	249	#define VOL_CAP_INT_ALLOCATE 0x00000040
	250	#define VOL_CAP_INT_VOL_RENAME 0x00000080
	251	#define VOL_CAP_INT_ADVLOCK 0x00000100
	252	#define VOL_CAP_INT_FLOCK 0x00000200
	253	#define VOL_CAP_INT_EXTENDED_SECURITY 0x00000400
	254	#define VOL_CAP_INT_USERACCESS 0x00000800
1c79356b A	255
	256	typedef struct vol_attributes_attr {
	257	attribute_set_t validattr;
	258	attribute_set_t nativeattr;
	259	} vol_attributes_attr_t;
	260
1c79356b A	261	#define ATTR_CMN_NAME 0x00000001
	262	#define ATTR_CMN_DEVID 0x00000002
	263	#define ATTR_CMN_FSID 0x00000004
	264	#define ATTR_CMN_OBJTYPE 0x00000008
	265	#define ATTR_CMN_OBJTAG 0x00000010
	266	#define ATTR_CMN_OBJID 0x00000020
91447636	267	#define ATTR_CMN_OBJPERMANENTID 0x00000040
1c79356b A	268	#define ATTR_CMN_PAROBJID 0x00000080
	269	#define ATTR_CMN_SCRIPT 0x00000100
	270	#define ATTR_CMN_CRTIME 0x00000200
	271	#define ATTR_CMN_MODTIME 0x00000400
	272	#define ATTR_CMN_CHGTIME 0x00000800
	273	#define ATTR_CMN_ACCTIME 0x00001000
	274	#define ATTR_CMN_BKUPTIME 0x00002000
	275	#define ATTR_CMN_FNDRINFO 0x00004000
	276	#define ATTR_CMN_OWNERID 0x00008000
	277	#define ATTR_CMN_GRPID 0x00010000
	278	#define ATTR_CMN_ACCESSMASK 0x00020000
	279	#define ATTR_CMN_FLAGS 0x00040000
1c79356b	280	#define ATTR_CMN_USERACCESS 0x00200000
91447636 A	281	#define ATTR_CMN_EXTENDED_SECURITY 0x00400000
	282	#define ATTR_CMN_UUID 0x00800000
	283	#define ATTR_CMN_GRPUUID 0x01000000
1c79356b A	284
1c79356b A	285	#define ATTR_CMN_VALIDMASK 0x003FFFFF
91447636	286	#define ATTR_CMN_SETMASK 0x01C7FF00
1c79356b A	287	#define ATTR_CMN_VOLSETMASK 0x00006700
	288
	289	#define ATTR_VOL_FSTYPE 0x00000001
	290	#define ATTR_VOL_SIGNATURE 0x00000002
	291	#define ATTR_VOL_SIZE 0x00000004
	292	#define ATTR_VOL_SPACEFREE 0x00000008
	293	#define ATTR_VOL_SPACEAVAIL 0x00000010
91447636 A	294	#define ATTR_VOL_MINALLOCATION 0x00000020
	295	#define ATTR_VOL_ALLOCATIONCLUMP 0x00000040
	296	#define ATTR_VOL_IOBLOCKSIZE 0x00000080
1c79356b A	297	#define ATTR_VOL_OBJCOUNT 0x00000100
	298	#define ATTR_VOL_FILECOUNT 0x00000200
	299	#define ATTR_VOL_DIRCOUNT 0x00000400
91447636	300	#define ATTR_VOL_MAXOBJCOUNT 0x00000800
1c79356b A	301	#define ATTR_VOL_MOUNTPOINT 0x00001000
	302	#define ATTR_VOL_NAME 0x00002000
	303	#define ATTR_VOL_MOUNTFLAGS 0x00004000
91447636 A	304	#define ATTR_VOL_MOUNTEDDEVICE 0x00008000
	305	#define ATTR_VOL_ENCODINGSUSED 0x00010000
	306	#define ATTR_VOL_CAPABILITIES 0x00020000
1c79356b A	307	#define ATTR_VOL_ATTRIBUTES 0x40000000
	308	#define ATTR_VOL_INFO 0x80000000
	309
	310	#define ATTR_VOL_VALIDMASK 0xC003FFFF
	311	#define ATTR_VOL_SETMASK 0x80002000
	312
	313
	314	/* File/directory attributes: */
	315	#define ATTR_DIR_LINKCOUNT 0x00000001
	316	#define ATTR_DIR_ENTRYCOUNT 0x00000002
91447636 A	317	#define ATTR_DIR_MOUNTSTATUS 0x00000004
91447636 A	318	#define DIR_MNTSTATUS_MNTPOINT 0x00000001
1c79356b A	319
	320	#define ATTR_DIR_VALIDMASK 0x00000007
	321	#define ATTR_DIR_SETMASK 0x00000000
	322
	323	#define ATTR_FILE_LINKCOUNT 0x00000001
	324	#define ATTR_FILE_TOTALSIZE 0x00000002
	325	#define ATTR_FILE_ALLOCSIZE 0x00000004
91447636	326	#define ATTR_FILE_IOBLOCKSIZE 0x00000008
1c79356b	327	#define ATTR_FILE_DEVTYPE 0x00000020
1c79356b A	328	#define ATTR_FILE_FORKCOUNT 0x00000080
1c79356b A	329	#define ATTR_FILE_FORKLIST 0x00000100
91447636 A	330	#define ATTR_FILE_DATALENGTH 0x00000200
	331	#define ATTR_FILE_DATAALLOCSIZE 0x00000400
	332	#define ATTR_FILE_RSRCLENGTH 0x00001000
	333	#define ATTR_FILE_RSRCALLOCSIZE 0x00002000
1c79356b A	334
	335	#define ATTR_FILE_VALIDMASK 0x00007FFF
	336	#define ATTR_FILE_SETMASK 0x00000020
	337
	338	#define ATTR_FORK_TOTALSIZE 0x00000001
	339	#define ATTR_FORK_ALLOCSIZE 0x00000002
	340
	341	#define ATTR_FORK_VALIDMASK 0x00000003
	342	#define ATTR_FORK_SETMASK 0x00000000
	343
91447636 A	344	/* Obsolete, implemented, not supported */
	345	#define ATTR_CMN_NAMEDATTRCOUNT 0x00080000 /* not implemented */
	346	#define ATTR_CMN_NAMEDATTRLIST 0x00100000 /* not implemented */
	347	#define ATTR_FILE_CLUMPSIZE 0x00000010 /* obsolete */
	348	#define ATTR_FILE_FILETYPE 0x00000040 /* always zero */
	349	#define ATTR_FILE_DATAEXTENTS 0x00000800 /* obsolete, HFS-specific */
	350	#define ATTR_FILE_RSRCEXTENTS 0x00004000 /* obsolete, HFS-specific */
	351
	352	/*
	353	* Searchfs
	354	*/
	355	#define SRCHFS_START 0x00000001
1c79356b	356	#define SRCHFS_MATCHPARTIALNAMES 0x00000002
91447636 A	357	#define SRCHFS_MATCHDIRS 0x00000004
	358	#define SRCHFS_MATCHFILES 0x00000008
	359	#define SRCHFS_SKIPLINKS 0x00000010
	360	#define SRCHFS_SKIPINVISIBLE 0x00000020
	361	#define SRCHFS_SKIPPACKAGES 0x00000040
	362	#define SRCHFS_SKIPINAPPROPRIATE 0x00000080
55e303ae	363
1c79356b	364	#define SRCHFS_NEGATEPARAMS 0x80000000
55e303ae	365	#define SRCHFS_VALIDOPTIONSMASK 0x800000FF
1c79356b A	366
	367	struct fssearchblock {
	368	struct attrlist *returnattrs;
	369	void *returnbuffer;
	370	size_t returnbuffersize;
	371	u_long maxmatches;
	372	struct timeval timelimit;
	373	void *searchparams1;
	374	size_t sizeofsearchparams1;
	375	void *searchparams2;
	376	size_t sizeofsearchparams2;
	377	struct attrlist searchattrs;
	378	};
	379
91447636 A	380	#ifdef KERNEL
	381	/* LP64 version of fssearchblock. all pointers and longs
	382	* grow when we're dealing with a 64-bit process.
	383	* WARNING - keep in sync with fssearchblock
	384	*/
	385	// LP64todo - should this move?
	386
8f6c56a5 A	387	#if __DARWIN_ALIGN_NATURAL
	388	#pragma options align=natural
	389	#endif
	390
91447636 A	391	struct user_fssearchblock {
	392	user_addr_t returnattrs;
	393	user_addr_t returnbuffer;
	394	user_size_t returnbuffersize;
	395	user_ulong_t maxmatches;
8f6c56a5 A	396	struct timeval timelimit;
8f6c56a5 A	397	user_addr_t searchparams1;
91447636 A	398	user_size_t sizeofsearchparams1;
	399	user_addr_t searchparams2;
	400	user_size_t sizeofsearchparams2;
	401	struct attrlist searchattrs;
	402	};
	403
8f6c56a5 A	404	#if __DARWIN_ALIGN_NATURAL
	405	#pragma options align=reset
	406	#endif
	407
91447636 A	408
	409	#endif // KERNEL
	410
1c79356b A	411
	412	struct searchstate {
	413	u_char reserved[556]; // sizeof( SearchState )
	414	};
	415
	416
1c79356b A	417	#define FST_EOF (-1) /* end-of-file offset */
1c79356b A	418
9bccf70c	419	#endif /* __APPLE_API_UNSTABLE */
1c79356b	420	#endif /* !_SYS_ATTR_H_ */