bsd/sys/cdefs.h

   1 /*
   2  * Copyright (c) 2000-2009 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  * The __CONCAT macro is used to concatenate parts of symbol names, e.g.
  86  * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo.
  87  * The __CONCAT macro is a bit tricky -- make sure you don't put spaces
  88  * in between its arguments.  __CONCAT can also concatenate double-quoted
  89  * strings produced by the __STRING macro, but this only works with ANSI C.
  90  */
  91 #if defined(__STDC__) || defined(__cplusplus)
  92 #define __P(protos)     protos          /* full-blown ANSI C */
  93 #define __CONCAT(x,y)   x ## y
  94 #define __STRING(x)     #x
  95
  96 #define __const         const           /* define reserved names to standard */
  97 #define __signed        signed
  98 #define __volatile      volatile
  99 #if defined(__cplusplus)
 100 #define __inline        inline          /* convert to C++ keyword */
 101 #else
 102 #ifndef __GNUC__
 103 #define __inline                        /* delete GCC keyword */
 104 #endif /* !__GNUC__ */
 105 #endif /* !__cplusplus */
 106
 107 #else   /* !(__STDC__ || __cplusplus) */
 108 #define __P(protos)     ()              /* traditional C preprocessor */
 109 #define __CONCAT(x,y)   x/**/y
 110 #define __STRING(x)     "x"
 111
 112 #ifndef __GNUC__
 113 #define __const                         /* delete pseudo-ANSI C keywords */
 114 #define __inline
 115 #define __signed
 116 #define __volatile
 117 #endif  /* !__GNUC__ */
 118
 119 /*
 120  * In non-ANSI C environments, new programs will want ANSI-only C keywords
 121  * deleted from the program and old programs will want them left alone.
 122  * When using a compiler other than gcc, programs using the ANSI C keywords
 123  * const, inline etc. as normal identifiers should define -DNO_ANSI_KEYWORDS.
 124  * When using "gcc -traditional", we assume that this is the intent; if
 125  * __GNUC__ is defined but __STDC__ is not, we leave the new keywords alone.
 126  */
 127 #ifndef NO_ANSI_KEYWORDS
 128 #define const           __const                 /* convert ANSI C keywords */
 129 #define inline          __inline
 130 #define signed          __signed
 131 #define volatile        __volatile
 132 #endif /* !NO_ANSI_KEYWORDS */
 133 #endif /* !(__STDC__ || __cplusplus) */
 134
 135 #define __dead2         __attribute__((noreturn))
 136 #define __pure2         __attribute__((const))
 137
 138 /* __unused denotes variables and functions that may not be used, preventing
 139  * the compiler from warning about it if not used.
 140  */
 141 #define __unused        __attribute__((unused))
 142
 143 /* __used forces variables and functions to be included even if it appears
 144  * to the compiler that they are not used (and would thust be discarded).
 145  */
 146 #define __used          __attribute__((used))
 147
 148 /* __deprecated causes the compiler to produce a warning when encountering
 149  * code using the deprecated functionality.  This may require turning on
 150  * such wardning with the -Wdeprecated flag.
 151  */
 152 #define __deprecated    __attribute__((deprecated))
 153
 154 /* __unavailable causes the compiler to error out when encountering
 155  * code using the tagged function of variable.
 156  */
 157 #define __unavailable   __attribute__((unavailable))
 158
 159 /* Delete pseudo-keywords wherever they are not available or needed. */
 160 #ifndef __dead
 161 #define __dead
 162 #define __pure
 163 #endif
 164
 165 /*
 166  * We use `__restrict' as a way to define the `restrict' type qualifier
 167  * without disturbing older software that is unaware of C99 keywords.
 168  */
 169 #if __STDC_VERSION__ < 199901
 170 #define __restrict
 171 #else
 172 #define __restrict      restrict
 173 #endif
 174
 175 /*
 176  * Compiler-dependent macros to declare that functions take printf-like
 177  * or scanf-like arguments.  They are null except for versions of gcc
 178  * that are known to support the features properly.  Functions declared
 179  * with these attributes will cause compilation warnings if there is a
 180  * mismatch between the format string and subsequent function parameter
 181  * types.
 182  */
 183 #define __printflike(fmtarg, firstvararg) \
 184                 __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
 185 #define __scanflike(fmtarg, firstvararg) \
 186                 __attribute__((__format__ (__scanf__, fmtarg, firstvararg)))
 187
 188 #define __IDSTRING(name,string) static const char name[] __used = string
 189
 190 #ifndef __COPYRIGHT
 191 #define __COPYRIGHT(s) __IDSTRING(copyright,s)
 192 #endif
 193
 194 #ifndef __RCSID
 195 #define __RCSID(s) __IDSTRING(rcsid,s)
 196 #endif
 197
 198 #ifndef __SCCSID
 199 #define __SCCSID(s) __IDSTRING(sccsid,s)
 200 #endif
 201
 202 #ifndef __PROJECT_VERSION
 203 #define __PROJECT_VERSION(s) __IDSTRING(project_version,s)
 204 #endif
 205
 206 /* Source compatibility only, ID string not emitted in object file */
 207 #ifndef __FBSDID
 208 #define __FBSDID(s)
 209 #endif
 210
 211
 212 /*
 213  * COMPILATION ENVIRONMENTS -- see compat(5) for additional detail
 214  *
 215  * DEFAULT      By default newly complied code will get POSIX APIs plus
 216  *              Apple API extensions in scope.
 217  *
 218  *              Most users will use this compilation environment to avoid
 219  *              behavioral differences between 32 and 64 bit code.
 220  *
 221  * LEGACY       Defining _NONSTD_SOURCE will get pre-POSIX APIs plus Apple
 222  *              API extensions in scope.
 223  *
 224  *              This is generally equivalent to the Tiger release compilation
 225  *              environment, except that it cannot be applied to 64 bit code;
 226  *              its use is discouraged.
 227  *
 228  *              We expect this environment to be deprecated in the future.
 229  *
 230  * STRICT       Defining _POSIX_C_SOURCE or _XOPEN_SOURCE restricts the
 231  *              available APIs to exactly the set of APIs defined by the
 232  *              corresponding standard, based on the value defined.
 233  *
 234  *              A correct, portable definition for _POSIX_C_SOURCE is 200112L.
 235  *              A correct, portable definition for _XOPEN_SOURCE is 600L.
 236  *
 237  *              Apple API extensions are not visible in this environment,
 238  *              which can cause Apple specific code to fail to compile,
 239  *              or behave incorrectly if prototypes are not in scope or
 240  *              warnings about missing prototypes are not enabled or ignored.
 241  *
 242  * In any compilation environment, for correct symbol resolution to occur,
 243  * function prototypes must be in scope.  It is recommended that all Apple
 244  * tools users add either the "-Wall" or "-Wimplicit-function-declaration"
 245  * compiler flags to their projects to be warned when a function is being
 246  * used without a prototype in scope.
 247  */
 248
 249 /* These settings are particular to each product. */
 250 #ifdef KERNEL
 251 #define __DARWIN_ONLY_64_BIT_INO_T      0
 252 #define __DARWIN_ONLY_UNIX_CONFORMANCE  0
 253 #define __DARWIN_ONLY_VERS_1050         0
 254 #define __DARWIN_SUF_DARWIN10   "_darwin10"
 255 #define __DARWIN10_ALIAS(sym)   __asm("_" __STRING(sym) __DARWIN_SUF_DARWIN10)
 256 #else /* !KERNEL */
 257 #ifdef PLATFORM_iPhoneOS
 258 /* Platform: iPhoneOS */
 259 #define __DARWIN_ONLY_64_BIT_INO_T      1
 260 #define __DARWIN_ONLY_UNIX_CONFORMANCE  1
 261 #define __DARWIN_ONLY_VERS_1050         1
 262 #endif /* PLATFORM_iPhoneOS */
 263 #ifdef PLATFORM_iPhoneSimulator
 264 /* Platform: iPhoneSimulator */
 265 #define __DARWIN_ONLY_64_BIT_INO_T      1
 266 #define __DARWIN_ONLY_UNIX_CONFORMANCE  1
 267 #define __DARWIN_ONLY_VERS_1050         1
 268 #endif /* PLATFORM_iPhoneSimulator */
 269 #ifdef PLATFORM_MacOSX
 270 /* Platform: MacOSX */
 271 #define __DARWIN_ONLY_64_BIT_INO_T      0
 272 /* #undef __DARWIN_ONLY_UNIX_CONFORMANCE (automatically set for 64-bit) */
 273 #define __DARWIN_ONLY_VERS_1050         0
 274 #endif /* PLATFORM_MacOSX */
 275 #endif /* KERNEL */
 276
 277 /*
 278  * The __DARWIN_ALIAS macros are used to do symbol renaming; they allow
 279  * legacy code to use the old symbol, thus maintaining binary compatibility
 280  * while new code can use a standards compliant version of the same function.
 281  *
 282  * __DARWIN_ALIAS is used by itself if the function signature has not
 283  * changed, it is used along with a #ifdef check for __DARWIN_UNIX03
 284  * if the signature has changed.  Because the __LP64__ environment
 285  * only supports UNIX03 semantics it causes __DARWIN_UNIX03 to be
 286  * defined, but causes __DARWIN_ALIAS to do no symbol mangling.
 287  *
 288  * As a special case, when XCode is used to target a specific version of the
 289  * OS, the manifest constant __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__
 290  * will be defined by the compiler, with the digits representing major version
 291  * time 100 + minor version times 10 (e.g. 10.5 := 1050).  If we are targeting
 292  * pre-10.5, and it is the default compilation environment, revert the
 293  * compilation environment to pre-__DARWIN_UNIX03.
 294  */
 295 #if !defined(__DARWIN_ONLY_UNIX_CONFORMANCE)
 296 #  if defined(__LP64__)
 297 #    define __DARWIN_ONLY_UNIX_CONFORMANCE 1
 298 #  else /* !__LP64__ */
 299 #    define __DARWIN_ONLY_UNIX_CONFORMANCE 0
 300 #  endif /* __LP64__ */
 301 #endif /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
 302
 303 #if !defined(__DARWIN_UNIX03)
 304 #  if defined(KERNEL)
 305 #    define __DARWIN_UNIX03     0
 306 #  elif __DARWIN_ONLY_UNIX_CONFORMANCE
 307 #    if defined(_NONSTD_SOURCE)
 308 #      error "Can't define _NONSTD_SOURCE when only UNIX conformance is available."
 309 #    endif /* _NONSTD_SOURCE */
 310 #    define __DARWIN_UNIX03     1
 311 #  elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1040)
 312 #    define __DARWIN_UNIX03     0
 313 #  elif defined(_DARWIN_C_SOURCE) || defined(_XOPEN_SOURCE) || defined(_POSIX_C_SOURCE)
 314 #    if defined(_NONSTD_SOURCE)
 315 #      error "Can't define both _NONSTD_SOURCE and any of _DARWIN_C_SOURCE, _XOPEN_SOURCE or _POSIX_C_SOURCE."
 316 #    endif /* _NONSTD_SOURCE */
 317 #    define __DARWIN_UNIX03     1
 318 #  elif defined(_NONSTD_SOURCE)
 319 #    define __DARWIN_UNIX03     0
 320 #  else /* default */
 321 #    if defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050)
 322 #      define __DARWIN_UNIX03   0
 323 #    else /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
 324 #      define __DARWIN_UNIX03   1
 325 #    endif /* __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050 */
 326 #  endif /* _DARWIN_C_SOURCE || _XOPEN_SOURCE || _POSIX_C_SOURCE || __LP64__ */
 327 #endif /* !__DARWIN_UNIX03 */
 328
 329 #if !defined(__DARWIN_64_BIT_INO_T)
 330 #  if defined(KERNEL)
 331 #    define __DARWIN_64_BIT_INO_T 0
 332 #  elif defined(_DARWIN_USE_64_BIT_INODE)
 333 #    if defined(_DARWIN_NO_64_BIT_INODE)
 334 #      error "Can't define both _DARWIN_USE_64_BIT_INODE and _DARWIN_NO_64_BIT_INODE."
 335 #    endif /* _DARWIN_NO_64_BIT_INODE */
 336 #    define __DARWIN_64_BIT_INO_T 1
 337 #  elif defined(_DARWIN_NO_64_BIT_INODE)
 338 #    if __DARWIN_ONLY_64_BIT_INO_T
 339 #      error "Can't define _DARWIN_NO_64_BIT_INODE when only 64-bit inodes are available."
 340 #    endif /* __DARWIN_ONLY_64_BIT_INO_T */
 341 #    define __DARWIN_64_BIT_INO_T 0
 342 #  else /* default */
 343 #    if __DARWIN_ONLY_64_BIT_INO_T
 344 #      define __DARWIN_64_BIT_INO_T 1
 345 #    elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1060) || __DARWIN_UNIX03 == 0
 346 #      define __DARWIN_64_BIT_INO_T 0
 347 #    else /* default */
 348 #      define __DARWIN_64_BIT_INO_T 1
 349 #    endif /* __DARWIN_ONLY_64_BIT_INO_T */
 350 #  endif
 351 #endif /* !__DARWIN_64_BIT_INO_T */
 352
 353 #if !defined(__DARWIN_VERS_1050)
 354 #  if defined(KERNEL)
 355 #    define __DARWIN_VERS_1050 0
 356 #  elif __DARWIN_ONLY_VERS_1050
 357 #    define __DARWIN_VERS_1050 1
 358 #  elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && ((__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__-0) < 1050) || __DARWIN_UNIX03 == 0
 359 #    define __DARWIN_VERS_1050 0
 360 #  else /* default */
 361 #    define __DARWIN_VERS_1050 1
 362 #  endif
 363 #endif /* !__DARWIN_VERS_1050 */
 364
 365 #if !defined(__DARWIN_NON_CANCELABLE)
 366 #  if defined(KERNEL)
 367 #    define __DARWIN_NON_CANCELABLE 0
 368 #  else /* default */
 369 #    define __DARWIN_NON_CANCELABLE 0
 370 #  endif
 371 #endif /* !__DARWIN_NON_CANCELABLE */
 372
 373 /*
 374  * symbol suffixes used for symbol versioning
 375  */
 376 #if __DARWIN_UNIX03
 377 #  if __DARWIN_ONLY_UNIX_CONFORMANCE
 378 #    define __DARWIN_SUF_UNIX03         /* nothing */
 379 #  else /* !__DARWIN_ONLY_UNIX_CONFORMANCE */
 380 #    define __DARWIN_SUF_UNIX03         "$UNIX2003"
 381 #  endif /* __DARWIN_ONLY_UNIX_CONFORMANCE */
 382
 383 #  if __DARWIN_64_BIT_INO_T
 384 #    if __DARWIN_ONLY_64_BIT_INO_T
 385 #      define __DARWIN_SUF_64_BIT_INO_T /* nothing */
 386 #    else /* !__DARWIN_ONLY_64_BIT_INO_T */
 387 #      define __DARWIN_SUF_64_BIT_INO_T "$INODE64"
 388 #    endif /* __DARWIN_ONLY_64_BIT_INO_T */
 389 #  else /* !__DARWIN_64_BIT_INO_T */
 390 #    define __DARWIN_SUF_64_BIT_INO_T   /* nothing */
 391 #  endif /* __DARWIN_64_BIT_INO_T */
 392
 393 #  if __DARWIN_VERS_1050
 394 #    if __DARWIN_ONLY_VERS_1050
 395 #      define __DARWIN_SUF_1050         /* nothing */
 396 #    else /* !__DARWIN_ONLY_VERS_1050 */
 397 #      define __DARWIN_SUF_1050         "$1050"
 398 #    endif /* __DARWIN_ONLY_VERS_1050 */
 399 #  else /* !__DARWIN_VERS_1050 */
 400 #    define __DARWIN_SUF_1050           /* nothing */
 401 #  endif /* __DARWIN_VERS_1050 */
 402
 403 #  if __DARWIN_NON_CANCELABLE
 404 #    define __DARWIN_SUF_NON_CANCELABLE "$NOCANCEL"
 405 #  else /* !__DARWIN_NON_CANCELABLE */
 406 #    define __DARWIN_SUF_NON_CANCELABLE /* nothing */
 407 #  endif /* __DARWIN_NON_CANCELABLE */
 408
 409 #else /* !__DARWIN_UNIX03 */
 410 #  define __DARWIN_SUF_UNIX03           /* nothing */
 411 #  define __DARWIN_SUF_64_BIT_INO_T     /* nothing */
 412 #  define __DARWIN_SUF_NON_CANCELABLE   /* nothing */
 413 #  define __DARWIN_SUF_1050             /* nothing */
 414 #endif /* __DARWIN_UNIX03 */
 415
 416 #define __DARWIN_SUF_EXTSN              "$DARWIN_EXTSN"
 417
 418 /*
 419  * symbol versioning macros
 420  */
 421 #define __DARWIN_ALIAS(sym)             __asm("_" __STRING(sym) __DARWIN_SUF_UNIX03)
 422 #define __DARWIN_ALIAS_C(sym)           __asm("_" __STRING(sym) __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
 423 #define __DARWIN_ALIAS_I(sym)           __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
 424 #define __DARWIN_INODE64(sym)           __asm("_" __STRING(sym) __DARWIN_SUF_64_BIT_INO_T)
 425
 426 #define __DARWIN_1050(sym)              __asm("_" __STRING(sym) __DARWIN_SUF_1050)
 427 #define __DARWIN_1050ALIAS(sym)         __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_UNIX03)
 428 #define __DARWIN_1050ALIAS_C(sym)       __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_NON_CANCELABLE __DARWIN_SUF_UNIX03)
 429 #define __DARWIN_1050ALIAS_I(sym)       __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T __DARWIN_SUF_UNIX03)
 430 #define __DARWIN_1050INODE64(sym)       __asm("_" __STRING(sym) __DARWIN_SUF_1050 __DARWIN_SUF_64_BIT_INO_T)
 431
 432 #define __DARWIN_EXTSN(sym)             __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN)
 433 #define __DARWIN_EXTSN_C(sym)           __asm("_" __STRING(sym) __DARWIN_SUF_EXTSN __DARWIN_SUF_NON_CANCELABLE)
 434
 435 /*
 436  * symbol release macros
 437  */
 438 #ifdef KERNEL
 439 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)
 440 #else
 441 #include <sys/_symbol_aliasing.h>
 442
 443 #if defined(__ENVIRONMENT_IPHONE_OS_VERSION_MIN_REQUIRED__)
 444 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)   __DARWIN_ALIAS_STARTING_IPHONE_##_iphone(x)
 445 #elif defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__)
 446 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)   __DARWIN_ALIAS_STARTING_MAC_##_mac(x)
 447 #else
 448 #define __DARWIN_ALIAS_STARTING(_mac, _iphone, x)
 449 #endif
 450 #endif /* KERNEL */
 451
 452
 453 /*
 454  * POSIX.1 requires that the macros we test be defined before any standard
 455  * header file is included.  This permits us to convert values for feature
 456  * testing, as necessary, using only _POSIX_C_SOURCE.
 457  *
 458  * Here's a quick run-down of the versions:
 459  *  defined(_POSIX_SOURCE)              1003.1-1988
 460  *  _POSIX_C_SOURCE == 1L               1003.1-1990
 461  *  _POSIX_C_SOURCE == 2L               1003.2-1992 C Language Binding Option
 462  *  _POSIX_C_SOURCE == 199309L          1003.1b-1993
 463  *  _POSIX_C_SOURCE == 199506L          1003.1c-1995, 1003.1i-1995,
 464  *                                      and the omnibus ISO/IEC 9945-1: 1996
 465  *  _POSIX_C_SOURCE == 200112L          1003.1-2001
 466  *  _POSIX_C_SOURCE == 200809L          1003.1-2008
 467  *
 468  * In addition, the X/Open Portability Guide, which is now the Single UNIX
 469  * Specification, defines a feature-test macro which indicates the version of
 470  * that specification, and which subsumes _POSIX_C_SOURCE.
 471  */
 472
 473 /* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1L. */
 474 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 1L
 475 #undef _POSIX_C_SOURCE
 476 #define _POSIX_C_SOURCE         199009L
 477 #endif
 478
 479 /* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2L. */
 480 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 2L
 481 #undef _POSIX_C_SOURCE
 482 #define _POSIX_C_SOURCE         199209L
 483 #endif
 484
 485 /* Deal with various X/Open Portability Guides and Single UNIX Spec. */
 486 #ifdef _XOPEN_SOURCE
 487 #if _XOPEN_SOURCE - 0L >= 700L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200809L)
 488 #undef _POSIX_C_SOURCE
 489 #define _POSIX_C_SOURCE         200809L
 490 #elif _XOPEN_SOURCE - 0L >= 600L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 200112L)
 491 #undef _POSIX_C_SOURCE
 492 #define _POSIX_C_SOURCE         200112L
 493 #elif _XOPEN_SOURCE - 0L >= 500L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE - 0L < 199506L)
 494 #undef _POSIX_C_SOURCE
 495 #define _POSIX_C_SOURCE         199506L
 496 #endif
 497 #endif
 498
 499 /*
 500  * Deal with all versions of POSIX.  The ordering relative to the tests above is
 501  * important.
 502  */
 503 #if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE)
 504 #define _POSIX_C_SOURCE         198808L
 505 #endif
 506
 507 /* POSIX C deprecation macros */
 508 #ifdef KERNEL
 509 #define __POSIX_C_DEPRECATED(ver)
 510 #else
 511 #include <sys/_posix_availability.h>
 512
 513 #define __POSIX_C_DEPRECATED(ver) ___POSIX_C_DEPRECATED_STARTING_##ver
 514 #endif
 515
 516 /*
 517  * Set a single macro which will always be defined and can be used to determine
 518  * the appropriate namespace.  For POSIX, these values will correspond to
 519  * _POSIX_C_SOURCE value.  Currently there are two additional levels corresponding
 520  * to ANSI (_ANSI_SOURCE) and Darwin extensions (_DARWIN_C_SOURCE)
 521  */
 522 #define __DARWIN_C_ANSI         010000L
 523 #define __DARWIN_C_FULL         900000L
 524
 525 #if   defined(_ANSI_SOURCE)
 526 #define __DARWIN_C_LEVEL        __DARWIN_C_ANSI
 527 #elif defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE) && !defined(_NONSTD_SOURCE)
 528 #define __DARWIN_C_LEVEL        _POSIX_C_SOURCE
 529 #else
 530 #define __DARWIN_C_LEVEL        __DARWIN_C_FULL
 531 #endif
 532
 533
 534 /*
 535  * long long is not supported in c89 (__STRICT_ANSI__), but g++ -ansi and
 536  * c99 still want long longs.  While not perfect, we allow long longs for
 537  * g++.
 538  */
 539 #define __DARWIN_NO_LONG_LONG   (defined(__STRICT_ANSI__) \
 540                                 && (__STDC_VERSION__-0 < 199901L) \
 541                                 && !defined(__GNUG__))
 542
 543 /*****************************************
 544  *  Public darwin-specific feature macros
 545  *****************************************/
 546
 547 /*
 548  * _DARWIN_FEATURE_64_BIT_INODE indicates that the ino_t type is 64-bit, and
 549  * structures modified for 64-bit inodes (like struct stat) will be used.
 550  */
 551 #if __DARWIN_64_BIT_INO_T
 552 #define _DARWIN_FEATURE_64_BIT_INODE            1
 553 #endif
 554
 555 /*
 556  * _DARWIN_FEATURE_64_ONLY_BIT_INODE indicates that the ino_t type may only
 557  * be 64-bit; there is no support for 32-bit ino_t when this macro is defined
 558  * (and non-zero).  There is no struct stat64 either, as the regular
 559  * struct stat will already be the 64-bit version.
 560  */
 561 #if __DARWIN_ONLY_64_BIT_INO_T
 562 #define _DARWIN_FEATURE_ONLY_64_BIT_INODE       1
 563 #endif
 564
 565 /*
 566  * _DARWIN_FEATURE_ONLY_VERS_1050 indicates that only those APIs updated
 567  * in 10.5 exists; no pre-10.5 variants are available.
 568  */
 569 #if __DARWIN_ONLY_VERS_1050
 570 #define _DARWIN_FEATURE_ONLY_VERS_1050          1
 571 #endif
 572
 573 /*
 574  * _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE indicates only UNIX conforming API
 575  * are available (the legacy BSD APIs are not available)
 576  */
 577 #if __DARWIN_ONLY_UNIX_CONFORMANCE
 578 #define _DARWIN_FEATURE_ONLY_UNIX_CONFORMANCE   1
 579 #endif
 580
 581 /*
 582  * _DARWIN_FEATURE_UNIX_CONFORMANCE indicates whether UNIX conformance is on,
 583  * and specifies the conformance level (3 is SUSv3)
 584  */
 585 #if __DARWIN_UNIX03
 586 #define _DARWIN_FEATURE_UNIX_CONFORMANCE        3
 587 #endif
 588
 589 /*
 590  * This macro casts away the qualifier from the variable
 591  *
 592  * Note: use at your own risk, removing qualifiers can result in
 593  * catastrophic run-time failures.
 594  */
 595 #ifndef __CAST_AWAY_QUALIFIER
 596 #define __CAST_AWAY_QUALIFIER(variable, qualifier, type)  (type) (long)(variable)
 597 #endif
 598
 599 #endif /* !_CDEFS_H_ */