Module Name:    src
Committed By:   riastradh
Date:           Sat Nov 30 02:38:44 UTC 2019

Modified Files:
        src/share/man/man9: atomic_loadstore.9

Log Message:
Document relation to atomic_ops(3) and membar_ops(3).

To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man9/atomic_loadstore.9

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man9/atomic_loadstore.9
diff -u src/share/man/man9/atomic_loadstore.9:1.1 src/share/man/man9/atomic_loadstore.9:1.2
--- src/share/man/man9/atomic_loadstore.9:1.1	Fri Nov 29 22:17:23 2019
+++ src/share/man/man9/atomic_loadstore.9	Sat Nov 30 02:38:44 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: atomic_loadstore.9,v 1.1 2019/11/29 22:17:23 riastradh Exp $
+.\"	$NetBSD: atomic_loadstore.9,v 1.2 2019/11/30 02:38:44 riastradh Exp $
 .\" Copyright (c) 2019 The NetBSD Foundation
 .\" All rights reserved.
@@ -621,6 +621,60 @@ They do not require
 to be at most the largest size of available atomic loads and stores on
 the host architecture.
+The atomic read/modify/write operations in
+.Xr atomic_ops 3
+have relaxed ordering by default, but can be combined with the memory
+barriers in
+.Xr membar_ops 3
+for the same effect as an acquire operation and a release operation for
+the purposes of pairing with
+.Fn atomic_store_release
+.Fn atomic_load_acquire
+.Fn atomic_load_consume :
+.Fn atomic_r/m/w
+is an atomic read/modify/write operation in
+.Xr atomic_ops 3 ,
+.Bd -literal
+	membar_exit();
+	atomic_r/m/w(obj, ...);
+functions like a release operation on
+.Fa obj ,
+.Bd -literal
+	atomic_r/m/w(obj, ...);
+	membar_enter();
+functions like a acquire operation on
+.Fa obj .
+The combination of
+.Fn atomic_load_relaxed
+.Xr membar_enter 3
+.Em does not
+make an acquire operation; only read/modify/write atomics may be
+combined with
+.Xr membar_enter 3
+this way.
+On architectures where
+is defined, all the
+.Xr atomic_ops 3
+imply release and acquire operations, so the
+.Xr membar_enter 3
+.Xr membar_exit 3
+are redundant.
 Maintaining lossy counters.
 These may lose some counts, because the read/modify/write cycle as a

Reply via email to