]> git.saurik.com Git - apple/xnu.git/blob - bsd/sys/cdefs.h
xnu-3789.41.3.tar.gz
[apple/xnu.git] / bsd / sys / cdefs.h
1 /*
2 * Copyright (c) 2000-2016 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 1995 NeXT Computer, Inc. All rights reserved. */
29 /*
30 * Copyright (c) 1991, 1993
31 * The Regents of the University of California. All rights reserved.
32 *
33 * This code is derived from software contributed to Berkeley by
34 * Berkeley Software Design, Inc.
35 *
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
44 * 3. All advertising materials mentioning features or use of this software
45 * must display the following acknowledgement:
46 * This product includes software developed by the University of
47 * California, Berkeley and its contributors.
48 * 4. Neither the name of the University nor the names of its contributors
49 * may be used to endorse or promote products derived from this software
50 * without specific prior written permission.
51 *
52 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
53 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
54 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
55 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
56 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
57 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
58 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
62 * SUCH DAMAGE.
63 *
64 * @(#)cdefs.h 8.8 (Berkeley) 1/9/95
65 */
66
67 #ifndef _CDEFS_H_
68 #define _CDEFS_H_
69
70 #if defined(__cplusplus)
71 #define __BEGIN_DECLS extern "C" {
72 #define __END_DECLS }
73 #else
74 #define __BEGIN_DECLS
75 #define __END_DECLS
76 #endif
77
78 /* This SDK is designed to work with clang and specific versions of
79 * gcc >= 4.0 with Apple's patch sets */
80 #if !defined(__GNUC__) || __GNUC__ < 4
81 #warning "Unsupported compiler detected"
82 #endif
83
84 /*
85 * Compatibility with compilers and environments that don't support compiler
86 * feature checking function-like macros.
87 */
88 #ifndef __has_builtin
89 #define __has_builtin(x) 0
90 #endif
91 #ifndef __has_include
92 #define __has_include(x) 0
93 #endif
94 #ifndef __has_feature
95 #define __has_feature(x) 0
96 #endif
97 #ifndef __has_attribute
98 #define __has_attribute(x) 0
99 #endif
100 #ifndef __has_extension
101 #define __has_extension(x) 0
102 #endif
103
104 /*
105 * The __CONCAT macro is used to concatenate parts of symbol names, e.g.
106 * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo.
107 * The __CONCAT macro is a bit tricky -- make sure you don't put spaces
108 * in between its arguments. __CONCAT can also concatenate double-quoted
109 * strings produced by the __STRING macro, but this only works with ANSI C.
110 */
111 #if defined(__STDC__) || defined(__cplusplus)
112 #define __P(protos) protos /* full-blown ANSI C */
113 #define __CONCAT(x,y) x ## y
114 #define __STRING(x) #x
115
116 #define __const const /* define reserved names to standard */
117 #define __signed signed
118 #define __volatile volatile
119 #if defined(__cplusplus)
120 #define __inline inline /* convert to C++ keyword */
121 #else
122 #ifndef __GNUC__
123 #define __inline /* delete GCC keyword */
124 #endif /* !__GNUC__ */
125 #endif /* !__cplusplus */
126
127 #else /* !(__STDC__ || __cplusplus) */
128 #define __P(protos) () /* traditional C preprocessor */
129 #define __CONCAT(x,y) x/**/y
130 #define __STRING(x) "x"
131
132 #ifndef __GNUC__
133 #define __const /* delete pseudo-ANSI C keywords */
134 #define __inline
135 #define __signed
136 #define __volatile
137 #endif /* !__GNUC__ */
138
139 /*
140 * In non-ANSI C environments, new programs will want ANSI-only C keywords
141 * deleted from the program and old programs will want them left alone.
142 * When using a compiler other than gcc, programs using the ANSI C keywords
143 * const, inline etc. as normal identifiers should define -DNO_ANSI_KEYWORDS.
144 * When using "gcc -traditional", we assume that this is the intent; if
145 * __GNUC__ is defined but __STDC__ is not, we leave the new keywords alone.
146 */
147 #ifndef NO_ANSI_KEYWORDS
148 #define const __const /* convert ANSI C keywords */
149 #define inline __inline
150 #define signed __signed
151 #define volatile __volatile
152 #endif /* !NO_ANSI_KEYWORDS */
153 #endif /* !(__STDC__ || __cplusplus) */
154
155 #define __dead2 __attribute__((noreturn))
156 #define __pure2 __attribute__((const))
157
158 /* __unused denotes variables and functions that may not be used, preventing
159 * the compiler from warning about it if not used.
160 */
161 #define __unused __attribute__((unused))
162
163 /* __used forces variables and functions to be included even if it appears
164 * to the compiler that they are not used (and would thust be discarded).
165 */
166 #define __used __attribute__((used))
167
168 /* __deprecated causes the compiler to produce a warning when encountering
169 * code using the deprecated functionality.
170 * __deprecated_msg() does the same, and compilers that support it will print
171 * a message along with the deprecation warning.
172 * This may require turning on such warning with the -Wdeprecated flag.
173 * __deprecated_enum_msg() should be used on enums, and compilers that support
174 * it will print the deprecation warning.
175 */
176 #define __deprecated __attribute__((deprecated))
177
178 #if __has_extension(attribute_deprecated_with_message) || \
179 (defined(__GNUC__) && ((__GNUC__ >= 5) || ((__GNUC__ == 4) && (__GNUC_MINOR__ >= 5))))
180 #define __deprecated_msg(_msg) __attribute__((deprecated(_msg)))
181 #else
182 #define __deprecated_msg(_msg) __attribute__((deprecated))
183 #endif
184
185 #if __has_extension(enumerator_attributes)
186 #define __deprecated_enum_msg(_msg) __deprecated_msg(_msg)
187 #else
188 #define __deprecated_enum_msg(_msg)
189 #endif
190
191 /* __unavailable causes the compiler to error out when encountering
192 * code using the tagged function of variable.
193 */
194 #define __unavailable __attribute__((unavailable))
195
196 /* Delete pseudo-keywords wherever they are not available or needed. */
197 #ifndef __dead
198 #define __dead
199 #define __pure
200 #endif
201
202 /*
203 * We use `__restrict' as a way to define the `restrict' type qualifier
204 * without disturbing older software that is unaware of C99 keywords.
205 */
206 #if __STDC_VERSION__ < 199901
207 #define __restrict
208 #else
209 #define __restrict restrict
210 #endif
211
212 /* Compatibility with compilers and environments that don't support the
213 * nullability feature.
214 */
215
216 #if !__has_feature(nullability)
217 #ifndef __nullable
218 #define __nullable
219 #endif
220 #ifndef __nonnull
221 #define __nonnull
222 #endif
223 #ifndef __null_unspecified
224 #define __null_unspecified
225 #endif
226 #ifndef _Nullable
227 #define _Nullable
228 #endif
229 #ifndef _Nonnull
230 #define _Nonnull
231 #endif
232 #ifndef _Null_unspecified
233 #define _Null_unspecified
234 #endif
235 #endif
236
237 /*
238 * __disable_tail_calls causes the compiler to not perform tail call
239 * optimization inside the marked function.
240 */
241 #if __has_attribute(disable_tail_calls)
242 #define __disable_tail_calls __attribute__((__disable_tail_calls__))
243 #else
244 #define __disable_tail_calls
245 #endif
246
247 /*
248 * __not_tail_called causes the compiler to prevent tail call optimization
249 * on statically bound calls to the function. It has no effect on indirect
250 * calls. Virtual functions, objective-c methods, and functions marked as
251 * "always_inline" cannot be marked as __not_tail_called.
252 */
253 #if __has_attribute(not_tail_called)
254 #define __not_tail_called __attribute__((__not_tail_called__))
255 #else
256 #define __not_tail_called
257 #endif
258
259 /*
260 * __result_use_check warns callers of a function that not using the function
261 * return value is a bug, i.e. dismissing malloc() return value results in a
262 * memory leak.
263 */
264 #if __has_attribute(warn_unused_result)
265 #define __result_use_check __attribute__((__warn_unused_result__))
266 #else
267 #define __result_use_check
268 #endif
269
270 /*
271 * __swift_unavailable causes the compiler to mark a symbol as specifically
272 * unavailable in Swift, regardless of any other availability in C.
273 */
274 #if __has_feature(attribute_availability_swift)
275 #define __swift_unavailable(_msg) __attribute__((__availability__(swift, unavailable, message=_msg)))
276 #else
277 #define __swift_unavailable(_msg)
278 #endif
279
280 /* Declaring inline functions within headers is error-prone due to differences
281 * across various versions of the C language and extensions. __header_inline
282 * can be used to declare inline functions within system headers. In cases
283 * where you want to force inlining instead of letting the compiler make
284 * the decision, you can use __header_always_inline.
285 *
286 * Be aware that using inline for functions which compilers may also provide
287 * builtins can behave differently under various compilers. If you intend to
288 * provide an inline version of such a function, you may want to use a macro
289 * instead.
290 *
291 * The check for !__GNUC__ || __clang__ is because gcc doesn't correctly
292 * support c99 inline in some cases:
293 * http://gcc.gnu.org/bugzilla/show_bug.cgi?id=55965
294 */
295
296 #if defined(__cplusplus) || \
297 (__STDC_VERSION__ >= 199901L && \
298 !defined(__GNUC_GNU_INLINE__) && \
299 (!defined(__GNUC__) || defined(__clang__)))
300 # define __header_inline inline
301 #elif defined(__GNUC__) && defined(__GNUC_STDC_INLINE__)
302 # define __header_inline extern __inline __attribute__((__gnu_inline__))
303 #elif defined(__GNUC__)
304 # define __header_inline extern __inline
305 #else
306 /* If we land here, we've encountered an unsupported compiler,
307 * so hopefully it understands static __inline as a fallback.
308 */
309 # define __header_inline static __inline
310 #endif
311
312 #ifdef __GNUC__
313 # define __header_always_inline __header_inline __attribute__ ((__always_inline__))
314 #else
315 /* Unfortunately, we're using a compiler that we don't know how to force to
316 * inline. Oh well.
317 */
318 # define __header_always_inline __header_inline
319 #endif
320
321 /*
322 * Compiler-dependent macros that bracket portions of code where the
323 * "-Wunreachable-code" warning should be ignored. Please use sparingly.
324 */
325 #if defined(__clang__)
326 # define __unreachable_ok_push \
327 _Pragma("clang diagnostic push") \
328 _Pragma("clang diagnostic ignored \"-Wunreachable-code\"")
329 # define __unreachable_ok_pop \
330 _Pragma("clang diagnostic pop")
331 #elif defined(__GNUC__) && ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6))
332 # define __unreachable_ok_push \
333 _Pragma("GCC diagnostic push") \
334 _Pragma("GCC diagnostic ignored \"-Wunreachable-code\"")
335 # define __unreachable_ok_pop \
336 _Pragma("GCC diagnostic pop")
337 #else
338 # define __unreachable_ok_push
339 # define __unreachable_ok_pop
340 #endif
341
342 /*
343 * Compiler-dependent macros to declare that functions take printf-like
344 * or scanf-like arguments. They are null except for versions of gcc
345 * that are known to support the features properly. Functions declared
346 * with these attributes will cause compilation warnings if there is a
347 * mismatch between the format string and subsequent function parameter
348 * types.
349 */
350 #define __printflike(fmtarg, firstvararg) \
351 __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
352 #define __printf0like(fmtarg, firstvararg) \
353 __attribute__((__format__ (__printf0__, fmtarg, firstvararg)))
354 #define __scanflike(fmtarg, firstvararg) \
355 __attribute__((__format__ (__scanf__, fmtarg, firstvararg)))
356
357 #define __IDSTRING(name,string) static const char name[] __used = string
358
359 #ifndef __COPYRIGHT
360 #define __COPYRIGHT(s) __IDSTRING(copyright,s)
361 #endif
362
363 #ifndef __RCSID
364 #define __RCSID(s) __IDSTRING(rcsid,s)
365 #endif
366
367 #ifndef __SCCSID
368 #define __SCCSID(s) __IDSTRING(sccsid,s)
369 #endif
370
371 #ifndef __PROJECT_VERSION
372 #define __PROJECT_VERSION(s) __IDSTRING(project_version,s)
373 #endif
374
375 /* Source compatibility only, ID string not emitted in object file */
376 #ifndef __FBSDID
377 #define __FBSDID(s)
378 #endif
379
380 #ifndef __DECONST
381 #define __DECONST(type, var) __CAST_AWAY_QUALIFIER(var, const, type)
382 #endif
383
384 #ifndef __DEVOLATILE
385 #define __DEVOLATILE(type, var) __CAST_AWAY_QUALIFIER(var, volatile, type)
386 #endif
387
388 #ifndef __DEQUALIFY
389 #define __DEQUALIFY(type, var) __CAST_AWAY_QUALIFIER(var, const volatile, type)
390 #endif
391
392 /*
393 * COMPILATION ENVIRONMENTS -- see compat(5) for additional detail
394 *
395 * DEFAULT By default newly complied code will get POSIX APIs plus
396 * Apple API extensions in scope.
397 *
398 * Most users will use this compilation environment to avoid
399 * behavioral differences between 32 and 64 bit code.
400 *
401 * LEGACY Defining _NONSTD_SOURCE will get pre-POSIX APIs plus Apple
402 * API extensions in scope.
403 *
404 * This is generally equivalent to the Tiger release compilation
405 * environment, except that it cannot be applied to 64 bit code;
406 * its use is discouraged.
407 *
408 * We expect this environment to be deprecated in the future.
409 *
410 * STRICT Defining _POSIX_C_SOURCE or _XOPEN_SOURCE restricts the
411 * available APIs to exactly the set of APIs defined by the
412 * corresponding standard, based on the value defined.
413 *
414 * A correct, portable definition for _POSIX_C_SOURCE is 200112L.
415 * A correct, portable definition for _XOPEN_SOURCE is 600L.
416 *
417 * Apple API extensions are not visible in this environment,
418 * which can cause Apple specific code to fail to compile,
419 * or behave incorrectly if prototypes are not in scope or
420 * warnings about missing prototypes are not enabled or ignored.
421 *
422 * In any compilation environment, for correct symbol resolution to occur,
423 * function prototypes must be in scope. It is recommended that all Apple
424 * tools users add either the "-Wall" or "-Wimplicit-function-declaration"
425 * compiler flags to their projects to be warned when a function is being
426 * used without a prototype in scope.
427 */
428
429 /* These settings are particular to each product. */
430 #ifdef KERNEL
431 #define __DARWIN_ONLY_64_BIT_INO_T 0
432 #define __DARWIN_ONLY_UNIX_CONFORMANCE 0
433 #define __DARWIN_ONLY_VERS_1050 0
434 #if defined(__x86_64__)
435 #define __DARWIN_SUF_DARWIN14 "_darwin14"
436 #define __DARWIN14_ALIAS(sym) __asm("_" __STRING(sym) __DARWIN_SUF_DARWIN14)
437 #else
438 #define __DARWIN14_ALIAS(sym)
439 #endif
440 #else /* !KERNEL */
441 #ifdef PLATFORM_iPhoneOS
442 /* Platform: iPhoneOS */
443 #define __DARWIN_ONLY_64_BIT_INO_T 1
444 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
445 #define __DARWIN_ONLY_VERS_1050 1
446 #endif /* PLATFORM_iPhoneOS */
447 #ifdef PLATFORM_iPhoneSimulator
448 /* Platform: iPhoneSimulator */
449 #define __DARWIN_ONLY_64_BIT_INO_T 1
450 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
451 #define __DARWIN_ONLY_VERS_1050 1
452 #endif /* PLATFORM_iPhoneSimulator */
453 #ifdef PLATFORM_tvOS
454 /* Platform: tvOS */
455 #define __DARWIN_ONLY_64_BIT_INO_T 1
456 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
457 #define __DARWIN_ONLY_VERS_1050 1
458 #endif /* PLATFORM_tvOS */
459 #ifdef PLATFORM_AppleTVOS
460 /* Platform: AppleTVOS */
461 #define __DARWIN_ONLY_64_BIT_INO_T 1
462 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
463 #define __DARWIN_ONLY_VERS_1050 1
464 #endif /* PLATFORM_AppleTVOS */
465 #ifdef PLATFORM_tvSimulator
466 /* Platform: tvSimulator */
467 #define __DARWIN_ONLY_64_BIT_INO_T 1
468 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
469 #define __DARWIN_ONLY_VERS_1050 1
470 #endif /* PLATFORM_tvSimulator */
471 #ifdef PLATFORM_AppleTVSimulator
472 /* Platform: AppleTVSimulator */
473 #define __DARWIN_ONLY_64_BIT_INO_T 1
474 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
475 #define __DARWIN_ONLY_VERS_1050 1
476 #endif /* PLATFORM_AppleTVSimulator */
477 #ifdef PLATFORM_iPhoneOSNano
478 /* Platform: iPhoneOSNano */
479 #define __DARWIN_ONLY_64_BIT_INO_T 1
480 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
481 #define __DARWIN_ONLY_VERS_1050 1
482 #endif /* PLATFORM_iPhoneOSNano */
483 #ifdef PLATFORM_iPhoneNanoSimulator
484 /* Platform: iPhoneNanoSimulator */
485 #define __DARWIN_ONLY_64_BIT_INO_T 1
486 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
487 #define __DARWIN_ONLY_VERS_1050 1
488 #endif /* PLATFORM_iPhoneNanoSimulator */
489 #ifdef PLATFORM_WatchOS
490 /* Platform: WatchOS */
491 #define __DARWIN_ONLY_64_BIT_INO_T 1
492 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
493 #define __DARWIN_ONLY_VERS_1050 1
494 #endif /* PLATFORM_WatchOS */
495 #ifdef PLATFORM_WatchSimulator
496 /* Platform: WatchSimulator */
497 #define __DARWIN_ONLY_64_BIT_INO_T 1
498 #define __DARWIN_ONLY_UNIX_CONFORMANCE 1
499 #define __DARWIN_ONLY_VERS_1050 1
500 #endif /* PLATFORM_WatchSimulator */
501 #ifdef PLATFORM_MacOSX
502 /* Platform: MacOSX */
503 #define __DARWIN_ONLY_64_BIT_INO_T 0
504 /* #undef __DARWIN_ONLY_UNIX_CONFORMANCE (automatically set for 64-bit) */
505 #define __DARWIN_ONLY_VERS_1050 0
506 #endif /* PLATFORM_MacOSX */
507 #endif /* KERNEL */
508
509 /*
510 * The __DARWIN_ALIAS macros are used to do symbol renaming; they allow
511 * legacy code to use the old symbol, thus maintaining binary compatibility
512 * while new code can use a standards compliant version of the same function.
513 *
514 * __DARWIN_ALIAS is used by itself if the function signature has not
515 * changed, it is used along with a #ifdef check for __DARWIN_UNIX03
516 * if the signature has changed. Because the __LP64__ environment
517 * only supports UNIX03 semantics it causes __DARWIN_UNIX03 to be
518 * defined, but causes __DARWIN_ALIAS to do no symbol mangling.
519 *
520 * As a special case, when XCode is used to target a specific version of the
521 * OS, the manifest constant __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__
522 * will be defined by the compiler, with the digits representing major version
523 * time 100 + minor version times 10 (e.g. 10.5 := 1050). If we are targeting
524 * pre-10.5, and it is the default compilation environment, revert the
525 * compilation environment to pre-__DARWIN_UNIX03.
526 */
527 #if !defined(__DARWIN_ONLY_UNIX_CONFORMANCE)
528 # if defined(__LP64__)
529 # define __DARWIN_ONLY_UNIX_CONFORMANCE 1
530 # else /* !__LP64__ */
531 # define __DARWIN_ONLY_UNIX_CONFORMANCE 0
532 # endif /* __LP64__ */
533 #endif /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
534
535 #if !defined(__DARWIN_UNIX03)
536 # if defined(KERNEL)
537 # define __DARWIN_UNIX03 0
538 # elif __DARWIN_ONLY_UNIX_CONFORMANCE
539 # if defined(_NONSTD_SOURCE)
540 # error "Can't define _NONSTD_SOURCE when only UNIX conformance is available."
541 # endif /* _NONSTD_SOURCE */
542 # define __DARWIN_UNIX03 1
543 # elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1040)
544 # define __DARWIN_UNIX03 0
545 # elif defined(_DARWIN_C_SOURCE) || defined(_XOPEN_SOURCE) || defined(_POSIX_C_SOURCE)
546 # if defined(_NONSTD_SOURCE)
547 # error "Can't define both _NONSTD_SOURCE and any of _DARWIN_C_SOURCE, _XOPEN_SOURCE or _POSIX_C_SOURCE."
548 # endif /* _NONSTD_SOURCE */
549 # define __DARWIN_UNIX03 1
550 # elif defined(_NONSTD_SOURCE)
551 # define __DARWIN_UNIX03 0
552 # else /* default */
553 # if defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050)
554 # define __DARWIN_UNIX03 0
555 # else /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
556 # define __DARWIN_UNIX03 1
557 # endif /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
558 # endif /* _DARWIN_C_SOURCE || _XOPEN_SOURCE || _POSIX_C_SOURCE || __LP64__ */
559 #endif /* !__DARWIN_UNIX03 */
560
561 #if !defined(__DARWIN_64_BIT_INO_T)
562 # if defined(KERNEL)
563 # define __DARWIN_64_BIT_INO_T 0
564 # elif defined(_DARWIN_USE_64_BIT_INODE)
565 # if defined(_DARWIN_NO_64_BIT_INODE)
566 # error "Can't define both _DARWIN_USE_64_BIT_INODE and _DARWIN_NO_64_BIT_INODE."
567 # endif /* _DARWIN_NO_64_BIT_INODE */
568 # define __DARWIN_64_BIT_INO_T 1
569 # elif defined(_DARWIN_NO_64_BIT_INODE)
570 # if __DARWIN_ONLY_64_BIT_INO_T
571 # error "Can't define _DARWIN_NO_64_BIT_INODE when only 64-bit inodes are available."
572 # endif /* __DARWIN_ONLY_64_BIT_INO_T */
573 # define __DARWIN_64_BIT_INO_T 0
574 # else /* default */
575 # if __DARWIN_ONLY_64_BIT_INO_T
576 # define __DARWIN_64_BIT_INO_T 1
577 # elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1060) || __DARWIN_UNIX03 == 0
578 # define __DARWIN_64_BIT_INO_T 0
579 # else /* default */
580 # define __DARWIN_64_BIT_INO_T 1
581 # endif /* __DARWIN_ONLY_64_BIT_INO_T */
582 # endif
583 #endif /* !__DARWIN_64_BIT_INO_T */
584
585 #if !defined(__DARWIN_VERS_1050)
586 # if defined(KERNEL)
587 # define __DARWIN_VERS_1050 0
588 # elif __DARWIN_ONLY_VERS_1050
589 # define __DARWIN_VERS_1050 1
590 # elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050) || __DARWIN_UNIX03 == 0
591 # define __DARWIN_VERS_1050 0
592 # else /* default */
593 # define __DARWIN_VERS_1050 1
594 # endif
595 #endif /* !__DARWIN_VERS_1050 */
596
597 #if !defined(__DARWIN_NON_CANCELABLE)
598 # if defined(KERNEL)
599 # define __DARWIN_NON_CANCELABLE 0
600 # else /* default */
601 # define __DARWIN_NON_CANCELABLE 0
602 # endif
603 #endif /* !__DARWIN_NON_CANCELABLE */
604
605 /*
606 * symbol suffixes used for symbol versioning
607 */
608 #if __DARWIN_UNIX03
609 # if __DARWIN_ONLY_UNIX_CONFORMANCE
610 # define __DARWIN_SUF_UNIX03 /* nothing */
611 # else /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
612 # define __DARWIN_SUF_UNIX03 "$UNIX2003"
613 # endif /* __DARWIN_ONLY_UNIX_CONFORMANCE */
614
615 # if __DARWIN_64_BIT_INO_T
616 # if __DARWIN_ONLY_64_BIT_INO_T
617 # define __DARWIN_SUF_64_BIT_INO_T /* nothing */
618 # else /* !__DARWIN_ONLY_64_BIT_INO_T */
619 # define __DARWIN_SUF_64_BIT_INO_T "$INODE64"
620 # endif /* __DARWIN_ONLY_64_BIT_INO_T */
621 # else /* !__DARWIN_64_BIT_INO_T */
622 # define __DARWIN_SUF_64_BIT_INO_T /* nothing */
623 # endif /* __DARWIN_64_BIT_INO_T */
624
625 # if __DARWIN_VERS_1050
626 # if __DARWIN_ONLY_VERS_1050
627 # define __DARWIN_SUF_1050 /* nothing */
628 # else /* !__DARWIN_ONLY_VERS_1050 */
629 # define __DARWIN_SUF_1050 "$1050"
630 # endif /* __DARWIN_ONLY_VERS_1050 */
631 # else /* !__DARWIN_VERS_1050 */
632 # define __DARWIN_SUF_1050 /* nothing */
633 # endif /* __DARWIN_VERS_1050 */
634
635 # if __DARWIN_NON_CANCELABLE
636 # define __DARWIN_SUF_NON_CANCELABLE "$NOCANCEL"
637 # else /* !__DARWIN_NON_CANCELABLE */
638 # define __DARWIN_SUF_NON_CANCELABLE /* nothing */
639 # endif /* __DARWIN_NON_CANCELABLE */
640
641 #else /* !__DARWIN_UNIX03 */
642 # define __DARWIN_SUF_UNIX03 /* nothing */
643 # define __DARWIN_SUF_64_BIT_INO_T /* nothing */
644 # define __DARWIN_SUF_NON_CANCELABLE /* nothing */
645 # define __DARWIN_SUF_1050 /* nothing */
646 #endif /* __DARWIN_UNIX03 */
647
648 #define __DARWIN_SUF_EXTSN "$DARWIN_EXTSN"
649
650 /*
651 * symbol versioning macros
652 */
653 #define __DARWIN_ALIAS(sym) __asm("_" __STRING(sym) __DARWIN_SUF_UNIX03)
654 #define __DARWIN_ALIAS_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
655 #define __DARWIN_ALIAS_I(sym) __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
656 #define __DARWIN_NOCANCEL(sym) __asm("_" __STRING(sym) __DARWIN_SUF_NON_CANCELABLE)
657 #define __DARWIN_INODE64(sym) __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T)
658
659 #define __DARWIN_1050(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050)
660 #define __DARWIN_1050ALIAS(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_UNIX03)
661 #define __DARWIN_1050ALIAS_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
662 #define __DARWIN_1050ALIAS_I(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
663 #define __DARWIN_1050INODE64(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T)
664
665 #define __DARWIN_EXTSN(sym) __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN)
666 #define __DARWIN_EXTSN_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN __DARWIN_SUF_NON_CANCELABLE)
667
668 /*
669 * symbol release macros
670 */
671 #ifdef KERNEL
672 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)
673 #else
674 #include <sys/_symbol_aliasing.h>
675
676 #if defined(__ENVIRONMENT_IPHONE_OS_VERSION_MIN_REQUIRED__)
677 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) __DARWIN_ALIAS_STARTING_IPHONE_##_iphone(x)
678 #elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__)
679 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) __DARWIN_ALIAS_STARTING_MAC_##_mac(x)
680 #else
681 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) x
682 #endif
683 #endif /* KERNEL */
684
685
686 /*
687 * POSIX.1 requires that the macros we test be defined before any standard
688 * header file is included. This permits us to convert values for feature
689 * testing, as necessary, using only _POSIX_C_SOURCE.
690 *
691 * Here's a quick run-down of the versions:
692 * defined(_POSIX_SOURCE) 1003.1-1988
693 * _POSIX_C_SOURCE == 1L 1003.1-1990
694 * _POSIX_C_SOURCE == 2L 1003.2-1992 C Language Binding Option
695 * _POSIX_C_SOURCE == 199309L 1003.1b-1993
696 * _POSIX_C_SOURCE == 199506L 1003.1c-1995, 1003.1i-1995,
697 * and the omnibus ISO/IEC 9945-1: 1996
698 * _POSIX_C_SOURCE == 200112L 1003.1-2001
699 * _POSIX_C_SOURCE == 200809L 1003.1-2008
700 *
701 * In addition, the X/Open Portability Guide, which is now the Single UNIX
702 * Specification, defines a feature-test macro which indicates the version of
703 * that specification, and which subsumes _POSIX_C_SOURCE.
704 */
705
706 /* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1L. */
707 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 1L
708 #undef _POSIX_C_SOURCE
709 #define _POSIX_C_SOURCE 199009L
710 #endif
711
712 /* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2L. */
713 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 2L
714 #undef _POSIX_C_SOURCE
715 #define _POSIX_C_SOURCE 199209L
716 #endif
717
718 /* Deal with various X/Open Portability Guides and Single UNIX Spec. */
719 #ifdef _XOPEN_SOURCE
720 #if _XOPEN_SOURCE - 0L >= 700L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200809L)
721 #undef _POSIX_C_SOURCE
722 #define _POSIX_C_SOURCE 200809L
723 #elif _XOPEN_SOURCE - 0L >= 600L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200112L)
724 #undef _POSIX_C_SOURCE
725 #define _POSIX_C_SOURCE 200112L
726 #elif _XOPEN_SOURCE - 0L >= 500L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 199506L)
727 #undef _POSIX_C_SOURCE
728 #define _POSIX_C_SOURCE 199506L
729 #endif
730 #endif
731
732 /*
733 * Deal with all versions of POSIX. The ordering relative to the tests above is
734 * important.
735 */
736 #if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE)
737 #define _POSIX_C_SOURCE 198808L
738 #endif
739
740 /* POSIX C deprecation macros */
741 #ifdef KERNEL
742 #define __POSIX_C_DEPRECATED(ver)
743 #else
744 #include <sys/_posix_availability.h>
745
746 #define __POSIX_C_DEPRECATED(ver) ___POSIX_C_DEPRECATED_STARTING_##ver
747 #endif
748
749 /*
750 * Set a single macro which will always be defined and can be used to determine
751 * the appropriate namespace. For POSIX, these values will correspond to
752 * _POSIX_C_SOURCE value. Currently there are two additional levels corresponding
753 * to ANSI (_ANSI_SOURCE) and Darwin extensions (_DARWIN_C_SOURCE)
754 */
755 #define __DARWIN_C_ANSI 010000L
756 #define __DARWIN_C_FULL 900000L
757
758 #if defined(_ANSI_SOURCE)
759 #define __DARWIN_C_LEVEL __DARWIN_C_ANSI
760 #elif defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE) && !defined(_NONSTD_SOURCE)
761 #define __DARWIN_C_LEVEL _POSIX_C_SOURCE
762 #else
763 #define __DARWIN_C_LEVEL __DARWIN_C_FULL
764 #endif
765
766 /* If the developer has neither requested a strict language mode nor a version
767 * of POSIX, turn on functionality provided by __STDC_WANT_LIB_EXT1__ as part
768 * of __DARWIN_C_FULL.
769 */
770 #if !defined(__STDC_WANT_LIB_EXT1__) && !defined(__STRICT_ANSI__) && __DARWIN_C_LEVEL >= __DARWIN_C_FULL
771 #define __STDC_WANT_LIB_EXT1__ 1
772 #endif
773
774 /*
775 * long long is not supported in c89 (__STRICT_ANSI__), but g++ -ansi and
776 * c99 still want long longs. While not perfect, we allow long longs for
777 * g++.
778 */
779 #define __DARWIN_NO_LONG_LONG (defined(__STRICT_ANSI__) \
780 && (__STDC_VERSION__-0 < 199901L) \
781 && !defined(__GNUG__))
782
783 /*****************************************
784 * Public darwin-specific feature macros
785 *****************************************/
786
787 /*
788 * _DARWIN_FEATURE_64_BIT_INODE indicates that the ino_t type is 64-bit, and
789 * structures modified for 64-bit inodes (like struct stat) will be used.
790 */
791 #if __DARWIN_64_BIT_INO_T
792 #define _DARWIN_FEATURE_64_BIT_INODE 1
793 #endif
794
795 /*
796 * _DARWIN_FEATURE_64_ONLY_BIT_INODE indicates that the ino_t type may only
797 * be 64-bit; there is no support for 32-bit ino_t when this macro is defined
798 * (and non-zero). There is no struct stat64 either, as the regular
799 * struct stat will already be the 64-bit version.
800 */
801 #if __DARWIN_ONLY_64_BIT_INO_T
802 #define _DARWIN_FEATURE_ONLY_64_BIT_INODE 1
803 #endif
804
805 /*
806 * _DARWIN_FEATURE_ONLY_VERS_1050 indicates that only those APIs updated
807 * in 10.5 exists; no pre-10.5 variants are available.
808 */
809 #if __DARWIN_ONLY_VERS_1050
810 #define _DARWIN_FEATURE_ONLY_VERS_1050 1
811 #endif
812
813 /*
814 * _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE indicates only UNIX conforming API
815 * are available (the legacy BSD APIs are not available)
816 */
817 #if __DARWIN_ONLY_UNIX_CONFORMANCE
818 #define _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE 1
819 #endif
820
821 /*
822 * _DARWIN_FEATURE_UNIX_CONFORMANCE indicates whether UNIX conformance is on,
823 * and specifies the conformance level (3 is SUSv3)
824 */
825 #if __DARWIN_UNIX03
826 #define _DARWIN_FEATURE_UNIX_CONFORMANCE 3
827 #endif
828
829 /*
830 * This macro casts away the qualifier from the variable
831 *
832 * Note: use at your own risk, removing qualifiers can result in
833 * catastrophic run-time failures.
834 */
835 #ifndef __CAST_AWAY_QUALIFIER
836 #define __CAST_AWAY_QUALIFIER(variable, qualifier, type) (type) (long)(variable)
837 #endif
838
839 /*
840 * __XNU_PRIVATE_EXTERN is a linkage decoration indicating that a symbol can be
841 * used from other compilation units, but not other libraries or executables.
842 */
843 #ifndef __XNU_PRIVATE_EXTERN
844 #define __XNU_PRIVATE_EXTERN __attribute__((visibility("hidden")))
845 #endif
846
847 /*
848 * Architecture validation for current SDK
849 */
850 #if !defined(__sys_cdefs_arch_unknown__) && defined(__i386__)
851 #elif !defined(__sys_cdefs_arch_unknown__) && defined(__x86_64__)
852 #else
853 #error Unsupported architecture
854 #endif
855
856 #ifdef XNU_KERNEL_PRIVATE
857 /*
858 * Selectively ignore cast alignment warnings
859 */
860 #define __IGNORE_WCASTALIGN(x) _Pragma("clang diagnostic push") \
861 _Pragma("clang diagnostic ignored \"-Wcast-align\"") \
862 x; \
863 _Pragma("clang diagnostic pop")
864 #endif
865
866 #endif /* !_CDEFS_H_ */