]> git.saurik.com Git - apple/xnu.git/blob - bsd/sys/fcntl.h
xnu-6153.81.5.tar.gz
[apple/xnu.git] / bsd / sys / fcntl.h
1 /*
2 * Copyright (c) 2000-2013 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) 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.
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 * @(#)fcntl.h 8.3 (Berkeley) 1/21/94
67 */
68
69
70 #ifndef _SYS_FCNTL_H_
71 #define _SYS_FCNTL_H_
72
73 /*
74 * This file includes the definitions for open and fcntl
75 * described by POSIX for <fcntl.h>; it also includes
76 * related kernel definitions.
77 */
78 #include <sys/_types.h>
79 #include <sys/cdefs.h>
80 #ifndef KERNEL
81 #include <Availability.h>
82 #endif
83
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>
89
90 /*
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.
96 */
97 /* open-only flags */
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 */
102
103 /*
104 * Kernel encoding of open mode; separate read and write bits that are
105 * independently testable: 1 greater than the above.
106 *
107 * XXX
108 * FREAD and FWRITE are excluded from the #ifdef KERNEL so that TIOCFLUSH,
109 * which was documented to use FREAD/FWRITE, continues to work.
110 */
111 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
112 #define FREAD 0x0001
113 #define FWRITE 0x0002
114 #endif
115 #define O_NONBLOCK 0x0004 /* no delay */
116 #define O_APPEND 0x0008 /* set append mode */
117
118 #include <sys/_types/_o_sync.h>
119
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 */
130 #ifdef KERNEL
131 #define FMARK 0x1000 /* mark during gc() */
132 #define FDEFER 0x2000 /* defer for next gc pass */
133 #define FHASLOCK 0x4000 /* descriptor holds advisory lock */
134 #endif
135
136 #if __DARWIN_C_LEVEL >= 200809L
137 /*
138 * Descriptor value for the current working directory
139 */
140 #define AT_FDCWD -2
141
142 /*
143 * Flags for the at functions
144 */
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
150 #ifdef PRIVATE
151 #define AT_REMOVEDIR_DATALESS 0x0100 /* Remove a dataless directory without materializing first */
152 #endif
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) */
155 #endif
156 #endif
157
158 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
159 #define O_EVTONLY 0x8000 /* descriptor requested for event notifications only */
160 #endif
161
162 #ifdef KERNEL
163 #define FWASWRITTEN 0x10000 /* descriptor was written */
164 #endif
165
166 #define O_NOCTTY 0x20000 /* don't assign controlling terminal */
167
168 #ifdef KERNEL
169 #define FNOCACHE 0x40000 /* fcntl(F_NOCACHE, 1) */
170 #define FNORDAHEAD 0x80000 /* fcntl(F_RDAHEAD, 0) */
171 #endif
172
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 */
176 #endif
177
178 #include <sys/_types/_o_dsync.h>
179
180 #ifdef KERNEL
181 #define FNODIRECT 0x800000 /* fcntl(F_NODIRECT, 1) */
182 #endif
183
184 #if __DARWIN_C_LEVEL >= 200809L
185 #define O_CLOEXEC 0x1000000 /* implicitly set FD_CLOEXEC */
186 #endif
187
188 #ifdef KERNEL
189 #define FENCRYPTED 0x2000000
190 #endif
191
192 #ifdef KERNEL
193 #define FSINGLE_WRITER 0x4000000 /* fcntl(F_SINGLE_WRITER, 1) */
194 #endif
195
196 #ifdef KERNEL
197 #define O_CLOFORK 0x8000000 /* implicitly set FD_CLOFORK */
198 #endif
199
200 #ifdef KERNEL
201 #define FUNENCRYPTED 0x10000000
202 #endif
203
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
208 #endif
209
210
211 #ifdef KERNEL
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)
215
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)
220 #endif
221
222 /*
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.
226 */
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 */
235 #endif
236
237 /*
238 * Flags used for copyfile(2)
239 */
240
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)
245 #endif
246
247 /*
248 * Constants used for fcntl(2)
249 */
250
251 /* command values */
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 */
272 /*
273 * 46,47 used to be F_READBOOTSTRAP and F_WRITEBOOTSTRAP
274 */
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 */
283
284 #ifdef PRIVATE
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 */
288 #endif /* PRIVATE */
289
290 #define F_ADDSIGS 59 /* add detached signatures */
291
292 #ifdef PRIVATE
293 /* Deprecated/Removed in 10.9 */
294 #define F_MARKDEPENDENCY 60 /* this process hosts the device supporting the fs backing this fd */
295 #endif
296
297 #define F_ADDFILESIGS 61 /* add signature from same file (used by dyld for shared libs) */
298
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) */
301
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 */
304
305 #define F_LOG2PHYS_EXT 65 /* file offset to device offset, extended */
306
307 #define F_GETLKPID 66 /* get record locking information, per-process */
308
309 /* See F_DUPFD_CLOEXEC below for 67 */
310
311 #ifdef PRIVATE
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.
315 */
316 #define F_MOVEDATAEXTENTS 69 /* Swap only the data associated with two files */
317 #endif
318
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 */
321
322 #define F_GETCODEDIR 72 /* Returns the code directory, with associated hashes, to the caller */
323
324 #define F_SETNOSIGPIPE 73 /* No SIGPIPE generated on EPIPE */
325 #define F_GETNOSIGPIPE 74 /* Status of SIGPIPE for this fd */
326
327 #define F_TRANSCODEKEY 75 /* For some cases, we need to rewrap the key for AKS/MKB */
328
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 */
331
332 #define F_GETPROTECTIONLEVEL 77 /* Get the protection version number for this filesystem */
333
334 #define F_FINDSIGS 78 /* Add detached code signatures (used by dyld for shared libs) */
335
336 #ifdef PRIVATE
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.
343 */
344
345 #define F_SETIOTYPE 82 /*
346 * Use parameters to describe content being written to the FD. See
347 * flag definitions below for argument bits.
348 */
349 #endif
350
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) */
352
353 #ifdef PRIVATE
354 #define F_RECYCLE 84 /* Recycle vnode; debug/development builds only */
355 #endif
356
357 #define F_BARRIERFSYNC 85 /* fsync + issue barrier to drive */
358
359 #ifdef PRIVATE
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 */
363
364 #define F_OFD_SETLKWTIMEOUT 93 /* (as F_OFD_SETLKW but return if timeout) */
365 #define F_OFD_GETLKPID 94 /* get record locking information */
366
367 #define F_SETCONFINED 95 /* "confine" OFD to process */
368 #define F_GETCONFINED 96 /* is-fd-confined? */
369 #endif
370
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 */
373
374 #define F_PUNCHHOLE 99 /* Deallocate a range of the file */
375
376 #define F_TRIM_ACTIVE_FILE 100 /* Trim an active file */
377
378 #define F_SPECULATIVE_READ 101 /* Synchronous advisory read fcntl for regular and compressed file */
379
380 #define F_GETPATH_NOFIRMLINK 102 /* return the full path without firmlinks of the fd */
381
382 // FS-specific fcntl()'s numbers begin at 0x00010000 and go up
383 #define FCNTL_FS_SPECIFIC_BASE 0x00010000
384
385 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
386
387 #if __DARWIN_C_LEVEL >= 200809L
388 #define F_DUPFD_CLOEXEC 67 /* mark the dup with FD_CLOEXEC */
389 #endif
390
391 /* file descriptor flags (F_GETFD, F_SETFD) */
392 #define FD_CLOEXEC 1 /* close-on-exec flag */
393 #if PRIVATE
394 #define FD_CLOFORK 2 /* close-on-fork flag */
395 #endif
396
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 */
401 #ifdef KERNEL
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 */
409 #endif
410
411 #if PRIVATE
412 /*
413 * ISOCHRONOUS attempts to sustain a minimum platform-dependent throughput
414 * for the duration of the I/O delivered to the driver.
415 */
416 #define F_IOTYPE_ISOCHRONOUS 0x0001
417 #endif
418
419 /*
420 * [XSI] The values used for l_whence shall be defined as described
421 * in <unistd.h>
422 */
423 #include <sys/_types/_seek_set.h>
424
425 /*
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>
428 */
429 #include <sys/_types/_s_ifmt.h>
430
431 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
432 /* allocate flags (F_PREALLOCATE) */
433
434 #define F_ALLOCATECONTIG 0x00000002 /* allocate contigious space */
435 #define F_ALLOCATEALL 0x00000004 /* allocate all requested space or no space at all */
436
437 /* Position Modes (fst_posmode) for F_PREALLOCATE */
438
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) */
443
444 /*
445 * Advisory file segment locking data type -
446 * information passed to system by user
447 */
448 struct flock {
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 */
454 };
455
456 #include <sys/_types/_timespec.h>
457
458 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
459 /*
460 * Advisory file segment locking with time out -
461 * Information passed to system by user for F_SETLKWTIMEOUT
462 */
463 struct flocktimeout {
464 struct flock fl; /* flock passed for file locking */
465 struct timespec timeout; /* timespec struct for timeout */
466 };
467 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
468
469 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
470 /*
471 * advisory file read data type -
472 * information passed by user to system
473 */
474
475 #ifdef KERNEL
476 #pragma pack(4) /* prevent structure padding in kernel */
477 #endif /* KERNEL */
478
479 struct radvisory {
480 off_t ra_offset;
481 int ra_count;
482 };
483
484 #ifdef KERNEL
485 #pragma pack()
486 #endif /* KERNEL */
487
488 #ifndef KERNEL
489 /** Information the user passes in to get the codeblobs out of the kernel */
490 typedef struct fcodeblobs {
491 void *f_cd_hash;
492 size_t f_hash_size;
493 void *f_cd_buffer;
494 size_t f_cd_size;
495 unsigned int *f_out_size;
496 int f_arch;
497 int __padding;
498 } fcodeblobs_t;
499 #endif /* KERNEL */
500
501 #ifdef KERNEL
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;
508 int f_arch;
509 } user32_fcodeblobs_t;
510
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;
518 int f_arch;
519 int __padding;
520 } user64_fcodeblobs_t;
521
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;
529 int f_arch;
530 } user_fcodeblobs_t;
531 #endif /* KERNEL */
532
533 /*
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.
538 */
539 typedef struct fsignatures {
540 off_t fs_file_start;
541 void *fs_blob_start;
542 size_t fs_blob_size;
543 } fsignatures_t;
544 #ifdef KERNEL
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
548 */
549
550 typedef struct user32_fsignatures {
551 off_t fs_file_start;
552 user32_addr_t fs_blob_start;
553 user32_size_t fs_blob_size;
554 } user32_fsignatures_t;
555
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;
563 #endif /* KERNEL */
564
565 /*
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.
569 *
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.
574 */
575 typedef struct fchecklv {
576 off_t lv_file_start;
577 size_t lv_error_message_size;
578 void *lv_error_message;
579 } fchecklv_t;
580
581 #ifdef KERNEL
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
585 */
586
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;
591 } user32_fchecklv_t;
592
593 typedef struct user_fchecklv {
594 off_t lv_file_start;
595 user_size_t lv_error_message_size;
596 user_addr_t lv_error_message;
597 } user_fchecklv_t;
598
599 #endif /* KERNEL */
600
601
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 */
607
608 /* fstore_t type used by F_PREALLOCATE command */
609
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 */
616 } fstore_t;
617
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 */
624 } fpunchhole_t;
625
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 */
630 } ftrimactivefile_t;
631
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 */
638 } fspecread_t;
639
640 /* fbootstraptransfer_t used by F_READBOOTSTRAP and F_WRITEBOOTSTRAP commands */
641
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;
647
648 #ifdef KERNEL
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
652 */
653
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;
659
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;
665
666 #endif // KERNEL
667
668 /*
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).
673 *
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.
683 *
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.
688 */
689 #pragma pack(4)
690
691 struct log2phys {
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 */
699 };
700
701 #pragma pack()
702
703 #define O_POPUP 0x80000000 /* force window to popup on open */
704 #define O_ALERT 0x20000000 /* small, clean popup window */
705
706 #ifdef PRIVATE
707 /*
708 * SPI: Argument data for F_OPENFROM
709 */
710 struct fopenfrom {
711 unsigned int o_flags; /* same as open(2) */
712 mode_t o_mode; /* same as open(2) */
713 char * o_pathname; /* relative pathname */
714 };
715
716 #ifdef KERNEL
717 /*
718 * LP64 version of fopenfrom. Memory pointers
719 * grow when we're dealing with a 64-bit process.
720 *
721 * WARNING - keep in sync with fopenfrom (above)
722 */
723 struct user32_fopenfrom {
724 unsigned int o_flags;
725 mode_t o_mode;
726 user32_addr_t o_pathname;
727 };
728
729 struct user_fopenfrom {
730 unsigned int o_flags;
731 mode_t o_mode;
732 user_addr_t o_pathname;
733 };
734 #endif /* KERNEL */
735
736 #endif /* PRIVATE */
737
738 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
739
740 #ifndef KERNEL
741
742 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
743
744 #include <sys/_types/_filesec_t.h>
745
746 typedef enum {
747 FILESEC_OWNER = 1,
748 FILESEC_GROUP = 2,
749 FILESEC_UUID = 3,
750 FILESEC_MODE = 4,
751 FILESEC_ACL = 5,
752 FILESEC_GRPUUID = 6,
753
754 /* XXX these are private to the implementation */
755 FILESEC_ACL_RAW = 100,
756 FILESEC_ACL_ALLOCSIZE = 101
757 } filesec_property_t;
758
759 /* XXX backwards compatibility */
760 #define FILESEC_GUID FILESEC_UUID
761 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
762
763 __BEGIN_DECLS
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);
767 #endif
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)
771
772 #ifdef PRIVATE
773 /*
774 * These definitions are retained temporarily for compatibility.
775 * If you want to use fileports, please use
776 * #include <sys/fileport.h>
777 * or
778 * #include <System/sys/fileport.h>
779 */
780 #ifndef _FILEPORT_T
781 #define _FILEPORT_T
782 typedef __darwin_mach_port_t fileport_t;
783 #define FILEPORT_NULL ((fileport_t)0)
784 #endif /* _FILEPORT_T */
785
786 int fileport_makeport(int, fileport_t*);
787 int fileport_makefd(fileport_t);
788 #endif /* PRIVATE */
789 int openx_np(const char *, int, filesec_t);
790 /*
791 * data-protected non-portable open(2) :
792 * int open_dprotected_np(user_addr_t path, int flags, int class, int dpflags, int mode)
793 */
794 int open_dprotected_np( const char *, int, int, int, ...);
795 int flock(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) */
806 __END_DECLS
807 #endif
808
809 #endif /* !_SYS_FCNTL_H_ */