Page MenuHomeFreeBSD

D22702.1790005989.diff
No OneTemporary

Size
2 KB
Referenced Files
None
Subscribers
None

D22702.1790005989.diff

Index: share/man/man9/bitset.9
===================================================================
--- share/man/man9/bitset.9
+++ share/man/man9/bitset.9
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd July 7, 2017
+.Dd December 6, 2019
.Dt BITSET 9
.Os
.Sh NAME
@@ -59,6 +59,8 @@
.Nm BIT_CLR_ATOMIC ,
.Nm BIT_SET_ATOMIC ,
.Nm BIT_SET_ATOMIC_ACQ ,
+.Nm BIT_TEST_SET_ATOMIC ,
+.Nm BIT_TEST_CLR_ATOMIC ,
.Nm BIT_AND_ATOMIC ,
.Nm BIT_OR_ATOMIC ,
.Nm BIT_COPY_STORE_REL
@@ -134,6 +136,10 @@
.Fn BIT_CLR_ATOMIC "const SETSIZE" "size_t bit" "struct STRUCTNAME *bitset"
.Fn BIT_SET_ATOMIC "const SETSIZE" "size_t bit" "struct STRUCTNAME *bitset"
.Fn BIT_SET_ATOMIC_ACQ "const SETSIZE" "size_t bit" "struct STRUCTNAME *bitset"
+.Ft bool
+.Fn BIT_TEST_SET_ATOMIC "const SETSIZE" "size_t bit" "struct STRUCTNAME *bitset"
+.Ft bool
+.Fn BIT_TEST_CLR_ATOMIC "const SETSIZE" "size_t bit" "struct STRUCTNAME *bitset"
.\"
.Fo BIT_AND_ATOMIC
.Fa "const SETSIZE" "struct STRUCTNAME *dst" "struct STRUCTNAME *src"
@@ -202,6 +208,9 @@
The
.Fn BIT_CLR_ATOMIC
macro is identical, but the bit is cleared atomically.
+The
+.Fn BIT_TEST_CLR_ATOMIC
+macro atomically clears the bit and returns whether it was set.
.Pp
The
.Fn BIT_COPY
@@ -233,6 +242,9 @@
The
.Fn BIT_SET_ATOMIC_ACQ
macro sets the bit with acquire semantics.
+The
+.Fn BIT_TEST_SET_ATOMIC
+macro atomically sets the bit and returns whether it was set.
.Pp
The
.Fn BIT_ZERO
Index: sys/sys/bitset.h
===================================================================
--- sys/sys/bitset.h
+++ sys/sys/bitset.h
@@ -173,6 +173,12 @@
(d)->__bits[__i] = (s1)->__bits[__i] ^ (s2)->__bits[__i];\
} while (0)
+/*
+ * Note, the atomic(9) API is not consistent between clear/set and
+ * testandclear/testandset in whether the value argument is a mask
+ * or a bit index.
+ */
+
#define BIT_CLR_ATOMIC(_s, n, p) \
atomic_clear_long(&(p)->__bits[__bitset_word(_s, n)], \
__bitset_mask((_s), n))
@@ -185,6 +191,14 @@
atomic_set_acq_long(&(p)->__bits[__bitset_word(_s, n)], \
__bitset_mask((_s), n))
+#define BIT_TEST_CLR_ATOMIC(_s, n, p) \
+ (atomic_testandclear_long( \
+ &(p)->__bits[__bitset_word((_s), (n))], (n)) != 0)
+
+#define BIT_TEST_SET_ATOMIC(_s, n, p) \
+ (atomic_testandset_long( \
+ &(p)->__bits[__bitset_word((_s), (n))], (n)) != 0)
+
/* Convenience functions catering special cases. */
#define BIT_AND_ATOMIC(_s, d, s) do { \
__size_t __i; \

File Metadata

Mime Type
text/plain
Expires
Mon, Sep 21, 3:53 PM (15 h, 18 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29845041
Default Alt Text
D22702.1790005989.diff (2 KB)

Event Timeline