Merge branch 'vendor/DHCPCD'
[dragonfly.git] / sys / sys / cdefs.h
1 /*
2  * Copyright (c) 1991, 1993
3  *      The Regents of the University of California.  All rights reserved.
4  *
5  * This code is derived from software contributed to Berkeley by
6  * Berkeley Software Design, Inc.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  *      @(#)cdefs.h     8.8 (Berkeley) 1/9/95
33  * $FreeBSD: src/sys/sys/cdefs.h,v 1.28.2.8 2002/09/18 04:05:13 mikeh Exp $
34  */
35
36 #ifndef _SYS_CDEFS_H_
37 #define _SYS_CDEFS_H_
38
39 /*
40  * Testing against Clang-specific extensions.
41  */
42 #ifndef __has_attribute
43 #define __has_attribute(x)      0
44 #endif
45 #ifndef __has_extension
46 #define __has_extension         __has_feature
47 #endif
48 #ifndef __has_feature
49 #define __has_feature(x)        0
50 #endif
51 #ifndef __has_include
52 #define __has_include(x)        0
53 #endif
54 #ifndef __has_builtin
55 #define __has_builtin(x)        0
56 #endif
57
58 /*
59  * Macro to test if we are using a specific version of gcc or later.
60  */
61 #if defined(__GNUC__) && !defined(__INTEL_COMPILER)
62 #define __GNUC_PREREQ__(ma, mi) \
63         (__GNUC__ > (ma) || __GNUC__ == (ma) && __GNUC_MINOR__ >= (mi))
64 #else
65 #define __GNUC_PREREQ__(ma, mi) 0
66 #endif
67
68 #if defined(__cplusplus)
69 #define __BEGIN_EXTERN_C        extern "C" {
70 #define __END_EXTERN_C          }
71 #else
72 #define __BEGIN_EXTERN_C
73 #define __END_EXTERN_C
74 #endif
75
76 #if __GNUC_PREREQ__(4, 0)
77 #define __dso_public    __attribute__((__visibility__("default")))
78 #define __dso_hidden    __attribute__((__visibility__("hidden")))
79 #define __BEGIN_DECLS   _Pragma("GCC visibility push(default)") __BEGIN_EXTERN_C
80 #define __END_DECLS     __END_EXTERN_C _Pragma("GCC visibility pop")
81 #define __BEGIN_HIDDEN_DECLS \
82                         _Pragma("GCC visibility push(hidden)") __BEGIN_EXTERN_C
83 #define __END_HIDDEN_DECLS \
84                         __END_EXTERN_C _Pragma("GCC visibility pop")
85 #else
86 #define __dso_public
87 #define __dso_hidden
88 #define __BEGIN_DECLS   __BEGIN_EXTERN_C
89 #define __END_DECLS     __END_EXTERN_C
90 #define __BEGIN_HIDDEN_DECLS \
91                         __BEGIN_EXTERN_C
92 #define __END_HIDDEN_DECLS \
93                         __END_EXTERN_C
94 #endif
95
96 /*
97  * The __VM_CACHELINE_SIZE macro defines the common cache line alignment
98  * size that can be found across most recent and somewhat latest Intel
99  * hardware, i.e. L1 cache sizes etc.
100  *
101  * If needed, this value can be TUNED.  Suitable values for this macro
102  * are 32, 64 and 128 bytes.  The unit of measurement for this macro is
103  * bytes.
104  *
105  * XXX: This macro and related macros will eventually move to a MD
106  * header, but currently, we do need such a hierarchy.
107  */
108 #define __VM_CACHELINE_SIZE     64
109 #define __VM_CACHELINE_MASK     (__VM_CACHELINE_SIZE - 1)
110 #define __VM_CACHELINE_ALIGN(n) \
111         (((n) + __VM_CACHELINE_MASK) & ~__VM_CACHELINE_MASK)
112
113 /*
114  * The __CONCAT macro is used to concatenate parts of symbol names, e.g.
115  * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo.
116  * The __CONCAT macro is a bit tricky to use if it must work in non-ANSI
117  * mode -- there must be no spaces between its arguments, and for nested
118  * __CONCAT's, all the __CONCAT's must be at the left.  __CONCAT can also
119  * concatenate double-quoted strings produced by the __STRING macro, but
120  * this only works with ANSI C.
121  *
122  * __XSTRING is like __STRING, but it expands any macros in its argument
123  * first.  It is only available with ANSI C.
124  */
125 #if defined(__STDC__) || defined(__cplusplus)
126 #define __P(protos)     protos          /* full-blown ANSI C */
127 #define __CONCAT1(x,y)  x ## y
128 #define __CONCAT(x,y)   __CONCAT1(x,y)
129 #define __STRING(x)     #x              /* stringify without expanding x */
130 #define __XSTRING(x)    __STRING(x)     /* expand x, then stringify */
131
132 #define __const         const           /* define reserved names to standard */
133 #define __signed        signed
134 #define __volatile      volatile
135 #if defined(__cplusplus)
136 #define __inline        inline          /* convert to C++ keyword */
137 #else
138 #ifndef __GNUC__
139 #define __inline                        /* delete GCC keyword */
140 #endif /* !__GNUC__ */
141 #endif /* !__cplusplus */
142
143 #else   /* !(__STDC__ || __cplusplus) */
144 #define __P(protos)     ()              /* traditional C preprocessor */
145 #define __CONCAT(x,y)   x/**/y
146 #define __STRING(x)     "x"
147
148 #ifndef __GNUC__
149 #define __const                         /* delete pseudo-ANSI C keywords */
150 #define __inline
151 #define __signed
152 #define __volatile
153 /*
154  * In non-ANSI C environments, new programs will want ANSI-only C keywords
155  * deleted from the program and old programs will want them left alone.
156  * When using a compiler other than gcc, programs using the ANSI C keywords
157  * const, inline etc. as normal identifiers should define -DNO_ANSI_KEYWORDS.
158  * When using "gcc -traditional", we assume that this is the intent; if
159  * __GNUC__ is defined but __STDC__ is not, we leave the new keywords alone.
160  */
161 #ifndef NO_ANSI_KEYWORDS
162 #define const                           /* delete ANSI C keywords */
163 #define inline
164 #define signed
165 #define volatile
166 #endif  /* !NO_ANSI_KEYWORDS */
167 #endif  /* !__GNUC__ */
168 #endif  /* !(__STDC__ || __cplusplus) */
169
170 /*
171  * Compiler-dependent macros to help declare dead (non-returning) and
172  * pure (no side effects) functions, and unused variables.  They are
173  * null except for versions of gcc that are known to support the features
174  * properly (old versions of gcc-2 supported the dead and pure features
175  * in a different (wrong) way).
176  */
177 #define __weak_symbol   __attribute__((__weak__))
178 #if __GNUC_PREREQ__(2, 7)
179 #define __dead2         __attribute__((__noreturn__))
180 #define __pure2         __attribute__((__const__))
181 #define __unused        __attribute__((__unused__))
182 #define __packed        __attribute__((__packed__))
183 #define __aligned(x)    __attribute__((__aligned__(x)))
184 #define __section(x)    __attribute__((__section__(x)))
185 #else
186 #define __dead2
187 #define __pure2
188 #define __unused
189 #endif
190
191 #if __GNUC_PREREQ__(2, 96)
192 #define __malloclike    __attribute__((__malloc__))
193 #define __pure          __attribute__((__pure__))
194 #else
195 #define __malloclike
196 #define __pure          __pure2
197 #endif
198
199 #if __GNUC_PREREQ__(3, 1)
200 #define __always_inline __attribute__((__always_inline__))
201 #define __noinline      __attribute__((__noinline__))
202 #else
203 #define __always_inline
204 #define __noinline
205 #endif
206
207 #if __GNUC_PREREQ__(3, 3)
208 #define __nonnull(...)  __attribute__((__nonnull__(__VA_ARGS__)))
209 #define __used          __attribute__((__used__))
210 #else
211 #define __nonnull(...)
212 #define __used          __unused
213 #endif
214
215 #if __GNUC_PREREQ__(3, 4)
216 #define __heedresult    __attribute__((__warn_unused_result__))
217 #else
218 #define __heedresult
219 #endif
220
221 #if __GNUC_PREREQ__(4, 1)
222 #define __returns_twice __attribute__((__returns_twice__))
223 #else
224 #define __returns_twice
225 #endif
226
227 #if __GNUC_PREREQ__(4, 6) || __has_builtin(__builtin_unreachable)
228 #define __unreachable() __builtin_unreachable()
229 #else
230 #define __unreachable() ((void)0)
231 #endif
232
233 #if __GNUC_PREREQ__(4, 3) || __has_attribute(__alloc_size__)
234 #define __alloc_size(x)         __attribute__((__alloc_size__(x)))
235 #define __alloc_size2(n, x)     __attribute__((__alloc_size__(n, x)))
236 #else
237 #define __alloc_size(x)
238 #define __alloc_size2(n, x)
239 #endif
240
241 #if __GNUC_PREREQ__(4, 9) || __has_attribute(__alloc_align__)
242 #define __alloc_align(x)        __attribute__((__alloc_align__(x)))
243 #else
244 #define __alloc_align(x)
245 #endif
246
247 #if !__GNUC_PREREQ__(2, 7) && __STDC_VERSION__ < 199901
248 #define __func__        NULL
249 #endif
250
251 #if (__GNUC_PREREQ__(2, 0) && !defined(__STRICT_ANSI__)) || \
252     __STDC_VERSION__ >= 199901
253 #define __LONG_LONG_SUPPORTED
254 #endif
255
256 /* C++11 exposes a load of C99 stuff */
257 #if defined(__cplusplus) && __cplusplus >= 201103L
258 #define __LONG_LONG_SUPPORTED
259 #ifndef __STDC_LIMIT_MACROS
260 #define __STDC_LIMIT_MACROS
261 #endif
262 #ifndef __STDC_CONSTANT_MACROS
263 #define __STDC_CONSTANT_MACROS
264 #endif
265 #endif
266
267 /*
268  * GCC 2.95 and later provides `__restrict' as an extension to C90 to support
269  * the C99-specific `restrict' type qualifier.  We happen to use `__restrict'
270  * as a way to define the `restrict' type qualifier without disturbing older
271  * software that is unaware of C99 keywords.
272  */
273 #if !__GNUC_PREREQ__(2, 95)
274 #if __STDC_VERSION__ < 199901
275 #define __restrict
276 #else
277 #define __restrict      restrict
278 #endif
279 #endif
280
281 /*
282  * C99 allows to declare arrays as non-overlapping.
283  */
284 #if __GNUC_PREREQ__(3, 1) && !defined(__GNUG__)
285 #define __restrict_arr  __restrict
286 #else
287 #ifdef __GNUC__
288 #define __restrict_arr
289 #else
290 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901
291 #define __restrict_arr  restrict
292 #else
293 #define __restrict_arr
294 #endif
295 #endif
296 #endif
297
298 /*
299  * GNU C version 2.96 adds explicit branch prediction so that
300  * the CPU back-end can hint the processor and also so that
301  * code blocks can be reordered such that the predicted path
302  * sees a more linear flow, thus improving cache behavior, etc.
303  *
304  * The following two macros provide us with a way to utilize this
305  * compiler feature.  Use __predict_true() if you expect the expression
306  * to evaluate to true, and __predict_false() if you expect the
307  * expression to evaluate to false.
308  *
309  * A few notes about usage:
310  *
311  *      * Generally, __predict_false() error condition checks (unless
312  *        you have some _strong_ reason to do otherwise, in which case
313  *        document it), and/or __predict_true() `no-error' condition
314  *        checks, assuming you want to optimize for the no-error case.
315  *
316  *      * Other than that, if you don't know the likelihood of a test
317  *        succeeding from empirical or other `hard' evidence, don't
318  *        make predictions.
319  *
320  *      * These are meant to be used in places that are run `a lot'.
321  *        It is wasteful to make predictions in code that is run
322  *        seldomly (e.g. at subsystem initialization time) as the
323  *        basic block reordering that this affects can often generate
324  *        larger code.
325  */
326 #if __GNUC_PREREQ__(2, 96)
327 #define __predict_true(exp)     __builtin_expect((exp), 1)
328 #define __predict_false(exp)    __builtin_expect((exp), 0)
329 #else
330 #define __predict_true(exp)     (exp)
331 #define __predict_false(exp)    (exp)
332 #endif
333
334 /*
335  * We define this here since <stddef.h>, <sys/queue.h>, and <sys/types.h>
336  * require it.
337  */
338 #if __GNUC_PREREQ__(4, 1)
339 #define __offsetof(type, field) __builtin_offsetof(type, field)
340 #else
341 #ifndef __cplusplus
342 #define __offsetof(type, field) \
343         ((__size_t)(__uintptr_t)((const volatile void *)&((type *)0)->field))
344 #else
345 #define __offsetof(type, field)                                 \
346         (__offsetof__ (reinterpret_cast <__size_t>              \
347                  (&reinterpret_cast <const volatile char &>     \
348                   (static_cast<type *> (0)->field))))
349 #endif
350 #endif
351
352 /*
353  * Compiler-dependent macros to declare that functions take printf-like
354  * or scanf-like arguments.  They are null except for versions of gcc
355  * that are known to support the features properly (old versions of gcc-2
356  * didn't permit keeping the keywords out of the application namespace).
357  *
358  * The printf0like macro for GCC 2 uses DragonFly specific compiler extensions.
359  */
360 #if !__GNUC_PREREQ__(2, 7)
361 #define __printflike(fmtarg, firstvararg)
362 #define __scanflike(fmtarg, firstvararg)
363 #define __printf0like(fmtarg, firstvararg)
364 #define __format_arg(fmtarg)
365 #define __strfmonlike(fmtarg, firstvararg)
366 #define __strftimelike(fmtarg, firstvararg)
367
368 #elif __GNUC_PREREQ__(3, 0)
369 #define __printflike(fmtarg, firstvararg) \
370             __attribute__((__nonnull__(fmtarg), \
371                           __format__ (__printf__, fmtarg, firstvararg)))
372 #define __printf0like(fmtarg, firstvararg) \
373             __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
374 #define __scanflike(fmtarg, firstvararg) \
375             __attribute__((__format__ (__scanf__, fmtarg, firstvararg)))
376 #define __format_arg(fmtarg) \
377             __attribute__((__format_arg__ (fmtarg)))
378 #define __strfmonlike(fmtarg, firstvararg) \
379             __attribute__((__format__ (__strfmon__, fmtarg, firstvararg)))
380 #define __strftimelike(fmtarg, firstvararg) \
381             __attribute__((__format__ (__strftime__, fmtarg, firstvararg)))
382
383 #else
384 #define __printflike(fmtarg, firstvararg) \
385             __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
386 #define __printf0like(fmtarg, firstvararg) \
387             __attribute__((__format__ (__printf0__, fmtarg, firstvararg)))
388 #define __scanflike(fmtarg, firstvararg) \
389             __attribute__((__format__ (__scanf__, fmtarg, firstvararg)))
390 #define __format_arg(fmtarg) \
391             __attribute__((__format_arg__ (fmtarg)))
392 #define __strfmonlike(fmtarg, firstvararg) \
393             __attribute__((__format__ (__strfmon__, fmtarg, firstvararg)))
394 #define __strftimelike(fmtarg, firstvararg) \
395             __attribute__((__format__ (__strftime__, fmtarg, firstvararg)))
396 #endif
397
398 #if !__GNUC_PREREQ__(3, 0)
399 #define __ARRAY_ZERO    0
400 #else
401 #define __ARRAY_ZERO
402 #endif
403
404 /*
405  * A convenient constructor macro, GCC 4.3.0 added priority support to
406  * constructors, provide a compatible interface for both.
407  */
408 #if __GNUC_PREREQ__(4, 3)
409 #define __constructor(prio)     __attribute__((constructor(prio)))
410 #else
411 #define __constructor(prio)     __attribute__((constructor))
412 #endif
413
414 /*
415  * Handy GCC based macros:
416  *
417  *      __cachealign:
418  *
419  *      The __cachealign macro can be used for cache line aligning structures
420  *      of small to medium size.  It aligns the particular structure or
421  *      storage type to a system default cache line alignment, thus giving us
422  *      a much more better cache utilization by making the hardware work at
423  *      its best burst speeds.
424  *
425  *      __usereg:
426  *
427  *      The __usereg macro can/should be used when a function contains
428  *      arguments not more than 3.  It can be very useful to us due to the
429  *      message-passing nature of the kernel.
430  *
431  * !!NOTE - USAGE INFORMATION!!
432  *
433  * The __cachealign macro should not be used for data structures that are
434  * as big struct proc, struct vnode, struct thread, and other structs which
435  * are as big as them; simply because it will be useless in that case.
436  *
437  * The __usereg macro should be used whenever possible, i.e., when a function
438  * does not exceed more than 3 arguments, and should not be used for vararg
439  * type functions.
440  *
441  * In other words, AVOID MISUSE OF THESE MACROS. :-)
442  */
443 #ifdef __GNUC__
444 #define __cachealign    __attribute__((__aligned__(__VM_CACHELINE_SIZE)))
445 #define __usereg        __attribute__((__regparm__(3)))
446 #else
447 #define __cachealign
448 #define __usereg
449 #endif
450
451 #ifdef __GNUC__
452 #define __strong_reference(sym,aliassym)        \
453         extern __typeof (sym) aliassym __attribute__ ((__alias__ (#sym)))
454 #define __weak_reference(sym,aliassym)  \
455         __strong_reference(sym,aliassym) __attribute__ ((__weak__))
456 #define __weak_reference_asm(sym,alias) \
457         __asm__(".weak " #alias);       \
458         __asm__(".equ "  #alias ", " #sym)
459 #define __warn_references(sym,msg)      \
460         __asm__(".section .gnu.warning." #sym); \
461         __asm__(".asciz \"" msg "\"");  \
462         __asm__(".previous")
463 #define __sym_compat(sym,impl,verid)    \
464         __asm__(".symver " #impl ", " #sym "@" #verid)
465 #define __sym_default(sym,impl,verid)   \
466         __asm__(".symver " #impl ", " #sym "@@@" #verid)
467 #endif  /* __GNUC__ */
468
469 #if defined(__GNUC__)
470 #define __IDSTRING(name,string) __asm__(".ident\t\"" string "\"")
471 #endif
472
473 #ifndef __RCSID
474 #define __RCSID(s)              struct __hack
475 #endif
476
477 #ifndef __RCSID_SOURCE
478 #define __RCSID_SOURCE(s)       struct __hack
479 #endif
480
481 #ifndef __SCCSID
482 #define __SCCSID(s)             struct __hack
483 #endif
484
485 #ifndef __FBSDID
486 #define __FBSDID(s)             struct __hack
487 #endif
488
489 #ifndef __COPYRIGHT
490 #define __COPYRIGHT(s)          struct __hack
491 #endif
492
493 #ifndef __DECONST
494 #define __DECONST(type, var)    ((type)(__uintptr_t)(const void *)(var))
495 #endif
496
497 #ifndef __DEVOLATILE
498 #define __DEVOLATILE(type, var) ((type)(__uintptr_t)(volatile void *)(var))
499 #endif
500
501 #ifndef __DEQUALIFY
502 #define __DEQUALIFY(type, var)  ((type)(__uintptr_t)(const volatile void *)(var))
503 #endif
504
505 /*
506  * Keywords added in C11.
507  */
508
509 #if !__GNUC_PREREQ__(2, 95)
510 #define __alignof(x)    __offsetof(struct { char __a; x __b; }, __b)
511 #endif
512
513 #if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 201112L
514
515 #if !__has_extension(c_alignas)
516 #if (defined(__cplusplus) && __cplusplus >= 201103L) || \
517     __has_extension(cxx_alignas)
518 #define _Alignas(x)             alignas(x)
519 #else
520 /* XXX: Only emulates _Alignas(constant-expression); not _Alignas(type-name). */
521 #define _Alignas(x)             __aligned(x)
522 #endif
523 #endif
524
525 #if defined(__cplusplus) && __cplusplus >= 201103L
526 #define _Alignof(x)             alignof(x)
527 #else
528 #define _Alignof(x)             __alignof(x)
529 #endif
530
531 #if !defined(_Noreturn)
532 #define _Noreturn               __dead2
533 #endif
534
535 #if !__has_extension(c_static_assert)
536 #if (defined(__cplusplus) && __cplusplus >= 201103L) || \
537     __has_extension(cxx_static_assert)
538 #define _Static_assert(x, y)    static_assert(x, y)
539 #elif !__GNUC_PREREQ__(4, 6)
540 #define _Static_assert(x, y)    struct __hack
541 #ifdef _KERNEL
542 #define CTASSERT(x)             _CTASSERT(x, __LINE__)
543 #define _CTASSERT(x, y)         __CTASSERT(x, y)
544 #define __CTASSERT(x, y)        typedef char __assert ## y[(x) ? 1 : -1]
545 #endif
546 #endif
547
548 /*
549  * GCC 4.7 has -std=c++11 but does not support thread_local.
550  */
551 #if !__has_extension(c_thread_local)
552 #if (defined(__cplusplus) && __cplusplus >= 201103L && __GNUC_PREREQ__(4, 8)) || \
553     __has_extension(cxx_thread_local)
554 #define _Thread_local           thread_local
555 #else
556 #define _Thread_local           __thread
557 #endif
558 #endif
559 #endif
560
561 #endif /* __STDC_VERSION__ || __STDC_VERSION__ < 201112L */
562
563 #if defined(_KERNEL) && !defined(CTASSERT)
564 #define CTASSERT(x)             _Static_assert(x, \
565                                     "compile-time assertion failed")
566 #endif
567
568 /*
569  * Emulation of C11 _Generic().  Unlike the previously defined C11
570  * keywords, it is not possible to implement this using exactly the same
571  * syntax.  Therefore implement something similar under the name
572  * __generic().  Unlike _Generic(), this macro can only distinguish
573  * between a single type, so it requires nested invocations to
574  * distinguish multiple cases.
575  */
576
577 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
578 #define __generic(expr, t, yes, no)                                     \
579         _Generic(expr, t: yes, default: no)
580 #elif __GNUC_PREREQ__(3, 1) && !defined(__cplusplus)
581 #define __generic(expr, t, yes, no)                                     \
582         __builtin_choose_expr(                                          \
583             __builtin_types_compatible_p(__typeof(expr), t), yes, no)
584 #endif
585
586 /*-
587  * POSIX.1 requires that the macros we test be defined before any standard
588  * header file is included.
589  *
590  * Here's a quick run-down of the versions:
591  *  defined(_POSIX_SOURCE)              1003.1-1988
592  *  _POSIX_C_SOURCE == 1                1003.1-1990
593  *  _POSIX_C_SOURCE == 2                1003.2-1992 C Language Binding Option
594  *  _POSIX_C_SOURCE == 199309           1003.1b-1993
595  *  _POSIX_C_SOURCE == 199506           1003.1c-1995, 1003.1i-1995,
596  *                                      and the omnibus ISO/IEC 9945-1: 1996
597  *  _POSIX_C_SOURCE == 200112           1003.1-2001
598  *  _POSIX_C_SOURCE == 200809           1003.1-2008
599  *
600  * In addition, the X/Open Portability Guide, which is now the Single UNIX
601  * Specification, defines a feature-test macro which indicates the version of
602  * that specification, and which subsumes _POSIX_C_SOURCE.
603  *
604  * Our macros begin with two underscores to avoid namespace screwage.
605  */
606
607 /* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1. */
608 #if defined(_POSIX_C_SOURCE) && (_POSIX_C_SOURCE - 0) == 1
609 #undef _POSIX_C_SOURCE          /* Probably illegal, but beyond caring now. */
610 #define _POSIX_C_SOURCE         199009
611 #endif
612
613 /* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2. */
614 #if defined(_POSIX_C_SOURCE) && (_POSIX_C_SOURCE - 0) == 2
615 #undef _POSIX_C_SOURCE
616 #define _POSIX_C_SOURCE         199209
617 #endif
618
619 /* Deal with various X/Open Portability Guides and Single UNIX Spec. */
620 #ifdef _XOPEN_SOURCE
621 #if _XOPEN_SOURCE - 0 >= 700
622 #define __XSI_VISIBLE           700
623 #undef _POSIX_C_SOURCE
624 #define _POSIX_C_SOURCE         200809
625 #elif _XOPEN_SOURCE - 0 >= 600
626 #define __XSI_VISIBLE           600
627 #undef _POSIX_C_SOURCE
628 #define _POSIX_C_SOURCE         200112
629 #elif _XOPEN_SOURCE - 0 >= 500
630 #define __XSI_VISIBLE           500
631 #undef _POSIX_C_SOURCE
632 #define _POSIX_C_SOURCE         199506
633 #endif
634 #endif
635
636 /*
637  * Deal with all versions of POSIX.  The ordering relative to the tests above is
638  * important.
639  */
640 #if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE)
641 #define _POSIX_C_SOURCE         198808
642 #endif
643 #ifdef _POSIX_C_SOURCE
644 #if (_POSIX_C_SOURCE - 0) >= 200809
645 #define __POSIX_VISIBLE         200809
646 #define __ISO_C_VISIBLE         1999
647 #elif (_POSIX_C_SOURCE - 0) >= 200112
648 #define __POSIX_VISIBLE         200112
649 #define __ISO_C_VISIBLE         1999
650 #elif (_POSIX_C_SOURCE - 0) >= 199506
651 #define __POSIX_VISIBLE         199506
652 #define __ISO_C_VISIBLE         1990
653 #elif (_POSIX_C_SOURCE - 0) >= 199309
654 #define __POSIX_VISIBLE         199309
655 #define __ISO_C_VISIBLE         1990
656 #elif (_POSIX_C_SOURCE - 0) >= 199209
657 #define __POSIX_VISIBLE         199209
658 #define __ISO_C_VISIBLE         1990
659 #elif (_POSIX_C_SOURCE - 0) >= 199009
660 #define __POSIX_VISIBLE         199009
661 #define __ISO_C_VISIBLE         1990
662 #else
663 #define __POSIX_VISIBLE         198808
664 #define __ISO_C_VISIBLE         0
665 #endif /* _POSIX_C_SOURCE */
666 #else
667 /*-
668  * Deal with _ANSI_SOURCE:
669  * If it is defined, and no other compilation environment is explicitly
670  * requested, then define our internal feature-test macros to zero.  This
671  * makes no difference to the preprocessor (undefined symbols in preprocessing
672  * expressions are defined to have value zero), but makes it more convenient for
673  * a test program to print out the values.
674  *
675  * If a program mistakenly defines _ANSI_SOURCE and some other macro such as
676  * _POSIX_C_SOURCE, we will assume that it wants the broader compilation
677  * environment (and in fact we will never get here).
678  */
679 #if defined(_ANSI_SOURCE)       /* Hide almost everything. */
680 #define __POSIX_VISIBLE         0
681 #define __XSI_VISIBLE           0
682 #define __BSD_VISIBLE           0
683 #define __ISO_C_VISIBLE         1990
684 #define __EXT1_VISIBLE          0
685 #elif defined(_C99_SOURCE)      /* Localism to specify strict C99 env. */
686 #define __POSIX_VISIBLE         0
687 #define __XSI_VISIBLE           0
688 #define __BSD_VISIBLE           0
689 #define __ISO_C_VISIBLE         1999
690 #define __EXT1_VISIBLE          0
691 #elif defined(_C11_SOURCE)      /* Localism to specify strict C11 env. */
692 #define __POSIX_VISIBLE         0
693 #define __XSI_VISIBLE           0
694 #define __BSD_VISIBLE           0
695 #define __ISO_C_VISIBLE         2011
696 #define __EXT1_VISIBLE          0
697 #else                           /* Default environment: show everything. */
698 #define __POSIX_VISIBLE         200809
699 #define __XSI_VISIBLE           700
700 #define __BSD_VISIBLE           1
701 #define __ISO_C_VISIBLE         2011
702 #define __EXT1_VISIBLE          1
703 #endif
704 #endif
705
706 /* User override __EXT1_VISIBLE */
707 #if defined(__STDC_WANT_LIB_EXT1__)
708 #undef  __EXT1_VISIBLE
709 #if __STDC_WANT_LIB_EXT1__
710 #define __EXT1_VISIBLE          1
711 #else
712 #define __EXT1_VISIBLE          0
713 #endif
714 #endif /* __STDC_WANT_LIB_EXT1__ */
715
716 #ifndef __BSD_VISIBLE
717 #define __BSD_VISIBLE           0
718 #endif
719 #ifndef __EXT1_VISIBLE
720 #define __EXT1_VISIBLE          0
721 #endif
722
723 /*
724  * GLOBL macro exists to preserve __start_set_* and __stop_set_* sections
725  * of kernel modules which are discarded from binutils 2.17.50+ otherwise.
726  */
727
728 #define __GLOBL1(sym)   __asm__(".globl " #sym)
729 #define __GLOBL(sym)    __GLOBL1(sym)
730
731 #endif /* !_SYS_CDEFS_H_ */