2 * Copyright (c) 2000-2013 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
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.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
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.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1983, 1990, 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.
38 * Redistribution and use in source and binary forms, with or without
39 * modification, are permitted provided that the following conditions
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.
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
66 * @(#)fcntl.h 8.3 (Berkeley) 1/21/94
74 * This file includes the definitions for open and fcntl
75 * described by POSIX for <fcntl.h>; it also includes
76 * related kernel definitions.
78 #include <sys/_types.h>
79 #include <sys/cdefs.h>
81 #include <Availability.h>
84 /* We should not be exporting size_t here. Temporary for gcc bootstrapping. */
85 #include <sys/_types/_size_t.h>
86 #include <sys/_types/_mode_t.h>
87 #include <sys/_types/_off_t.h>
88 #include <sys/_types/_pid_t.h>
91 * File status flags: these are used by open(2), fcntl(2).
92 * They are also used (indirectly) in the kernel file structure f_flags,
93 * which is a superset of the open/fcntl flags. Open flags and f_flags
94 * are inter-convertible using OFLAGS(fflags) and FFLAGS(oflags).
95 * Open/fcntl flags begin with O_; kernel-internal flags begin with F.
98 #define O_RDONLY 0x0000 /* open for reading only */
99 #define O_WRONLY 0x0001 /* open for writing only */
100 #define O_RDWR 0x0002 /* open for reading and writing */
101 #define O_ACCMODE 0x0003 /* mask for above modes */
104 * Kernel encoding of open mode; separate read and write bits that are
105 * independently testable: 1 greater than the above.
108 * FREAD and FWRITE are excluded from the #ifdef KERNEL so that TIOCFLUSH,
109 * which was documented to use FREAD/FWRITE, continues to work.
111 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
113 #define FWRITE 0x0002
115 #define O_NONBLOCK 0x0004 /* no delay */
116 #define O_APPEND 0x0008 /* set append mode */
118 #include <sys/_types/_o_sync.h>
120 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
121 #define O_SHLOCK 0x0010 /* open with shared file lock */
122 #define O_EXLOCK 0x0020 /* open with exclusive file lock */
123 #define O_ASYNC 0x0040 /* signal pgrp when data ready */
124 #define O_FSYNC O_SYNC /* source compatibility: do not use */
125 #define O_NOFOLLOW 0x0100 /* don't follow symlinks */
126 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
127 #define O_CREAT 0x0200 /* create if nonexistant */
128 #define O_TRUNC 0x0400 /* truncate to zero length */
129 #define O_EXCL 0x0800 /* error if already exists */
131 #define FMARK 0x1000 /* mark during gc() */
132 #define FDEFER 0x2000 /* defer for next gc pass */
133 #define FHASLOCK 0x4000 /* descriptor holds advisory lock */
136 #if __DARWIN_C_LEVEL >= 200809L
138 * Descriptor value for the current working directory
143 * Flags for the at functions
145 #define AT_EACCESS 0x0010 /* Use effective ids in access check */
146 #define AT_SYMLINK_NOFOLLOW 0x0020 /* Act on the symlink itself not the target */
147 #define AT_SYMLINK_FOLLOW 0x0040 /* Act on target of symlink */
148 #define AT_REMOVEDIR 0x0080 /* Path refers to directory */
149 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
151 #define AT_REMOVEDIR_DATALESS 0x0100 /* Remove a dataless directory without materializing first */
153 #define AT_REALDEV 0x0200 /* Return real device inodes resides on for fstatat(2) */
154 #define AT_FDONLY 0x0400 /* Use only the fd and Ignore the path for fstatat(2) */
158 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
159 #define O_EVTONLY 0x8000 /* descriptor requested for event notifications only */
163 #define FWASWRITTEN 0x10000 /* descriptor was written */
166 #define O_NOCTTY 0x20000 /* don't assign controlling terminal */
169 #define FNOCACHE 0x40000 /* fcntl(F_NOCACHE, 1) */
170 #define FNORDAHEAD 0x80000 /* fcntl(F_RDAHEAD, 0) */
173 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
174 #define O_DIRECTORY 0x100000
175 #define O_SYMLINK 0x200000 /* allow open of a symlink */
178 #include <sys/_types/_o_dsync.h>
181 #define FNODIRECT 0x800000 /* fcntl(F_NODIRECT, 1) */
184 #if __DARWIN_C_LEVEL >= 200809L
185 #define O_CLOEXEC 0x1000000 /* implicitly set FD_CLOEXEC */
189 #define FENCRYPTED 0x2000000
193 #define FSINGLE_WRITER 0x4000000 /* fcntl(F_SINGLE_WRITER, 1) */
197 #define O_CLOFORK 0x8000000 /* implicitly set FD_CLOFORK */
201 #define FUNENCRYPTED 0x10000000
204 /* Data Protection Flags */
205 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
206 #define O_DP_GETRAWENCRYPTED 0x0001
207 #define O_DP_GETRAWUNENCRYPTED 0x0002
212 /* convert from open() flags to/from fflags; convert O_RD/WR to FREAD/FWRITE */
213 #define FFLAGS(oflags) ((oflags) + 1)
214 #define OFLAGS(fflags) ((fflags) - 1)
216 /* bits to save after open */
217 #define FMASK (FREAD|FWRITE|FAPPEND|FASYNC|FFSYNC|FFDSYNC|FNONBLOCK)
218 /* bits settable by fcntl(F_SETFL, ...) */
219 #define FCNTLFLAGS (FAPPEND|FASYNC|FFSYNC|FFDSYNC|FNONBLOCK)
223 * The O_* flags used to have only F* names, which were used in the kernel
224 * and by fcntl. We retain the F* names for the kernel f_flags field
225 * and for backward compatibility for fcntl.
227 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
228 #define FAPPEND O_APPEND /* kernel/compat */
229 #define FASYNC O_ASYNC /* kernel/compat */
230 #define FFSYNC O_FSYNC /* kernel */
231 #define FFDSYNC O_DSYNC /* kernel */
232 #define FNONBLOCK O_NONBLOCK /* kernel */
233 #define FNDELAY O_NONBLOCK /* compat */
234 #define O_NDELAY O_NONBLOCK /* compat */
238 * Flags used for copyfile(2)
241 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
242 #define CPF_OVERWRITE 0x0001
243 #define CPF_IGNORE_MODE 0x0002
244 #define CPF_MASK (CPF_OVERWRITE|CPF_IGNORE_MODE)
248 * Constants used for fcntl(2)
252 #define F_DUPFD 0 /* duplicate file descriptor */
253 #define F_GETFD 1 /* get file descriptor flags */
254 #define F_SETFD 2 /* set file descriptor flags */
255 #define F_GETFL 3 /* get file status flags */
256 #define F_SETFL 4 /* set file status flags */
257 #define F_GETOWN 5 /* get SIGIO/SIGURG proc/pgrp */
258 #define F_SETOWN 6 /* set SIGIO/SIGURG proc/pgrp */
259 #define F_GETLK 7 /* get record locking information */
260 #define F_SETLK 8 /* set record locking information */
261 #define F_SETLKW 9 /* F_SETLK; wait if blocked */
262 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
263 #define F_SETLKWTIMEOUT 10 /* F_SETLK; wait if blocked, return on timeout */
264 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
265 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
266 #define F_FLUSH_DATA 40
267 #define F_CHKCLEAN 41 /* Used for regression test */
268 #define F_PREALLOCATE 42 /* Preallocate storage */
269 #define F_SETSIZE 43 /* Truncate a file without zeroing space */
270 #define F_RDADVISE 44 /* Issue an advisory read async with no copy to user */
271 #define F_RDAHEAD 45 /* turn read ahead off/on for this fd */
273 * 46,47 used to be F_READBOOTSTRAP and F_WRITEBOOTSTRAP
275 #define F_NOCACHE 48 /* turn data caching off/on for this fd */
276 #define F_LOG2PHYS 49 /* file offset to device offset */
277 #define F_GETPATH 50 /* return the full path of the fd */
278 #define F_FULLFSYNC 51 /* fsync + ask the drive to flush to the media */
279 #define F_PATHPKG_CHECK 52 /* find which component (if any) is a package */
280 #define F_FREEZE_FS 53 /* "freeze" all fs operations */
281 #define F_THAW_FS 54 /* "thaw" all fs operations */
282 #define F_GLOBAL_NOCACHE 55 /* turn data caching off/on (globally) for this file */
285 #define F_OPENFROM 56 /* SPI: open a file relative to fd (must be a dir) */
286 #define F_UNLINKFROM 57 /* SPI: open a file relative to fd (must be a dir) */
287 #define F_CHECK_OPENEVT 58 /* SPI: if a process is marked OPENEVT, or in O_EVTONLY on opens of this vnode */
290 #define F_ADDSIGS 59 /* add detached signatures */
293 /* Deprecated/Removed in 10.9 */
294 #define F_MARKDEPENDENCY 60 /* this process hosts the device supporting the fs backing this fd */
297 #define F_ADDFILESIGS 61 /* add signature from same file (used by dyld for shared libs) */
299 #define F_NODIRECT 62 /* used in conjunction with F_NOCACHE to indicate that DIRECT, synchonous writes */
300 /* should not be used (i.e. its ok to temporaily create cached pages) */
302 #define F_GETPROTECTIONCLASS 63 /* Get the protection class of a file from the EA, returns int */
303 #define F_SETPROTECTIONCLASS 64 /* Set the protection class of a file for the EA, requires int */
305 #define F_LOG2PHYS_EXT 65 /* file offset to device offset, extended */
307 #define F_GETLKPID 66 /* get record locking information, per-process */
309 /* See F_DUPFD_CLOEXEC below for 67 */
312 #define F_SETSTATICCONTENT 68 /*
313 * indicate to the filesystem/storage driver that the content to be
314 * written is usually static. a nonzero value enables it, 0 disables it.
316 #define F_MOVEDATAEXTENTS 69 /* Swap only the data associated with two files */
319 #define F_SETBACKINGSTORE 70 /* Mark the file as being the backing store for another filesystem */
320 #define F_GETPATH_MTMINFO 71 /* return the full path of the FD, but error in specific mtmd circumstances */
322 #define F_GETCODEDIR 72 /* Returns the code directory, with associated hashes, to the caller */
324 #define F_SETNOSIGPIPE 73 /* No SIGPIPE generated on EPIPE */
325 #define F_GETNOSIGPIPE 74 /* Status of SIGPIPE for this fd */
327 #define F_TRANSCODEKEY 75 /* For some cases, we need to rewrap the key for AKS/MKB */
329 #define F_SINGLE_WRITER 76 /* file being written to a by single writer... if throttling enabled, writes */
330 /* may be broken into smaller chunks with throttling in between */
332 #define F_GETPROTECTIONLEVEL 77 /* Get the protection version number for this filesystem */
334 #define F_FINDSIGS 78 /* Add detached code signatures (used by dyld for shared libs) */
337 #define F_GETDEFAULTPROTLEVEL 79 /* Get the default protection level for the filesystem */
338 #define F_MAKECOMPRESSED 80 /* Make the file compressed; truncate & toggle BSD bits */
339 #define F_SET_GREEDY_MODE 81 /*
340 * indicate to the filesystem/storage driver that the content to be
341 * written should be written in greedy mode for additional speed at
342 * the cost of storage efficiency. A nonzero value enables it, 0 disables it.
345 #define F_SETIOTYPE 82 /*
346 * Use parameters to describe content being written to the FD. See
347 * flag definitions below for argument bits.
351 #define F_ADDFILESIGS_FOR_DYLD_SIM 83 /* Add signature from same file, only if it is signed by Apple (used by dyld for simulator) */
354 #define F_RECYCLE 84 /* Recycle vnode; debug/development builds only */
357 #define F_BARRIERFSYNC 85 /* fsync + issue barrier to drive */
360 #define F_OFD_SETLK 90 /* Acquire or release open file description lock */
361 #define F_OFD_SETLKW 91 /* (as F_OFD_SETLK but blocking if conflicting lock) */
362 #define F_OFD_GETLK 92 /* Examine OFD lock */
364 #define F_OFD_SETLKWTIMEOUT 93 /* (as F_OFD_SETLKW but return if timeout) */
365 #define F_OFD_GETLKPID 94 /* get record locking information */
367 #define F_SETCONFINED 95 /* "confine" OFD to process */
368 #define F_GETCONFINED 96 /* is-fd-confined? */
371 #define F_ADDFILESIGS_RETURN 97 /* Add signature from same file, return end offset in structure on success */
372 #define F_CHECK_LV 98 /* Check if Library Validation allows this Mach-O file to be mapped into the calling process */
374 #define F_PUNCHHOLE 99 /* Deallocate a range of the file */
376 #define F_TRIM_ACTIVE_FILE 100 /* Trim an active file */
378 #define F_SPECULATIVE_READ 101 /* Synchronous advisory read fcntl for regular and compressed file */
380 #define F_GETPATH_NOFIRMLINK 102 /* return the full path without firmlinks of the fd */
382 // FS-specific fcntl()'s numbers begin at 0x00010000 and go up
383 #define FCNTL_FS_SPECIFIC_BASE 0x00010000
385 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
387 #if __DARWIN_C_LEVEL >= 200809L
388 #define F_DUPFD_CLOEXEC 67 /* mark the dup with FD_CLOEXEC */
391 /* file descriptor flags (F_GETFD, F_SETFD) */
392 #define FD_CLOEXEC 1 /* close-on-exec flag */
394 #define FD_CLOFORK 2 /* close-on-fork flag */
397 /* record locking flags (F_GETLK, F_SETLK, F_SETLKW) */
398 #define F_RDLCK 1 /* shared or read lock */
399 #define F_UNLCK 2 /* unlock */
400 #define F_WRLCK 3 /* exclusive or write lock */
402 #define F_WAIT 0x010 /* Wait until lock is granted */
403 #define F_FLOCK 0x020 /* Use flock(2) semantics for lock */
404 #define F_POSIX 0x040 /* Use POSIX semantics for lock */
405 #define F_PROV 0x080 /* Non-coalesced provisional lock */
406 #define F_WAKE1_SAFE 0x100 /* its safe to only wake one waiter */
407 #define F_ABORT 0x200 /* lock attempt aborted (force umount) */
408 #define F_OFD_LOCK 0x400 /* Use "OFD" semantics for lock */
413 * ISOCHRONOUS attempts to sustain a minimum platform-dependent throughput
414 * for the duration of the I/O delivered to the driver.
416 #define F_IOTYPE_ISOCHRONOUS 0x0001
420 * [XSI] The values used for l_whence shall be defined as described
423 #include <sys/_types/_seek_set.h>
426 * [XSI] The symbolic names for file modes for use as values of mode_t
427 * shall be defined as described in <sys/stat.h>
429 #include <sys/_types/_s_ifmt.h>
431 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
432 /* allocate flags (F_PREALLOCATE) */
434 #define F_ALLOCATECONTIG 0x00000002 /* allocate contigious space */
435 #define F_ALLOCATEALL 0x00000004 /* allocate all requested space or no space at all */
437 /* Position Modes (fst_posmode) for F_PREALLOCATE */
439 #define F_PEOFPOSMODE 3 /* Make it past all of the SEEK pos modes so that */
440 /* we can keep them in sync should we desire */
441 #define F_VOLPOSMODE 4 /* specify volume starting postion */
442 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
445 * Advisory file segment locking data type -
446 * information passed to system by user
449 off_t l_start
; /* starting offset */
450 off_t l_len
; /* len = 0 means until end of file */
451 pid_t l_pid
; /* lock owner */
452 short l_type
; /* lock type: read/write, etc. */
453 short l_whence
; /* type of l_start */
456 #include <sys/_types/_timespec.h>
458 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
460 * Advisory file segment locking with time out -
461 * Information passed to system by user for F_SETLKWTIMEOUT
463 struct flocktimeout
{
464 struct flock fl
; /* flock passed for file locking */
465 struct timespec timeout
; /* timespec struct for timeout */
467 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
469 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
471 * advisory file read data type -
472 * information passed by user to system
476 #pragma pack(4) /* prevent structure padding in kernel */
489 /** Information the user passes in to get the codeblobs out of the kernel */
490 typedef struct fcodeblobs
{
495 unsigned int *f_out_size
;
502 typedef struct user32_fcodeblobs
{
503 user32_addr_t f_cd_hash
;
504 user32_size_t f_hash_size
;
505 user32_addr_t f_cd_buffer
;
506 user32_size_t f_cd_size
;
507 user32_addr_t f_out_size
;
509 } user32_fcodeblobs_t
;
511 /* LP64 version of fcodeblobs */
512 typedef struct user64_fcodeblobs
{
513 user64_addr_t f_cd_hash
;
514 user64_size_t f_hash_size
;
515 user64_addr_t f_cd_buffer
;
516 user64_size_t f_cd_size
;
517 user64_addr_t f_out_size
;
520 } user64_fcodeblobs_t
;
522 /* kernel version of fcodeblobs */
523 typedef struct user_fcodeblobs
{
524 user_addr_t f_cd_hash
;
525 user_size_t f_hash_size
;
526 user_addr_t f_cd_buffer
;
527 user_size_t f_cd_size
;
528 user_addr_t f_out_size
;
534 * detached code signatures data type -
535 * information passed by user to system used by F_ADDSIGS and F_ADDFILESIGS.
536 * F_ADDFILESIGS is a shortcut for files that contain their own signature and
537 * doesn't require mapping of the file in order to load the signature.
539 typedef struct fsignatures
{
545 /* LP64 version of fsignatures. all pointers
546 * grow when we're dealing with a 64-bit process.
547 * WARNING - keep in sync with fsignatures
550 typedef struct user32_fsignatures
{
552 user32_addr_t fs_blob_start
;
553 user32_size_t fs_blob_size
;
554 } user32_fsignatures_t
;
556 typedef struct user_fsignatures
{
557 off_t fs_file_start
; /* offset of Mach-O image in FAT file */
558 user_addr_t fs_blob_start
; /* F_ADDSIGS: mem address of signature*/
559 /* F_ADDFILESIGS: offset of signature */
560 /* in Mach-O image */
561 user_size_t fs_blob_size
; /* size of signature blob */
562 } user_fsignatures_t
;
566 * DYLD needs to check if the object is allowed to be combined
567 * into the main binary. This is done between the code signature
568 * is loaded and dyld is doing all the work to process the LOAD commands.
570 * While this could be done in F_ADDFILESIGS.* family the hook into
571 * the MAC module doesn't say no when LV isn't enabled and then that
572 * is cached on the vnode, and the MAC module never gets change once
573 * a process that library validation enabled.
575 typedef struct fchecklv
{
577 size_t lv_error_message_size
;
578 void *lv_error_message
;
582 /* LP64 version of fchecklv. all pointers
583 * grow when we're dealing with a 64-bit process.
584 * WARNING - keep in sync with fsignatures
587 typedef struct user32_fchecklv
{
588 user32_off_t lv_file_start
;
589 user32_size_t lv_error_message_size
;
590 user32_addr_t lv_error_message
;
593 typedef struct user_fchecklv
{
595 user_size_t lv_error_message_size
;
596 user_addr_t lv_error_message
;
602 /* lock operations for flock(2) */
603 #define LOCK_SH 0x01 /* shared file lock */
604 #define LOCK_EX 0x02 /* exclusive file lock */
605 #define LOCK_NB 0x04 /* don't block when locking */
606 #define LOCK_UN 0x08 /* unlock file */
608 /* fstore_t type used by F_PREALLOCATE command */
610 typedef struct fstore
{
611 unsigned int fst_flags
; /* IN: flags word */
612 int fst_posmode
; /* IN: indicates use of offset field */
613 off_t fst_offset
; /* IN: start of the region */
614 off_t fst_length
; /* IN: size of the region */
615 off_t fst_bytesalloc
; /* OUT: number of bytes allocated */
618 /* fpunchhole_t used by F_PUNCHHOLE */
619 typedef struct fpunchhole
{
620 unsigned int fp_flags
; /* unused */
621 unsigned int reserved
; /* (to maintain 8-byte alignment) */
622 off_t fp_offset
; /* IN: start of the region */
623 off_t fp_length
; /* IN: size of the region */
626 /* factive_file_trim_t used by F_TRIM_ACTIVE_FILE */
627 typedef struct ftrimactivefile
{
628 off_t fta_offset
; /* IN: start of the region */
629 off_t fta_length
; /* IN: size of the region */
632 /* fspecread_t used by F_SPECULATIVE_READ */
633 typedef struct fspecread
{
634 unsigned int fsr_flags
; /* IN: flags word */
635 unsigned int reserved
; /* to maintain 8-byte alignment */
636 off_t fsr_offset
; /* IN: start of the region */
637 off_t fsr_length
; /* IN: size of the region */
640 /* fbootstraptransfer_t used by F_READBOOTSTRAP and F_WRITEBOOTSTRAP commands */
642 typedef struct fbootstraptransfer
{
643 off_t fbt_offset
; /* IN: offset to start read/write */
644 size_t fbt_length
; /* IN: number of bytes to transfer */
645 void *fbt_buffer
; /* IN: buffer to be read/written */
646 } fbootstraptransfer_t
;
649 /* LP64 version of fbootstraptransfer. all pointers
650 * grow when we're dealing with a 64-bit process.
651 * WARNING - keep in sync with fbootstraptransfer
654 typedef struct user32_fbootstraptransfer
{
655 off_t fbt_offset
; /* IN: offset to start read/write */
656 user32_size_t fbt_length
; /* IN: number of bytes to transfer */
657 user32_addr_t fbt_buffer
; /* IN: buffer to be read/written */
658 } user32_fbootstraptransfer_t
;
660 typedef struct user_fbootstraptransfer
{
661 off_t fbt_offset
; /* IN: offset to start read/write */
662 user_size_t fbt_length
; /* IN: number of bytes to transfer */
663 user_addr_t fbt_buffer
; /* IN: buffer to be read/written */
664 } user_fbootstraptransfer_t
;
669 * For F_LOG2PHYS this information is passed back to user
670 * Currently only devoffset is returned - that is the VOP_BMAP
671 * result - the disk device address corresponding to the
672 * current file offset (likely set with an lseek).
674 * The flags could hold an indication of whether the # of
675 * contiguous bytes reflects the true extent length on disk,
676 * or is an advisory value that indicates there is at least that
677 * many bytes contiguous. For some filesystems it might be too
678 * inefficient to provide anything beyond the advisory value.
679 * Flags and contiguous bytes return values are not yet implemented.
680 * For them the fcntl will nedd to switch from using BMAP to CMAP
681 * and a per filesystem type flag will be needed to interpret the
682 * contiguous bytes count result from CMAP.
684 * F_LOG2PHYS_EXT is a variant of F_LOG2PHYS that uses a passed in
685 * file offset and length instead of the current file offset.
686 * F_LOG2PHYS_EXT operates on the same structure as F_LOG2PHYS, but
687 * treats it as an in/out.
692 unsigned int l2p_flags
; /* unused so far */
693 off_t l2p_contigbytes
; /* F_LOG2PHYS: unused so far */
694 /* F_LOG2PHYS_EXT: IN: number of bytes to be queried */
695 /* OUT: number of contiguous bytes at this position */
696 off_t l2p_devoffset
; /* F_LOG2PHYS: OUT: bytes into device */
697 /* F_LOG2PHYS_EXT: IN: bytes into file */
698 /* OUT: bytes into device */
703 #define O_POPUP 0x80000000 /* force window to popup on open */
704 #define O_ALERT 0x20000000 /* small, clean popup window */
708 * SPI: Argument data for F_OPENFROM
711 unsigned int o_flags
; /* same as open(2) */
712 mode_t o_mode
; /* same as open(2) */
713 char * o_pathname
; /* relative pathname */
718 * LP64 version of fopenfrom. Memory pointers
719 * grow when we're dealing with a 64-bit process.
721 * WARNING - keep in sync with fopenfrom (above)
723 struct user32_fopenfrom
{
724 unsigned int o_flags
;
726 user32_addr_t o_pathname
;
729 struct user_fopenfrom
{
730 unsigned int o_flags
;
732 user_addr_t o_pathname
;
738 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
742 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
744 #include <sys/_types/_filesec_t.h>
754 /* XXX these are private to the implementation */
755 FILESEC_ACL_RAW
= 100,
756 FILESEC_ACL_ALLOCSIZE
= 101
757 } filesec_property_t
;
759 /* XXX backwards compatibility */
760 #define FILESEC_GUID FILESEC_UUID
761 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
764 int open(const char *, int, ...) __DARWIN_ALIAS_C(open
);
765 #if __DARWIN_C_LEVEL >= 200809L
766 int openat(int, const char *, int, ...) __DARWIN_NOCANCEL(openat
) __OSX_AVAILABLE_STARTING(__MAC_10_10
, __IPHONE_8_0
);
768 int creat(const char *, mode_t
) __DARWIN_ALIAS_C(creat
);
769 int fcntl(int, int, ...) __DARWIN_ALIAS_C(fcntl
);
770 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
774 * These definitions are retained temporarily for compatibility.
775 * If you want to use fileports, please use
776 * #include <sys/fileport.h>
778 * #include <System/sys/fileport.h>
782 typedef __darwin_mach_port_t fileport_t
;
783 #define FILEPORT_NULL ((fileport_t)0)
784 #endif /* _FILEPORT_T */
786 int fileport_makeport(int, fileport_t
*);
787 int fileport_makefd(fileport_t
);
789 int openx_np(const char *, int, filesec_t
);
791 * data-protected non-portable open(2) :
792 * int open_dprotected_np(user_addr_t path, int flags, int class, int dpflags, int mode)
794 int open_dprotected_np( const char *, int, int, int, ...);
796 filesec_t
filesec_init(void);
797 filesec_t
filesec_dup(filesec_t
);
798 void filesec_free(filesec_t
);
799 int filesec_get_property(filesec_t
, filesec_property_t
, void *);
800 int filesec_query_property(filesec_t
, filesec_property_t
, int *);
801 int filesec_set_property(filesec_t
, filesec_property_t
, const void *);
802 int filesec_unset_property(filesec_t
, filesec_property_t
) __OSX_AVAILABLE_STARTING(__MAC_10_6
, __IPHONE_3_2
);
803 #define _FILESEC_UNSET_PROPERTY ((void *)0)
804 #define _FILESEC_REMOVE_ACL ((void *)1)
805 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
809 #endif /* !_SYS_FCNTL_H_ */