summaryrefslogtreecommitdiffstats
path: root/share/man/man9
diff options
context:
space:
mode:
authorkib <kib@FreeBSD.org>2015-06-27 09:47:28 +0000
committerkib <kib@FreeBSD.org>2015-06-27 09:47:28 +0000
commit02efaba1d135756ed65855bdc99e7d83f46cc4a2 (patch)
treeee26f738755bf2087d67bfedf3714b546668ea62 /share/man/man9
parent45502dd8d189893975f1f887eb97e8f59e9b2c78 (diff)
downloadFreeBSD-src-02efaba1d135756ed65855bdc99e7d83f46cc4a2.zip
FreeBSD-src-02efaba1d135756ed65855bdc99e7d83f46cc4a2.tar.gz
MFC r284646:
The barriers, provided by _acq and _rel atomics, are acquire and release barriers, not read and write barriers.
Diffstat (limited to 'share/man/man9')
-rw-r--r--share/man/man9/atomic.910
1 files changed, 7 insertions, 3 deletions
diff --git a/share/man/man9/atomic.9 b/share/man/man9/atomic.9
index 44d800e..727ef47 100644
--- a/share/man/man9/atomic.9
+++ b/share/man/man9/atomic.9
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 20, 2013
+.Dd June 20, 2015
.Dt ATOMIC 9
.Os
.Sh NAME
@@ -123,7 +123,9 @@ The first form just performs the operation without any explicit barriers.
The second form uses a read memory barrier, and the third variant uses a write
memory barrier.
.Pp
-The second variant of each operation includes a read memory barrier.
+The second variant of each operation includes an
+.Em acquire
+memory barrier.
This barrier ensures that the effects of this operation are completed before the
effects of any later data accesses.
As a result, the operation is said to have acquire semantics as it acquires a
@@ -137,7 +139,9 @@ For example, to subtract two integers ensuring that any later writes will
happen after the subtraction is performed, use
.Fn atomic_subtract_acq_int .
.Pp
-The third variant of each operation includes a write memory barrier.
+The third variant of each operation includes a
+.Em release
+memory barrier.
This ensures that all effects of all previous data accesses are completed
before this operation takes place.
As a result, the operation is said to have release semantics as it releases
OpenPOWER on IntegriCloud