1 /* $NetBSD: cdefs.h,v 1.58 2004/12/11 05:59:00 christos Exp $ */ 2 3 /* 4 * Copyright (c) 1991, 1993 5 * The Regents of the University of California. All rights reserved. 6 * 7 * This code is derived from software contributed to Berkeley by 8 * Berkeley Software Design, Inc. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 3. Neither the name of the University nor the names of its contributors 19 * may be used to endorse or promote products derived from this software 20 * without specific prior written permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 * SUCH DAMAGE. 33 * 34 * @(#)cdefs.h 8.8 (Berkeley) 1/9/95 35 */ 36 37 #ifndef _SYS_CDEFS_H_ 38 #define _SYS_CDEFS_H_ 39 40 /* 41 * Macro to test if we're using a GNU C compiler of a specific vintage 42 * or later, for e.g. features that appeared in a particular version 43 * of GNU C. Usage: 44 * 45 * #if __GNUC_PREREQ__(major, minor) 46 * ...cool feature... 47 * #else 48 * ...delete feature... 49 * #endif 50 */ 51 #ifdef __GNUC__ 52 #define __GNUC_PREREQ__(x, y) \ 53 ((__GNUC__ == (x) && __GNUC_MINOR__ >= (y)) || \ 54 (__GNUC__ > (x))) 55 #else 56 #define __GNUC_PREREQ__(x, y) 0 57 #endif 58 59 #include <sys/cdefs_elf.h> 60 61 #if defined(__cplusplus) 62 #define __BEGIN_DECLS extern "C" { 63 #define __END_DECLS } 64 #define __static_cast(x,y) static_cast<x>(y) 65 #else 66 #define __BEGIN_DECLS 67 #define __END_DECLS 68 #define __static_cast(x,y) (x)y 69 #endif 70 71 /* 72 * The __CONCAT macro is used to concatenate parts of symbol names, e.g. 73 * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo. 74 * The __CONCAT macro is a bit tricky -- make sure you don't put spaces 75 * in between its arguments. __CONCAT can also concatenate double-quoted 76 * strings produced by the __STRING macro, but this only works with ANSI C. 77 */ 78 79 #define ___STRING(x) __STRING(x) 80 #define ___CONCAT(x,y) __CONCAT(x,y) 81 82 #if defined(__STDC__) || defined(__cplusplus) 83 #define __P(protos) protos /* full-blown ANSI C */ 84 #define __CONCAT(x,y) x ## y 85 #define __STRING(x) #x 86 87 #define __const const /* define reserved names to standard */ 88 #define __signed signed 89 #define __volatile volatile 90 #if defined(__cplusplus) 91 #define __inline inline /* convert to C++ keyword */ 92 #else 93 #if !defined(__GNUC__) && !defined(__lint__) 94 #define __inline /* delete GCC keyword */ 95 #endif /* !__GNUC__ && !__lint__ */ 96 #endif /* !__cplusplus */ 97 98 #else /* !(__STDC__ || __cplusplus) */ 99 #define __P(protos) () /* traditional C preprocessor */ 100 #define __CONCAT(x,y) x/**/y 101 #define __STRING(x) "x" 102 103 #ifndef __GNUC__ 104 #define __const /* delete pseudo-ANSI C keywords */ 105 #define __inline 106 #define __signed 107 #define __volatile 108 #endif /* !__GNUC__ */ 109 110 /* 111 * In non-ANSI C environments, new programs will want ANSI-only C keywords 112 * deleted from the program and old programs will want them left alone. 113 * Programs using the ANSI C keywords const, inline etc. as normal 114 * identifiers should define -DNO_ANSI_KEYWORDS. 115 */ 116 #ifndef NO_ANSI_KEYWORDS 117 #define const __const /* convert ANSI C keywords */ 118 #define inline __inline 119 #define signed __signed 120 #define volatile __volatile 121 #endif /* !NO_ANSI_KEYWORDS */ 122 #endif /* !(__STDC__ || __cplusplus) */ 123 124 /* 125 * Used for internal auditing of the NetBSD source tree. 126 */ 127 #ifdef __AUDIT__ 128 #define __aconst __const 129 #else 130 #define __aconst 131 #endif 132 133 /* 134 * The following macro is used to remove const cast-away warnings 135 * from gcc -Wcast-qual; it should be used with caution because it 136 * can hide valid errors; in particular most valid uses are in 137 * situations where the API requires it, not to cast away string 138 * constants. We don't use *intptr_t on purpose here and we are 139 * explicit about unsigned long so that we don't have additional 140 * dependencies. 141 */ 142 #define __UNCONST(a) ((void *)(unsigned long)(const void *)(a)) 143 144 /* 145 * GCC2 provides __extension__ to suppress warnings for various GNU C 146 * language extensions under "-ansi -pedantic". 147 */ 148 #if !__GNUC_PREREQ__(2, 0) 149 #define __extension__ /* delete __extension__ if non-gcc or gcc1 */ 150 #endif 151 152 /* 153 * GCC1 and some versions of GCC2 declare dead (non-returning) and 154 * pure (no side effects) functions using "volatile" and "const"; 155 * unfortunately, these then cause warnings under "-ansi -pedantic". 156 * GCC2 uses a new, peculiar __attribute__((attrs)) style. All of 157 * these work for GNU C++ (modulo a slight glitch in the C++ grammar 158 * in the distribution version of 2.5.5). 159 */ 160 #if !__GNUC_PREREQ__(2, 5) 161 #define __attribute__(x) /* delete __attribute__ if non-gcc or gcc1 */ 162 #if defined(__GNUC__) && !defined(__STRICT_ANSI__) 163 #define __dead __volatile 164 #define __pure __const 165 #endif 166 #endif 167 168 /* Delete pseudo-keywords wherever they are not available or needed. */ 169 #ifndef __dead 170 #define __dead 171 #define __pure 172 #endif 173 174 #if __GNUC_PREREQ__(2, 7) 175 #define __unused __attribute__((__unused__)) 176 #else 177 #define __unused /* delete */ 178 #endif 179 180 #define __pure2 __attribute__((__const__)) /* Android-added: used by FreeBSD libm */ 181 182 #if __GNUC_PREREQ__(3, 1) 183 #define __used __attribute__((__used__)) 184 #else 185 #define __used /* delete */ 186 #endif 187 188 #if __GNUC_PREREQ__(2, 7) 189 #define __packed __attribute__((__packed__)) 190 #define __aligned(x) __attribute__((__aligned__(x))) 191 #define __section(x) __attribute__((__section__(x))) 192 #elif defined(__lint__) 193 #define __packed /* delete */ 194 #define __aligned(x) /* delete */ 195 #define __section(x) /* delete */ 196 #else 197 #define __packed error: no __packed for this compiler 198 #define __aligned(x) error: no __aligned for this compiler 199 #define __section(x) error: no __section for this compiler 200 #endif 201 202 #if !__GNUC_PREREQ__(2, 8) 203 #define __extension__ 204 #endif 205 206 #if __GNUC_PREREQ__(2, 8) 207 #define __statement(x) __extension__(x) 208 #elif defined(lint) 209 #define __statement(x) (0) 210 #else 211 #define __statement(x) (x) 212 #endif 213 214 #define __nonnull(args) __attribute__((__nonnull__ args)) 215 216 #define __printflike(x, y) __attribute__((__format__(printf, x, y))) __nonnull((x)) 217 #define __scanflike(x, y) __attribute__((__format__(scanf, x, y))) __nonnull((x)) 218 219 /* 220 * C99 defines the restrict type qualifier keyword, which was made available 221 * in GCC 2.92. 222 */ 223 #if defined(__STDC__VERSION__) && __STDC_VERSION__ >= 199901L 224 #define __restrict restrict 225 #else 226 #if !__GNUC_PREREQ__(2, 92) 227 #define __restrict /* delete __restrict when not supported */ 228 #endif 229 #endif 230 231 /* 232 * C99 defines __func__ predefined identifier, which was made available 233 * in GCC 2.95. 234 */ 235 #if !defined(__STDC_VERSION__) || !(__STDC_VERSION__ >= 199901L) 236 #if __GNUC_PREREQ__(2, 6) 237 #define __func__ __PRETTY_FUNCTION__ 238 #elif __GNUC_PREREQ__(2, 4) 239 #define __func__ __FUNCTION__ 240 #else 241 #define __func__ "" 242 #endif 243 #endif /* !(__STDC_VERSION__ >= 199901L) */ 244 245 #if defined(_KERNEL) 246 #if defined(NO_KERNEL_RCSIDS) 247 #undef __KERNEL_RCSID 248 #define __KERNEL_RCSID(_n, _s) /* nothing */ 249 #endif /* NO_KERNEL_RCSIDS */ 250 #endif /* _KERNEL */ 251 252 #if !defined(_STANDALONE) && !defined(_KERNEL) 253 #ifdef __GNUC__ 254 #define __RENAME(x) ___RENAME(x) 255 #else 256 #ifdef __lint__ 257 #define __RENAME(x) __symbolrename(x) 258 #else 259 #error "No function renaming possible" 260 #endif /* __lint__ */ 261 #endif /* __GNUC__ */ 262 #else /* _STANDALONE || _KERNEL */ 263 #define __RENAME(x) no renaming in kernel or standalone environment 264 #endif 265 266 /* 267 * A barrier to stop the optimizer from moving code or assume live 268 * register values. This is gcc specific, the version is more or less 269 * arbitrary, might work with older compilers. 270 */ 271 #if __GNUC_PREREQ__(2, 95) 272 #define __insn_barrier() __asm __volatile("":::"memory") 273 #else 274 #define __insn_barrier() /* */ 275 #endif 276 277 /* 278 * GNU C version 2.96 adds explicit branch prediction so that 279 * the CPU back-end can hint the processor and also so that 280 * code blocks can be reordered such that the predicted path 281 * sees a more linear flow, thus improving cache behavior, etc. 282 * 283 * The following two macros provide us with a way to use this 284 * compiler feature. Use __predict_true() if you expect the expression 285 * to evaluate to true, and __predict_false() if you expect the 286 * expression to evaluate to false. 287 * 288 * A few notes about usage: 289 * 290 * * Generally, __predict_false() error condition checks (unless 291 * you have some _strong_ reason to do otherwise, in which case 292 * document it), and/or __predict_true() `no-error' condition 293 * checks, assuming you want to optimize for the no-error case. 294 * 295 * * Other than that, if you don't know the likelihood of a test 296 * succeeding from empirical or other `hard' evidence, don't 297 * make predictions. 298 * 299 * * These are meant to be used in places that are run `a lot'. 300 * It is wasteful to make predictions in code that is run 301 * seldomly (e.g. at subsystem initialization time) as the 302 * basic block reordering that this affects can often generate 303 * larger code. 304 */ 305 #if __GNUC_PREREQ__(2, 96) 306 #define __predict_true(exp) __builtin_expect((exp) != 0, 1) 307 #define __predict_false(exp) __builtin_expect((exp) != 0, 0) 308 #else 309 #define __predict_true(exp) (exp) 310 #define __predict_false(exp) (exp) 311 #endif 312 313 #if __GNUC_PREREQ__(2, 96) 314 #define __noreturn __attribute__((__noreturn__)) 315 #define __mallocfunc __attribute__((malloc)) 316 #define __purefunc __attribute__((pure)) 317 #else 318 #define __noreturn 319 #define __mallocfunc 320 #define __purefunc 321 #endif 322 323 #if __GNUC_PREREQ__(3, 1) 324 #define __always_inline __attribute__((__always_inline__)) 325 #else 326 #define __always_inline 327 #endif 328 329 #if __GNUC_PREREQ__(3, 4) 330 #define __wur __attribute__((__warn_unused_result__)) 331 #else 332 #define __wur 333 #endif 334 335 #if __GNUC_PREREQ__(4, 3) 336 #define __errordecl(name, msg) extern void name(void) __attribute__((__error__(msg))) 337 #else 338 #define __errordecl(name, msg) extern void name(void) 339 #endif 340 341 /* 342 * Macros for manipulating "link sets". Link sets are arrays of pointers 343 * to objects, which are gathered up by the linker. 344 * 345 * Object format-specific code has provided us with the following macros: 346 * 347 * __link_set_add_text(set, sym) 348 * Add a reference to the .text symbol `sym' to `set'. 349 * 350 * __link_set_add_rodata(set, sym) 351 * Add a reference to the .rodata symbol `sym' to `set'. 352 * 353 * __link_set_add_data(set, sym) 354 * Add a reference to the .data symbol `sym' to `set'. 355 * 356 * __link_set_add_bss(set, sym) 357 * Add a reference to the .bss symbol `sym' to `set'. 358 * 359 * __link_set_decl(set, ptype) 360 * Provide an extern declaration of the set `set', which 361 * contains an array of the pointer type `ptype'. This 362 * macro must be used by any code which wishes to reference 363 * the elements of a link set. 364 * 365 * __link_set_start(set) 366 * This points to the first slot in the link set. 367 * 368 * __link_set_end(set) 369 * This points to the (non-existent) slot after the last 370 * entry in the link set. 371 * 372 * __link_set_count(set) 373 * Count the number of entries in link set `set'. 374 * 375 * In addition, we provide the following macros for accessing link sets: 376 * 377 * __link_set_foreach(pvar, set) 378 * Iterate over the link set `set'. Because a link set is 379 * an array of pointers, pvar must be declared as "type **pvar", 380 * and the actual entry accessed as "*pvar". 381 * 382 * __link_set_entry(set, idx) 383 * Access the link set entry at index `idx' from set `set'. 384 */ 385 #define __link_set_foreach(pvar, set) \ 386 for (pvar = __link_set_start(set); pvar < __link_set_end(set); pvar++) 387 388 #define __link_set_entry(set, idx) (__link_set_begin(set)[idx]) 389 390 /* 391 * Some of the FreeBSD sources used in Bionic need this. 392 * Originally, this is used to embed the rcs versions of each source file 393 * in the generated binary. We certainly don't want this in Bionic. 394 */ 395 #define __FBSDID(s) /* nothing */ 396 397 /*- 398 * The following definitions are an extension of the behavior originally 399 * implemented in <sys/_posix.h>, but with a different level of granularity. 400 * POSIX.1 requires that the macros we test be defined before any standard 401 * header file is included. 402 * 403 * Here's a quick run-down of the versions: 404 * defined(_POSIX_SOURCE) 1003.1-1988 405 * _POSIX_C_SOURCE == 1 1003.1-1990 406 * _POSIX_C_SOURCE == 2 1003.2-1992 C Language Binding Option 407 * _POSIX_C_SOURCE == 199309 1003.1b-1993 408 * _POSIX_C_SOURCE == 199506 1003.1c-1995, 1003.1i-1995, 409 * and the omnibus ISO/IEC 9945-1: 1996 410 * _POSIX_C_SOURCE == 200112 1003.1-2001 411 * _POSIX_C_SOURCE == 200809 1003.1-2008 412 * 413 * In addition, the X/Open Portability Guide, which is now the Single UNIX 414 * Specification, defines a feature-test macro which indicates the version of 415 * that specification, and which subsumes _POSIX_C_SOURCE. 416 * 417 * Our macros begin with two underscores to avoid namespace screwage. 418 */ 419 420 /* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1. */ 421 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 1 422 #undef _POSIX_C_SOURCE /* Probably illegal, but beyond caring now. */ 423 #define _POSIX_C_SOURCE 199009 424 #endif 425 426 /* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2. */ 427 #if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 2 428 #undef _POSIX_C_SOURCE 429 #define _POSIX_C_SOURCE 199209 430 #endif 431 432 /* Deal with various X/Open Portability Guides and Single UNIX Spec. */ 433 #ifdef _XOPEN_SOURCE 434 #if _XOPEN_SOURCE - 0 >= 700 435 #define __XSI_VISIBLE 700 436 #undef _POSIX_C_SOURCE 437 #define _POSIX_C_SOURCE 200809 438 #elif _XOPEN_SOURCE - 0 >= 600 439 #define __XSI_VISIBLE 600 440 #undef _POSIX_C_SOURCE 441 #define _POSIX_C_SOURCE 200112 442 #elif _XOPEN_SOURCE - 0 >= 500 443 #define __XSI_VISIBLE 500 444 #undef _POSIX_C_SOURCE 445 #define _POSIX_C_SOURCE 199506 446 #endif 447 #endif 448 449 /* 450 * Deal with all versions of POSIX. The ordering relative to the tests above is 451 * important. 452 */ 453 #if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE) 454 #define _POSIX_C_SOURCE 198808 455 #endif 456 #ifdef _POSIX_C_SOURCE 457 #if _POSIX_C_SOURCE >= 200809 458 #define __POSIX_VISIBLE 200809 459 #define __ISO_C_VISIBLE 1999 460 #elif _POSIX_C_SOURCE >= 200112 461 #define __POSIX_VISIBLE 200112 462 #define __ISO_C_VISIBLE 1999 463 #elif _POSIX_C_SOURCE >= 199506 464 #define __POSIX_VISIBLE 199506 465 #define __ISO_C_VISIBLE 1990 466 #elif _POSIX_C_SOURCE >= 199309 467 #define __POSIX_VISIBLE 199309 468 #define __ISO_C_VISIBLE 1990 469 #elif _POSIX_C_SOURCE >= 199209 470 #define __POSIX_VISIBLE 199209 471 #define __ISO_C_VISIBLE 1990 472 #elif _POSIX_C_SOURCE >= 199009 473 #define __POSIX_VISIBLE 199009 474 #define __ISO_C_VISIBLE 1990 475 #else 476 #define __POSIX_VISIBLE 198808 477 #define __ISO_C_VISIBLE 0 478 #endif /* _POSIX_C_SOURCE */ 479 #else 480 /*- 481 * Deal with _ANSI_SOURCE: 482 * If it is defined, and no other compilation environment is explicitly 483 * requested, then define our internal feature-test macros to zero. This 484 * makes no difference to the preprocessor (undefined symbols in preprocessing 485 * expressions are defined to have value zero), but makes it more convenient for 486 * a test program to print out the values. 487 * 488 * If a program mistakenly defines _ANSI_SOURCE and some other macro such as 489 * _POSIX_C_SOURCE, we will assume that it wants the broader compilation 490 * environment (and in fact we will never get here). 491 */ 492 #if defined(_ANSI_SOURCE) /* Hide almost everything. */ 493 #define __POSIX_VISIBLE 0 494 #define __XSI_VISIBLE 0 495 #define __BSD_VISIBLE 0 496 #define __ISO_C_VISIBLE 1990 497 #elif defined(_C99_SOURCE) /* Localism to specify strict C99 env. */ 498 #define __POSIX_VISIBLE 0 499 #define __XSI_VISIBLE 0 500 #define __BSD_VISIBLE 0 501 #define __ISO_C_VISIBLE 1999 502 #else /* Default environment: show everything. */ 503 #define __POSIX_VISIBLE 200809 504 #define __XSI_VISIBLE 700 505 #define __BSD_VISIBLE 1 506 #define __ISO_C_VISIBLE 1999 507 #endif 508 #endif 509 510 /* 511 * Default values. 512 */ 513 #ifndef __XPG_VISIBLE 514 # define __XPG_VISIBLE 700 515 #endif 516 #ifndef __POSIX_VISIBLE 517 # define __POSIX_VISIBLE 200809 518 #endif 519 #ifndef __ISO_C_VISIBLE 520 # define __ISO_C_VISIBLE 1999 521 #endif 522 #ifndef __BSD_VISIBLE 523 # define __BSD_VISIBLE 1 524 #endif 525 526 #define __BIONIC__ 1 527 #include <android/api-level.h> 528 529 #if defined(_FORTIFY_SOURCE) && _FORTIFY_SOURCE > 0 && defined(__OPTIMIZE__) && __OPTIMIZE__ > 0 530 #define __BIONIC_FORTIFY 1 531 #if _FORTIFY_SOURCE == 2 532 #define __bos(s) __builtin_object_size((s), 1) 533 #else 534 #define __bos(s) __builtin_object_size((s), 0) 535 #endif 536 537 #define __BIONIC_FORTIFY_INLINE \ 538 extern inline \ 539 __attribute__ ((always_inline)) \ 540 __attribute__ ((gnu_inline)) 541 #endif 542 #define __BIONIC_FORTIFY_UNKNOWN_SIZE ((size_t) -1) 543 544 /* Android-added: for FreeBSD's libm. */ 545 #define __weak_reference(sym,alias) \ 546 __asm__(".weak " #alias); \ 547 __asm__(".equ " #alias ", " #sym) 548 #define __strong_reference(sym,aliassym) \ 549 extern __typeof (sym) aliassym __attribute__ ((__alias__ (#sym))) 550 551 #endif /* !_SYS_CDEFS_H_ */ 552