1/* SPDX-License-Identifier: GPL-2.0 */
2/* Atomic operations usable in machine independent code */
3#ifndef _LINUX_ATOMIC_H
4#define _LINUX_ATOMIC_H
5#include <linux/types.h>
6
7#include <asm/atomic.h>
8#include <asm/barrier.h>
9
10/*
11 * Relaxed variants of xchg, cmpxchg and some atomic operations.
12 *
13 * We support four variants:
14 *
15 * - Fully ordered: The default implementation, no suffix required.
16 * - Acquire: Provides ACQUIRE semantics, _acquire suffix.
17 * - Release: Provides RELEASE semantics, _release suffix.
18 * - Relaxed: No ordering guarantees, _relaxed suffix.
19 *
20 * For compound atomics performing both a load and a store, ACQUIRE
21 * semantics apply only to the load and RELEASE semantics only to the
22 * store portion of the operation. Note that a failed cmpxchg_acquire
23 * does -not- imply any memory ordering constraints.
24 *
25 * See Documentation/memory-barriers.txt for ACQUIRE/RELEASE definitions.
26 */
27
28#define atomic_cond_read_acquire(v, c) smp_cond_load_acquire(&(v)->counter, (c))
29#define atomic_cond_read_relaxed(v, c) smp_cond_load_relaxed(&(v)->counter, (c))
30
31#define atomic64_cond_read_acquire(v, c) smp_cond_load_acquire(&(v)->counter, (c))
32#define atomic64_cond_read_relaxed(v, c) smp_cond_load_relaxed(&(v)->counter, (c))
33
34/*
35 * The idea here is to build acquire/release variants by adding explicit
36 * barriers on top of the relaxed variant. In the case where the relaxed
37 * variant is already fully ordered, no additional barriers are needed.
38 *
39 * If an architecture overrides __atomic_acquire_fence() it will probably
40 * want to define smp_mb__after_spinlock().
41 */
42#ifndef __atomic_acquire_fence
43#define __atomic_acquire_fence smp_mb__after_atomic
44#endif
45
46#ifndef __atomic_release_fence
47#define __atomic_release_fence smp_mb__before_atomic
48#endif
49
50#ifndef __atomic_pre_full_fence
51#define __atomic_pre_full_fence smp_mb__before_atomic
52#endif
53
54#ifndef __atomic_post_full_fence
55#define __atomic_post_full_fence smp_mb__after_atomic
56#endif
57
58#define __atomic_op_acquire(op, args...) \
59({ \
60 typeof(op##_relaxed(args)) __ret = op##_relaxed(args); \
61 __atomic_acquire_fence(); \
62 __ret; \
63})
64
65#define __atomic_op_release(op, args...) \
66({ \
67 __atomic_release_fence(); \
68 op##_relaxed(args); \
69})
70
71#define __atomic_op_fence(op, args...) \
72({ \
73 typeof(op##_relaxed(args)) __ret; \
74 __atomic_pre_full_fence(); \
75 __ret = op##_relaxed(args); \
76 __atomic_post_full_fence(); \
77 __ret; \
78})
79
80#include <linux/atomic/atomic-arch-fallback.h>
81#include <linux/atomic/atomic-long.h>
82#include <linux/atomic/atomic-instrumented.h>
83
84#endif /* _LINUX_ATOMIC_H */
85

source code of linux/include/linux/atomic.h