]>
Commit | Line | Data |
---|---|---|
df4ef2ab | 1 | /* Copyright (C) 1991, 92, 93, 95, 96, 97 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. |
2f6d1f1b | 26 | _ISOC9X_SOURCE Extensions to ISO C 89 from ISO C 9x. |
28f540f4 | 27 | _POSIX_SOURCE IEEE Std 1003.1. |
6d52618b UD |
28 | _POSIX_C_SOURCE If ==1, like _POSIX_SOURCE; if >=2 add IEEE Std 1003.2; |
29 | if >=199309L, add IEEE Std 1003.1b-1993 | |
a5a0310d UD |
30 | _XOPEN_SOURCE Includes POSIX and XPG things. Set to 500 if |
31 | Single Unix conformance is wanted. | |
2c6fe0bd | 32 | _XOPEN_SOURCE_EXTENDED XPG things and X/Open Unix extensions. |
dfd2257a UD |
33 | _LARGEFILE_SOURCE Some more functions for correct standard I/O. |
34 | _LARGEFILE64_SOURCE Additional functionality from LFS for large files. | |
35 | _FILE_OFFSET_BITS=N Select default filesystem interface. | |
d38cd08c UD |
36 | _BSD_SOURCE ISO C, POSIX, and 4.3BSD things. |
37 | _SVID_SOURCE ISO C, POSIX, and SVID things. | |
28f540f4 | 38 | _GNU_SOURCE All of the above, plus GNU extensions. |
ec4b0518 UD |
39 | _REENTRANT Select additionally reentrant object. |
40 | _THREAD_SAFE Same as _REENTRANT, often used by other systems. | |
28f540f4 RM |
41 | |
42 | The `-ansi' switch to the GNU C compiler defines __STRICT_ANSI__. | |
d3669add | 43 | If none of these are defined, the default is all but _GNU_SOURCE. |
28f540f4 RM |
44 | If more than one of these are defined, they accumulate. |
45 | For example __STRICT_ANSI__, _POSIX_SOURCE and _POSIX_C_SOURCE | |
d38cd08c | 46 | together give you ISO C, 1003.1, and 1003.2, but nothing else. |
28f540f4 RM |
47 | |
48 | These are defined by this file and are used by the | |
49 | header files to decide what to declare or define: | |
50 | ||
2f6d1f1b | 51 | __USE_ISOC9X Define ISO C 9X things. |
28f540f4 RM |
52 | __USE_POSIX Define IEEE Std 1003.1 things. |
53 | __USE_POSIX2 Define IEEE Std 1003.2 things. | |
6d52618b | 54 | __USE_POSIX199309 Define IEEE Std 1003.1b things. |
2c6fe0bd UD |
55 | __USE_XOPEN Define XPG things. |
56 | __USE_XOPEN_EXTENDED Define X/Open Unix things. | |
a5a0310d | 57 | __USE_UNIX98 Define Single Unix V2 things. |
dfd2257a UD |
58 | __USE_LARGEFILE64 Define LFS things with separate names. |
59 | __USE_FILE_OFFSET64 Define 64bit interface as default. | |
28f540f4 RM |
60 | __USE_BSD Define 4.3BSD things. |
61 | __USE_SVID Define SVID things. | |
62 | __USE_MISC Define things common to BSD and System V Unix. | |
63 | __USE_GNU Define GNU extensions. | |
aa910907 | 64 | __USE_REENTRANT Define reentrant/thread-safe *_r functions. |
28f540f4 RM |
65 | __FAVOR_BSD Favor 4.3BSD things in cases of conflict. |
66 | ||
d38cd08c UD |
67 | The macros `__GNU_LIBRARY__', `__GLIBC__', and `__GLIBC_MINOR__' are |
68 | defined by this file unconditionally. `__GNU_LIBRARY__' is provided | |
69 | only for compatibility. All new code should use the other symbols | |
70 | to test for features. | |
28f540f4 | 71 | |
28f540f4 RM |
72 | All macros listed above as possibly being defined by this file are |
73 | explicitly undefined if they are not explicitly defined. | |
74 | Feature-test macros that are not defined by the user or compiler | |
75 | but are implied by the other feature-test macros defined (or by the | |
76 | lack of any definitions) are defined by the file. */ | |
77 | ||
78 | ||
79 | /* Undefine everything, so we get a clean slate. */ | |
2f6d1f1b | 80 | #undef __USE_ISOC9X |
28f540f4 RM |
81 | #undef __USE_POSIX |
82 | #undef __USE_POSIX2 | |
6d52618b | 83 | #undef __USE_POSIX199309 |
2c6fe0bd UD |
84 | #undef __USE_XOPEN |
85 | #undef __USE_XOPEN_EXTENDED | |
dfd2257a UD |
86 | #undef __USE_UNIX98 |
87 | #undef __USE_LARGEFILE | |
88 | #undef __USE_LARGEFILE64 | |
89 | #undef __USE_FILE_OFFSET64 | |
28f540f4 RM |
90 | #undef __USE_BSD |
91 | #undef __USE_SVID | |
92 | #undef __USE_MISC | |
93 | #undef __USE_GNU | |
aa910907 | 94 | #undef __USE_REENTRANT |
28f540f4 | 95 | #undef __FAVOR_BSD |
a1470b6f | 96 | #undef __KERNEL_STRICT_NAMES |
28f540f4 | 97 | |
a1470b6f | 98 | /* Suppress kernel-name space pollution unless user expressedly asks |
2c6fe0bd | 99 | for it. */ |
a1470b6f RM |
100 | #ifndef _LOOSE_KERNEL_NAMES |
101 | # define __KERNEL_STRICT_NAMES | |
102 | #endif | |
28f540f4 | 103 | |
d38cd08c | 104 | /* Always use ISO C things. */ |
28f540f4 RM |
105 | #define __USE_ANSI 1 |
106 | ||
107 | ||
108 | /* If _BSD_SOURCE was defined by the user, favor BSD over POSIX. */ | |
d38cd08c UD |
109 | #if defined _BSD_SOURCE && \ |
110 | !(defined _POSIX_SOURCE || defined _POSIX_C_SOURCE || \ | |
df4ef2ab | 111 | defined _XOPEN_SOURCE || defined _XOPEN_SOURCE_EXTENDED || \ |
d38cd08c | 112 | defined _GNU_SOURCE || defined _SVID_SOURCE) |
2c6fe0bd | 113 | # define __FAVOR_BSD 1 |
28f540f4 RM |
114 | #endif |
115 | ||
59dd8641 RM |
116 | /* If _GNU_SOURCE was defined by the user, turn on all the other features. */ |
117 | #ifdef _GNU_SOURCE | |
5107cf1d UD |
118 | # undef _ISOC9X_SOURCE |
119 | # define _ISOC9X_SOURCE 1 | |
120 | # undef _POSIX_SOURCE | |
121 | # define _POSIX_SOURCE 1 | |
122 | # undef _POSIX_C_SOURCE | |
dd7d45e8 | 123 | # define _POSIX_C_SOURCE 199506L |
5107cf1d | 124 | # undef _XOPEN_SOURCE |
a5a0310d | 125 | # define _XOPEN_SOURCE 500 |
5107cf1d UD |
126 | # undef _XOPEN_SOURCE_EXTENDED |
127 | # define _XOPEN_SOURCE_EXTENDED 1 | |
dfd2257a UD |
128 | # undef _LARGEFILE64_SOURCE |
129 | # define _LARGEFILE64_SOURCE 1 | |
5107cf1d UD |
130 | # undef _BSD_SOURCE |
131 | # define _BSD_SOURCE 1 | |
132 | # undef _SVID_SOURCE | |
133 | # define _SVID_SOURCE 1 | |
59dd8641 | 134 | #endif |
28f540f4 RM |
135 | |
136 | /* If nothing (other than _GNU_SOURCE) is defined, | |
137 | define _BSD_SOURCE and _SVID_SOURCE. */ | |
2f6d1f1b UD |
138 | #if (!defined __STRICT_ANSI__ && !defined _ISOC9X_SOURCE && \ |
139 | !defined _POSIX_SOURCE && !defined _POSIX_C_SOURCE && \ | |
140 | !defined _XOPEN_SOURCE && !defined _XOPEN_SOURCE_EXTENDED && \ | |
141 | !defined _BSD_SOURCE && !defined _SVID_SOURCE) | |
5107cf1d UD |
142 | # define _BSD_SOURCE 1 |
143 | # define _SVID_SOURCE 1 | |
28f540f4 RM |
144 | #endif |
145 | ||
2f6d1f1b UD |
146 | /* This is to enable the ISO C 9x extension. It will go away as soon |
147 | as this standard is officially released. */ | |
148 | #ifdef _ISOC9X_SOURCE | |
5107cf1d | 149 | # define __USE_ISOC9X 1 |
2f6d1f1b UD |
150 | #endif |
151 | ||
6d52618b UD |
152 | /* If none of the ANSI/POSIX macros are defined, use POSIX.1 and POSIX.2 |
153 | (and IEEE Std 1003.1b-1993 unless _XOPEN_SOURCE is defined). */ | |
d38cd08c UD |
154 | #if (!defined __STRICT_ANSI__ && !defined _POSIX_SOURCE && \ |
155 | !defined _POSIX_C_SOURCE) | |
5107cf1d | 156 | # define _POSIX_SOURCE 1 |
dfd2257a | 157 | # if defined _XOPEN_SOURCE && (_XOPEN_SOURCE - 0) != 500 |
5107cf1d UD |
158 | # define _POSIX_C_SOURCE 2 |
159 | # else | |
dd7d45e8 | 160 | # define _POSIX_C_SOURCE 199506L |
5107cf1d | 161 | # endif |
28f540f4 RM |
162 | #endif |
163 | ||
d38cd08c | 164 | #if defined _POSIX_SOURCE || _POSIX_C_SOURCE >= 1 || defined _XOPEN_SOURCE |
5107cf1d | 165 | # define __USE_POSIX 1 |
28f540f4 RM |
166 | #endif |
167 | ||
d38cd08c | 168 | #if defined _POSIX_C_SOURCE && _POSIX_C_SOURCE >= 2 || defined _XOPEN_SOURCE |
5107cf1d | 169 | # define __USE_POSIX2 1 |
28f540f4 RM |
170 | #endif |
171 | ||
9756dfe1 UD |
172 | #if (_POSIX_C_SOURCE - 0) >= 199309L |
173 | # define __USE_POSIX199309 1 | |
6d52618b UD |
174 | #endif |
175 | ||
2c6fe0bd | 176 | #ifdef _XOPEN_SOURCE |
5107cf1d | 177 | # define __USE_XOPEN 1 |
dfd2257a | 178 | # if (_XOPEN_SOURCE - 0) == 500 |
5107cf1d | 179 | # define __USE_XOPEN_EXTENDED 1 |
a5a0310d | 180 | # define __USE_UNIX98 1 |
dfd2257a UD |
181 | # undef _LARGEFILE_SOURCE |
182 | # define _LARGEFILE_SOURCE 1 | |
a5a0310d UD |
183 | # else |
184 | # ifdef _XOPEN_SOURCE_EXTENDED | |
185 | # define __USE_XOPEN_EXTENDED 1 | |
186 | # endif | |
5107cf1d | 187 | # endif |
2c6fe0bd UD |
188 | #endif |
189 | ||
dfd2257a UD |
190 | #ifdef _LARGEFILE_SOURCE |
191 | # define __USE_LARGEFILE 1 | |
192 | #endif | |
193 | ||
194 | #ifdef _LARGEFILE64_SOURCE | |
195 | # define __USE_LARGEFILE64 1 | |
196 | #endif | |
197 | ||
198 | #if defined _FILE_OFFSET_BITS && _FILE_OFFSET_BITS == 64 | |
199 | # define __USE_FILE_OFFSET64 1 | |
200 | #endif | |
201 | ||
d38cd08c | 202 | #if defined _BSD_SOURCE || defined _SVID_SOURCE |
5107cf1d | 203 | # define __USE_MISC 1 |
28f540f4 RM |
204 | #endif |
205 | ||
206 | #ifdef _BSD_SOURCE | |
5107cf1d | 207 | # define __USE_BSD 1 |
28f540f4 RM |
208 | #endif |
209 | ||
210 | #ifdef _SVID_SOURCE | |
5107cf1d | 211 | # define __USE_SVID 1 |
28f540f4 RM |
212 | #endif |
213 | ||
214 | #ifdef _GNU_SOURCE | |
5107cf1d | 215 | # define __USE_GNU 1 |
28f540f4 RM |
216 | #endif |
217 | ||
d38cd08c | 218 | #if defined _REENTRANT || defined _THREAD_SAFE |
5107cf1d | 219 | # define __USE_REENTRANT 1 |
aa910907 RM |
220 | #endif |
221 | ||
d705269e UD |
222 | /* We do support the IEC 559 math functionality, real and complex. */ |
223 | #define __STDC_IEC_559__ 1 | |
224 | #define __STDC_IEC_559_COMPLEX__ 1 | |
28f540f4 | 225 | |
ba1ffaa1 UD |
226 | /* This macro indicates that the installed library is the GNU C Library. |
227 | For historic reasons the value now is 6 and this will stay from now | |
228 | on. The use of this variable is deprecated. Use __GLIBC__ and | |
229 | __GLIBC_MINOR__ now (see below) when you want to test for a specific | |
230 | GNU C library version and use the values in <gnu/lib-names.h> to get | |
231 | the sonames of the shared libraries. */ | |
232 | #undef __GNU_LIBRARY__ | |
233 | #define __GNU_LIBRARY__ 6 | |
234 | ||
235 | /* Major and minor version number of the GNU C library package. Use | |
236 | these macros to test for features in specific releases. */ | |
237 | #define __GLIBC__ 2 | |
c84142e8 | 238 | #define __GLIBC_MINOR__ 1 |
28f540f4 | 239 | |
28f540f4 | 240 | /* This is here only because every header file already includes this one. */ |
edf5b2d7 | 241 | #ifndef __ASSEMBLER__ |
5107cf1d | 242 | # include <sys/cdefs.h> |
01cad722 UD |
243 | |
244 | /* If we don't have __REDIRECT, prototypes will be missing if | |
245 | __USE_FILE_OFFSET64 but not __USE_LARGEFILE[64]. */ | |
246 | # if defined __USE_FILE_OFFSET64 && !defined __REDIRECT | |
247 | # define __USE_LARGEFILE | |
248 | # define __USE_LARGEFILE64 | |
249 | # endif | |
250 | ||
eedbbe58 UD |
251 | #endif /* !ASSEMBLER */ |
252 | ||
253 | /* Decide whether we can define 'extern inline' functions in headers. */ | |
254 | #if defined __GNUC__ && (__GNUC__ > 2 || __GNUC__ == 2 && __GNUC_MINOR__ >= 7)\ | |
255 | && defined __OPTIMIZE__ && !defined __OPTIMIZE_SIZE__ | |
256 | # define __USE_EXTERN_INLINES 1 | |
edf5b2d7 | 257 | #endif |
28f540f4 RM |
258 | |
259 | /* This is here only because every header file already includes this one. */ | |
260 | #ifndef _LIBC | |
261 | /* Get the definitions of all the appropriate `__stub_FUNCTION' symbols. | |
6bc31da0 | 262 | <gnu/stubs.h> contains `#define __stub_FUNCTION' when FUNCTION is a stub |
28f540f4 RM |
263 | which will always return failure (and set errno to ENOSYS). |
264 | ||
6bc31da0 | 265 | We avoid including <gnu/stubs.h> when compiling the C library itself to |
28f540f4 RM |
266 | avoid a dependency loop. stubs.h depends on every object file. If |
267 | this #include were done for the library source code, then every object | |
268 | file would depend on stubs.h. */ | |
269 | ||
5107cf1d | 270 | # include <gnu/stubs.h> |
28f540f4 RM |
271 | #endif |
272 | ||
6ed0492f | 273 | #endif /* features.h */ |