DPDK 26.11.0-rc1
rte_stdatomic.h
1/* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2023 Microsoft Corporation
3 */
4
5#ifndef RTE_STDATOMIC_H
6#define RTE_STDATOMIC_H
7
8#include <assert.h>
9
10#ifdef RTE_ENABLE_STDATOMIC
11
12#ifndef __cplusplus
13#ifndef _MSC_VER
14#ifdef __STDC_NO_ATOMICS__
15#error enable_stdatomic=true but atomics not supported by toolchain
16#endif
17#endif
18
19#include <stdatomic.h>
20
21/* RTE_ATOMIC(type) is provided for use as a type specifier
22 * permitting designation of an rte atomic type.
23 */
24#define RTE_ATOMIC(type) _Atomic(type)
25
26/* __rte_atomic is provided for type qualification permitting
27 * designation of an rte atomic qualified type-name.
28 */
29#define __rte_atomic _Atomic
30
31/* The memory order is an enumerated type in C11. */
32typedef memory_order rte_memory_order;
33
34#define rte_memory_order_relaxed memory_order_relaxed
35#ifdef __ATOMIC_RELAXED
36static_assert(rte_memory_order_relaxed == __ATOMIC_RELAXED,
37 "rte_memory_order_relaxed == __ATOMIC_RELAXED");
38#endif
39
40#define rte_memory_order_consume memory_order_consume
41#ifdef __ATOMIC_CONSUME
42static_assert(rte_memory_order_consume == __ATOMIC_CONSUME,
43 "rte_memory_order_consume == __ATOMIC_CONSUME");
44#endif
45
46#define rte_memory_order_acquire memory_order_acquire
47#ifdef __ATOMIC_ACQUIRE
48static_assert(rte_memory_order_acquire == __ATOMIC_ACQUIRE,
49 "rte_memory_order_acquire == __ATOMIC_ACQUIRE");
50#endif
51
52#define rte_memory_order_release memory_order_release
53#ifdef __ATOMIC_RELEASE
54static_assert(rte_memory_order_release == __ATOMIC_RELEASE,
55 "rte_memory_order_release == __ATOMIC_RELEASE");
56#endif
57
58#define rte_memory_order_acq_rel memory_order_acq_rel
59#ifdef __ATOMIC_ACQ_REL
60static_assert(rte_memory_order_acq_rel == __ATOMIC_ACQ_REL,
61 "rte_memory_order_acq_rel == __ATOMIC_ACQ_REL");
62#endif
63
64#define rte_memory_order_seq_cst memory_order_seq_cst
65#ifdef __ATOMIC_SEQ_CST
66static_assert(rte_memory_order_seq_cst == __ATOMIC_SEQ_CST,
67 "rte_memory_order_seq_cst == __ATOMIC_SEQ_CST");
68#endif
69
70#define rte_atomic_load_explicit(ptr, memorder) \
71 atomic_load_explicit(ptr, memorder)
72
73#define rte_atomic_store_explicit(ptr, val, memorder) \
74 atomic_store_explicit(ptr, val, memorder)
75
76#define rte_atomic_exchange_explicit(ptr, val, memorder) \
77 atomic_exchange_explicit(ptr, val, memorder)
78
79#define rte_atomic_compare_exchange_strong_explicit(ptr, expected, desired, \
80 succ_memorder, fail_memorder) \
81 atomic_compare_exchange_strong_explicit(ptr, expected, desired, \
82 succ_memorder, fail_memorder)
83
84#define rte_atomic_compare_exchange_weak_explicit(ptr, expected, desired, \
85 succ_memorder, fail_memorder) \
86 atomic_compare_exchange_weak_explicit(ptr, expected, desired, \
87 succ_memorder, fail_memorder)
88
89#define rte_atomic_fetch_add_explicit(ptr, val, memorder) \
90 atomic_fetch_add_explicit(ptr, val, memorder)
91
92#define rte_atomic_fetch_sub_explicit(ptr, val, memorder) \
93 atomic_fetch_sub_explicit(ptr, val, memorder)
94
95#define rte_atomic_fetch_and_explicit(ptr, val, memorder) \
96 atomic_fetch_and_explicit(ptr, val, memorder)
97
98#define rte_atomic_fetch_xor_explicit(ptr, val, memorder) \
99 atomic_fetch_xor_explicit(ptr, val, memorder)
100
101#define rte_atomic_fetch_or_explicit(ptr, val, memorder) \
102 atomic_fetch_or_explicit(ptr, val, memorder)
103
104#define rte_atomic_fetch_nand_explicit(ptr, val, memorder) \
105 atomic_fetch_nand_explicit(ptr, val, memorder)
106
107#define rte_atomic_flag_test_and_set_explicit(ptr, memorder) \
108 atomic_flag_test_and_set_explicit(ptr, memorder)
109
110#define rte_atomic_flag_clear_explicit(ptr, memorder) \
111 atomic_flag_clear_explicit(ptr, memorder)
112
113/* We provide internal macro here to allow conditional expansion
114 * in the body of the per-arch rte_atomic_thread_fence inline functions.
115 */
116#define __rte_atomic_thread_fence(memorder) \
117 atomic_thread_fence(memorder)
118
119#else /* __cplusplus */
120
121/* C++ cannot use the C11 _Atomic member layout that DPDK public headers
122 * rely on, so keep the builtin-based implementation for C++ and continue
123 * to expose the existing rte_atomic_* API surface.
124 */
125#define RTE_ATOMIC(type) type
126
127#define __rte_atomic
128
129/* The memory order is an integer type in GCC built-ins,
130 * not an enumerated type like in C11.
131 */
132typedef int rte_memory_order;
133
134#define rte_memory_order_relaxed __ATOMIC_RELAXED
135#define rte_memory_order_consume __ATOMIC_CONSUME
136#define rte_memory_order_acquire __ATOMIC_ACQUIRE
137#define rte_memory_order_release __ATOMIC_RELEASE
138#define rte_memory_order_acq_rel __ATOMIC_ACQ_REL
139#define rte_memory_order_seq_cst __ATOMIC_SEQ_CST
140
141#define rte_atomic_load_explicit(ptr, memorder) \
142 __atomic_load_n(ptr, memorder)
143
144#define rte_atomic_store_explicit(ptr, val, memorder) \
145 __atomic_store_n(ptr, val, memorder)
146
147#define rte_atomic_exchange_explicit(ptr, val, memorder) \
148 __atomic_exchange_n(ptr, val, memorder)
149
150#define rte_atomic_compare_exchange_strong_explicit(ptr, expected, desired, \
151 succ_memorder, fail_memorder) \
152 __atomic_compare_exchange_n(ptr, expected, desired, 0, \
153 succ_memorder, fail_memorder)
154
155#define rte_atomic_compare_exchange_weak_explicit(ptr, expected, desired, \
156 succ_memorder, fail_memorder) \
157 __atomic_compare_exchange_n(ptr, expected, desired, 1, \
158 succ_memorder, fail_memorder)
159
160#define rte_atomic_fetch_add_explicit(ptr, val, memorder) \
161 __atomic_fetch_add(ptr, val, memorder)
162
163#define rte_atomic_fetch_sub_explicit(ptr, val, memorder) \
164 __atomic_fetch_sub(ptr, val, memorder)
165
166#define rte_atomic_fetch_and_explicit(ptr, val, memorder) \
167 __atomic_fetch_and(ptr, val, memorder)
168
169#define rte_atomic_fetch_xor_explicit(ptr, val, memorder) \
170 __atomic_fetch_xor(ptr, val, memorder)
171
172#define rte_atomic_fetch_or_explicit(ptr, val, memorder) \
173 __atomic_fetch_or(ptr, val, memorder)
174
175#define rte_atomic_fetch_nand_explicit(ptr, val, memorder) \
176 __atomic_fetch_nand(ptr, val, memorder)
177
178#define rte_atomic_flag_test_and_set_explicit(ptr, memorder) \
179 __atomic_test_and_set(ptr, memorder)
180
181#define rte_atomic_flag_clear_explicit(ptr, memorder) \
182 __atomic_clear(ptr, memorder)
183
184/* We provide internal macro here to allow conditional expansion
185 * in the body of the per-arch rte_atomic_thread_fence inline functions.
186 */
187#define __rte_atomic_thread_fence(memorder) \
188 __atomic_thread_fence(memorder)
189
190#endif /* __cplusplus */
191
192#else /* !RTE_ENABLE_STDATOMIC */
193
194#define RTE_ATOMIC(type) type
195
196#define __rte_atomic
197
198/* The memory order is an integer type in GCC built-ins,
199 * not an enumerated type like in C11.
200 */
201typedef int rte_memory_order;
202
203#define rte_memory_order_relaxed __ATOMIC_RELAXED
204#define rte_memory_order_consume __ATOMIC_CONSUME
205#define rte_memory_order_acquire __ATOMIC_ACQUIRE
206#define rte_memory_order_release __ATOMIC_RELEASE
207#define rte_memory_order_acq_rel __ATOMIC_ACQ_REL
208#define rte_memory_order_seq_cst __ATOMIC_SEQ_CST
209
210#define rte_atomic_load_explicit(ptr, memorder) \
211 __atomic_load_n(ptr, memorder)
212
213#define rte_atomic_store_explicit(ptr, val, memorder) \
214 __atomic_store_n(ptr, val, memorder)
215
216#define rte_atomic_exchange_explicit(ptr, val, memorder) \
217 __atomic_exchange_n(ptr, val, memorder)
218
219#define rte_atomic_compare_exchange_strong_explicit(ptr, expected, desired, \
220 succ_memorder, fail_memorder) \
221 __atomic_compare_exchange_n(ptr, expected, desired, 0, \
222 succ_memorder, fail_memorder)
223
224#define rte_atomic_compare_exchange_weak_explicit(ptr, expected, desired, \
225 succ_memorder, fail_memorder) \
226 __atomic_compare_exchange_n(ptr, expected, desired, 1, \
227 succ_memorder, fail_memorder)
228
229#define rte_atomic_fetch_add_explicit(ptr, val, memorder) \
230 __atomic_fetch_add(ptr, val, memorder)
231
232#define rte_atomic_fetch_sub_explicit(ptr, val, memorder) \
233 __atomic_fetch_sub(ptr, val, memorder)
234
235#define rte_atomic_fetch_and_explicit(ptr, val, memorder) \
236 __atomic_fetch_and(ptr, val, memorder)
237
238#define rte_atomic_fetch_xor_explicit(ptr, val, memorder) \
239 __atomic_fetch_xor(ptr, val, memorder)
240
241#define rte_atomic_fetch_or_explicit(ptr, val, memorder) \
242 __atomic_fetch_or(ptr, val, memorder)
243
244#define rte_atomic_fetch_nand_explicit(ptr, val, memorder) \
245 __atomic_fetch_nand(ptr, val, memorder)
246
247#define rte_atomic_flag_test_and_set_explicit(ptr, memorder) \
248 __atomic_test_and_set(ptr, memorder)
249
250#define rte_atomic_flag_clear_explicit(ptr, memorder) \
251 __atomic_clear(ptr, memorder)
252
253/* We provide internal macro here to allow conditional expansion
254 * in the body of the per-arch rte_atomic_thread_fence inline functions.
255 */
256#define __rte_atomic_thread_fence(memorder) \
257 __atomic_thread_fence(memorder)
258
259#endif
260
261#endif /* RTE_STDATOMIC_H */