Skip to contentSkip to conversation

documentation: atomic_add_unless() doesn't imply mb() on failure

PATCH RESEND Superseded Oleg Nesterov 2 participants 2 messages Aug 17, 2007 – Aug 23, 2007

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH RESEND 1/1 documentation: atomic_add_unless() doesn't imply mb() on failure

(the explicit ack/nack from maintainers is wanted).

A "typical" implementation of atomic_add_unless() can return 0 immediately after the first atomic_read() (before doing cmpxchg). In that case it doesn't provide any barrier semantics. See include/asm-ia64/atomic.h as an example.

We should either change the implementation, or fix the docs.

 Documentation/atomic_ops.txt      |    3 ++-
 Documentation/memory-barriers.txt |    2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)
Documentation/atomic_ops.txt renamed from Documentation/atomic_ops.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure +2 -1
diff -puN Documentation/atomic_ops.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure Documentation/atomic_ops.txt
@@ -137,7 +137,8 @@ If the atomic value v is not equal to u,
 returns non zero. If v is equal to u then it returns zero. This is done as
 an atomic operation.
 
-atomic_add_unless requires explicit memory barriers around the operation.
+atomic_add_unless requires explicit memory barriers around the operation
+unless it fails (returns 0).
 
 atomic_inc_not_zero, equivalent to atomic_add_unless(v, 1, 0)
 
Documentation/memory-barriers.txt renamed from Documentation/memory-barriers.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure +1 -1
diff -puN Documentation/memory-barriers.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure Documentation/memory-barriers.txt
@@ -1492,7 +1492,7 @@ about the state (old or new) implies an 
 	atomic_dec_and_test();
 	atomic_sub_and_test();
 	atomic_add_negative();
-	atomic_add_unless();
+	atomic_add_unless();	/* when succeeds (returns 1) */
 	test_and_set_bit();
 	test_and_clear_bit();
 	test_and_change_bit();

_

Acked-by on v1 1/1
#1 lore raw
Quoted 7 lines · Oleg Nesterov

(the explicit ack/nack from maintainers is wanted).

A "typical" implementation of atomic_add_unless() can return 0 immediately after the first atomic_read() (before doing cmpxchg). In that case it doesn't provide any barrier semantics. See include/asm-ia64/atomic.h as an example.

We should either change the implementation, or fix the docs.

Did this end up getting merged? If not, it should, thanks.

Quoted 35 lines
 Documentation/atomic_ops.txt      |    3 ++-
 Documentation/memory-barriers.txt |    2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff -puN Documentation/atomic_ops.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure Documentation/atomic_ops.txt

Documentation/atomic_ops.txt renamed from Documentation/atomic_ops.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure +2 -1
@@ -137,7 +137,8 @@ If the atomic value v is not equal to u,
 returns non zero. If v is equal to u then it returns zero. This is done as
 an atomic operation.
 
-atomic_add_unless requires explicit memory barriers around the operation.
+atomic_add_unless requires explicit memory barriers around the operation
+unless it fails (returns 0).
 
 atomic_inc_not_zero, equivalent to atomic_add_unless(v, 1, 0)
 

diff -puN Documentation/memory-barriers.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure Documentation/memory-barriers.txt

Documentation/memory-barriers.txt renamed from Documentation/memory-barriers.txt~doc-atomic_add_unless-doesnt-imply-mb-on-failure +1 -1
@@ -1492,7 +1492,7 @@ about the state (old or new) implies an 
 	atomic_dec_and_test();
 	atomic_sub_and_test();
 	atomic_add_negative();
-	atomic_add_unless();
+	atomic_add_unless();	/* when succeeds (returns 1) */
 	test_and_set_bit();
 	test_and_clear_bit();
 	test_and_change_bit();

_

Signature · 1 line
SUSE Labs, Novell Inc.