ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
atomic.h
Go to the documentation of this file.
1
37
38#pragma once
39
40#include <stdatomic.h>
41#include <stdbool.h>
42#include <stdint.h>
43#include <stddef.h>
44
45#ifdef __cplusplus
46extern "C" {
47#endif
48
49// ============================================================================
50// Core Atomic Types
51// ============================================================================
52
76typedef struct {
78#ifndef NDEBUG
79 _Atomic(uint64_t) change_count;
80 _Atomic(uint64_t) last_store_time_ns;
81 _Atomic(uint64_t) last_load_time_ns;
82 _Atomic(uint64_t) store_count;
83 _Atomic(uint64_t) load_count;
84 _Atomic(uint64_t) cas_count;
85 _Atomic(uint64_t) cas_success_count;
86 _Atomic(uint64_t) fetch_count;
87#endif
90} atomic_t;
91
110typedef struct {
111 _Atomic(void *) impl;
112#ifndef NDEBUG
113 _Atomic(uint64_t) change_count;
114 _Atomic(uint64_t) last_store_time_ns;
115 _Atomic(uint64_t) last_load_time_ns;
116 _Atomic(uint64_t) store_count;
117 _Atomic(uint64_t) load_count;
118 _Atomic(uint64_t) cas_count;
119 _Atomic(uint64_t) cas_success_count;
120 _Atomic(uint64_t) exchange_count;
121#endif
125
126// ============================================================================
127// bool Operations
128// ============================================================================
129
136#ifndef NDEBUG
138#else
139#define atomic_load_bool(a) ((bool)atomic_load_bool_impl(a))
140#endif
141
143
149#ifndef NDEBUG
150void atomic_store_bool(atomic_t *a, bool value);
151#else
152#define atomic_store_bool(a, value) atomic_store_bool_impl((a), (uint64_t)(value))
153#endif
154
156
164#ifndef NDEBUG
165bool atomic_cas_bool(atomic_t *a, bool *expected, bool new_value);
166#else
167#define atomic_cas_bool(a, expected, new_value) atomic_cas_bool_impl((a), (expected), (new_value))
168#endif
169
170bool atomic_cas_bool_impl(atomic_t *a, bool *expected, bool new_value);
171
181#ifndef NDEBUG
182bool atomic_exchange_bool(atomic_t *a, bool new_value);
183#else
184#define atomic_exchange_bool(a, new_value) atomic_exchange_bool_impl((a), (new_value))
185#endif
186
187bool atomic_exchange_bool_impl(atomic_t *a, bool new_value);
188
189// ============================================================================
190// int Operations
191// ============================================================================
192
198#ifndef NDEBUG
200#else
201#define atomic_load_int(a) ((int)atomic_load_int_impl(a))
202#endif
203
205
211#ifndef NDEBUG
212void atomic_store_int(atomic_t *a, int value);
213#else
214#define atomic_store_int(a, value) atomic_store_int_impl((a), (uint64_t)(int32_t)(value))
215#endif
216
218
225#ifndef NDEBUG
227#else
228#define atomic_fetch_add_int(a, delta) ((int)atomic_fetch_add_int_impl((a), (int64_t)(delta)))
229#endif
230
231int atomic_fetch_add_int_impl(atomic_t *a, int64_t delta);
232
239#ifndef NDEBUG
241#else
242#define atomic_fetch_sub_int(a, delta) ((int)atomic_fetch_sub_int_impl((a), (int64_t)(delta)))
243#endif
244
245int atomic_fetch_sub_int_impl(atomic_t *a, int64_t delta);
246
254#ifndef NDEBUG
255bool atomic_cas_int(atomic_t *a, int *expected, int new_value);
256#else
257#define atomic_cas_int(a, expected, new_value) atomic_cas_int_impl((a), (expected), (new_value))
258#endif
259
260bool atomic_cas_int_impl(atomic_t *a, int *expected, int new_value);
261
262// ============================================================================
263// uint64_t Operations
264// ============================================================================
265
271#ifndef NDEBUG
273#else
274#define atomic_load_u64(a) atomic_load_u64_impl(a)
275#endif
276
278
284#ifndef NDEBUG
286#else
287#define atomic_store_u64(a, value) atomic_store_u64_impl((a), (value))
288#endif
289
291
298#ifndef NDEBUG
300#else
301#define atomic_fetch_add_u64(a, delta) atomic_fetch_add_u64_impl((a), (delta))
302#endif
303
305
312#ifndef NDEBUG
314#else
315#define atomic_fetch_sub_u64(a, delta) atomic_fetch_sub_u64_impl((a), (delta))
316#endif
317
319
327#ifndef NDEBUG
328bool atomic_cas_u64(atomic_t *a, uint64_t *expected, uint64_t new_value);
329#else
330#define atomic_cas_u64(a, expected, new_value) atomic_cas_u64_impl((a), (expected), (new_value))
331#endif
332
333bool atomic_cas_u64_impl(atomic_t *a, uint64_t *expected, uint64_t new_value);
334
350#ifndef NDEBUG
352#else
353#define atomic_exchange_u64(a, new_value) atomic_exchange_u64_impl((a), (new_value))
354#endif
355
357
358// ============================================================================
359// Pointer Operations
360// ============================================================================
361
367#ifndef NDEBUG
369#else
370#define atomic_ptr_load(a) atomic_ptr_load_impl(a)
371#endif
372
374
380#ifndef NDEBUG
381void atomic_ptr_store(atomic_ptr_t *a, void *value);
382#else
383#define atomic_ptr_store(a, value) atomic_ptr_store_impl((a), (value))
384#endif
385
387
395#ifndef NDEBUG
396bool atomic_ptr_cas(atomic_ptr_t *a, void **expected, void *new_value);
397#else
398#define atomic_ptr_cas(a, expected, new_value) atomic_ptr_cas_impl((a), (expected), (new_value))
399#endif
400
401bool atomic_ptr_cas_impl(atomic_ptr_t *a, void **expected, void *new_value);
402
409#ifndef NDEBUG
410void *atomic_ptr_exchange(atomic_ptr_t *a, void *new_value);
411#else
412#define atomic_ptr_exchange(a, new_value) atomic_ptr_exchange_impl((a), (new_value))
413#endif
414
415void *atomic_ptr_exchange_impl(atomic_ptr_t *a, void *new_value);
416
423#ifndef NDEBUG
424int atomic_exchange_int(atomic_t *a, int new_value);
425#else
426#define atomic_exchange_int(a, new_value) atomic_exchange_int_impl((a), (new_value))
427#endif
428
429int atomic_exchange_int_impl(atomic_t *a, int new_value);
430
431// ============================================================================
432// Debug Hooks (called by _impl functions in debug builds)
433// ============================================================================
434
435#ifndef NDEBUG
438void atomic_on_cas(atomic_t *a, bool success);
440
443void atomic_ptr_on_cas(atomic_ptr_t *a, bool success);
445#endif
446
447// ============================================================================
448// Convenience Macros for Atomic Declaration and Registration
449// ============================================================================
450
469#define ATOMIC_REGISTER_AUTO(name, parent_ptr) NAMED_REGISTER_ATOMIC(&(name), #name, (uintptr_t)(const void *)(parent_ptr))
470
482#define ATOMIC_PTR_REGISTER_AUTO(name) NAMED_REGISTER_ATOMIC_PTR(&(name), #name)
483
484// ============================================================================
485// Automatic Named Initialization & Registration Macros
486// ============================================================================
487
506#ifndef NDEBUG
507#define ATOMIC_INIT_AUTO(...) = _atomic_init_auto(__VA_ARGS__)
508#else
509#define ATOMIC_INIT_AUTO(...) = {0}
510#endif
511
517#ifndef NDEBUG
518#define ATOMIC_PTR_INIT_AUTO(...) = _atomic_ptr_init_auto(__VA_ARGS__)
519#else
520#define ATOMIC_PTR_INIT_AUTO(...) = {0}
521#endif
522
523// Actual init functions (defined below - use a workaround pattern)
524// These are helpers that work with static initialization
525#define _atomic_init_auto(name) \
526 {0}; \
527 static void __attribute__((constructor, used)) _atomic_reg_##name(void) { \
528 NAMED_REGISTER_ATOMIC(&name, #name, NULL); \
529 } \
530 typedef int _atomic_assert_##name
531
532#define _atomic_ptr_init_auto(name) \
533 {0}; \
534 static void __attribute__((constructor, used)) _atomic_ptr_reg_##name(void) { \
535 NAMED_REGISTER_ATOMIC_PTR(&name, #name, NULL); \
536 } \
537 typedef int _atomic_ptr_assert_##name
538
539// ============================================================================
540// Debug Initialization/Shutdown
541// ============================================================================
542
543#ifndef NDEBUG
548#else
549#define debug_atomic_init() ((void)0)
550#define debug_atomic_shutdown() ((void)0)
551#define debug_atomic_is_initialized() (true)
552#define debug_atomic_print_state() ((void)0)
553#endif
554
555#ifdef __cplusplus
556}
557#endif
uint64_t atomic_fetch_add_u64(atomic_t *a, uint64_t delta)
Atomically add to a uint64_t and return the previous value.
void atomic_ptr_on_load(atomic_ptr_t *a)
bool atomic_cas_int_impl(atomic_t *a, int *expected, int new_value)
bool atomic_cas_u64(atomic_t *a, uint64_t *expected, uint64_t new_value)
Atomically compare-and-swap a uint64_t.
void * atomic_ptr_exchange(atomic_ptr_t *a, void *new_value)
Atomically exchange a pointer and return the old value.
void atomic_ptr_store_impl(atomic_ptr_t *a, void *value)
int atomic_fetch_add_int_impl(atomic_t *a, int64_t delta)
void atomic_on_cas(atomic_t *a, bool success)
uint64_t atomic_exchange_u64_impl(atomic_t *a, uint64_t new_value)
void atomic_store_bool(atomic_t *a, bool value)
Atomically store a boolean value.
void atomic_ptr_store(atomic_ptr_t *a, void *value)
Atomically store a pointer.
int atomic_fetch_add_int(atomic_t *a, int delta)
Atomically add to an int and return the previous value.
bool atomic_load_bool(atomic_t *a)
Atomic pointer wrapper.
void atomic_ptr_on_cas(atomic_ptr_t *a, bool success)
void * atomic_ptr_load(atomic_ptr_t *a)
Atomically load a pointer.
uint64_t atomic_exchange_u64(atomic_t *a, uint64_t new_value)
Atomically exchange a uint64_t and return the old value.
int atomic_fetch_sub_int(atomic_t *a, int delta)
Atomically subtract from an int and return the previous value.
bool atomic_cas_bool_impl(atomic_t *a, bool *expected, bool new_value)
void debug_atomic_init(void)
int atomic_load_int_impl(const atomic_t *a)
bool atomic_cas_u64_impl(atomic_t *a, uint64_t *expected, uint64_t new_value)
void atomic_ptr_on_store(atomic_ptr_t *a)
void atomic_store_u64_impl(atomic_t *a, uint64_t value)
void atomic_on_load(atomic_t *a)
uint64_t atomic_load_u64_impl(const atomic_t *a)
void * atomic_ptr_exchange_impl(atomic_ptr_t *a, void *new_value)
uint64_t atomic_fetch_add_u64_impl(atomic_t *a, uint64_t delta)
int atomic_fetch_sub_int_impl(atomic_t *a, int64_t delta)
bool atomic_ptr_cas_impl(atomic_ptr_t *a, void **expected, void *new_value)
bool atomic_load_bool_impl(const atomic_t *a)
uint64_t atomic_fetch_sub_u64(atomic_t *a, uint64_t delta)
Atomically subtract from a uint64_t and return the previous value.
void atomic_store_u64(atomic_t *a, uint64_t value)
Atomically store a uint64_t value.
void atomic_store_int(atomic_t *a, int value)
Atomically store an int value.
void atomic_store_bool_impl(atomic_t *a, uint64_t value)
bool atomic_cas_int(atomic_t *a, int *expected, int new_value)
Atomically compare-and-swap an int.
void atomic_ptr_on_exchange(atomic_ptr_t *a)
void atomic_store_int_impl(atomic_t *a, uint64_t value)
void debug_atomic_print_state(void)
void debug_atomic_shutdown(void)
void atomic_on_fetch(atomic_t *a)
bool debug_atomic_is_initialized(void)
int atomic_exchange_int_impl(atomic_t *a, int new_value)
int atomic_exchange_int(atomic_t *a, int new_value)
Atomically exchange an int and return the old value.
void * atomic_ptr_load_impl(const atomic_ptr_t *a)
uint64_t atomic_fetch_sub_u64_impl(atomic_t *a, uint64_t delta)
uint64_t atomic_load_u64(atomic_t *a)
Atomically load a uint64_t value.
void atomic_on_store(atomic_t *a)
bool atomic_exchange_bool_impl(atomic_t *a, bool new_value)
bool atomic_exchange_bool(atomic_t *a, bool new_value)
Atomically exchange a boolean and return the old value.
int atomic_load_int(atomic_t *a)
Atomically load an int value.
bool atomic_ptr_cas(atomic_ptr_t *a, void **expected, void *new_value)
Atomically compare-and-swap a pointer.
bool atomic_cas_bool(atomic_t *a, bool *expected, bool new_value)
Atomically compare-and-swap a boolean.
unsigned long long uint64_t
Atomic value wrapper for integral/boolean types.
Definition atomic.h:110
_Atomic(uint64_t) cas_success_count
_Atomic(uint64_t) last_load_time_ns
_Atomic(uint64_t) change_count
_Atomic(uint64_t) store_count
_Atomic(void *) impl
Underlying C11 atomic pointer.
_Atomic(uint64_t) load_count
_Atomic(uint64_t) last_store_time_ns
_Atomic(uint64_t) cas_count
_Atomic(uint64_t) exchange_count
Atomic value wrapper for integral/boolean types.
Definition atomic.h:76
_Atomic(uint64_t) impl
Underlying C11 atomic value.
_Atomic(uint64_t) store_count
_Atomic(uint64_t) fetch_count
_Atomic(uint64_t) last_load_time_ns
_Atomic(uint64_t) last_store_time_ns
_Atomic(uint64_t) change_count
_Atomic(uint64_t) cas_success_count
_Atomic(uint64_t) cas_count
_Atomic(uint64_t) load_count