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