1 /* Copyright (C) 1992-2001, 2002, 2004, 2005, 2006, 2007
2 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <http://www.gnu.org/licenses/>. */
20 #define _SYS_CDEFS_H 1
22 /* We are almost always included from features.h. */
24 # include <features.h>
27 /* The GNU libc does not support any K&R compilers or the traditional mode
28 of ISO C compilers anymore. Check for some of the combinations not
30 #if defined __GNUC__ && !defined __STDC__
31 # error "You need a ISO C conforming compiler to use the glibc headers"
34 /* Some user header file might have defined this before. */
40 /* GCC can always grok prototypes. For C++ programs we add throw()
41 to help it optimize the function calls. But this works only with
42 gcc 2.8.x and egcs. For gcc 3.2 and up we even mark C functions
43 as non-throwing using a function attribute since programs can use
44 the -fexceptions options for C code as well. */
45 # if !defined __cplusplus && __GNUC_PREREQ (3, 3)
46 # define __THROW __attribute__ ((__nothrow__))
47 # define __NTH(fct) __attribute__ ((__nothrow__)) fct
49 # if defined __cplusplus && __GNUC_PREREQ (2,8)
50 # define __THROW throw ()
51 # define __NTH(fct) fct throw ()
54 # define __NTH(fct) fct
60 # define __inline /* No inline functions. */
63 # define __NTH(fct) fct
67 /* These two macros are not used in glibc anymore. They are kept here
68 only because some other projects expect the macros to be defined. */
69 #define __P(args) args
70 #define __PMT(args) args
72 /* For these things, GCC behaves the ANSI way normally,
73 and the non-ANSI way under -traditional. */
75 #define __CONCAT(x,y) x ## y
76 #define __STRING(x) #x
78 /* This is not a typedef so `const __ptr_t' does the right thing. */
79 #define __ptr_t void *
80 #define __long_double_t long double
83 /* C++ needs to know that types and declarations are C, not C++. */
85 # define __BEGIN_DECLS extern "C" {
86 # define __END_DECLS }
88 # define __BEGIN_DECLS
93 /* The standard library needs the functions from the ISO C90 standard
94 in the std namespace. At the same time we want to be safe for
95 future changes and we include the ISO C99 code in the non-standard
96 namespace __c99. The C++ wrapper header take case of adding the
97 definitions to the global namespace. */
98 #if defined __cplusplus && defined _GLIBCPP_USE_NAMESPACES
99 # define __BEGIN_NAMESPACE_STD namespace std {
100 # define __END_NAMESPACE_STD }
101 # define __USING_NAMESPACE_STD(name) using std::name;
102 # define __BEGIN_NAMESPACE_C99 namespace __c99 {
103 # define __END_NAMESPACE_C99 }
104 # define __USING_NAMESPACE_C99(name) using __c99::name;
106 /* For compatibility we do not add the declarations into any
107 namespace. They will end up in the global namespace which is what
109 # define __BEGIN_NAMESPACE_STD
110 # define __END_NAMESPACE_STD
111 # define __USING_NAMESPACE_STD(name)
112 # define __BEGIN_NAMESPACE_C99
113 # define __END_NAMESPACE_C99
114 # define __USING_NAMESPACE_C99(name)
118 /* Fortify support. */
119 #define __bos(ptr) __builtin_object_size (ptr, __USE_FORTIFY_LEVEL > 1)
120 #define __bos0(ptr) __builtin_object_size (ptr, 0)
122 #if __GNUC_PREREQ (4,3)
123 # define __warndecl(name, msg) \
124 extern void name (void) __attribute__((__warning__ (msg)))
125 # define __warnattr(msg) __attribute__((__warning__ (msg)))
126 # define __errordecl(name, msg) \
127 extern void name (void) __attribute__((__error__ (msg)))
129 # define __warndecl(name, msg) extern void name (void)
130 # define __warnattr(msg)
131 # define __errordecl(name, msg) extern void name (void)
134 /* Support for flexible arrays. */
135 #if __GNUC_PREREQ (2,97)
136 /* GCC 2.97 supports C99 flexible array members. */
137 # define __flexarr []
140 # define __flexarr [0]
142 # if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
143 # define __flexarr []
145 /* Some other non-C99 compiler. Approximate with [1]. */
146 # define __flexarr [1]
152 /* __asm__ ("xyz") is used throughout the headers to rename functions
153 at the assembly language level. This is wrapped by the __REDIRECT
154 macro, in order to support compilers that can do this some other
155 way. When compilers don't support asm-names at all, we have to do
156 preprocessor tricks instead (which don't have exactly the right
157 semantics, but it's the best we can do).
160 int __REDIRECT(setpgrp, (__pid_t pid, __pid_t pgrp), setpgid); */
162 #if defined __GNUC__ && __GNUC__ >= 2
164 # define __REDIRECT(name, proto, alias) name proto __asm__ (__ASMNAME (#alias))
166 # define __REDIRECT_NTH(name, proto, alias) \
167 name proto __THROW __asm__ (__ASMNAME (#alias))
169 # define __REDIRECT_NTH(name, proto, alias) \
170 name proto __asm__ (__ASMNAME (#alias)) __THROW
172 # define __ASMNAME(cname) __ASMNAME2 (__USER_LABEL_PREFIX__, cname)
173 # define __ASMNAME2(prefix, cname) __STRING (prefix) cname
176 #elif __SOME_OTHER_COMPILER__
178 # define __REDIRECT(name, proto, alias) name proto; \
179 _Pragma("let " #name " = " #alias)
183 /* GCC has various useful declarations that can be made with the
184 `__attribute__' syntax. All of the ways we use this do fine if
185 they are omitted for compilers that don't understand it. */
186 #if !defined __GNUC__ || __GNUC__ < 2
187 # define __attribute__(xyz) /* Ignore */
190 /* We make this a no-op unless it can be used as both a variable and
191 a type attribute. gcc 2.8 is known to support both. */
192 #if __GNUC_PREREQ (2,8)
193 # define __attribute_aligned__(size) __attribute__ ((__aligned__ (size)))
195 # define __attribute_aligned__(size) /* Ignore */
198 /* At some point during the gcc 2.96 development the `malloc' attribute
199 for functions was introduced. We don't want to use it unconditionally
200 (although this would be possible) since it generates warnings. */
201 #if __GNUC_PREREQ (2,96)
202 # define __attribute_malloc__ __attribute__ ((__malloc__))
204 # define __attribute_malloc__ /* Ignore */
207 /* At some point during the gcc 2.96 development the `pure' attribute
208 for functions was introduced. We don't want to use it unconditionally
209 (although this would be possible) since it generates warnings. */
210 #if __GNUC_PREREQ (2,96)
211 # define __attribute_pure__ __attribute__ ((__pure__))
213 # define __attribute_pure__ /* Ignore */
216 /* At some point during the gcc 3.1 development the `used' attribute
217 for functions was introduced. We don't want to use it unconditionally
218 (although this would be possible) since it generates warnings. */
219 #if __GNUC_PREREQ (3,1)
220 # define __attribute_used__ __attribute__ ((__used__))
221 # define __attribute_noinline__ __attribute__ ((__noinline__))
223 # define __attribute_used__ __attribute__ ((__unused__))
224 # define __attribute_noinline__ /* Ignore */
227 /* gcc allows marking deprecated functions. */
228 #if __GNUC_PREREQ (3,2) && !defined(__UCLIBC_HIDE_DEPRECATED__)
229 # define __attribute_deprecated__ __attribute__ ((__deprecated__))
231 # define __attribute_deprecated__ /* Ignore */
234 /* At some point during the gcc 2.8 development the `format_arg' attribute
235 for functions was introduced. We don't want to use it unconditionally
236 (although this would be possible) since it generates warnings.
237 If several `format_arg' attributes are given for the same function, in
238 gcc-3.0 and older, all but the last one are ignored. In newer gccs,
239 all designated arguments are considered. */
240 #if __GNUC_PREREQ (2,8)
241 # define __attribute_format_arg__(x) __attribute__ ((__format_arg__ (x)))
243 # define __attribute_format_arg__(x) /* Ignore */
246 /* At some point during the gcc 2.97 development the `strfmon' format
247 attribute for functions was introduced. We don't want to use it
248 unconditionally (although this would be possible) since it
249 generates warnings. */
250 #if __GNUC_PREREQ (2,97)
251 # define __attribute_format_strfmon__(a,b) \
252 __attribute__ ((__format__ (__strfmon__, a, b)))
254 # define __attribute_format_strfmon__(a,b) /* Ignore */
257 /* The nonull function attribute allows to mark pointer parameters which
259 #if __GNUC_PREREQ (3,3)
260 # define __nonnull(params) __attribute__ ((__nonnull__ params))
262 # define __nonnull(params)
265 /* If fortification mode, we warn about unused results of certain
266 function calls which can lead to problems. */
267 #if __GNUC_PREREQ (3,4)
268 # define __attribute_warn_unused_result__ \
269 __attribute__ ((__warn_unused_result__))
270 # if __USE_FORTIFY_LEVEL > 0
271 # define __wur __attribute_warn_unused_result__
274 # define __attribute_warn_unused_result__ /* empty */
277 # define __wur /* Ignore */
280 /* Forces a function to be always inlined. */
281 #if __GNUC_PREREQ (3,2)
282 # define __always_inline __inline __attribute__ ((__always_inline__))
284 # define __always_inline __inline
287 /* GCC 4.3 and above with -std=c99 or -std=gnu99 implements ISO C99
288 inline semantics, unless -fgnu89-inline is used.
289 For -std=gnu99, forcing gnu_inline attribute does not change behavior,
290 but may silence spurious warnings (such as in GCC 4.2). */
291 #if !defined __cplusplus || __GNUC_PREREQ (4,3)
292 # if defined __GNUC_STDC_INLINE__ || defined __GNUC_GNU_INLINE__ || defined __cplusplus
293 # define __extern_inline extern __inline __attribute__ ((__gnu_inline__))
294 # if __GNUC_PREREQ (4,3)
295 # define __extern_always_inline \
296 extern __always_inline __attribute__ ((__gnu_inline__, __artificial__))
298 # define __extern_always_inline \
299 extern __always_inline __attribute__ ((__gnu_inline__))
302 # define __extern_inline extern __inline
303 # define __extern_always_inline extern __always_inline
307 /* GCC 4.3 and above allow passing all anonymous arguments of an
308 __extern_always_inline function to some other vararg function. */
309 #if __GNUC_PREREQ (4,3)
310 # define __va_arg_pack() __builtin_va_arg_pack ()
311 # define __va_arg_pack_len() __builtin_va_arg_pack_len ()
314 /* It is possible to compile containing GCC extensions even if GCC is
315 run in pedantic mode if the uses are carefully marked using the
316 `__extension__' keyword. But this is not generally available before
318 #if !__GNUC_PREREQ (2,8)
319 # define __extension__ /* Ignore */
322 /* __restrict is known in EGCS 1.2 and above. */
323 #if !__GNUC_PREREQ (2,92)
324 # define __restrict /* Ignore */
327 /* ISO C99 also allows to declare arrays as non-overlapping. The syntax is
329 GCC 3.1 supports this. */
330 #if __GNUC_PREREQ (3,1) && !defined __GNUG__
331 # define __restrict_arr __restrict
334 # define __restrict_arr /* Not supported in old GCC. */
336 # if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
337 # define __restrict_arr restrict
339 /* Some other non-C99 compiler. */
340 # define __restrict_arr /* Not supported. */
345 #endif /* sys/cdefs.h */