[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH] atomic: update documentation
From: |
Alex Bennée |
Subject: |
Re: [Qemu-devel] [PATCH] atomic: update documentation |
Date: |
Fri, 22 Sep 2017 11:00:35 +0100 |
User-agent: |
mu4e 0.9.19; emacs 25.3.50.1 |
Paolo Bonzini <address@hidden> writes:
> Signed-off-by: Paolo Bonzini <address@hidden>
Reviewed-by: Alex Bennée <address@hidden>
> ---
> docs/devel/atomics.txt | 13 ++++++++++++-
> 1 file changed, 12 insertions(+), 1 deletion(-)
>
> diff --git a/docs/devel/atomics.txt b/docs/devel/atomics.txt
> index 3ef5d85b1b..048e5f23cb 100644
> --- a/docs/devel/atomics.txt
> +++ b/docs/devel/atomics.txt
> @@ -63,11 +63,22 @@ operations:
> typeof(*ptr) atomic_fetch_sub(ptr, val)
> typeof(*ptr) atomic_fetch_and(ptr, val)
> typeof(*ptr) atomic_fetch_or(ptr, val)
> + typeof(*ptr) atomic_fetch_xor(ptr, val)
> typeof(*ptr) atomic_xchg(ptr, val)
> typeof(*ptr) atomic_cmpxchg(ptr, old, new)
>
> all of which return the old value of *ptr. These operations are
> -polymorphic; they operate on any type that is as wide as an int.
> +polymorphic; they operate on any type that is as wide as a pointer.
> +
> +Similar operations return the new value of *ptr:
> +
> + typeof(*ptr) atomic_inc_fetch(ptr)
> + typeof(*ptr) atomic_dec_fetch(ptr)
> + typeof(*ptr) atomic_add_fetch(ptr, val)
> + typeof(*ptr) atomic_sub_fetch(ptr, val)
> + typeof(*ptr) atomic_and_fetch(ptr, val)
> + typeof(*ptr) atomic_or_fetch(ptr, val)
> + typeof(*ptr) atomic_xor_fetch(ptr, val)
>
> Sequentially consistent loads and stores can be done using:
--
Alex Bennée