1 /**************************************************************************
3 * Copyright 2007-2008 Tungsten Graphics, Inc., Cedar Park, Texas.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
41 #if defined(_WIN32) && !defined(__WIN32__)
47 /* Avoid 'expression is always true' warning */
48 #pragma warning(disable: 4296)
54 * Alternative stdint.h and stdbool.h headers are supplied in include/c99 for
55 * systems that lack it.
57 #ifndef __STDC_LIMIT_MACROS
58 #define __STDC_LIMIT_MACROS 1
69 #if !defined(__HAIKU__) && !defined(__USE_MISC)
70 #if !defined(PIPE_OS_ANDROID)
71 typedef unsigned int uint
;
73 typedef unsigned short ushort
;
75 typedef unsigned char ubyte
;
77 typedef unsigned char boolean
;
87 #define va_copy(dest, src) __va_copy((dest), (src))
89 #define va_copy(dest, src) (dest) = (src)
93 /* Function inlining */
96 /* C++ supports inline keyword */
97 # elif defined(__GNUC__)
98 # define inline __inline__
99 # elif defined(_MSC_VER)
100 # define inline __inline
101 # elif defined(__ICL)
102 # define inline __inline
103 # elif defined(__INTEL_COMPILER)
104 /* Intel compiler supports inline keyword */
105 # elif defined(__WATCOMC__) && (__WATCOMC__ >= 1100)
106 # define inline __inline
107 # elif defined(__SUNPRO_C) && defined(__C99FEATURES__)
108 /* C99 supports inline keyword */
109 # elif (__STDC_VERSION__ >= 199901L)
110 /* C99 supports inline keyword */
116 # define INLINE inline
119 /* Forced function inlining */
120 #ifndef ALWAYS_INLINE
122 # define ALWAYS_INLINE inline __attribute__((always_inline))
123 # elif defined(_MSC_VER)
124 # define ALWAYS_INLINE __forceinline
126 # define ALWAYS_INLINE INLINE
131 * Define the C99 restrict keyword.
134 * - http://cellperformance.beyond3d.com/articles/2006/05/demystifying-the-restrict-keyword.html
137 # if (__STDC_VERSION__ >= 199901L)
139 # elif defined(__SUNPRO_C) && defined(__C99FEATURES__)
141 # elif defined(__GNUC__)
142 # define restrict __restrict__
143 # elif defined(_MSC_VER)
144 # define restrict __restrict
146 # define restrict /* */
151 /* Function visibility */
153 # if defined(__GNUC__) || (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x590))
154 # define PUBLIC __attribute__((visibility("default")))
155 # elif defined(_MSC_VER)
156 # define PUBLIC __declspec(dllexport)
163 /* The __FUNCTION__ gcc variable is generally only used for debugging.
164 * If we're not using gcc, define __FUNCTION__ as a cpp symbol here.
167 # if !defined(__GNUC__)
168 # if (__STDC_VERSION__ >= 199901L) /* C99 */ || \
169 (defined(__SUNPRO_C) && defined(__C99FEATURES__))
170 # define __FUNCTION__ __func__
172 # define __FUNCTION__ "<unknown>"
175 # if defined(_MSC_VER) && _MSC_VER < 1300
176 # define __FUNCTION__ "<unknown>"
180 # if (__STDC_VERSION__ >= 199901L) || \
181 (defined(__SUNPRO_C) && defined(__C99FEATURES__))
182 /* __func__ is part of C99 */
183 # elif defined(_MSC_VER)
184 # if _MSC_VER >= 1300
185 # define __func__ __FUNCTION__
187 # define __func__ "<unknown>"
194 /* This should match linux gcc cdecl semantics everywhere, so that we
195 * just codegen one calling convention on all platforms.
198 #define PIPE_CDECL __cdecl
205 #if defined(__GNUC__)
206 #define PIPE_DEPRECATED __attribute__((__deprecated__))
208 #define PIPE_DEPRECATED
213 /* Macros for data alignment. */
214 #if defined(__GNUC__) || (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x590))
216 /* See http://gcc.gnu.org/onlinedocs/gcc-4.4.2/gcc/Type-Attributes.html */
217 #define PIPE_ALIGN_TYPE(_alignment, _type) _type __attribute__((aligned(_alignment)))
219 /* See http://gcc.gnu.org/onlinedocs/gcc-4.4.2/gcc/Variable-Attributes.html */
220 #define PIPE_ALIGN_VAR(_alignment) __attribute__((aligned(_alignment)))
222 #if (__GNUC__ > 4 || (__GNUC__ == 4 &&__GNUC_MINOR__>1)) && !defined(PIPE_ARCH_X86_64)
223 #define PIPE_ALIGN_STACK __attribute__((force_align_arg_pointer))
225 #define PIPE_ALIGN_STACK
228 #elif defined(_MSC_VER)
230 /* See http://msdn.microsoft.com/en-us/library/83ythb65.aspx */
231 #define PIPE_ALIGN_TYPE(_alignment, _type) __declspec(align(_alignment)) _type
232 #define PIPE_ALIGN_VAR(_alignment) __declspec(align(_alignment))
234 #define PIPE_ALIGN_STACK
238 #define PIPE_ALIGN_TYPE(_alignment, _type) _type
239 #define PIPE_ALIGN_VAR(_alignment)
241 #define PIPE_ALIGN_STACK
245 #error "Unsupported compiler"
250 #if defined(__GNUC__)
252 #define PIPE_READ_WRITE_BARRIER() __asm__("":::"memory")
254 #elif defined(_MSC_VER)
256 void _ReadWriteBarrier(void);
257 #pragma intrinsic(_ReadWriteBarrier)
258 #define PIPE_READ_WRITE_BARRIER() _ReadWriteBarrier()
262 #warning "Unsupported compiler"
263 #define PIPE_READ_WRITE_BARRIER() /* */
268 /* You should use these macros to mark if blocks where the if condition
269 * is either likely to be true, or unlikely to be true.
271 * This will inform human readers of this fact, and will also inform
272 * the compiler, who will in turn inform the CPU.
274 * CPUs often start executing code inside the if or the else blocks
275 * without knowing whether the condition is true or not, and will have
276 * to throw the work away if they find out later they executed the
277 * wrong part of the if.
279 * If these macros are used, the CPU is more likely to correctly predict
280 * the right path, and will avoid speculatively executing the wrong branch,
281 * thus not throwing away work, resulting in better performance.
283 * In light of this, it is also a good idea to mark as "likely" a path
284 * which is not necessarily always more likely, but that will benefit much
285 * more from performance improvements since it is already much faster than
286 * the other path, or viceversa with "unlikely".
289 * if(unlikely(do_we_need_a_software_fallback()))
290 * do_software_fallback();
294 * The macros follow the Linux kernel convention, and more examples can
297 * Note that profile guided optimization can offer better results, but
298 * needs an appropriate coverage suite and does not inform human readers.
301 # if defined(__GNUC__)
302 # define likely(x) __builtin_expect(!!(x), 1)
303 # define unlikely(x) __builtin_expect(!!(x), 0)
305 # define likely(x) (x)
306 # define unlikely(x) (x)
312 * Static (compile-time) assertion.
313 * Basically, use COND to dimension an array. If COND is false/zero the
314 * array size will be -1 and we'll get a compilation error.
316 #define STATIC_ASSERT(COND) \
318 typedef int static_assertion_failed[(!!(COND))*2-1]; \
322 #if defined(__cplusplus)
327 #endif /* P_COMPILER_H */