cdefs.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315
  1. /* Copyright (C) 1992-2001, 2002, 2004, 2005 Free Software Foundation, Inc.
  2. This file is part of the GNU C Library.
  3. The GNU C Library is free software; you can redistribute it and/or
  4. modify it under the terms of the GNU Lesser General Public
  5. License as published by the Free Software Foundation; either
  6. version 2.1 of the License, or (at your option) any later version.
  7. The GNU C Library is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  10. Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public
  12. License along with the GNU C Library; if not, write to the Free
  13. Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  14. 02111-1307 USA. */
  15. #ifndef _SYS_CDEFS_H
  16. #define _SYS_CDEFS_H 1
  17. /* We are almost always included from features.h. */
  18. #ifndef _FEATURES_H
  19. # include <features.h>
  20. #endif
  21. /* The GNU libc does not support any K&R compilers or the traditional mode
  22. of ISO C compilers anymore. Check for some of the combinations not
  23. anymore supported. */
  24. #if defined __GNUC__ && !defined __STDC__
  25. # error "You need a ISO C conforming compiler to use the glibc headers"
  26. #endif
  27. /* Some user header file might have defined this before. */
  28. #undef __P
  29. #undef __PMT
  30. #ifdef __GNUC__
  31. /* GCC can always grok prototypes. For C++ programs we add throw()
  32. to help it optimize the function calls. But this works only with
  33. gcc 2.8.x and egcs. For gcc 3.2 and up we even mark C functions
  34. as non-throwing using a function attribute since programs can use
  35. the -fexceptions options for C code as well. */
  36. # if 0 //!defined __cplusplus && __GNUC_PREREQ (3, 3)
  37. # define __THROW __attribute__ ((__nothrow__))
  38. # define __NTH(fct) __attribute__ ((__nothrow__)) fct
  39. # else
  40. # if defined __cplusplus && __GNUC_PREREQ (2,8)
  41. # define __THROW throw ()
  42. # define __NTH(fct) fct throw ()
  43. # else
  44. # define __THROW
  45. # define __NTH(fct) fct
  46. # endif
  47. # endif
  48. #else /* Not GCC. */
  49. # define __inline /* No inline functions. */
  50. # define __THROW
  51. # define __NTH(fct) fct
  52. # define __const const
  53. # define __signed signed
  54. # define __volatile volatile
  55. #endif /* GCC. */
  56. /* These two macros are not used in glibc anymore. They are kept here
  57. only because some other projects expect the macros to be defined. */
  58. #define __P(args) args
  59. #define __PMT(args) args
  60. /* For these things, GCC behaves the ANSI way normally,
  61. and the non-ANSI way under -traditional. */
  62. #define __CONCAT(x,y) x ## y
  63. #define __STRING(x) #x
  64. /* This is not a typedef so `const __ptr_t' does the right thing. */
  65. #define __ptr_t void *
  66. #define __long_double_t long double
  67. /* C++ needs to know that types and declarations are C, not C++. */
  68. #ifdef __cplusplus
  69. # define __BEGIN_DECLS extern "C" {
  70. # define __END_DECLS }
  71. #else
  72. # define __BEGIN_DECLS
  73. # define __END_DECLS
  74. #endif
  75. /* The standard library needs the functions from the ISO C90 standard
  76. in the std namespace. At the same time we want to be safe for
  77. future changes and we include the ISO C99 code in the non-standard
  78. namespace __c99. The C++ wrapper header take case of adding the
  79. definitions to the global namespace. */
  80. #if defined __cplusplus && defined _GLIBCPP_USE_NAMESPACES
  81. # define __BEGIN_NAMESPACE_STD namespace std {
  82. # define __END_NAMESPACE_STD }
  83. # define __USING_NAMESPACE_STD(name) using std::name;
  84. # define __BEGIN_NAMESPACE_C99 namespace __c99 {
  85. # define __END_NAMESPACE_C99 }
  86. # define __USING_NAMESPACE_C99(name) using __c99::name;
  87. #else
  88. /* For compatibility we do not add the declarations into any
  89. namespace. They will end up in the global namespace which is what
  90. old code expects. */
  91. # define __BEGIN_NAMESPACE_STD
  92. # define __END_NAMESPACE_STD
  93. # define __USING_NAMESPACE_STD(name)
  94. # define __BEGIN_NAMESPACE_C99
  95. # define __END_NAMESPACE_C99
  96. # define __USING_NAMESPACE_C99(name)
  97. #endif
  98. /* Support for bounded pointers. */
  99. #ifndef __BOUNDED_POINTERS__
  100. # define __bounded /* nothing */
  101. # define __unbounded /* nothing */
  102. # define __ptrvalue /* nothing */
  103. #endif
  104. /* Fortify support. */
  105. #define __bos(ptr) __builtin_object_size (ptr, __USE_FORTIFY_LEVEL > 1)
  106. #define __bos0(ptr) __builtin_object_size (ptr, 0)
  107. #define __warndecl(name, msg) extern void name (void)
  108. /* Support for flexible arrays. */
  109. #if __GNUC_PREREQ (2,97)
  110. /* GCC 2.97 supports C99 flexible array members. */
  111. # define __flexarr []
  112. #else
  113. # ifdef __GNUC__
  114. # define __flexarr [0]
  115. # else
  116. # if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
  117. # define __flexarr []
  118. # else
  119. /* Some other non-C99 compiler. Approximate with [1]. */
  120. # define __flexarr [1]
  121. # endif
  122. # endif
  123. #endif
  124. /* __asm__ ("xyz") is used throughout the headers to rename functions
  125. at the assembly language level. This is wrapped by the __REDIRECT
  126. macro, in order to support compilers that can do this some other
  127. way. When compilers don't support asm-names at all, we have to do
  128. preprocessor tricks instead (which don't have exactly the right
  129. semantics, but it's the best we can do).
  130. Example:
  131. int __REDIRECT(setpgrp, (__pid_t pid, __pid_t pgrp), setpgid); */
  132. #if defined __GNUC__ && __GNUC__ >= 2
  133. # define __REDIRECT(name, proto, alias) name proto __asm__ (__ASMNAME (#alias))
  134. # define __ASMNAME(cname) __C_SYMBOL_PREFIX__ cname
  135. /*
  136. # ifdef __cplusplus
  137. # define __REDIRECT_NTH(name, proto, alias) \
  138. name proto __THROW __asm__ (__ASMNAME (#alias))
  139. # else
  140. # define __REDIRECT_NTH(name, proto, alias) \
  141. name proto __asm__ (__ASMNAME (#alias)) __THROW
  142. # endif
  143. # define __ASMNAME(cname) __ASMNAME2 (__USER_LABEL_PREFIX__, cname)
  144. # define __ASMNAME2(prefix, cname) __STRING (prefix) cname
  145. */
  146. /*
  147. #elif __SOME_OTHER_COMPILER__
  148. # define __REDIRECT(name, proto, alias) name proto; \
  149. _Pragma("let " #name " = " #alias)
  150. */
  151. #endif
  152. /* GCC has various useful declarations that can be made with the
  153. `__attribute__' syntax. All of the ways we use this do fine if
  154. they are omitted for compilers that don't understand it. */
  155. #if !defined __GNUC__ || __GNUC__ < 2
  156. # define __attribute__(xyz) /* Ignore */
  157. #endif
  158. /* At some point during the gcc 2.96 development the `malloc' attribute
  159. for functions was introduced. We don't want to use it unconditionally
  160. (although this would be possible) since it generates warnings. */
  161. #if __GNUC_PREREQ (2,96)
  162. # define __attribute_malloc__ __attribute__ ((__malloc__))
  163. #else
  164. # define __attribute_malloc__ /* Ignore */
  165. #endif
  166. /* At some point during the gcc 2.96 development the `pure' attribute
  167. for functions was introduced. We don't want to use it unconditionally
  168. (although this would be possible) since it generates warnings. */
  169. #if __GNUC_PREREQ (2,96)
  170. # define __attribute_pure__ __attribute__ ((__pure__))
  171. #else
  172. # define __attribute_pure__ /* Ignore */
  173. #endif
  174. /* At some point during the gcc 3.1 development the `used' attribute
  175. for functions was introduced. We don't want to use it unconditionally
  176. (although this would be possible) since it generates warnings. */
  177. #if __GNUC_PREREQ (3,1)
  178. # define __attribute_used__ __attribute__ ((__used__))
  179. # define __attribute_noinline__ __attribute__ ((__noinline__))
  180. #else
  181. # define __attribute_used__ __attribute__ ((__unused__))
  182. # define __attribute_noinline__ /* Ignore */
  183. #endif
  184. /* gcc allows marking deprecated functions. */
  185. #if __GNUC_PREREQ (3,2)
  186. # define __attribute_deprecated__ __attribute__ ((__deprecated__))
  187. #else
  188. # define __attribute_deprecated__ /* Ignore */
  189. #endif
  190. /* At some point during the gcc 2.8 development the `format_arg' attribute
  191. for functions was introduced. We don't want to use it unconditionally
  192. (although this would be possible) since it generates warnings.
  193. If several `format_arg' attributes are given for the same function, in
  194. gcc-3.0 and older, all but the last one are ignored. In newer gccs,
  195. all designated arguments are considered. */
  196. #if __GNUC_PREREQ (2,8)
  197. # define __attribute_format_arg__(x) __attribute__ ((__format_arg__ (x)))
  198. #else
  199. # define __attribute_format_arg__(x) /* Ignore */
  200. #endif
  201. /* At some point during the gcc 2.97 development the `strfmon' format
  202. attribute for functions was introduced. We don't want to use it
  203. unconditionally (although this would be possible) since it
  204. generates warnings. */
  205. #if __GNUC_PREREQ (2,97)
  206. # define __attribute_format_strfmon__(a,b) \
  207. __attribute__ ((__format__ (__strfmon__, a, b)))
  208. #else
  209. # define __attribute_format_strfmon__(a,b) /* Ignore */
  210. #endif
  211. /* The nonull function attribute allows to mark pointer parameters which
  212. must not be NULL. */
  213. #if __GNUC_PREREQ (3,3)
  214. # define __nonnull(params) __attribute__ ((__nonnull__ params))
  215. #else
  216. # define __nonnull(params)
  217. #endif
  218. /* If fortification mode, we warn about unused results of certain
  219. function calls which can lead to problems. */
  220. #if __GNUC_PREREQ (3,4)
  221. # define __attribute_warn_unused_result__ \
  222. __attribute__ ((__warn_unused_result__))
  223. # if __USE_FORTIFY_LEVEL > 0
  224. # define __wur __attribute_warn_unused_result__
  225. # endif
  226. #else
  227. # define __attribute_warn_unused_result__ /* empty */
  228. #endif
  229. #ifndef __wur
  230. # define __wur /* Ignore */
  231. #endif
  232. /* Forces a function to be always inlined. */
  233. #if __GNUC_PREREQ (3,2)
  234. # define __always_inline __inline __attribute__ ((__always_inline__))
  235. #else
  236. # define __always_inline __inline
  237. #endif
  238. /* It is possible to compile containing GCC extensions even if GCC is
  239. run in pedantic mode if the uses are carefully marked using the
  240. `__extension__' keyword. But this is not generally available before
  241. version 2.8. */
  242. #if !__GNUC_PREREQ (2,8)
  243. # define __extension__ /* Ignore */
  244. #endif
  245. /* __restrict is known in EGCS 1.2 and above. */
  246. #if !__GNUC_PREREQ (2,92)
  247. # define __restrict /* Ignore */
  248. #endif
  249. /* ISO C99 also allows to declare arrays as non-overlapping. The syntax is
  250. array_name[restrict]
  251. GCC 3.1 supports this. */
  252. #if __GNUC_PREREQ (3,1) && !defined __GNUG__
  253. # define __restrict_arr __restrict
  254. #else
  255. # ifdef __GNUC__
  256. # define __restrict_arr /* Not supported in old GCC. */
  257. # else
  258. # if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
  259. # define __restrict_arr restrict
  260. # else
  261. /* Some other non-C99 compiler. */
  262. # define __restrict_arr /* Not supported. */
  263. # endif
  264. # endif
  265. #endif
  266. #endif /* sys/cdefs.h */