]> git.saurik.com Git - apple/xnu.git/blame - bsd/sys/cdefs.h
xnu-4570.31.3.tar.gz
[apple/xnu.git] / bsd / sys / cdefs.h
CommitLineData
1c79356b 1/*
39037602 2 * Copyright (c) 2000-2016 Apple Inc. All rights reserved.
5d5c5d0d 3 *
2d21ac55 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
1c79356b 5 *
2d21ac55
A
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
8f6c56a5 14 *
2d21ac55
A
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
8f6c56a5
A
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55
A
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.
8f6c56a5 25 *
2d21ac55 26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b
A
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
316670eb
A
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
3e170ce0
A
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
1c79356b
A
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
316670eb
A
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.
1c79356b 160 */
316670eb
A
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
39236c6e
A
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.
316670eb
A
175 */
176#define __deprecated __attribute__((deprecated))
177
3e170ce0
A
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)))
39236c6e 181#else
3e170ce0 182 #define __deprecated_msg(_msg) __attribute__((deprecated))
39236c6e
A
183#endif
184
3e170ce0
A
185#if __has_extension(enumerator_attributes)
186 #define __deprecated_enum_msg(_msg) __deprecated_msg(_msg)
39236c6e 187#else
3e170ce0 188 #define __deprecated_enum_msg(_msg)
39236c6e
A
189#endif
190
316670eb
A
191/* __unavailable causes the compiler to error out when encountering
192 * code using the tagged function of variable.
193 */
194#define __unavailable __attribute__((unavailable))
1c79356b
A
195
196/* Delete pseudo-keywords wherever they are not available or needed. */
197#ifndef __dead
198#define __dead
199#define __pure
200#endif
6d2010ae 201
91447636 202/*
316670eb
A
203 * We use `__restrict' as a way to define the `restrict' type qualifier
204 * without disturbing older software that is unaware of C99 keywords.
91447636 205 */
91447636
A
206#if __STDC_VERSION__ < 199901
207#define __restrict
208#else
209#define __restrict restrict
210#endif
91447636 211
3e170ce0
A
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
39037602
A
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)
3e170ce0
A
278#endif
279
39236c6e
A
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
15129b1c
A
296#if defined(__cplusplus) || \
297 (__STDC_VERSION__ >= 199901L && \
298 !defined(__GNUC_GNU_INLINE__) && \
299 (!defined(__GNUC__) || defined(__clang__)))
39236c6e
A
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
fe8ab488
A
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
91447636
A
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 */
91447636
A
350#define __printflike(fmtarg, firstvararg) \
351 __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
39037602
A
352#define __printf0like(fmtarg, firstvararg) \
353 __attribute__((__format__ (__printf0__, fmtarg, firstvararg)))
91447636
A
354#define __scanflike(fmtarg, firstvararg) \
355 __attribute__((__format__ (__scanf__, fmtarg, firstvararg)))
91447636 356
6d2010ae 357#define __IDSTRING(name,string) static const char name[] __used = string
1c79356b
A
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
316670eb
A
375/* Source compatibility only, ID string not emitted in object file */
376#ifndef __FBSDID
377#define __FBSDID(s)
378#endif
379
39236c6e
A
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
316670eb 391
91447636 392/*
6d2010ae 393 * COMPILATION ENVIRONMENTS -- see compat(5) for additional detail
2d21ac55
A
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
b0d623f7 399 * behavioral differences between 32 and 64 bit code.
2d21ac55
A
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.
91447636 413 *
2d21ac55
A
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
b0d623f7 424 * tools users add either the "-Wall" or "-Wimplicit-function-declaration"
2d21ac55
A
425 * compiler flags to their projects to be warned when a function is being
426 * used without a prototype in scope.
427 */
428
593a1d5f
A
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
fe8ab488
A
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
593a1d5f 440#else /* !KERNEL */
6d2010ae
A
441#ifdef PLATFORM_iPhoneOS
442/* Platform: iPhoneOS */
593a1d5f
A
443#define __DARWIN_ONLY_64_BIT_INO_T 1
444#define __DARWIN_ONLY_UNIX_CONFORMANCE 1
445#define __DARWIN_ONLY_VERS_1050 1
6d2010ae
A
446#endif /* PLATFORM_iPhoneOS */
447#ifdef PLATFORM_iPhoneSimulator
448/* Platform: iPhoneSimulator */
593a1d5f
A
449#define __DARWIN_ONLY_64_BIT_INO_T 1
450#define __DARWIN_ONLY_UNIX_CONFORMANCE 1
451#define __DARWIN_ONLY_VERS_1050 1
6d2010ae 452#endif /* PLATFORM_iPhoneSimulator */
3e170ce0
A
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 */
fe8ab488
A
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 */
3e170ce0
A
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 */
5ba3f43e
A
501#ifdef PLATFORM_BridgeOS
502/* Platform: BridgeOS */
503#define __DARWIN_ONLY_64_BIT_INO_T 1
504#define __DARWIN_ONLY_UNIX_CONFORMANCE 1
505#define __DARWIN_ONLY_VERS_1050 1
506#endif /* PLATFORM_BridgeOS */
6d2010ae
A
507#ifdef PLATFORM_MacOSX
508/* Platform: MacOSX */
593a1d5f
A
509#define __DARWIN_ONLY_64_BIT_INO_T 0
510/* #undef __DARWIN_ONLY_UNIX_CONFORMANCE (automatically set for 64-bit) */
511#define __DARWIN_ONLY_VERS_1050 0
6d2010ae 512#endif /* PLATFORM_MacOSX */
593a1d5f
A
513#endif /* KERNEL */
514
2d21ac55
A
515/*
516 * The __DARWIN_ALIAS macros are used to do symbol renaming; they allow
b0d623f7 517 * legacy code to use the old symbol, thus maintaining binary compatibility
2d21ac55 518 * while new code can use a standards compliant version of the same function.
91447636
A
519 *
520 * __DARWIN_ALIAS is used by itself if the function signature has not
521 * changed, it is used along with a #ifdef check for __DARWIN_UNIX03
b0d623f7
A
522 * if the signature has changed. Because the __LP64__ environment
523 * only supports UNIX03 semantics it causes __DARWIN_UNIX03 to be
91447636 524 * defined, but causes __DARWIN_ALIAS to do no symbol mangling.
2d21ac55
A
525 *
526 * As a special case, when XCode is used to target a specific version of the
527 * OS, the manifest constant __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__
528 * will be defined by the compiler, with the digits representing major version
b0d623f7 529 * time 100 + minor version times 10 (e.g. 10.5 := 1050). If we are targeting
2d21ac55
A
530 * pre-10.5, and it is the default compilation environment, revert the
531 * compilation environment to pre-__DARWIN_UNIX03.
91447636 532 */
593a1d5f
A
533#if !defined(__DARWIN_ONLY_UNIX_CONFORMANCE)
534# if defined(__LP64__)
535# define __DARWIN_ONLY_UNIX_CONFORMANCE 1
536# else /* !__LP64__ */
537# define __DARWIN_ONLY_UNIX_CONFORMANCE 0
538# endif /* __LP64__ */
539#endif /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
540
91447636 541#if !defined(__DARWIN_UNIX03)
593a1d5f
A
542# if defined(KERNEL)
543# define __DARWIN_UNIX03 0
544# elif __DARWIN_ONLY_UNIX_CONFORMANCE
2d21ac55 545# if defined(_NONSTD_SOURCE)
593a1d5f 546# error "Can't define _NONSTD_SOURCE when only UNIX conformance is available."
2d21ac55
A
547# endif /* _NONSTD_SOURCE */
548# define __DARWIN_UNIX03 1
6d2010ae
A
549# elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1040)
550# define __DARWIN_UNIX03 0
593a1d5f
A
551# elif defined(_DARWIN_C_SOURCE) || defined(_XOPEN_SOURCE) || defined(_POSIX_C_SOURCE)
552# if defined(_NONSTD_SOURCE)
553# error "Can't define both _NONSTD_SOURCE and any of _DARWIN_C_SOURCE, _XOPEN_SOURCE or _POSIX_C_SOURCE."
554# endif /* _NONSTD_SOURCE */
555# define __DARWIN_UNIX03 1
556# elif defined(_NONSTD_SOURCE)
2d21ac55
A
557# define __DARWIN_UNIX03 0
558# else /* default */
559# if defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050)
560# define __DARWIN_UNIX03 0
561# else /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
562# define __DARWIN_UNIX03 1
563# endif /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
564# endif /* _DARWIN_C_SOURCE || _XOPEN_SOURCE || _POSIX_C_SOURCE || __LP64__ */
91447636
A
565#endif /* !__DARWIN_UNIX03 */
566
2d21ac55 567#if !defined(__DARWIN_64_BIT_INO_T)
593a1d5f
A
568# if defined(KERNEL)
569# define __DARWIN_64_BIT_INO_T 0
570# elif defined(_DARWIN_USE_64_BIT_INODE)
571# if defined(_DARWIN_NO_64_BIT_INODE)
572# error "Can't define both _DARWIN_USE_64_BIT_INODE and _DARWIN_NO_64_BIT_INODE."
573# endif /* _DARWIN_NO_64_BIT_INODE */
2d21ac55 574# define __DARWIN_64_BIT_INO_T 1
593a1d5f
A
575# elif defined(_DARWIN_NO_64_BIT_INODE)
576# if __DARWIN_ONLY_64_BIT_INO_T
577# error "Can't define _DARWIN_NO_64_BIT_INODE when only 64-bit inodes are available."
578# endif /* __DARWIN_ONLY_64_BIT_INO_T */
2d21ac55
A
579# define __DARWIN_64_BIT_INO_T 0
580# else /* default */
593a1d5f
A
581# if __DARWIN_ONLY_64_BIT_INO_T
582# define __DARWIN_64_BIT_INO_T 1
b0d623f7 583# elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1060) || __DARWIN_UNIX03 == 0
593a1d5f 584# define __DARWIN_64_BIT_INO_T 0
b0d623f7
A
585# else /* default */
586# define __DARWIN_64_BIT_INO_T 1
593a1d5f 587# endif /* __DARWIN_ONLY_64_BIT_INO_T */
2d21ac55
A
588# endif
589#endif /* !__DARWIN_64_BIT_INO_T */
590
593a1d5f 591#if !defined(__DARWIN_VERS_1050)
2d21ac55 592# if defined(KERNEL)
593a1d5f
A
593# define __DARWIN_VERS_1050 0
594# elif __DARWIN_ONLY_VERS_1050
595# define __DARWIN_VERS_1050 1
b0d623f7 596# elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050) || __DARWIN_UNIX03 == 0
593a1d5f 597# define __DARWIN_VERS_1050 0
b0d623f7
A
598# else /* default */
599# define __DARWIN_VERS_1050 1
2d21ac55 600# endif
593a1d5f 601#endif /* !__DARWIN_VERS_1050 */
2d21ac55 602
593a1d5f
A
603#if !defined(__DARWIN_NON_CANCELABLE)
604# if defined(KERNEL)
605# define __DARWIN_NON_CANCELABLE 0
2d21ac55 606# else /* default */
593a1d5f 607# define __DARWIN_NON_CANCELABLE 0
2d21ac55
A
608# endif
609#endif /* !__DARWIN_NON_CANCELABLE */
610
611/*
612 * symbol suffixes used for symbol versioning
613 */
614#if __DARWIN_UNIX03
593a1d5f 615# if __DARWIN_ONLY_UNIX_CONFORMANCE
2d21ac55 616# define __DARWIN_SUF_UNIX03 /* nothing */
593a1d5f
A
617# else /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
618# define __DARWIN_SUF_UNIX03 "$UNIX2003"
619# endif /* __DARWIN_ONLY_UNIX_CONFORMANCE */
2d21ac55
A
620
621# if __DARWIN_64_BIT_INO_T
593a1d5f
A
622# if __DARWIN_ONLY_64_BIT_INO_T
623# define __DARWIN_SUF_64_BIT_INO_T /* nothing */
624# else /* !__DARWIN_ONLY_64_BIT_INO_T */
625# define __DARWIN_SUF_64_BIT_INO_T "$INODE64"
626# endif /* __DARWIN_ONLY_64_BIT_INO_T */
2d21ac55
A
627# else /* !__DARWIN_64_BIT_INO_T */
628# define __DARWIN_SUF_64_BIT_INO_T /* nothing */
593a1d5f
A
629# endif /* __DARWIN_64_BIT_INO_T */
630
631# if __DARWIN_VERS_1050
632# if __DARWIN_ONLY_VERS_1050
633# define __DARWIN_SUF_1050 /* nothing */
634# else /* !__DARWIN_ONLY_VERS_1050 */
635# define __DARWIN_SUF_1050 "$1050"
636# endif /* __DARWIN_ONLY_VERS_1050 */
637# else /* !__DARWIN_VERS_1050 */
638# define __DARWIN_SUF_1050 /* nothing */
639# endif /* __DARWIN_VERS_1050 */
2d21ac55
A
640
641# if __DARWIN_NON_CANCELABLE
642# define __DARWIN_SUF_NON_CANCELABLE "$NOCANCEL"
643# else /* !__DARWIN_NON_CANCELABLE */
644# define __DARWIN_SUF_NON_CANCELABLE /* nothing */
645# endif /* __DARWIN_NON_CANCELABLE */
646
2d21ac55
A
647#else /* !__DARWIN_UNIX03 */
648# define __DARWIN_SUF_UNIX03 /* nothing */
2d21ac55
A
649# define __DARWIN_SUF_64_BIT_INO_T /* nothing */
650# define __DARWIN_SUF_NON_CANCELABLE /* nothing */
651# define __DARWIN_SUF_1050 /* nothing */
652#endif /* __DARWIN_UNIX03 */
653
654#define __DARWIN_SUF_EXTSN "$DARWIN_EXTSN"
655
656/*
657 * symbol versioning macros
658 */
659#define __DARWIN_ALIAS(sym) __asm("_" __STRING(sym) __DARWIN_SUF_UNIX03)
660#define __DARWIN_ALIAS_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
661#define __DARWIN_ALIAS_I(sym) __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
fe8ab488 662#define __DARWIN_NOCANCEL(sym) __asm("_" __STRING(sym) __DARWIN_SUF_NON_CANCELABLE)
2d21ac55
A
663#define __DARWIN_INODE64(sym) __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T)
664
665#define __DARWIN_1050(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050)
666#define __DARWIN_1050ALIAS(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_UNIX03)
667#define __DARWIN_1050ALIAS_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
668#define __DARWIN_1050ALIAS_I(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
669#define __DARWIN_1050INODE64(sym) __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T)
670
671#define __DARWIN_EXTSN(sym) __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN)
672#define __DARWIN_EXTSN_C(sym) __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN __DARWIN_SUF_NON_CANCELABLE)
91447636 673
b0d623f7
A
674/*
675 * symbol release macros
676 */
6d2010ae
A
677#ifdef KERNEL
678#define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)
679#else
680#include <sys/_symbol_aliasing.h>
681
316670eb 682#if defined(__ENVIRONMENT_IPHONE_OS_VERSION_MIN_REQUIRED__)
6d2010ae
A
683#define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) __DARWIN_ALIAS_STARTING_IPHONE_##_iphone(x)
684#elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__)
685#define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) __DARWIN_ALIAS_STARTING_MAC_##_mac(x)
686#else
3e170ce0 687#define __DARWIN_ALIAS_STARTING(_mac, _iphone, x) x
b0d623f7 688#endif
6d2010ae 689#endif /* KERNEL */
b0d623f7 690
91447636
A
691
692/*
693 * POSIX.1 requires that the macros we test be defined before any standard
694 * header file is included. This permits us to convert values for feature
695 * testing, as necessary, using only _POSIX_C_SOURCE.
696 *
697 * Here's a quick run-down of the versions:
698 * defined(_POSIX_SOURCE) 1003.1-1988
699 * _POSIX_C_SOURCE == 1L 1003.1-1990
700 * _POSIX_C_SOURCE == 2L 1003.2-1992 C Language Binding Option
701 * _POSIX_C_SOURCE == 199309L 1003.1b-1993
702 * _POSIX_C_SOURCE == 199506L 1003.1c-1995, 1003.1i-1995,
703 * and the omnibus ISO/IEC 9945-1: 1996
704 * _POSIX_C_SOURCE == 200112L 1003.1-2001
6d2010ae 705 * _POSIX_C_SOURCE == 200809L 1003.1-2008
91447636
A
706 *
707 * In addition, the X/Open Portability Guide, which is now the Single UNIX
708 * Specification, defines a feature-test macro which indicates the version of
709 * that specification, and which subsumes _POSIX_C_SOURCE.
710 */
711
712/* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1L. */
713#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 1L
714#undef _POSIX_C_SOURCE
715#define _POSIX_C_SOURCE 199009L
716#endif
717
718/* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2L. */
719#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 2L
720#undef _POSIX_C_SOURCE
721#define _POSIX_C_SOURCE 199209L
722#endif
723
724/* Deal with various X/Open Portability Guides and Single UNIX Spec. */
725#ifdef _XOPEN_SOURCE
6d2010ae
A
726#if _XOPEN_SOURCE - 0L >= 700L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200809L)
727#undef _POSIX_C_SOURCE
728#define _POSIX_C_SOURCE 200809L
729#elif _XOPEN_SOURCE - 0L >= 600L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200112L)
91447636
A
730#undef _POSIX_C_SOURCE
731#define _POSIX_C_SOURCE 200112L
6d2010ae 732#elif _XOPEN_SOURCE - 0L >= 500L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 199506L)
91447636
A
733#undef _POSIX_C_SOURCE
734#define _POSIX_C_SOURCE 199506L
735#endif
736#endif
737
738/*
739 * Deal with all versions of POSIX. The ordering relative to the tests above is
740 * important.
741 */
742#if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE)
743#define _POSIX_C_SOURCE 198808L
744#endif
745
6d2010ae
A
746/* POSIX C deprecation macros */
747#ifdef KERNEL
748#define __POSIX_C_DEPRECATED(ver)
749#else
750#include <sys/_posix_availability.h>
751
752#define __POSIX_C_DEPRECATED(ver) ___POSIX_C_DEPRECATED_STARTING_##ver
753#endif
754
755/*
756 * Set a single macro which will always be defined and can be used to determine
757 * the appropriate namespace. For POSIX, these values will correspond to
758 * _POSIX_C_SOURCE value. Currently there are two additional levels corresponding
759 * to ANSI (_ANSI_SOURCE) and Darwin extensions (_DARWIN_C_SOURCE)
760 */
761#define __DARWIN_C_ANSI 010000L
762#define __DARWIN_C_FULL 900000L
763
764#if defined(_ANSI_SOURCE)
765#define __DARWIN_C_LEVEL __DARWIN_C_ANSI
766#elif defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE) && !defined(_NONSTD_SOURCE)
767#define __DARWIN_C_LEVEL _POSIX_C_SOURCE
768#else
769#define __DARWIN_C_LEVEL __DARWIN_C_FULL
770#endif
771
39236c6e
A
772/* If the developer has neither requested a strict language mode nor a version
773 * of POSIX, turn on functionality provided by __STDC_WANT_LIB_EXT1__ as part
774 * of __DARWIN_C_FULL.
775 */
776#if !defined(__STDC_WANT_LIB_EXT1__) && !defined(__STRICT_ANSI__) && __DARWIN_C_LEVEL >= __DARWIN_C_FULL
777#define __STDC_WANT_LIB_EXT1__ 1
778#endif
6d2010ae 779
91447636
A
780/*
781 * long long is not supported in c89 (__STRICT_ANSI__), but g++ -ansi and
782 * c99 still want long longs. While not perfect, we allow long longs for
783 * g++.
784 */
785#define __DARWIN_NO_LONG_LONG (defined(__STRICT_ANSI__) \
786 && (__STDC_VERSION__-0 < 199901L) \
787 && !defined(__GNUG__))
788
2d21ac55
A
789/*****************************************
790 * Public darwin-specific feature macros
791 *****************************************/
792
593a1d5f
A
793/*
794 * _DARWIN_FEATURE_64_BIT_INODE indicates that the ino_t type is 64-bit, and
795 * structures modified for 64-bit inodes (like struct stat) will be used.
796 */
797#if __DARWIN_64_BIT_INO_T
798#define _DARWIN_FEATURE_64_BIT_INODE 1
799#endif
800
2d21ac55 801/*
593a1d5f
A
802 * _DARWIN_FEATURE_64_ONLY_BIT_INODE indicates that the ino_t type may only
803 * be 64-bit; there is no support for 32-bit ino_t when this macro is defined
804 * (and non-zero). There is no struct stat64 either, as the regular
805 * struct stat will already be the 64-bit version.
2d21ac55 806 */
593a1d5f
A
807#if __DARWIN_ONLY_64_BIT_INO_T
808#define _DARWIN_FEATURE_ONLY_64_BIT_INODE 1
2d21ac55
A
809#endif
810
811/*
593a1d5f
A
812 * _DARWIN_FEATURE_ONLY_VERS_1050 indicates that only those APIs updated
813 * in 10.5 exists; no pre-10.5 variants are available.
2d21ac55 814 */
593a1d5f
A
815#if __DARWIN_ONLY_VERS_1050
816#define _DARWIN_FEATURE_ONLY_VERS_1050 1
817#endif
818
819/*
820 * _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE indicates only UNIX conforming API
821 * are available (the legacy BSD APIs are not available)
822 */
823#if __DARWIN_ONLY_UNIX_CONFORMANCE
824#define _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE 1
825#endif
826
827/*
828 * _DARWIN_FEATURE_UNIX_CONFORMANCE indicates whether UNIX conformance is on,
829 * and specifies the conformance level (3 is SUSv3)
830 */
831#if __DARWIN_UNIX03
832#define _DARWIN_FEATURE_UNIX_CONFORMANCE 3
2d21ac55
A
833#endif
834
b0d623f7
A
835/*
836 * This macro casts away the qualifier from the variable
837 *
838 * Note: use at your own risk, removing qualifiers can result in
839 * catastrophic run-time failures.
840 */
841#ifndef __CAST_AWAY_QUALIFIER
6d2010ae 842#define __CAST_AWAY_QUALIFIER(variable, qualifier, type) (type) (long)(variable)
b0d623f7
A
843#endif
844
39236c6e
A
845/*
846 * __XNU_PRIVATE_EXTERN is a linkage decoration indicating that a symbol can be
847 * used from other compilation units, but not other libraries or executables.
848 */
849#ifndef __XNU_PRIVATE_EXTERN
850#define __XNU_PRIVATE_EXTERN __attribute__((visibility("hidden")))
851#endif
852
853/*
854 * Architecture validation for current SDK
855 */
856#if !defined(__sys_cdefs_arch_unknown__) && defined(__i386__)
857#elif !defined(__sys_cdefs_arch_unknown__) && defined(__x86_64__)
5ba3f43e
A
858#elif !defined(__sys_cdefs_arch_unknown__) && defined(__arm__)
859#elif !defined(__sys_cdefs_arch_unknown__) && defined(__arm64__)
39236c6e
A
860#else
861#error Unsupported architecture
862#endif
863
3e170ce0
A
864#ifdef XNU_KERNEL_PRIVATE
865/*
866 * Selectively ignore cast alignment warnings
867 */
868#define __IGNORE_WCASTALIGN(x) _Pragma("clang diagnostic push") \
869 _Pragma("clang diagnostic ignored \"-Wcast-align\"") \
870 x; \
871 _Pragma("clang diagnostic pop")
872#endif
873
1c79356b 874#endif /* !_CDEFS_H_ */