FreeBSD/Linux Kernel Cross Reference
sys/cddl/contrib/opensolaris/uts/common/sys/feature_tests.h

     /*
      * 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 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>
    
    #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.
     *
     * _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 revision, ISO/IEC 9899:1999 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
    */
   
   #if __STDC_VERSION__ - 0 >= 199901L
   #ifndef _STDC_C99
   #define _STDC_C99
   #endif
   #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 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)) && !defined(__cplusplus)
   #define _RESTRICT_KYWD  restrict
   #else
   #define _RESTRICT_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 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 */

Cache object: 13645669020adc7b7d9953d0f5f18fb5