]>
Commit | Line | Data |
---|---|---|
24d6fe58 | 1 | /* Copyright (C) 1991,92,93,95,96,97,98,99, 2000 Free Software Foundation, Inc. |
2c6fe0bd | 2 | This file is part of the GNU C Library. |
28f540f4 | 3 | |
2c6fe0bd UD |
4 | The GNU C Library is free software; you can redistribute it and/or |
5 | modify it under the terms of the GNU Library General Public License as | |
6 | published by the Free Software Foundation; either version 2 of the | |
7 | License, or (at your option) any later version. | |
28f540f4 | 8 | |
2c6fe0bd UD |
9 | The GNU C Library is distributed in the hope that it will be useful, |
10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
12 | Library General Public License for more details. | |
28f540f4 | 13 | |
2c6fe0bd UD |
14 | You should have received a copy of the GNU Library General Public |
15 | License along with the GNU C Library; see the file COPYING.LIB. If not, | |
16 | write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
17 | Boston, MA 02111-1307, USA. */ | |
28f540f4 RM |
18 | |
19 | #ifndef _FEATURES_H | |
28f540f4 RM |
20 | #define _FEATURES_H 1 |
21 | ||
22 | /* These are defined by the user (or the compiler) | |
23 | to specify the desired environment: | |
24 | ||
d38cd08c | 25 | __STRICT_ANSI__ ISO Standard C. |
ec751a23 | 26 | _ISOC99_SOURCE Extensions to ISO C89 from ISO C99. |
28f540f4 | 27 | _POSIX_SOURCE IEEE Std 1003.1. |
6d52618b | 28 | _POSIX_C_SOURCE If ==1, like _POSIX_SOURCE; if >=2 add IEEE Std 1003.2; |
118bad87 UD |
29 | if >=199309L, add IEEE Std 1003.1b-1993; |
30 | if >=199506L, add IEEE Std 1003.1c-1995 | |
a5a0310d UD |
31 | _XOPEN_SOURCE Includes POSIX and XPG things. Set to 500 if |
32 | Single Unix conformance is wanted. | |
2c6fe0bd | 33 | _XOPEN_SOURCE_EXTENDED XPG things and X/Open Unix extensions. |
dfd2257a UD |
34 | _LARGEFILE_SOURCE Some more functions for correct standard I/O. |
35 | _LARGEFILE64_SOURCE Additional functionality from LFS for large files. | |
36 | _FILE_OFFSET_BITS=N Select default filesystem interface. | |
d38cd08c UD |
37 | _BSD_SOURCE ISO C, POSIX, and 4.3BSD things. |
38 | _SVID_SOURCE ISO C, POSIX, and SVID things. | |
28f540f4 | 39 | _GNU_SOURCE All of the above, plus GNU extensions. |
ec4b0518 UD |
40 | _REENTRANT Select additionally reentrant object. |
41 | _THREAD_SAFE Same as _REENTRANT, often used by other systems. | |
28f540f4 RM |
42 | |
43 | The `-ansi' switch to the GNU C compiler defines __STRICT_ANSI__. | |
d3669add | 44 | If none of these are defined, the default is all but _GNU_SOURCE. |
28f540f4 RM |
45 | If more than one of these are defined, they accumulate. |
46 | For example __STRICT_ANSI__, _POSIX_SOURCE and _POSIX_C_SOURCE | |
d38cd08c | 47 | together give you ISO C, 1003.1, and 1003.2, but nothing else. |
28f540f4 RM |
48 | |
49 | These are defined by this file and are used by the | |
50 | header files to decide what to declare or define: | |
51 | ||
ec751a23 | 52 | __USE_ISOC99 Define ISO C99 things. |
28f540f4 RM |
53 | __USE_POSIX Define IEEE Std 1003.1 things. |
54 | __USE_POSIX2 Define IEEE Std 1003.2 things. | |
4a582094 UD |
55 | __USE_POSIX199309 Define IEEE Std 1003.1, and .1b things. |
56 | __USE_POSIX199506 Define IEEE Std 1003.1, .1b, .1c and .1i things. | |
2c6fe0bd UD |
57 | __USE_XOPEN Define XPG things. |
58 | __USE_XOPEN_EXTENDED Define X/Open Unix things. | |
a5a0310d | 59 | __USE_UNIX98 Define Single Unix V2 things. |
24d6fe58 | 60 | __USE_XOPEN2K Define XPG6 things |
dfd2257a UD |
61 | __USE_LARGEFILE64 Define LFS things with separate names. |
62 | __USE_FILE_OFFSET64 Define 64bit interface as default. | |
28f540f4 RM |
63 | __USE_BSD Define 4.3BSD things. |
64 | __USE_SVID Define SVID things. | |
65 | __USE_MISC Define things common to BSD and System V Unix. | |
66 | __USE_GNU Define GNU extensions. | |
aa910907 | 67 | __USE_REENTRANT Define reentrant/thread-safe *_r functions. |
28f540f4 RM |
68 | __FAVOR_BSD Favor 4.3BSD things in cases of conflict. |
69 | ||
d38cd08c UD |
70 | The macros `__GNU_LIBRARY__', `__GLIBC__', and `__GLIBC_MINOR__' are |
71 | defined by this file unconditionally. `__GNU_LIBRARY__' is provided | |
72 | only for compatibility. All new code should use the other symbols | |
73 | to test for features. | |
28f540f4 | 74 | |
28f540f4 RM |
75 | All macros listed above as possibly being defined by this file are |
76 | explicitly undefined if they are not explicitly defined. | |
77 | Feature-test macros that are not defined by the user or compiler | |
78 | but are implied by the other feature-test macros defined (or by the | |
79 | lack of any definitions) are defined by the file. */ | |
80 | ||
81 | ||
82 | /* Undefine everything, so we get a clean slate. */ | |
ec751a23 | 83 | #undef __USE_ISOC99 |
28f540f4 RM |
84 | #undef __USE_POSIX |
85 | #undef __USE_POSIX2 | |
6d52618b | 86 | #undef __USE_POSIX199309 |
4a582094 | 87 | #undef __USE_POSIX199506 |
2c6fe0bd UD |
88 | #undef __USE_XOPEN |
89 | #undef __USE_XOPEN_EXTENDED | |
dfd2257a | 90 | #undef __USE_UNIX98 |
24d6fe58 | 91 | #undef __USE_XOPEN2K |
dfd2257a UD |
92 | #undef __USE_LARGEFILE |
93 | #undef __USE_LARGEFILE64 | |
94 | #undef __USE_FILE_OFFSET64 | |
28f540f4 RM |
95 | #undef __USE_BSD |
96 | #undef __USE_SVID | |
97 | #undef __USE_MISC | |
98 | #undef __USE_GNU | |
aa910907 | 99 | #undef __USE_REENTRANT |
28f540f4 | 100 | #undef __FAVOR_BSD |
a1470b6f | 101 | #undef __KERNEL_STRICT_NAMES |
28f540f4 | 102 | |
a1470b6f | 103 | /* Suppress kernel-name space pollution unless user expressedly asks |
2c6fe0bd | 104 | for it. */ |
a1470b6f RM |
105 | #ifndef _LOOSE_KERNEL_NAMES |
106 | # define __KERNEL_STRICT_NAMES | |
107 | #endif | |
28f540f4 | 108 | |
d38cd08c | 109 | /* Always use ISO C things. */ |
28f540f4 RM |
110 | #define __USE_ANSI 1 |
111 | ||
112 | ||
113 | /* If _BSD_SOURCE was defined by the user, favor BSD over POSIX. */ | |
d38cd08c UD |
114 | #if defined _BSD_SOURCE && \ |
115 | !(defined _POSIX_SOURCE || defined _POSIX_C_SOURCE || \ | |
df4ef2ab | 116 | defined _XOPEN_SOURCE || defined _XOPEN_SOURCE_EXTENDED || \ |
d38cd08c | 117 | defined _GNU_SOURCE || defined _SVID_SOURCE) |
2c6fe0bd | 118 | # define __FAVOR_BSD 1 |
28f540f4 RM |
119 | #endif |
120 | ||
59dd8641 RM |
121 | /* If _GNU_SOURCE was defined by the user, turn on all the other features. */ |
122 | #ifdef _GNU_SOURCE | |
ec751a23 UD |
123 | # undef _ISOC99_SOURCE |
124 | # define _ISOC99_SOURCE 1 | |
5107cf1d UD |
125 | # undef _POSIX_SOURCE |
126 | # define _POSIX_SOURCE 1 | |
127 | # undef _POSIX_C_SOURCE | |
dd7d45e8 | 128 | # define _POSIX_C_SOURCE 199506L |
5107cf1d | 129 | # undef _XOPEN_SOURCE |
219aa9e9 | 130 | # define _XOPEN_SOURCE 600 |
5107cf1d UD |
131 | # undef _XOPEN_SOURCE_EXTENDED |
132 | # define _XOPEN_SOURCE_EXTENDED 1 | |
dfd2257a UD |
133 | # undef _LARGEFILE64_SOURCE |
134 | # define _LARGEFILE64_SOURCE 1 | |
5107cf1d UD |
135 | # undef _BSD_SOURCE |
136 | # define _BSD_SOURCE 1 | |
137 | # undef _SVID_SOURCE | |
138 | # define _SVID_SOURCE 1 | |
59dd8641 | 139 | #endif |
28f540f4 RM |
140 | |
141 | /* If nothing (other than _GNU_SOURCE) is defined, | |
142 | define _BSD_SOURCE and _SVID_SOURCE. */ | |
ec751a23 | 143 | #if (!defined __STRICT_ANSI__ && !defined _ISOC99_SOURCE && \ |
2f6d1f1b UD |
144 | !defined _POSIX_SOURCE && !defined _POSIX_C_SOURCE && \ |
145 | !defined _XOPEN_SOURCE && !defined _XOPEN_SOURCE_EXTENDED && \ | |
146 | !defined _BSD_SOURCE && !defined _SVID_SOURCE) | |
5107cf1d UD |
147 | # define _BSD_SOURCE 1 |
148 | # define _SVID_SOURCE 1 | |
28f540f4 RM |
149 | #endif |
150 | ||
ec751a23 UD |
151 | /* This is to enable the ISO C99 extension. Also recognize the old macro |
152 | which was used prior to the standard acceptance. This macro will | |
153 | eventually go away and the features enabled by default once the ISO C99 | |
154 | standard is widely adopted. */ | |
155 | #if defined _ISOC99_SOURCE || defined _ISOC9X_SOURCE | |
156 | # define __USE_ISOC99 1 | |
2f6d1f1b UD |
157 | #endif |
158 | ||
6d52618b UD |
159 | /* If none of the ANSI/POSIX macros are defined, use POSIX.1 and POSIX.2 |
160 | (and IEEE Std 1003.1b-1993 unless _XOPEN_SOURCE is defined). */ | |
d38cd08c UD |
161 | #if (!defined __STRICT_ANSI__ && !defined _POSIX_SOURCE && \ |
162 | !defined _POSIX_C_SOURCE) | |
5107cf1d | 163 | # define _POSIX_SOURCE 1 |
dfd2257a | 164 | # if defined _XOPEN_SOURCE && (_XOPEN_SOURCE - 0) != 500 |
5107cf1d UD |
165 | # define _POSIX_C_SOURCE 2 |
166 | # else | |
dd7d45e8 | 167 | # define _POSIX_C_SOURCE 199506L |
5107cf1d | 168 | # endif |
28f540f4 RM |
169 | #endif |
170 | ||
d38cd08c | 171 | #if defined _POSIX_SOURCE || _POSIX_C_SOURCE >= 1 || defined _XOPEN_SOURCE |
5107cf1d | 172 | # define __USE_POSIX 1 |
28f540f4 RM |
173 | #endif |
174 | ||
d38cd08c | 175 | #if defined _POSIX_C_SOURCE && _POSIX_C_SOURCE >= 2 || defined _XOPEN_SOURCE |
5107cf1d | 176 | # define __USE_POSIX2 1 |
28f540f4 RM |
177 | #endif |
178 | ||
9756dfe1 UD |
179 | #if (_POSIX_C_SOURCE - 0) >= 199309L |
180 | # define __USE_POSIX199309 1 | |
6d52618b UD |
181 | #endif |
182 | ||
4a582094 UD |
183 | #if (_POSIX_C_SOURCE - 0) >= 199506L |
184 | # define __USE_POSIX199506 1 | |
185 | #endif | |
186 | ||
2c6fe0bd | 187 | #ifdef _XOPEN_SOURCE |
5107cf1d | 188 | # define __USE_XOPEN 1 |
219aa9e9 | 189 | # if (_XOPEN_SOURCE - 0) >= 500 |
5107cf1d | 190 | # define __USE_XOPEN_EXTENDED 1 |
a5a0310d | 191 | # define __USE_UNIX98 1 |
dfd2257a UD |
192 | # undef _LARGEFILE_SOURCE |
193 | # define _LARGEFILE_SOURCE 1 | |
219aa9e9 UD |
194 | # if (_XOPEN_SOURCE - 0) == 600 |
195 | # define __USE_XOPEN2K 1 | |
196 | # endif | |
a5a0310d UD |
197 | # else |
198 | # ifdef _XOPEN_SOURCE_EXTENDED | |
199 | # define __USE_XOPEN_EXTENDED 1 | |
200 | # endif | |
5107cf1d | 201 | # endif |
2c6fe0bd UD |
202 | #endif |
203 | ||
dfd2257a UD |
204 | #ifdef _LARGEFILE_SOURCE |
205 | # define __USE_LARGEFILE 1 | |
206 | #endif | |
207 | ||
208 | #ifdef _LARGEFILE64_SOURCE | |
209 | # define __USE_LARGEFILE64 1 | |
210 | #endif | |
211 | ||
212 | #if defined _FILE_OFFSET_BITS && _FILE_OFFSET_BITS == 64 | |
213 | # define __USE_FILE_OFFSET64 1 | |
214 | #endif | |
215 | ||
d38cd08c | 216 | #if defined _BSD_SOURCE || defined _SVID_SOURCE |
5107cf1d | 217 | # define __USE_MISC 1 |
28f540f4 RM |
218 | #endif |
219 | ||
220 | #ifdef _BSD_SOURCE | |
5107cf1d | 221 | # define __USE_BSD 1 |
28f540f4 RM |
222 | #endif |
223 | ||
224 | #ifdef _SVID_SOURCE | |
5107cf1d | 225 | # define __USE_SVID 1 |
28f540f4 RM |
226 | #endif |
227 | ||
228 | #ifdef _GNU_SOURCE | |
5107cf1d | 229 | # define __USE_GNU 1 |
28f540f4 RM |
230 | #endif |
231 | ||
d38cd08c | 232 | #if defined _REENTRANT || defined _THREAD_SAFE |
5107cf1d | 233 | # define __USE_REENTRANT 1 |
aa910907 RM |
234 | #endif |
235 | ||
d705269e UD |
236 | /* We do support the IEC 559 math functionality, real and complex. */ |
237 | #define __STDC_IEC_559__ 1 | |
238 | #define __STDC_IEC_559_COMPLEX__ 1 | |
28f540f4 | 239 | |
ba1ffaa1 UD |
240 | /* This macro indicates that the installed library is the GNU C Library. |
241 | For historic reasons the value now is 6 and this will stay from now | |
242 | on. The use of this variable is deprecated. Use __GLIBC__ and | |
243 | __GLIBC_MINOR__ now (see below) when you want to test for a specific | |
244 | GNU C library version and use the values in <gnu/lib-names.h> to get | |
245 | the sonames of the shared libraries. */ | |
246 | #undef __GNU_LIBRARY__ | |
247 | #define __GNU_LIBRARY__ 6 | |
248 | ||
249 | /* Major and minor version number of the GNU C library package. Use | |
250 | these macros to test for features in specific releases. */ | |
251 | #define __GLIBC__ 2 | |
0a1752b8 | 252 | #define __GLIBC_MINOR__ 2 |
28f540f4 | 253 | |
4360eafd UD |
254 | /* Convenience macros to test the versions of glibc and gcc. |
255 | Use them like this: | |
256 | #if __GNUC_PREREQ (2,8) | |
257 | ... code requiring gcc 2.8 or later ... | |
258 | #endif | |
259 | Note - they won't work for gcc1 or glibc1, since the _MINOR macros | |
260 | were not defined then. */ | |
f042f18f UD |
261 | #if defined __GNUC__ && defined __GNUC_MINOR__ |
262 | # define __GNUC_PREREQ(maj, min) \ | |
263 | ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min)) | |
264 | #else | |
265 | # define __GNUC_PREREQ(maj, min) 0 | |
266 | #endif | |
267 | ||
268 | #define __GLIBC_PREREQ(maj, min) \ | |
269 | ((__GLIBC__ << 16) + __GLIBC_MINOR__ >= ((maj) << 16) + (min)) | |
4360eafd | 270 | |
28f540f4 | 271 | /* This is here only because every header file already includes this one. */ |
edf5b2d7 | 272 | #ifndef __ASSEMBLER__ |
4360eafd | 273 | #ifndef _SYS_CDEFS_H |
5107cf1d | 274 | # include <sys/cdefs.h> |
4360eafd | 275 | #endif |
01cad722 UD |
276 | |
277 | /* If we don't have __REDIRECT, prototypes will be missing if | |
278 | __USE_FILE_OFFSET64 but not __USE_LARGEFILE[64]. */ | |
279 | # if defined __USE_FILE_OFFSET64 && !defined __REDIRECT | |
280 | # define __USE_LARGEFILE | |
281 | # define __USE_LARGEFILE64 | |
282 | # endif | |
283 | ||
eedbbe58 UD |
284 | #endif /* !ASSEMBLER */ |
285 | ||
286 | /* Decide whether we can define 'extern inline' functions in headers. */ | |
655c0697 | 287 | #if __GNUC_PREREQ (2, 7) && defined __OPTIMIZE__ && !defined __OPTIMIZE_SIZE__ |
eedbbe58 | 288 | # define __USE_EXTERN_INLINES 1 |
edf5b2d7 | 289 | #endif |
28f540f4 RM |
290 | |
291 | /* This is here only because every header file already includes this one. */ | |
292 | #ifndef _LIBC | |
293 | /* Get the definitions of all the appropriate `__stub_FUNCTION' symbols. | |
6bc31da0 | 294 | <gnu/stubs.h> contains `#define __stub_FUNCTION' when FUNCTION is a stub |
28f540f4 RM |
295 | which will always return failure (and set errno to ENOSYS). |
296 | ||
6bc31da0 | 297 | We avoid including <gnu/stubs.h> when compiling the C library itself to |
28f540f4 RM |
298 | avoid a dependency loop. stubs.h depends on every object file. If |
299 | this #include were done for the library source code, then every object | |
300 | file would depend on stubs.h. */ | |
301 | ||
5107cf1d | 302 | # include <gnu/stubs.h> |
28f540f4 RM |
303 | #endif |
304 | ||
6ed0492f | 305 | #endif /* features.h */ |