Monado OpenXR Runtime
Loading...
Searching...
No Matches
xrt_compiler.h
Go to the documentation of this file.
1// Copyright 2019, Collabora, Ltd.
2// Copyright 2025-2026, NVIDIA CORPORATION.
3// SPDX-License-Identifier: BSL-1.0
4/*!
5 * @file
6 * @brief Header holding common defines.
7 * @author Jakob Bornecrantz <jakob@collabora.com>
8 * @ingroup xrt_iface
9 */
10
11#pragma once
12
13
14/*
15 * C99 is not a high bar to reach.
16 */
17#include <stddef.h>
18#include <stdint.h>
19#include <stdbool.h>
20#include <inttypes.h>
21
22#ifdef _MSC_VER
23#include <intrin.h>
24// for atomic intrinsics
25#include "xrt_windows.h"
26// Older MSVC versions do not have stdalign.h, define it manually using __declspec(align).
27#define XRT_ALIGNAS(n) __declspec(align(n))
28#elif defined(XRT_DOXYGEN)
29#define XRT_ALIGNAS(align)
30#else // _MSC_VER
31#include <stdalign.h>
32#define XRT_ALIGNAS(align) alignas(align)
33#endif
34
35#if (defined(__BYTE_ORDER) && __BYTE_ORDER == __BIG_ENDIAN) || \
36 (defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__) || \
37 (defined(__STDC_ENDIAN_NATIVE__) && __STDC_ENDIAN_NATIVE__ == __STDC_ENDIAN_BIG__) || defined(__BIG_ENDIAN__) || \
38 defined(__ARMEB__) || defined(__THUMBEB__) || defined(__AARCH64EB__) || defined(_MIBSEB) || defined(__MIBSEB) || \
39 defined(__MIBSEB__)
40
41#define XRT_BIG_ENDIAN
42
43#elif (defined(__BYTE_ORDER) && __BYTE_ORDER == __LITTLE_ENDIAN) || \
44 (defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__) || \
45 (defined(__STDC_ENDIAN_NATIVE__) && __STDC_ENDIAN_NATIVE__ == __STDC_ENDIAN_LITTLE__) || \
46 defined(__LITTLE_ENDIAN__) || defined(__ARMEL__) || defined(__THUMBEL__) || defined(__AARCH64EL__) || \
47 defined(_MIPSEL) || defined(__MIPSEL) || defined(__MIPSEL__) || defined(__x86_64__) || defined(_M_X64) || \
48 defined(i386) || defined(__i386__) || defined(__i386) || defined(_M_IX86)
49
50#undef XRT_BIG_ENDIAN
51
52#else
53#error "@todo: Unable to determine current architecture."
54#endif
55
56/*!
57 * Array size helper.
58 */
59#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
60
61#if defined(__x86_64__) || defined(_M_X64) || defined(__aarch64__) || defined(_ARCH_PPC64) || defined(__s390x__) || \
62 (defined(__SIZEOF_POINTER__) && __SIZEOF_POINTER__ == 8)
63#define XRT_64_BIT
64#else
65#define XRT_32_BIT
66#endif
67
68/*
69 * Printf helper attribute.
70 */
71#if defined(__GNUC__)
72#define XRT_PRINTF_FORMAT(fmt, list) __attribute__((format(printf, fmt, list)))
73#else
74#define XRT_PRINTF_FORMAT(fmt, list)
75#endif
76
77
78/*
79 * To silence unused warnings.
80 */
81#if defined(__GNUC__)
82#define XRT_MAYBE_UNUSED __attribute__((unused))
83#elif defined(_MSC_VER) && defined(__cplusplus)
84#define XRT_MAYBE_UNUSED [[maybe_unused]]
85#else
86#define XRT_MAYBE_UNUSED
87#endif
88
89
90/*
91 * To indicate that all pointer parameters must not be null.
92 *
93 * Note: MSVC does not have a function-level equivalent. To get similar checking
94 * on MSVC, individual parameters would need SAL annotations like _In_, _Out_, etc.
95 */
96#if defined(__GNUC__)
97#define XRT_NONNULL_ALL __attribute__((nonnull))
98#else
99#define XRT_NONNULL_ALL
100#endif
101
102
103/*
104 * To indicate that the first parameter must not be null.
105 *
106 * Note: MSVC does not have a function-level equivalent. To get similar checking
107 * on MSVC, individual parameters would need SAL annotations like _In_, _Out_, etc.
108 */
109#if defined(__GNUC__)
110#define XRT_NONNULL_FIRST __attribute__((nonnull(1)))
111#else
112#define XRT_NONNULL_FIRST
113#endif
114
115
116/*
117 * To make sure return values are checked.
118 */
119#if defined(__GNUC__) && (__GNUC__ >= 4)
120#define XRT_CHECK_RESULT __attribute__((warn_unused_result))
121#elif defined(_MSC_VER) && (_MSC_VER >= 1700)
122#define XRT_CHECK_RESULT _Check_return_
123#else
124#define XRT_CHECK_RESULT
125#endif
126
127
128/*
129 * To stop inlining.
130 */
131#if defined(__GNUC__)
132#define XRT_NO_INLINE __attribute__((noinline))
133#elif defined(_MSC_VER)
134#define XRT_NO_INLINE __declspec(noinline)
135#else
136#define XRT_NO_INLINE
137#endif
138
139
140#ifdef XRT_DOXYGEN
141/*!
142 * To trigger a trap/break in the debugger.
143 *
144 * @ingroup xrt_iface
145 */
146#define XRT_DEBUGBREAK()
147#elif defined(__clang__) || defined(__GNUC__)
148#define XRT_DEBUGBREAK() __builtin_trap()
149#elif defined(_MSC_VER)
150#define XRT_DEBUGBREAK() __debugbreak()
151#else
152#error "compiler not supported"
153#endif
154
155
156/*
157 * typeof extension, until C23 is widely available. This macro may not always be available,
158 * and should be checked before usage.
159 *
160 * @todo Remove this macro when Monado is updated project-wide to C23.
161 */
162#if defined(__cpp_decltype) && __cpp_decltype >= 200707L
163#define XRT_TYPEOF(x) decltype(x)
164#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202311L
165#define XRT_TYPEOF(x) typeof(x)
166#elif defined(__GNUC__) || defined(__clang__)
167#define XRT_TYPEOF(x) __typeof__(x)
168#endif
169
170
171typedef volatile int32_t xrt_atomic_s32_t;
172
173static inline int32_t
174xrt_atomic_s32_inc_return(xrt_atomic_s32_t *p)
175{
176#if defined(__GNUC__)
177 return __sync_add_and_fetch(p, 1);
178#elif defined(_MSC_VER)
179 return InterlockedIncrement((volatile LONG *)p);
180#else
181#error "compiler not supported"
182#endif
183}
184static inline int32_t
185xrt_atomic_s32_dec_return(xrt_atomic_s32_t *p)
186{
187#if defined(__GNUC__)
188 return __sync_sub_and_fetch(p, 1);
189#elif defined(_MSC_VER)
190 return InterlockedDecrement((volatile LONG *)p);
191#else
192#error "compiler not supported"
193#endif
194}
195static inline int32_t
196xrt_atomic_s32_cmpxchg(xrt_atomic_s32_t *p, int32_t old_, int32_t new_)
197{
198#if defined(__GNUC__)
199 return __sync_val_compare_and_swap(p, old_, new_);
200#elif defined(_MSC_VER)
201 return InterlockedCompareExchange((volatile LONG *)p, old_, new_);
202#else
203#error "compiler not supported"
204#endif
205}
206static inline void
207xrt_atomic_s32_store(xrt_atomic_s32_t *p, int32_t v)
208{
209#if defined(__GNUC__)
210 __atomic_store_n(p, v, __ATOMIC_SEQ_CST);
211#elif defined(_MSC_VER)
212 InterlockedExchange((volatile LONG *)p, v);
213#else
214#error "compiler not supported"
215#endif
216}
217static inline int32_t
218xrt_atomic_s32_load(xrt_atomic_s32_t *p)
219{
220#if defined(__GNUC__)
221 return __atomic_load_n(p, __ATOMIC_SEQ_CST);
222#elif defined(_MSC_VER)
223 return InterlockedCompareExchange((volatile LONG *)p, 0, 0);
224#else
225#error "compiler not supported"
226#endif
227}
228
229typedef volatile int64_t xrt_atomic_s64_t;
230
231static inline int64_t
232xrt_atomic_s64_inc_return(xrt_atomic_s64_t *p)
233{
234#if defined(__GNUC__)
235 return __sync_add_and_fetch(p, 1);
236#elif defined(_MSC_VER)
237 return InterlockedIncrement64((volatile LONG64 *)p);
238#else
239#error "compiler not supported"
240#endif
241}
242static inline int64_t
243xrt_atomic_s64_dec_return(xrt_atomic_s64_t *p)
244{
245#if defined(__GNUC__)
246 return __sync_sub_and_fetch(p, 1);
247#elif defined(_MSC_VER)
248 return InterlockedDecrement64((volatile LONG64 *)p);
249#else
250#error "compiler not supported"
251#endif
252}
253static inline int64_t
254xrt_atomic_s64_cmpxchg(xrt_atomic_s64_t *p, int64_t old_, int64_t new_)
255{
256#if defined(__GNUC__)
257 return __sync_val_compare_and_swap(p, old_, new_);
258#elif defined(_MSC_VER)
259 return InterlockedCompareExchange64((volatile LONG64 *)p, old_, new_);
260#else
261#error "compiler not supported"
262#endif
263}
264static inline void
265xrt_atomic_s64_store(xrt_atomic_s64_t *p, int64_t v)
266{
267#if defined(__GNUC__)
268 __atomic_store_n(p, v, __ATOMIC_SEQ_CST);
269#elif defined(_MSC_VER)
270 InterlockedExchange64((volatile LONG64 *)p, v);
271#else
272#error "compiler not supported"
273#endif
274}
275static inline int64_t
276xrt_atomic_s64_load(xrt_atomic_s64_t *p)
277{
278#if defined(__GNUC__)
279 return __atomic_load_n(p, __ATOMIC_SEQ_CST);
280#elif defined(_MSC_VER)
281 return InterlockedCompareExchange64((volatile LONG64 *)p, 0, 0);
282#else
283#error "compiler not supported"
284#endif
285}
286
287#ifdef _MSC_VER
288typedef intptr_t ssize_t;
289#define _SSIZE_T_
290#define _SSIZE_T_DEFINED
291#endif
292
293/*!
294 * Get the holder from a pointer to a field.
295 *
296 * @ingroup xrt_iface
297 */
298#define container_of(ptr, type, field) (type *)((char *)ptr - offsetof(type, field))
299
300
301#ifdef XRT_DOXYGEN
302
303/*!
304 * Very small default init for structs that works in both C and C++. Helps with
305 * code that needs to be compiled with both C and C++.
306 *
307 * @ingroup xrt_iface
308 */
309
310// clang-format off
311#define XRT_STRUCT_INIT {}
312// clang-format on
313
314#elif defined(__cplusplus)
315
316// clang-format off
317#define XRT_STRUCT_INIT {}
318// clang-format on
319
320#else
321
322// clang-format off
323#define XRT_STRUCT_INIT {0}
324// clang-format on
325
326#endif
327
328/*
329 * C11 style designated initializers (as compound literals) causes warning messages
330 * in C++ (even in C++20), usage:
331 *
332 * @code{.c}
333 * static inline struct xrt_foo_bar
334 * xrt_foo_bar_make()
335 * {
336 * return XRT_C11_COMPOUND(struct xrt_foo_bar){
337 * .x = y,
338 * // ...
339 * };
340 * }
341 * @endcode
342 */
343#ifdef __cplusplus
344#define XRT_C11_COMPOUND(X)
345#else
346#define XRT_C11_COMPOUND(X) (X)
347#endif
xrt_windows.h
A minimal way to include Windows.h.