1/*
2 * Copyright (c) 2000-2014 Apple Inc. All rights reserved.
3 *
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
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
24 * limitations under the License.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 */
28/* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
29/*-
30 * Copyright (c) 1982, 1986, 1989, 1993
31 *	The Regents of the University of California.  All rights reserved.
32 * (c) UNIX System Laboratories, Inc.
33 * All or some portions of this file are derived from material licensed
34 * to the University of California by American Telephone and Telegraph
35 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
36 * the permission of UNIX System Laboratories, Inc.
37 *
38 * Redistribution and use in source and binary forms, with or without
39 * modification, are permitted provided that the following conditions
40 * are met:
41 * 1. Redistributions of source code must retain the above copyright
42 *    notice, this list of conditions and the following disclaimer.
43 * 2. Redistributions in binary form must reproduce the above copyright
44 *    notice, this list of conditions and the following disclaimer in the
45 *    documentation and/or other materials provided with the distribution.
46 * 3. All advertising materials mentioning features or use of this software
47 *    must display the following acknowledgement:
48 *	This product includes software developed by the University of
49 *	California, Berkeley and its contributors.
50 * 4. Neither the name of the University nor the names of its contributors
51 *    may be used to endorse or promote products derived from this software
52 *    without specific prior written permission.
53 *
54 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
55 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
56 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
57 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
58 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
59 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
60 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
61 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
62 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
63 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
64 * SUCH DAMAGE.
65 *
66 *	@(#)stat.h	8.9 (Berkeley) 8/17/94
67 */
68
69
70#ifndef _SYS_STAT_H_
71#define	_SYS_STAT_H_
72
73#include <sys/_types.h>
74#include <sys/cdefs.h>
75#ifdef KERNEL
76#include <machine/types.h>
77#else /* !KERNEL */
78#include <Availability.h>
79#endif /* KERNEL */
80
81/* [XSI] The timespec structure may be defined as described in <time.h> */
82#include <sys/_types/_timespec.h>
83#ifdef KERNEL
84#include <sys/_types/_user64_timespec.h>
85#include <sys/_types/_user32_timespec.h>
86#endif /* KERNEL */
87
88/*
89 * [XSI] The blkcnt_t, blksize_t, dev_t, ino_t, mode_t, nlink_t, uid_t,
90 * gid_t, off_t, and time_t types shall be defined as described in
91 * <sys/types.h>.
92 */
93#include <sys/_types/_blkcnt_t.h>
94#include <sys/_types/_blksize_t.h>
95#include <sys/_types/_dev_t.h>			/* device number */
96#include <sys/_types/_ino_t.h>
97
98#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
99#include <sys/_types/_ino64_t.h>
100#endif /* !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE) */
101
102#include <sys/_types/_mode_t.h>
103#include <sys/_types/_nlink_t.h>
104#include <sys/_types/_uid_t.h>
105#include <sys/_types/_gid_t.h>
106#include <sys/_types/_off_t.h>
107#include <sys/_types/_time_t.h>
108
109#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
110/*
111 * XXX So deprecated, it would make your head spin
112 *
113 * The old stat structure.  In fact, this is not used by the kernel at all,
114 * and should not be used by user space, and should be removed from this
115 * header file entirely (along with the unused cvtstat() prototype in
116 * vnode_internal.h).
117 */
118struct ostat {
119	__uint16_t	st_dev;		/* inode's device */
120	ino_t		st_ino;		/* inode's number */
121	mode_t		st_mode;	/* inode protection mode */
122	nlink_t		st_nlink;	/* number of hard links */
123	__uint16_t	st_uid;		/* user ID of the file's owner */
124	__uint16_t	st_gid;		/* group ID of the file's group */
125	__uint16_t	st_rdev;	/* device type */
126	__int32_t	st_size;	/* file size, in bytes */
127	struct	timespec st_atimespec;	/* time of last access */
128	struct	timespec st_mtimespec;	/* time of last data modification */
129	struct	timespec st_ctimespec;	/* time of last file status change */
130	__int32_t	st_blksize;	/* optimal blocksize for I/O */
131	__int32_t	st_blocks;	/* blocks allocated for file */
132	__uint32_t	st_flags;	/* user defined flags for file */
133	__uint32_t	st_gen;		/* file generation number */
134};
135
136#define __DARWIN_STRUCT_STAT64_TIMES \
137	struct timespec st_atimespec;		/* time of last access */ \
138	struct timespec st_mtimespec;		/* time of last data modification */ \
139	struct timespec st_ctimespec;		/* time of last status change */ \
140	struct timespec st_birthtimespec;	/* time of file creation(birth) */
141
142#else /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
143
144#define __DARWIN_STRUCT_STAT64_TIMES \
145	time_t		st_atime;		/* [XSI] Time of last access */ \
146	long		st_atimensec;		/* nsec of last access */ \
147	time_t		st_mtime;		/* [XSI] Last data modification time */ \
148	long		st_mtimensec;		/* last data modification nsec */ \
149	time_t		st_ctime;		/* [XSI] Time of last status change */ \
150	long		st_ctimensec;		/* nsec of last status change */ \
151	time_t		st_birthtime;		/*  File creation time(birth)  */ \
152	long		st_birthtimensec;	/* nsec of File creation time */
153
154#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
155
156/*
157 * This structure is used as the second parameter to the fstat64(),
158 * lstat64(), and stat64() functions, and for struct stat when
159 * __DARWIN_64_BIT_INO_T is set. __DARWIN_STRUCT_STAT64 is defined
160 * above, depending on whether we use struct timespec or the direct
161 * components.
162 *
163 * This is simillar to stat except for 64bit inode number
164 * number instead of 32bit ino_t and the addition of create(birth) time.
165 */
166#define __DARWIN_STRUCT_STAT64 { \
167	dev_t		st_dev;			/* [XSI] ID of device containing file */ \
168	mode_t		st_mode;		/* [XSI] Mode of file (see below) */ \
169	nlink_t		st_nlink;		/* [XSI] Number of hard links */ \
170	__darwin_ino64_t st_ino;		/* [XSI] File serial number */ \
171	uid_t		st_uid;			/* [XSI] User ID of the file */ \
172	gid_t		st_gid;			/* [XSI] Group ID of the file */ \
173	dev_t		st_rdev;		/* [XSI] Device ID */ \
174	__DARWIN_STRUCT_STAT64_TIMES \
175	off_t		st_size;		/* [XSI] file size, in bytes */ \
176	blkcnt_t	st_blocks;		/* [XSI] blocks allocated for file */ \
177	blksize_t	st_blksize;		/* [XSI] optimal blocksize for I/O */ \
178	__uint32_t	st_flags;		/* user defined flags for file */ \
179	__uint32_t	st_gen;			/* file generation number */ \
180	__int32_t	st_lspare;		/* RESERVED: DO NOT USE! */ \
181	__int64_t	st_qspare[2];		/* RESERVED: DO NOT USE! */ \
182}
183
184/*
185 * [XSI] This structure is used as the second parameter to the fstat(),
186 * lstat(), and stat() functions.
187 */
188#if __DARWIN_64_BIT_INO_T
189
190struct stat __DARWIN_STRUCT_STAT64;
191
192#else /* !__DARWIN_64_BIT_INO_T */
193
194struct stat {
195	dev_t	 	st_dev;		/* [XSI] ID of device containing file */
196	ino_t	  	st_ino;		/* [XSI] File serial number */
197	mode_t	 	st_mode;	/* [XSI] Mode of file (see below) */
198	nlink_t		st_nlink;	/* [XSI] Number of hard links */
199	uid_t		st_uid;		/* [XSI] User ID of the file */
200	gid_t		st_gid;		/* [XSI] Group ID of the file */
201	dev_t		st_rdev;	/* [XSI] Device ID */
202#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
203	struct	timespec st_atimespec;	/* time of last access */
204	struct	timespec st_mtimespec;	/* time of last data modification */
205	struct	timespec st_ctimespec;	/* time of last status change */
206#else
207	time_t		st_atime;	/* [XSI] Time of last access */
208	long		st_atimensec;	/* nsec of last access */
209	time_t		st_mtime;	/* [XSI] Last data modification time */
210	long		st_mtimensec;	/* last data modification nsec */
211	time_t		st_ctime;	/* [XSI] Time of last status change */
212	long		st_ctimensec;	/* nsec of last status change */
213#endif
214	off_t		st_size;	/* [XSI] file size, in bytes */
215	blkcnt_t	st_blocks;	/* [XSI] blocks allocated for file */
216	blksize_t	st_blksize;	/* [XSI] optimal blocksize for I/O */
217	__uint32_t	st_flags;	/* user defined flags for file */
218	__uint32_t	st_gen;		/* file generation number */
219	__int32_t	st_lspare;	/* RESERVED: DO NOT USE! */
220	__int64_t	st_qspare[2];	/* RESERVED: DO NOT USE! */
221};
222
223#endif /* __DARWIN_64_BIT_INO_T */
224
225#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
226
227#if !__DARWIN_ONLY_64_BIT_INO_T
228
229struct stat64 __DARWIN_STRUCT_STAT64;
230
231#endif /* !__DARWIN_ONLY_64_BIT_INO_T */
232
233#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
234
235
236#ifdef KERNEL
237#ifdef BSD_KERNEL_PRIVATE
238/* LP64 version of struct stat.  time_t (see timespec) is a long and must
239 * grow when we're dealing with a 64-bit process.
240 * WARNING - keep in sync with struct stat
241 */
242
243struct user64_stat {
244	dev_t	 	st_dev;		/* [XSI] ID of device containing file */
245	ino_t	  	st_ino;		/* [XSI] File serial number */
246	mode_t	 	st_mode;	/* [XSI] Mode of file (see below) */
247	nlink_t		st_nlink;	/* [XSI] Number of hard links */
248	uid_t		st_uid;		/* [XSI] User ID of the file */
249	gid_t		st_gid;		/* [XSI] Group ID of the file */
250	dev_t		st_rdev;	/* [XSI] Device ID */
251#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
252	struct	user64_timespec st_atimespec; /* time of last access */
253	struct	user64_timespec st_mtimespec; /* time of last data modification */
254	struct	user64_timespec st_ctimespec; /* time of last status change */
255#else
256	user64_time_t	st_atime;	/* [XSI] Time of last access */
257	user64_long_t	st_atimensec;	/* nsec of last access */
258	user64_time_t	st_mtime;	/* [XSI] Last data modification */
259	user64_long_t	st_mtimensec;	/* last data modification nsec */
260	user64_time_t	st_ctime;	/* [XSI] Time of last status change */
261	user64_long_t	st_ctimensec;	/* nsec of last status change */
262#endif
263	off_t		st_size;	/* [XSI] File size, in bytes */
264	blkcnt_t	st_blocks;	/* [XSI] Blocks allocated for file */
265	blksize_t	st_blksize;	/* [XSI] Optimal blocksize for I/O */
266	__uint32_t	st_flags;	/* user defined flags for file */
267	__uint32_t	st_gen;		/* file generation number */
268	__int32_t	st_lspare;	/* RESERVED: DO NOT USE! */
269	__int64_t	st_qspare[2];	/* RESERVED: DO NOT USE! */
270};
271
272/* ILP32 version of struct stat.
273 * WARNING - keep in sync with struct stat
274 */
275
276struct user32_stat {
277	dev_t	 	st_dev;		/* [XSI] ID of device containing file */
278	ino_t	  	st_ino;		/* [XSI] File serial number */
279	mode_t	 	st_mode;	/* [XSI] Mode of file (see below) */
280	nlink_t		st_nlink;	/* [XSI] Number of hard links */
281	uid_t		st_uid;		/* [XSI] User ID of the file */
282	gid_t		st_gid;		/* [XSI] Group ID of the file */
283	dev_t		st_rdev;	/* [XSI] Device ID */
284#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
285	struct	user32_timespec st_atimespec; /* time of last access */
286	struct	user32_timespec st_mtimespec; /* time of last data modification */
287	struct	user32_timespec st_ctimespec; /* time of last status change */
288#else
289	user32_time_t	st_atime;	/* [XSI] Time of last access */
290	user32_long_t	st_atimensec;	/* nsec of last access */
291	user32_time_t	st_mtime;	/* [XSI] Last data modification */
292	user32_long_t	st_mtimensec;	/* last data modification nsec */
293	user32_time_t	st_ctime;	/* [XSI] Time of last status change */
294	user32_long_t	st_ctimensec;	/* nsec of last status change */
295#endif
296	off_t		st_size;	/* [XSI] File size, in bytes */
297	blkcnt_t	st_blocks;	/* [XSI] Blocks allocated for file */
298	blksize_t	st_blksize;	/* [XSI] Optimal blocksize for I/O */
299	__uint32_t	st_flags;	/* user defined flags for file */
300	__uint32_t	st_gen;		/* file generation number */
301	__int32_t	st_lspare;	/* RESERVED: DO NOT USE! */
302	__int64_t	st_qspare[2];	/* RESERVED: DO NOT USE! */
303};
304
305extern void munge_user64_stat(struct stat *sbp, struct user64_stat *usbp);
306extern void munge_user32_stat(struct stat *sbp, struct user32_stat *usbp);
307
308
309struct user64_stat64 {
310	dev_t		st_dev;					/* [XSI] ID of device containing file */
311	mode_t		st_mode;				/* [XSI] Mode of file (see below) */
312	nlink_t		st_nlink;				/* [XSI] Number of hard links */
313	ino64_t		st_ino;					/* [XSI] File serial number */
314	uid_t		st_uid;					/* [XSI] User ID of the file */
315	gid_t		st_gid;					/* [XSI] Group ID of the file */
316	dev_t		st_rdev;				/* [XSI] Device ID */
317#ifndef _POSIX_C_SOURCE
318	struct user64_timespec st_atimespec;		/* time of last access */
319	struct user64_timespec st_mtimespec;		/* time of last data modification */
320	struct user64_timespec st_ctimespec;		/* time of last status change */
321	struct user64_timespec st_birthtimespec;	/* time of file creation(birth) */
322#else
323	user64_time_t	st_atime;				/* [XSI] Time of last access */
324	user64_long_t	st_atimensec;			/* nsec of last access */
325	user64_time_t	st_mtime;				/* [XSI] Last data modification time */
326	user64_long_t	st_mtimensec;			/* last data modification nsec */
327	user64_time_t	st_ctime;				/* [XSI] Time of last status change */
328	user64_long_t	st_ctimensec;			/* nsec of last status change */
329	user64_time_t	st_birthtime;			/*  File creation time(birth)  */
330	user64_long_t	st_birthtimensec;		/* nsec of File creation time */
331#endif
332	off_t		st_size;				/* [XSI] file size, in bytes */
333	blkcnt_t	st_blocks;				/* [XSI] blocks allocated for file */
334	blksize_t	st_blksize;				/* [XSI] optimal blocksize for I/O */
335	__uint32_t	st_flags;				/* user defined flags for file */
336	__uint32_t	st_gen;					/* file generation number */
337	__uint32_t	st_lspare;				/* RESERVED: DO NOT USE! */
338	__int64_t	st_qspare[2];			/* RESERVED: DO NOT USE! */
339};
340
341struct user32_stat64 {
342	dev_t		st_dev;					/* [XSI] ID of device containing file */
343	mode_t		st_mode;				/* [XSI] Mode of file (see below) */
344	nlink_t		st_nlink;				/* [XSI] Number of hard links */
345	ino64_t		st_ino;					/* [XSI] File serial number */
346	uid_t		st_uid;					/* [XSI] User ID of the file */
347	gid_t		st_gid;					/* [XSI] Group ID of the file */
348	dev_t		st_rdev;				/* [XSI] Device ID */
349#ifndef _POSIX_C_SOURCE
350	struct user32_timespec st_atimespec;		/* time of last access */
351	struct user32_timespec st_mtimespec;		/* time of last data modification */
352	struct user32_timespec st_ctimespec;		/* time of last status change */
353	struct user32_timespec st_birthtimespec;	/* time of file creation(birth) */
354#else
355	user32_time_t	st_atime;				/* [XSI] Time of last access */
356	user32_long_t	st_atimensec;			/* nsec of last access */
357	user32_time_t	st_mtime;				/* [XSI] Last data modification time */
358	user32_long_t	st_mtimensec;			/* last data modification nsec */
359	user32_time_t	st_ctime;				/* [XSI] Time of last status change */
360	user32_long_t	st_ctimensec;			/* nsec of last status change */
361	user32_time_t	st_birthtime;			/*  File creation time(birth)  */
362	user32_long_t	st_birthtimensec;		/* nsec of File creation time */
363#endif
364	off_t		st_size;				/* [XSI] file size, in bytes */
365	blkcnt_t	st_blocks;				/* [XSI] blocks allocated for file */
366	blksize_t	st_blksize;				/* [XSI] optimal blocksize for I/O */
367	__uint32_t	st_flags;				/* user defined flags for file */
368	__uint32_t	st_gen;					/* file generation number */
369	__uint32_t	st_lspare;				/* RESERVED: DO NOT USE! */
370	__int64_t	st_qspare[2];			/* RESERVED: DO NOT USE! */
371} __attribute__((packed,aligned(4)));
372
373extern void munge_user64_stat64(struct stat64 *sbp, struct user64_stat64 *usbp);
374extern void munge_user32_stat64(struct stat64 *sbp, struct user32_stat64 *usbp);
375
376#endif /* BSD_KERNEL_PRIVATE */
377
378#endif /* KERNEL */
379
380
381#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
382#define st_atime st_atimespec.tv_sec
383#define st_mtime st_mtimespec.tv_sec
384#define st_ctime st_ctimespec.tv_sec
385#define st_birthtime st_birthtimespec.tv_sec
386#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
387
388/*
389 * [XSI] The following are symbolic names for the values of type mode_t.  They
390 * are bitmap values.
391 */
392#include <sys/_types/_s_ifmt.h>
393
394/*
395 * [XSI] The following macros shall be provided to test whether a file is
396 * of the specified type.  The value m supplied to the macros is the value
397 * of st_mode from a stat structure.  The macro shall evaluate to a non-zero
398 * value if the test is true; 0 if the test is false.
399 */
400#define	S_ISBLK(m)	(((m) & S_IFMT) == S_IFBLK)	/* block special */
401#define	S_ISCHR(m)	(((m) & S_IFMT) == S_IFCHR)	/* char special */
402#define	S_ISDIR(m)	(((m) & S_IFMT) == S_IFDIR)	/* directory */
403#define	S_ISFIFO(m)	(((m) & S_IFMT) == S_IFIFO)	/* fifo or socket */
404#define	S_ISREG(m)	(((m) & S_IFMT) == S_IFREG)	/* regular file */
405#define	S_ISLNK(m)	(((m) & S_IFMT) == S_IFLNK)	/* symbolic link */
406#define	S_ISSOCK(m)	(((m) & S_IFMT) == S_IFSOCK)	/* socket */
407#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
408#define	S_ISWHT(m)	(((m) & S_IFMT) == S_IFWHT)	/* OBSOLETE: whiteout */
409#endif
410
411/*
412 * [XSI] The implementation may implement message queues, semaphores, or
413 * shared memory objects as distinct file types.  The following macros
414 * shall be provided to test whether a file is of the specified type.
415 * The value of the buf argument supplied to the macros is a pointer to
416 * a stat structure.  The macro shall evaluate to a non-zero value if
417 * the specified object is implemented as a distinct file type and the
418 * specified file type is contained in the stat structure referenced by
419 * buf.  Otherwise, the macro shall evaluate to zero.
420 *
421 * NOTE:	The current implementation does not do this, although
422 *		this may change in future revisions, and co currently only
423 *		provides these macros to ensure source compatability with
424 *		implementations which do.
425 */
426#define	S_TYPEISMQ(buf)		(0)	/* Test for a message queue */
427#define	S_TYPEISSEM(buf)	(0)	/* Test for a semaphore */
428#define	S_TYPEISSHM(buf)	(0)	/* Test for a shared memory object */
429
430/*
431 * [TYM] The implementation may implement typed memory objects as distinct
432 * file types, and the following macro shall test whether a file is of the
433 * specified type.  The value of the buf argument supplied to the macros is
434 * a pointer to a stat structure.  The macro shall evaluate to a non-zero
435 * value if the specified object is implemented as a distinct file type and
436 * the specified file type is contained in the stat structure referenced by
437 * buf.  Otherwise, the macro shall evaluate to zero.
438 *
439 * NOTE:	The current implementation does not do this, although
440 *		this may change in future revisions, and co currently only
441 *		provides this macro to ensure source compatability with
442 *		implementations which do.
443 */
444#define	S_TYPEISTMO(buf)	(0)	/* Test for a typed memory object */
445
446
447#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
448#define	ACCESSPERMS	(S_IRWXU|S_IRWXG|S_IRWXO)	/* 0777 */
449							/* 7777 */
450#define	ALLPERMS	(S_ISUID|S_ISGID|S_ISTXT|S_IRWXU|S_IRWXG|S_IRWXO)
451							/* 0666 */
452#define	DEFFILEMODE	(S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH)
453
454#define S_BLKSIZE	512		/* block size used in the stat struct */
455
456/*
457 * Definitions of flags stored in file flags word.
458 *
459 * Super-user and owner changeable flags.
460 */
461#define	UF_SETTABLE	0x0000ffff	/* mask of owner changeable flags */
462#define	UF_NODUMP	0x00000001	/* do not dump file */
463#define	UF_IMMUTABLE	0x00000002	/* file may not be changed */
464#define	UF_APPEND	0x00000004	/* writes to file may only append */
465#define UF_OPAQUE	0x00000008	/* directory is opaque wrt. union */
466/*
467 * The following bit is reserved for FreeBSD.  It is not implemented
468 * in Mac OS X.
469 */
470/* #define UF_NOUNLINK	0x00000010 */	/* file may not be removed or renamed */
471#define UF_COMPRESSED	0x00000020	/* file is hfs-compressed */
472
473/* UF_TRACKED is used for dealing with document IDs.  We no longer issue
474   notifications for deletes or renames for files which have UF_TRACKED set. */
475#define UF_TRACKED		0x00000040
476
477/* Bits 0x0080 through 0x4000 are currently undefined. */
478#define UF_HIDDEN	0x00008000	/* hint that this item should not be */
479					/* displayed in a GUI */
480/*
481 * Super-user changeable flags.
482 */
483#define	SF_SETTABLE	0xffff0000	/* mask of superuser changeable flags */
484#define	SF_ARCHIVED	0x00010000	/* file is archived */
485#define	SF_IMMUTABLE	0x00020000	/* file may not be changed */
486#define	SF_APPEND	0x00040000	/* writes to file may only append */
487#define SF_RESTRICTED	0x00080000	/* restricted access */
488
489/*
490 * The following two bits are reserved for FreeBSD.  They are not
491 * implemented in Mac OS X.
492 */
493/* #define SF_NOUNLINK	0x00100000 */	/* file may not be removed or renamed */
494/* #define SF_SNAPSHOT	0x00200000 */	/* snapshot inode */
495/* NOTE: There is no SF_HIDDEN bit. */
496
497#ifdef KERNEL
498/*
499 * Shorthand abbreviations of above.
500 */
501#define	OPAQUE		(UF_OPAQUE)
502#define	APPEND		(UF_APPEND | SF_APPEND)
503#define	IMMUTABLE	(UF_IMMUTABLE | SF_IMMUTABLE)
504#endif
505#endif
506
507#ifndef KERNEL
508
509__BEGIN_DECLS
510/* [XSI] */
511int	chmod(const char *, mode_t) __DARWIN_ALIAS(chmod);
512int	fchmod(int, mode_t) __DARWIN_ALIAS(fchmod);
513int	fstat(int, struct stat *) __DARWIN_INODE64(fstat);
514int	lstat(const char *, struct stat *) __DARWIN_INODE64(lstat);
515int	mkdir(const char *, mode_t);
516int	mkfifo(const char *, mode_t);
517int	stat(const char *, struct stat *) __DARWIN_INODE64(stat);
518int	mknod(const char *, mode_t, dev_t);
519mode_t	umask(mode_t);
520
521#if __DARWIN_C_LEVEL >= 200809L
522int	fchmodat(int, const char *, mode_t, int) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
523int	fstatat(int, const char *, struct stat *, int) __DARWIN_INODE64(fstatat) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
524int	mkdirat(int, const char *, mode_t) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
525#endif
526
527#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
528
529#include <sys/_types/_filesec_t.h>
530
531int	chflags(const char *, __uint32_t);
532int	chmodx_np(const char *, filesec_t);
533int	fchflags(int, __uint32_t);
534int	fchmodx_np(int, filesec_t);
535int	fstatx_np(int, struct stat *, filesec_t) __DARWIN_INODE64(fstatx_np);
536int	lchflags(const char *, __uint32_t) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
537int	lchmod(const char *, mode_t) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
538int	lstatx_np(const char *, struct stat *, filesec_t) __DARWIN_INODE64(lstatx_np);
539int	mkdirx_np(const char *, filesec_t);
540int	mkfifox_np(const char *, filesec_t);
541int	statx_np(const char *, struct stat *, filesec_t) __DARWIN_INODE64(statx_np);
542int	umaskx_np(filesec_t) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
543
544#if !__DARWIN_ONLY_64_BIT_INO_T
545/* The following deprecated routines are simillar to stat and friends except provide struct stat64 instead of struct stat  */
546int	fstatx64_np(int, struct stat64 *, filesec_t) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
547int	lstatx64_np(const char *, struct stat64 *, filesec_t) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
548int	statx64_np(const char *, struct stat64 *, filesec_t) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
549int	fstat64(int, struct stat64 *) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
550int	lstat64(const char *, struct stat64 *) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
551int	stat64(const char *, struct stat64 *) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5,__MAC_10_6,__IPHONE_NA,__IPHONE_NA);
552#endif /* !__DARWIN_ONLY_64_BIT_INO_T */
553#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
554
555__END_DECLS
556#endif /* !KERNEL */
557#endif /* !_SYS_STAT_H_ */
558