git: 9front

Info  •  Files  •  Log  •  Branches

atomic(2): note that use is discouraged

consider yourselves warned.
atomics are often misunderstood and easily misused.
example: https://preshing.com/20120515/memory-reordering-caught-in-the-act

--- a/sys/man/2/atomic

+++ b/sys/man/2/atomic

@@ -92,3 +92,10 @@

 .SH BUGS

 The vlong operations may be emulated in software and therefore must not be called from a note handler.

+.P

+Correct use of atomics is fundamentally hard,

+and they are generally to be avoided.

+If the intent is to use them for anything other than refcounts and id generation,

+look to

+.IR lock (2)

+for alternatives.

-- 

⑨