Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ad2ad5d3 authored by Paul E. McKenney's avatar Paul E. McKenney
Browse files

documentation: Add lockless_dereference() 



The recently added lockless_dereference() macro is not present in the
Documentation/ directory, so this commit fixes that.

Reported-by: default avatarDmitry Vyukov <dvyukov@google.com>
Signed-off-by: default avatarPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: default avatarJosh Triplett <josh@joshtriplett.org>
parent b672adf8

Documentation/memory-barriers.txt

+11 −0
Original line number Original line Diff line number Diff line
@@ -1710,6 +1710,17 @@ There are some more advanced barrier functions: 
     operations" subsection for information on where to use these.

     operations" subsection for information on where to use these.









 (*) lockless_dereference();

     This can be thought of as a pointer-fetch wrapper around the

     smp_read_barrier_depends() data-dependency barrier.



     This is also similar to rcu_dereference(), but in cases where

     object lifetime is handled by some mechanism other than RCU, for

     example, when the objects removed only when the system goes down.

     In addition, lockless_dereference() is used in some data structures

     that can be used both with and without RCU.





 (*) dma_wmb();

 (*) dma_wmb();

 (*) dma_rmb();

 (*) dma_rmb();