Print this page
Finished obsoleting interfaces for XPG7.
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/uts/common/sys/feature_tests.h
+++ new/usr/src/uts/common/sys/feature_tests.h
1 1 /*
2 2 * CDDL HEADER START
3 3 *
4 4 * The contents of this file are subject to the terms of the
5 5 * Common Development and Distribution License (the "License").
6 6 * You may not use this file except in compliance with the License.
7 7 *
8 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 9 * or http://www.opensolaris.org/os/licensing.
10 10 * See the License for the specific language governing permissions
11 11 * and limitations under the License.
12 12 *
13 13 * When distributing Covered Code, include this CDDL HEADER in each
14 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 15 * If applicable, add the following below this CDDL HEADER, with the
16 16 * fields enclosed by brackets "[]" replaced with your own identifying
17 17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 18 *
19 19 * CDDL HEADER END
20 20 */
21 21
22 22 /*
23 23 * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
24 24 * Use is subject to license terms.
25 25 */
26 26 /*
27 27 * Copyright 2013 Garrett D'Amore <garrett@damore.org>
28 28 */
29 29
30 30 #ifndef _SYS_FEATURE_TESTS_H
31 31 #define _SYS_FEATURE_TESTS_H
32 32
33 33 #include <sys/ccompile.h>
34 34 #include <sys/isa_defs.h>
35 35
36 36 #ifdef __cplusplus
37 37 extern "C" {
38 38 #endif
39 39
40 40 /*
41 41 * Values of _POSIX_C_SOURCE
42 42 *
43 43 * undefined not a POSIX compilation
44 44 * 1 POSIX.1-1990 compilation
45 45 * 2 POSIX.2-1992 compilation
46 46 * 199309L POSIX.1b-1993 compilation (Real Time)
47 47 * 199506L POSIX.1c-1995 compilation (POSIX Threads)
48 48 * 200112L POSIX.1-2001 compilation (Austin Group Revision)
49 49 * 200809L POSIX.1-2008 compilation
50 50 */
51 51 #if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE)
52 52 #define _POSIX_C_SOURCE 1
53 53 #endif
54 54
55 55 /*
56 56 * The feature test macros __XOPEN_OR_POSIX, _STRICT_STDC, _STRICT_SYMBOLS,
57 57 * and _STDC_C99 are Sun implementation specific macros created in order to
58 58 * compress common standards specified feature test macros for easier reading.
59 59 * These macros should not be used by the application developer as
60 60 * unexpected results may occur. Instead, the user should reference
61 61 * standards(5) for correct usage of the standards feature test macros.
62 62 *
63 63 * __XOPEN_OR_POSIX Used in cases where a symbol is defined by both
64 64 * X/Open or POSIX or in the negative, when neither
65 65 * X/Open or POSIX defines a symbol.
66 66 *
67 67 * _STRICT_STDC __STDC__ is specified by the C Standards and defined
68 68 * by the compiler. For Sun compilers the value of
69 69 * __STDC__ is either 1, 0, or not defined based on the
70 70 * compilation mode (see cc(1)). When the value of
71 71 * __STDC__ is 1 and in the absence of any other feature
72 72 * test macros, the namespace available to the application
73 73 * is limited to only those symbols defined by the C
74 74 * Standard. _STRICT_STDC provides a more readable means
75 75 * of identifying symbols defined by the standard, or in
76 76 * the negative, symbols that are extensions to the C
77 77 * Standard. See additional comments for GNU C differences.
78 78 *
79 79 * _STDC_C99 __STDC_VERSION__ is specified by the C standards and
80 80 * defined by the compiler and indicates the version of
81 81 * the C standard. A value of 199901L indicates a
82 82 * compiler that complies with ISO/IEC 9899:1999, other-
83 83 * wise known as the C99 standard.
84 84 *
85 85 * _STRICT_SYMBOLS Used in cases where symbol visibility is restricted
86 86 * by the standards, and the user has not explicitly
87 87 * relaxed the strictness via __EXTENSIONS__.
88 88 */
89 89
90 90 #if defined(_XOPEN_SOURCE) || defined(_POSIX_C_SOURCE)
91 91 #define __XOPEN_OR_POSIX
92 92 #endif
93 93
94 94 /*
95 95 * ISO/IEC 9899:1990 and it's revision, ISO/IEC 9899:1999 specify the
96 96 * following predefined macro name:
97 97 *
98 98 * __STDC__ The integer constant 1, intended to indicate a conforming
99 99 * implementation.
100 100 *
101 101 * Furthermore, a strictly conforming program shall use only those features
102 102 * of the language and library specified in these standards. A conforming
103 103 * implementation shall accept any strictly conforming program.
104 104 *
105 105 * Based on these requirements, Sun's C compiler defines __STDC__ to 1 for
106 106 * strictly conforming environments and __STDC__ to 0 for environments that
107 107 * use ANSI C semantics but allow extensions to the C standard. For non-ANSI
108 108 * C semantics, Sun's C compiler does not define __STDC__.
109 109 *
110 110 * The GNU C project interpretation is that __STDC__ should always be defined
111 111 * to 1 for compilation modes that accept ANSI C syntax regardless of whether
112 112 * or not extensions to the C standard are used. Violations of conforming
113 113 * behavior are conditionally flagged as warnings via the use of the
114 114 * -pedantic option. In addition to defining __STDC__ to 1, the GNU C
115 115 * compiler also defines __STRICT_ANSI__ as a means of specifying strictly
116 116 * conforming environments using the -ansi or -std=<standard> options.
117 117 *
118 118 * In the absence of any other compiler options, Sun and GNU set the value
119 119 * of __STDC__ as follows when using the following options:
120 120 *
121 121 * Value of __STDC__ __STRICT_ANSI__
122 122 *
123 123 * cc -Xa (default) 0 undefined
124 124 * cc -Xt (transitional) 0 undefined
125 125 * cc -Xc (strictly conforming) 1 undefined
126 126 * cc -Xs (K&R C) undefined undefined
127 127 *
128 128 * gcc (default) 1 undefined
129 129 * gcc -ansi, -std={c89, c99,...) 1 defined
130 130 * gcc -traditional (K&R) undefined undefined
131 131 *
132 132 * The default compilation modes for Sun C compilers versus GNU C compilers
133 133 * results in a differing value for __STDC__ which results in a more
134 134 * restricted namespace when using Sun compilers. To allow both GNU and Sun
135 135 * interpretations to peacefully co-exist, we use the following Sun
136 136 * implementation _STRICT_STDC_ macro:
137 137 */
138 138
139 139 #if (__STDC__ - 0 == 1 && !defined(__GNUC__)) || \
140 140 (defined(__GNUC__) && defined(__STRICT_ANSI__))
141 141 #define _STRICT_STDC
142 142 #else
143 143 #undef _STRICT_STDC
144 144 #endif
145 145
146 146 /*
147 147 * Compiler complies with ISO/IEC 9899:1999
148 148 */
149 149
150 150 #if __STDC_VERSION__ - 0 >= 199901L
151 151 #define _STDC_C99
152 152 #endif
153 153
154 154 /*
155 155 * Use strict symbol visibility.
156 156 */
157 157 #if (defined(_STRICT_STDC) || defined(__XOPEN_OR_POSIX)) && \
158 158 !defined(__EXTENSIONS__)
159 159 #define _STRICT_SYMBOLS
160 160 #endif
161 161
162 162 /*
163 163 * Large file interfaces:
164 164 *
165 165 * _LARGEFILE_SOURCE
166 166 * 1 large file-related additions to POSIX
167 167 * interfaces requested (fseeko, etc.)
168 168 * _LARGEFILE64_SOURCE
169 169 * 1 transitional large-file-related interfaces
170 170 * requested (seek64, stat64, etc.)
171 171 *
172 172 * The corresponding announcement macros are respectively:
173 173 * _LFS_LARGEFILE
174 174 * _LFS64_LARGEFILE
175 175 * (These are set in <unistd.h>.)
176 176 *
177 177 * Requesting _LARGEFILE64_SOURCE implies requesting _LARGEFILE_SOURCE as
178 178 * well.
179 179 *
180 180 * The large file interfaces are made visible regardless of the initial values
181 181 * of the feature test macros under certain circumstances:
182 182 * - If no explicit standards-conforming environment is requested (neither
183 183 * of _POSIX_SOURCE nor _XOPEN_SOURCE is defined and the value of
184 184 * __STDC__ does not imply standards conformance).
185 185 * - Extended system interfaces are explicitly requested (__EXTENSIONS__
186 186 * is defined).
187 187 * - Access to in-kernel interfaces is requested (_KERNEL or _KMEMUSER is
188 188 * defined). (Note that this dependency is an artifact of the current
189 189 * kernel implementation and may change in future releases.)
190 190 */
191 191 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
192 192 defined(_KERNEL) || defined(_KMEMUSER) || \
193 193 defined(__EXTENSIONS__)
194 194 #undef _LARGEFILE64_SOURCE
195 195 #define _LARGEFILE64_SOURCE 1
196 196 #endif
197 197 #if _LARGEFILE64_SOURCE - 0 == 1
198 198 #undef _LARGEFILE_SOURCE
199 199 #define _LARGEFILE_SOURCE 1
200 200 #endif
201 201
202 202 /*
203 203 * Large file compilation environment control:
204 204 *
205 205 * The setting of _FILE_OFFSET_BITS controls the size of various file-related
206 206 * types and governs the mapping between file-related source function symbol
207 207 * names and the corresponding binary entry points.
208 208 *
209 209 * In the 32-bit environment, the default value is 32; if not set, set it to
210 210 * the default here, to simplify tests in other headers.
211 211 *
212 212 * In the 64-bit compilation environment, the only value allowed is 64.
213 213 */
214 214 #if defined(_LP64)
215 215 #ifndef _FILE_OFFSET_BITS
216 216 #define _FILE_OFFSET_BITS 64
217 217 #endif
218 218 #if _FILE_OFFSET_BITS - 0 != 64
219 219 #error "invalid _FILE_OFFSET_BITS value specified"
220 220 #endif
221 221 #else /* _LP64 */
222 222 #ifndef _FILE_OFFSET_BITS
223 223 #define _FILE_OFFSET_BITS 32
224 224 #endif
225 225 #if _FILE_OFFSET_BITS - 0 != 32 && _FILE_OFFSET_BITS - 0 != 64
226 226 #error "invalid _FILE_OFFSET_BITS value specified"
227 227 #endif
228 228 #endif /* _LP64 */
229 229
230 230 /*
231 231 * Use of _XOPEN_SOURCE
232 232 *
233 233 * The following X/Open specifications are supported:
234 234 *
235 235 * X/Open Portability Guide, Issue 3 (XPG3)
236 236 * X/Open CAE Specification, Issue 4 (XPG4)
237 237 * X/Open CAE Specification, Issue 4, Version 2 (XPG4v2)
238 238 * X/Open CAE Specification, Issue 5 (XPG5)
239 239 * Open Group Technical Standard, Issue 6 (XPG6), also referred to as
240 240 * IEEE Std. 1003.1-2001 and ISO/IEC 9945:2002.
241 241 * Open Group Technical Standard, Issue 7 (XPG7), also referred to as
242 242 * IEEE Std. 1003.1-2008 and ISO/IEC 9945:2009.
243 243 *
244 244 * XPG4v2 is also referred to as UNIX 95 (SUS or SUSv1).
245 245 * XPG5 is also referred to as UNIX 98 or the Single Unix Specification,
246 246 * Version 2 (SUSv2)
247 247 * XPG6 is the result of a merge of the X/Open and POSIX specifications
248 248 * and as such is also referred to as IEEE Std. 1003.1-2001 in
249 249 * addition to UNIX 03 and SUSv3.
250 250 * XPG7 is also referred to as UNIX 08 and SUSv4.
251 251 *
252 252 * When writing a conforming X/Open application, as per the specification
253 253 * requirements, the appropriate feature test macros must be defined at
254 254 * compile time. These are as follows. For more info, see standards(5).
255 255 *
256 256 * Feature Test Macro Specification
257 257 * ------------------------------------------------ -------------
258 258 * _XOPEN_SOURCE XPG3
259 259 * _XOPEN_SOURCE && _XOPEN_VERSION = 4 XPG4
260 260 * _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED = 1 XPG4v2
261 261 * _XOPEN_SOURCE = 500 XPG5
262 262 * _XOPEN_SOURCE = 600 (or POSIX_C_SOURCE=200112L) XPG6
263 263 * _XOPEN_SOURCE = 700 (or POSIX_C_SOURCE=200809L) XPG7
264 264 *
265 265 * In order to simplify the guards within the headers, the following
266 266 * implementation private test macros have been created. Applications
267 267 * must NOT use these private test macros as unexpected results will
268 268 * occur.
269 269 *
270 270 * Note that in general, the use of these private macros is cumulative.
271 271 * For example, the use of _XPG3 with no other restrictions on the X/Open
272 272 * namespace will make the symbols visible for XPG3 through XPG6
273 273 * compilation environments. The use of _XPG4_2 with no other X/Open
274 274 * namespace restrictions indicates that the symbols were introduced in
275 275 * XPG4v2 and are therefore visible for XPG4v2 through XPG6 compilation
276 276 * environments, but not for XPG3 or XPG4 compilation environments.
277 277 *
278 278 * _XPG3 X/Open Portability Guide, Issue 3 (XPG3)
279 279 * _XPG4 X/Open CAE Specification, Issue 4 (XPG4)
280 280 * _XPG4_2 X/Open CAE Specification, Issue 4, Version 2 (XPG4v2/UNIX 95/SUS)
281 281 * _XPG5 X/Open CAE Specification, Issue 5 (XPG5/UNIX 98/SUSv2)
282 282 * _XPG6 Open Group Technical Standard, Issue 6 (XPG6/UNIX 03/SUSv3)
283 283 * _XPG7 Open Group Technical Standard, Issue 7 (XPG7/UNIX 08/SUSv4)
284 284 */
285 285
286 286 /* X/Open Portability Guide, Issue 3 */
287 287 #if defined(_XOPEN_SOURCE) && (_XOPEN_SOURCE - 0 < 500) && \
288 288 (_XOPEN_VERSION - 0 < 4) && !defined(_XOPEN_SOURCE_EXTENDED)
289 289 #define _XPG3
290 290 /* X/Open CAE Specification, Issue 4 */
291 291 #elif (defined(_XOPEN_SOURCE) && _XOPEN_VERSION - 0 == 4)
292 292 #define _XPG4
293 293 #define _XPG3
294 294 /* X/Open CAE Specification, Issue 4, Version 2 */
295 295 #elif (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE_EXTENDED - 0 == 1)
296 296 #define _XPG4_2
297 297 #define _XPG4
298 298 #define _XPG3
299 299 /* X/Open CAE Specification, Issue 5 */
300 300 #elif (_XOPEN_SOURCE - 0 == 500)
301 301 #define _XPG5
302 302 #define _XPG4_2
303 303 #define _XPG4
304 304 #define _XPG3
305 305 #undef _POSIX_C_SOURCE
306 306 #define _POSIX_C_SOURCE 199506L
307 307 /* Open Group Technical Standard , Issue 6 */
308 308 #elif (_XOPEN_SOURCE - 0 == 600) || (_POSIX_C_SOURCE - 0 == 200112L)
309 309 #define _XPG6
310 310 #define _XPG5
311 311 #define _XPG4_2
312 312 #define _XPG4
313 313 #define _XPG3
314 314 #undef _POSIX_C_SOURCE
315 315 #define _POSIX_C_SOURCE 200112L
316 316 #undef _XOPEN_SOURCE
317 317 #define _XOPEN_SOURCE 600
318 318
319 319 /* Open Group Technical Standard, Issue 7 */
320 320 #elif (_XOPEN_SOURCE - 0 == 700) || (_POSIX_C_SOURCE - 0 == 200809L)
321 321 #define _XPG7
322 322 #define _XPG6
323 323 #define _XPG5
|
↓ open down ↓ |
323 lines elided |
↑ open up ↑ |
324 324 #define _XPG4_2
325 325 #define _XPG4
326 326 #define _XPG3
327 327 #undef _POSIX_C_SOURCE
328 328 #define _POSIX_C_SOURCE 200809L
329 329 #undef _XOPEN_SOURCE
330 330 #define _XOPEN_SOURCE 700
331 331 #endif
332 332
333 333 /*
334 + * As another simplification attempt for the rest of our headers, we
335 + * define the following macros to indicate that a specific XPG standard
336 + * is in force, AND symbols should be restricted. This lets us prune
337 + * symbols that should not be visible under a given standard. These should
338 + * not be used by applications directly.
339 + */
340 +#if defined(_STRICT_SYMBOLS) && defined(_XPG3)
341 +#define _STRICT_XPG3
342 +#endif
343 +#if defined(_STRICT_SYMBOLS) && defined(_XPG4)
344 +#define _STRICT_XPG4
345 +#endif
346 +#if defined(_STRICT_SYMBOLS) && defined(_XPG4_2)
347 +#define _STRICT_XPG4_2
348 +#endif
349 +#if defined(_STRICT_SYMBOLS) && defined(_XPG5)
350 +#define _STRICT_XPG5
351 +#endif
352 +#if defined(_STRICT_SYMBOLS) && defined(_XPG6)
353 +#define _STRICT_XPG6
354 +#endif
355 +#if defined(_STRICT_SYMBOLS) && defined(_XPG7)
356 +#define _STRICT_XPG7
357 +#endif
358 +
359 +/*
334 360 * _XOPEN_VERSION is defined by the X/Open specifications and is not
335 361 * normally defined by the application, except in the case of an XPG4
336 362 * application. On the implementation side, _XOPEN_VERSION defined with
337 363 * the value of 3 indicates an XPG3 application. _XOPEN_VERSION defined
338 364 * with the value of 4 indicates an XPG4 or XPG4v2 (UNIX 95) application.
339 365 * _XOPEN_VERSION defined with a value of 500 indicates an XPG5 (UNIX 98)
340 366 * application and with a value of 600 indicates an XPG6 (UNIX 03)
341 367 * application and with a value of 700 indicates an XPG7 (UNIX 08).
342 368 * The appropriate version is determined by the use of the
343 369 * feature test macros described earlier. The value of _XOPEN_VERSION
344 370 * defaults to 3 otherwise indicating support for XPG3 applications.
345 371 */
346 372 #ifndef _XOPEN_VERSION
347 373 #if defined(_XPG7)
348 374 #define _XOPEN_VERSION 700
349 375 #elif defined(_XPG6)
350 376 #define _XOPEN_VERSION 600
351 377 #elif defined(_XPG5)
352 378 #define _XOPEN_VERSION 500
353 379 #elif defined(_XPG4_2)
354 380 #define _XOPEN_VERSION 4
355 381 #else
356 382 #define _XOPEN_VERSION 3
357 383 #endif
358 384 #endif
359 385
360 386 /*
361 387 * ANSI C and ISO 9899:1990 say the type long long doesn't exist in strictly
362 388 * conforming environments. ISO 9899:1999 says it does.
363 389 *
364 390 * The presence of _LONGLONG_TYPE says "long long exists" which is therefore
365 391 * defined in all but strictly conforming environments that disallow it.
366 392 */
367 393 #if !defined(_STDC_C99) && defined(_STRICT_STDC) && !defined(__GNUC__)
368 394 /*
369 395 * Resist attempts to force the definition of long long in this case.
370 396 */
371 397 #if defined(_LONGLONG_TYPE)
372 398 #error "No long long in strictly conforming ANSI C & 1990 ISO C environments"
373 399 #endif
374 400 #else
375 401 #if !defined(_LONGLONG_TYPE)
376 402 #define _LONGLONG_TYPE
377 403 #endif
378 404 #endif
379 405
380 406 /*
381 407 * It is invalid to compile an XPG3, XPG4, XPG4v2, or XPG5 application
382 408 * using c99. The same is true for POSIX.1-1990, POSIX.2-1992, POSIX.1b,
383 409 * and POSIX.1c applications. Likewise, it is invalid to compile an XPG6
384 410 * or a POSIX.1-2001 application with anything other than a c99 or later
385 411 * compiler. Therefore, we force an error in both cases.
386 412 */
387 413 #if defined(_STDC_C99) && (defined(__XOPEN_OR_POSIX) && !defined(_XPG6))
388 414 #error "Compiler or options invalid for pre-UNIX 03 X/Open applications \
389 415 and pre-2001 POSIX applications"
390 416 #elif !defined(_STDC_C99) && \
391 417 (defined(__XOPEN_OR_POSIX) && defined(_XPG6))
392 418 #error "Compiler or options invalid; UNIX 03 and POSIX.1-2001 applications \
393 419 require the use of c99"
394 420 #endif
395 421
396 422 /*
397 423 * The following macro defines a value for the ISO C99 restrict
398 424 * keyword so that _RESTRICT_KYWD resolves to "restrict" if
399 425 * an ISO C99 compiler is used and "" (null string) if any other
400 426 * compiler is used. This allows for the use of single prototype
401 427 * declarations regardless of compiler version.
402 428 */
403 429 #if (defined(__STDC__) && defined(_STDC_C99)) && !defined(__cplusplus)
404 430 #define _RESTRICT_KYWD restrict
405 431 #else
406 432 #define _RESTRICT_KYWD
407 433 #endif
408 434
409 435 /*
410 436 * The following macro indicates header support for the ANSI C++
411 437 * standard. The ISO/IEC designation for this is ISO/IEC FDIS 14882.
412 438 */
413 439 #define _ISO_CPP_14882_1998
414 440
415 441 /*
416 442 * The following macro indicates header support for the C99 standard,
417 443 * ISO/IEC 9899:1999, Programming Languages - C.
418 444 */
419 445 #define _ISO_C_9899_1999
420 446
421 447 /*
422 448 * The following macro indicates header support for DTrace. The value is an
423 449 * integer that corresponds to the major version number for DTrace.
424 450 */
425 451 #define _DTRACE_VERSION 1
426 452
427 453 #ifdef __cplusplus
428 454 }
429 455 #endif
430 456
431 457 #endif /* _SYS_FEATURE_TESTS_H */
|
↓ open down ↓ |
88 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX