#include <stdint.h>
#include <rte_common.h>

Data Structures
struct	rte_atomic16_t

struct	rte_atomic32_t

struct	rte_atomic64_t

struct	__rte_aligned

Macros
#define	rte_compiler_barrier()

#define	RTE_ATOMIC16_INIT(val) { (val) }

#define	RTE_ATOMIC32_INIT(val) { (val) }

#define	RTE_ATOMIC64_INIT(val) { (val) }

Functions
static void	rte_atomic_thread_fence (int memorder)

static int	rte_atomic16_cmpset (volatile uint16_t *dst, uint16_t exp, uint16_t src)

static uint16_t	rte_atomic16_exchange (volatile uint16_t *dst, uint16_t val)

static void	rte_atomic16_init (rte_atomic16_t *v)

static int16_t	rte_atomic16_read (const rte_atomic16_t *v)

static void	rte_atomic16_set (rte_atomic16_t *v, int16_t new_value)

static void	rte_atomic16_add (rte_atomic16_t *v, int16_t inc)

static void	rte_atomic16_sub (rte_atomic16_t *v, int16_t dec)

static void	rte_atomic16_inc (rte_atomic16_t *v)

static void	rte_atomic16_dec (rte_atomic16_t *v)

static int16_t	rte_atomic16_add_return (rte_atomic16_t *v, int16_t inc)

static int16_t	rte_atomic16_sub_return (rte_atomic16_t *v, int16_t dec)

static int	rte_atomic16_inc_and_test (rte_atomic16_t *v)

static int	rte_atomic16_dec_and_test (rte_atomic16_t *v)

static int	rte_atomic16_test_and_set (rte_atomic16_t *v)

static void	rte_atomic16_clear (rte_atomic16_t *v)

static int	rte_atomic32_cmpset (volatile uint32_t *dst, uint32_t exp, uint32_t src)

static uint32_t	rte_atomic32_exchange (volatile uint32_t *dst, uint32_t val)

static void	rte_atomic32_init (rte_atomic32_t *v)

static int32_t	rte_atomic32_read (const rte_atomic32_t *v)

static void	rte_atomic32_set (rte_atomic32_t *v, int32_t new_value)

static void	rte_atomic32_add (rte_atomic32_t *v, int32_t inc)

static void	rte_atomic32_sub (rte_atomic32_t *v, int32_t dec)

static void	rte_atomic32_inc (rte_atomic32_t *v)

static void	rte_atomic32_dec (rte_atomic32_t *v)

static int32_t	rte_atomic32_add_return (rte_atomic32_t *v, int32_t inc)

static int32_t	rte_atomic32_sub_return (rte_atomic32_t *v, int32_t dec)

static int	rte_atomic32_inc_and_test (rte_atomic32_t *v)

static int	rte_atomic32_dec_and_test (rte_atomic32_t *v)

static int	rte_atomic32_test_and_set (rte_atomic32_t *v)

static void	rte_atomic32_clear (rte_atomic32_t *v)

static int	rte_atomic64_cmpset (volatile uint64_t *dst, uint64_t exp, uint64_t src)

static uint64_t	rte_atomic64_exchange (volatile uint64_t *dst, uint64_t val)

static void	rte_atomic64_init (rte_atomic64_t *v)

static int64_t	rte_atomic64_read (rte_atomic64_t *v)

static void	rte_atomic64_set (rte_atomic64_t *v, int64_t new_value)

static void	rte_atomic64_add (rte_atomic64_t *v, int64_t inc)

static void	rte_atomic64_sub (rte_atomic64_t *v, int64_t dec)

static void	rte_atomic64_inc (rte_atomic64_t *v)

static void	rte_atomic64_dec (rte_atomic64_t *v)

static int64_t	rte_atomic64_add_return (rte_atomic64_t *v, int64_t inc)

static int64_t	rte_atomic64_sub_return (rte_atomic64_t *v, int64_t dec)

static int	rte_atomic64_inc_and_test (rte_atomic64_t *v)

static int	rte_atomic64_dec_and_test (rte_atomic64_t *v)

static int	rte_atomic64_test_and_set (rte_atomic64_t *v)

static void	rte_atomic64_clear (rte_atomic64_t *v)

static __rte_experimental int	rte_atomic128_cmp_exchange (rte_int128_t dst, rte_int128_t exp, const rte_int128_t *src, unsigned int weak, int success, int failure)

Memory Barrier
static void	rte_mb (void)

static void	rte_wmb (void)

static void	rte_rmb (void)

SMP Memory Barrier
static void	rte_smp_mb (void)

static void	rte_smp_wmb (void)

static void	rte_smp_rmb (void)

I/O Memory Barrier
static void	rte_io_mb (void)

static void	rte_io_wmb (void)

static void	rte_io_rmb (void)

Detailed Description

Atomic Operations

This file defines a generic API for atomic operations.

Definition in file rte_atomic.h.

Macro Definition Documentation

◆ rte_compiler_barrier

#define rte_compiler_barrier ( )

Value:

do {        \
    asm volatile ("" : : : "memory");   \
} while(0)

Compiler barrier.

Guarantees that operation reordering does not occur at compile time for operations directly before and after the barrier.

Examples:: examples/performance-thread/common/lthread_tls.c.

Definition at line 118 of file rte_atomic.h.

◆ RTE_ATOMIC16_INIT

#define RTE_ATOMIC16_INIT ( val ) { (val) }

Static initializer for an atomic counter.

Definition at line 196 of file rte_atomic.h.

◆ RTE_ATOMIC32_INIT

#define RTE_ATOMIC32_INIT ( val ) { (val) }

Static initializer for an atomic counter.

Examples:: examples/kni/main.c.

Definition at line 479 of file rte_atomic.h.

◆ RTE_ATOMIC64_INIT

#define RTE_ATOMIC64_INIT ( val ) { (val) }

Static initializer for an atomic counter.

Definition at line 761 of file rte_atomic.h.

Function Documentation

◆ rte_mb()

static void rte_mb ( void )

inlinestatic

General memory barrier.

Guarantees that the LOAD and STORE operations generated before the barrier occur before the LOAD and STORE operations generated after.

◆ rte_wmb()

static void rte_wmb ( void )

inlinestatic

Write memory barrier.

Guarantees that the STORE operations generated before the barrier occur before the STORE operations generated after.

Examples:: examples/performance-thread/common/lthread.c, examples/performance-thread/common/lthread_sched.c, and examples/vhost_crypto/main.c.

◆ rte_rmb()

static void rte_rmb ( void )

inlinestatic

Read memory barrier.

Guarantees that the LOAD operations generated before the barrier occur before the LOAD operations generated after.

◆ rte_smp_mb()

static void rte_smp_mb ( void )

inlinestatic

General memory barrier between lcores

Guarantees that the LOAD and STORE operations that precede the rte_smp_mb() call are globally visible across the lcores before the LOAD and STORE operations that follows it.

◆ rte_smp_wmb()

static void rte_smp_wmb ( void )

inlinestatic

Write memory barrier between lcores

Guarantees that the STORE operations that precede the rte_smp_wmb() call are globally visible across the lcores before the STORE operations that follows it.

◆ rte_smp_rmb()

static void rte_smp_rmb ( void )

inlinestatic

Read memory barrier between lcores

Guarantees that the LOAD operations that precede the rte_smp_rmb() call are globally visible across the lcores before the LOAD operations that follows it.

◆ rte_io_mb()

static void rte_io_mb ( void )

inlinestatic

General memory barrier for I/O device

Guarantees that the LOAD and STORE operations that precede the rte_io_mb() call are visible to I/O device or CPU before the LOAD and STORE operations that follow it.

◆ rte_io_wmb()

static void rte_io_wmb ( void )

inlinestatic

Write memory barrier for I/O device

Guarantees that the STORE operations that precede the rte_io_wmb() call are visible to I/O device before the STORE operations that follow it.

◆ rte_io_rmb()

static void rte_io_rmb ( void )

inlinestatic

Read memory barrier for IO device

Guarantees that the LOAD operations on I/O device that precede the rte_io_rmb() call are visible to CPU before the LOAD operations that follow it.

◆ rte_atomic_thread_fence()

static void rte_atomic_thread_fence ( int memorder )

inlinestatic

Synchronization fence between threads based on the specified memory order.

Examples:: examples/vhost_blk/vhost_blk.c.

◆ rte_atomic16_cmpset()

static int rte_atomic16_cmpset	(	volatile uint16_t *	dst,
		uint16_t	exp,
		uint16_t	src
	)

inlinestatic

Atomic compare and set.

(atomic) equivalent to: if (*dst == exp) *dst = src (all 16-bit words)

Parameters

dst	The destination location into which the value will be written.
exp	The expected value.
src	The new value.

Returns: Non-zero on success; 0 on failure.

◆ rte_atomic16_exchange()

static uint16_t rte_atomic16_exchange	(	volatile uint16_t *	dst,
		uint16_t	val
	)

inlinestatic

Atomic exchange.

(atomic) equivalent to: ret = *dst *dst = val; return ret;

Parameters

dst	The destination location into which the value will be written.
val	The new value.

Returns: The original value at that location

◆ rte_atomic16_init()

static void rte_atomic16_init ( rte_atomic16_t * v )

inlinestatic

Initialize an atomic counter.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/bbdev_app/main.c, and examples/performance-thread/common/lthread_sched.c.

Definition at line 205 of file rte_atomic.h.

◆ rte_atomic16_read()

static int16_t rte_atomic16_read ( const rte_atomic16_t * v )

inlinestatic

Atomically read a 16-bit value from a counter.

Parameters

v	A pointer to the atomic counter.

Returns: The value of the counter.

Examples:: examples/bbdev_app/main.c, examples/l2fwd-jobstats/main.c, examples/performance-thread/common/lthread_sched.c, and examples/performance-thread/l3fwd-thread/main.c.

Definition at line 219 of file rte_atomic.h.

◆ rte_atomic16_set()

static void rte_atomic16_set	(	rte_atomic16_t *	v,
		int16_t	new_value
	)

inlinestatic

Atomically set a counter to a 16-bit value.

Parameters

v	A pointer to the atomic counter.
new_value	The new value for the counter.

Examples:: examples/bbdev_app/main.c, examples/l2fwd-jobstats/main.c, and examples/performance-thread/common/lthread_sched.c.

Definition at line 233 of file rte_atomic.h.

◆ rte_atomic16_add()

static void rte_atomic16_add	(	rte_atomic16_t *	v,
		int16_t	inc
	)

inlinestatic

Atomically add a 16-bit value to an atomic counter.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

Definition at line 247 of file rte_atomic.h.

◆ rte_atomic16_sub()

static void rte_atomic16_sub	(	rte_atomic16_t *	v,
		int16_t	dec
	)

inlinestatic

Atomically subtract a 16-bit value from an atomic counter.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

Definition at line 261 of file rte_atomic.h.

◆ rte_atomic16_inc()

static void rte_atomic16_inc ( rte_atomic16_t * v )

inlinestatic

Atomically increment a counter by one.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/performance-thread/common/lthread_sched.c, and examples/performance-thread/l3fwd-thread/main.c.

◆ rte_atomic16_dec()

static void rte_atomic16_dec ( rte_atomic16_t * v )

inlinestatic

Atomically decrement a counter by one.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/performance-thread/common/lthread_sched.c.

◆ rte_atomic16_add_return()

static int16_t rte_atomic16_add_return	(	rte_atomic16_t *	v,
		int16_t	inc
	)

inlinestatic

Atomically add a 16-bit value to a counter and return the result.

Atomically adds the 16-bits value (inc) to the atomic counter (v) and returns the value of v after addition.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

Returns: The value of v after the addition.

Definition at line 314 of file rte_atomic.h.

◆ rte_atomic16_sub_return()

static int16_t rte_atomic16_sub_return	(	rte_atomic16_t *	v,
		int16_t	dec
	)

inlinestatic

Atomically subtract a 16-bit value from a counter and return the result.

Atomically subtracts the 16-bit value (inc) from the atomic counter (v) and returns the value of v after the subtraction.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

Returns: The value of v after the subtraction.

Definition at line 334 of file rte_atomic.h.

◆ rte_atomic16_inc_and_test()

static int rte_atomic16_inc_and_test ( rte_atomic16_t * v )

inlinestatic

Atomically increment a 16-bit counter by one and test.

Atomically increments the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after the increment operation is 0; false otherwise.

◆ rte_atomic16_dec_and_test()

static int rte_atomic16_dec_and_test ( rte_atomic16_t * v )

inlinestatic

Atomically decrement a 16-bit counter by one and test.

Atomically decrements the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after the decrement operation is 0; false otherwise.

◆ rte_atomic16_test_and_set()

static int rte_atomic16_test_and_set ( rte_atomic16_t * v )

inlinestatic

Atomically test and set a 16-bit atomic counter.

If the counter value is already set, return 0 (failed). Otherwise, set the counter value to 1 and return 1 (success).

Parameters

v	A pointer to the atomic counter.

Returns: 0 if failed; else 1, success.

◆ rte_atomic16_clear()

static void rte_atomic16_clear ( rte_atomic16_t * v )

inlinestatic

Atomically set a 16-bit counter to 0.

Parameters

v	A pointer to the atomic counter.

Definition at line 405 of file rte_atomic.h.

◆ rte_atomic32_cmpset()

static int rte_atomic32_cmpset	(	volatile uint32_t *	dst,
		uint32_t	exp,
		uint32_t	src
	)

inlinestatic

Atomic compare and set.

(atomic) equivalent to: if (*dst == exp) *dst = src (all 32-bit words)

Parameters

dst	The destination location into which the value will be written.
exp	The expected value.
src	The new value.

Returns: Non-zero on success; 0 on failure.

Examples:: examples/vm_power_manager/channel_monitor.c.

◆ rte_atomic32_exchange()

static uint32_t rte_atomic32_exchange	(	volatile uint32_t *	dst,
		uint32_t	val
	)

inlinestatic

Atomic exchange.

(atomic) equivalent to: ret = *dst *dst = val; return ret;

Parameters

dst	The destination location into which the value will be written.
val	The new value.

Returns: The original value at that location

◆ rte_atomic32_init()

static void rte_atomic32_init ( rte_atomic32_t * v )

inlinestatic

Initialize an atomic counter.

Parameters

v	A pointer to the atomic counter.

Definition at line 488 of file rte_atomic.h.

◆ rte_atomic32_read()

static int32_t rte_atomic32_read ( const rte_atomic32_t * v )

inlinestatic

Atomically read a 32-bit value from a counter.

Parameters

v	A pointer to the atomic counter.

Returns: The value of the counter.

Examples:: examples/kni/main.c.

Definition at line 502 of file rte_atomic.h.

◆ rte_atomic32_set()

static void rte_atomic32_set	(	rte_atomic32_t *	v,
		int32_t	new_value
	)

inlinestatic

Atomically set a counter to a 32-bit value.

Parameters

v	A pointer to the atomic counter.
new_value	The new value for the counter.

Definition at line 516 of file rte_atomic.h.

◆ rte_atomic32_add()

static void rte_atomic32_add	(	rte_atomic32_t *	v,
		int32_t	inc
	)

inlinestatic

Atomically add a 32-bit value to an atomic counter.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

Definition at line 530 of file rte_atomic.h.

◆ rte_atomic32_sub()

static void rte_atomic32_sub	(	rte_atomic32_t *	v,
		int32_t	dec
	)

inlinestatic

Atomically subtract a 32-bit value from an atomic counter.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

Definition at line 544 of file rte_atomic.h.

◆ rte_atomic32_inc()

static void rte_atomic32_inc ( rte_atomic32_t * v )

inlinestatic

Atomically increment a counter by one.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/kni/main.c.

◆ rte_atomic32_dec()

static void rte_atomic32_dec ( rte_atomic32_t * v )

inlinestatic

Atomically decrement a counter by one.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/kni/main.c.

◆ rte_atomic32_add_return()

static int32_t rte_atomic32_add_return	(	rte_atomic32_t *	v,
		int32_t	inc
	)

inlinestatic

Atomically add a 32-bit value to a counter and return the result.

Atomically adds the 32-bits value (inc) to the atomic counter (v) and returns the value of v after addition.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

Returns: The value of v after the addition.

Definition at line 597 of file rte_atomic.h.

◆ rte_atomic32_sub_return()

static int32_t rte_atomic32_sub_return	(	rte_atomic32_t *	v,
		int32_t	dec
	)

inlinestatic

Atomically subtract a 32-bit value from a counter and return the result.

Atomically subtracts the 32-bit value (inc) from the atomic counter (v) and returns the value of v after the subtraction.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

Returns: The value of v after the subtraction.

Definition at line 617 of file rte_atomic.h.

◆ rte_atomic32_inc_and_test()

static int rte_atomic32_inc_and_test ( rte_atomic32_t * v )

inlinestatic

Atomically increment a 32-bit counter by one and test.

Atomically increments the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after the increment operation is 0; false otherwise.

◆ rte_atomic32_dec_and_test()

static int rte_atomic32_dec_and_test ( rte_atomic32_t * v )

inlinestatic

Atomically decrement a 32-bit counter by one and test.

Atomically decrements the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after the decrement operation is 0; false otherwise.

◆ rte_atomic32_test_and_set()

static int rte_atomic32_test_and_set ( rte_atomic32_t * v )

inlinestatic

Atomically test and set a 32-bit atomic counter.

If the counter value is already set, return 0 (failed). Otherwise, set the counter value to 1 and return 1 (success).

Parameters

v	A pointer to the atomic counter.

Returns: 0 if failed; else 1, success.

Examples:: examples/multi_process/client_server_mp/mp_server/main.c, and examples/server_node_efd/server/main.c.

◆ rte_atomic32_clear()

static void rte_atomic32_clear ( rte_atomic32_t * v )

inlinestatic

Atomically set a 32-bit counter to 0.

Parameters

v	A pointer to the atomic counter.

Definition at line 688 of file rte_atomic.h.

◆ rte_atomic64_cmpset()

static int rte_atomic64_cmpset	(	volatile uint64_t *	dst,
		uint64_t	exp,
		uint64_t	src
	)

inlinestatic

An atomic compare and set function used by the mutex functions. (atomic) equivalent to: if (*dst == exp) *dst = src (all 64-bit words)

Parameters

dst	The destination into which the value will be written.
exp	The expected value.
src	The new value.

Returns: Non-zero on success; 0 on failure.

Examples:: examples/performance-thread/common/lthread.c, examples/performance-thread/common/lthread_mutex.c, and examples/performance-thread/common/lthread_tls.c.

◆ rte_atomic64_exchange()

static uint64_t rte_atomic64_exchange	(	volatile uint64_t *	dst,
		uint64_t	val
	)

inlinestatic

Atomic exchange.

(atomic) equivalent to: ret = *dst *dst = val; return ret;

Parameters

dst	The destination location into which the value will be written.
val	The new value.

Returns: The original value at that location

◆ rte_atomic64_init()

static void rte_atomic64_init ( rte_atomic64_t * v )

inlinestatic

Initialize the atomic counter.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/performance-thread/common/lthread_mutex.c.

◆ rte_atomic64_read()

static int64_t rte_atomic64_read ( rte_atomic64_t * v )

inlinestatic

Atomically read a 64-bit counter.

Parameters

v	A pointer to the atomic counter.

Returns: The value of the counter.

Examples:: examples/performance-thread/common/lthread_mutex.c.

◆ rte_atomic64_set()

static void rte_atomic64_set	(	rte_atomic64_t *	v,
		int64_t	new_value
	)

inlinestatic

Atomically set a 64-bit counter.

Parameters

v	A pointer to the atomic counter.
new_value	The new value of the counter.

◆ rte_atomic64_add()

static void rte_atomic64_add	(	rte_atomic64_t *	v,
		int64_t	inc
	)

inlinestatic

Atomically add a 64-bit value to a counter.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

◆ rte_atomic64_sub()

static void rte_atomic64_sub	(	rte_atomic64_t *	v,
		int64_t	dec
	)

inlinestatic

Atomically subtract a 64-bit value from a counter.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

◆ rte_atomic64_inc()

static void rte_atomic64_inc ( rte_atomic64_t * v )

inlinestatic

Atomically increment a 64-bit counter by one and test.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/performance-thread/common/lthread_mutex.c.

◆ rte_atomic64_dec()

static void rte_atomic64_dec ( rte_atomic64_t * v )

inlinestatic

Atomically decrement a 64-bit counter by one and test.

Parameters

v	A pointer to the atomic counter.

Examples:: examples/performance-thread/common/lthread_mutex.c.

◆ rte_atomic64_add_return()

static int64_t rte_atomic64_add_return	(	rte_atomic64_t *	v,
		int64_t	inc
	)

inlinestatic

Add a 64-bit value to an atomic counter and return the result.

Atomically adds the 64-bit value (inc) to the atomic counter (v) and returns the value of v after the addition.

Parameters

v	A pointer to the atomic counter.
inc	The value to be added to the counter.

Returns: The value of v after the addition.

◆ rte_atomic64_sub_return()

static int64_t rte_atomic64_sub_return	(	rte_atomic64_t *	v,
		int64_t	dec
	)

inlinestatic

Subtract a 64-bit value from an atomic counter and return the result.

Atomically subtracts the 64-bit value (dec) from the atomic counter (v) and returns the value of v after the subtraction.

Parameters

v	A pointer to the atomic counter.
dec	The value to be subtracted from the counter.

Returns: The value of v after the subtraction.

◆ rte_atomic64_inc_and_test()

static int rte_atomic64_inc_and_test ( rte_atomic64_t * v )

inlinestatic

Atomically increment a 64-bit counter by one and test.

Atomically increments the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after the addition is 0; false otherwise.

◆ rte_atomic64_dec_and_test()

static int rte_atomic64_dec_and_test ( rte_atomic64_t * v )

inlinestatic

Atomically decrement a 64-bit counter by one and test.

Atomically decrements the atomic counter (v) by one and returns true if the result is 0, or false in all other cases.

Parameters

v	A pointer to the atomic counter.

Returns: True if the result after subtraction is 0; false otherwise.

◆ rte_atomic64_test_and_set()

static int rte_atomic64_test_and_set ( rte_atomic64_t * v )

inlinestatic

Atomically test and set a 64-bit atomic counter.

If the counter value is already set, return 0 (failed). Otherwise, set the counter value to 1 and return 1 (success).

Parameters

v	A pointer to the atomic counter.

Returns: 0 if failed; else 1, success.

◆ rte_atomic64_clear()

static void rte_atomic64_clear ( rte_atomic64_t * v )

inlinestatic

Atomically set a 64-bit counter to 0.

Parameters

v	A pointer to the atomic counter.

◆ rte_atomic128_cmp_exchange()

static __rte_experimental int rte_atomic128_cmp_exchange	(	rte_int128_t *	dst,
		rte_int128_t *	exp,
		const rte_int128_t *	src,
		unsigned int	weak,
		int	success,
		int	failure
	)

inlinestatic

An atomic compare and set function used by the mutex functions. (Atomically) Equivalent to:

if (*dst == *exp)
  *dst = *src
else
  *exp = *dst

Note: This function is currently available for the x86-64 and aarch64 platforms.; The success and failure arguments must be one of the __ATOMIC_* values defined in the C++11 standard. For details on their behavior, refer to the standard.

Parameters

dst	The destination into which the value will be written.
exp	Pointer to the expected value. If the operation fails, this memory is updated with the actual value.
src	Pointer to the new value.
weak	A value of true allows the comparison to spuriously fail and allows the 'exp' update to occur non-atomically (i.e. a torn read may occur). Implementations may ignore this argument and only implement the strong variant.
success	If successful, the operation's memory behavior conforms to this (or a stronger) model.
failure	If unsuccessful, the operation's memory behavior conforms to this (or a stronger) model. This argument cannot be __ATOMIC_RELEASE, __ATOMIC_ACQ_REL, or a stronger model than success.

Returns: Non-zero on success; 0 on failure.

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ rte_compiler_barrier

◆ RTE_ATOMIC16_INIT

◆ RTE_ATOMIC32_INIT

◆ RTE_ATOMIC64_INIT

Function Documentation

◆ rte_mb()

◆ rte_wmb()

◆ rte_rmb()

◆ rte_smp_mb()

◆ rte_smp_wmb()

◆ rte_smp_rmb()

◆ rte_io_mb()

◆ rte_io_wmb()

◆ rte_io_rmb()

◆ rte_atomic_thread_fence()

◆ rte_atomic16_cmpset()

◆ rte_atomic16_exchange()

◆ rte_atomic16_init()

◆ rte_atomic16_read()

◆ rte_atomic16_set()

◆ rte_atomic16_add()

◆ rte_atomic16_sub()

◆ rte_atomic16_inc()

◆ rte_atomic16_dec()

◆ rte_atomic16_add_return()

◆ rte_atomic16_sub_return()

◆ rte_atomic16_inc_and_test()

◆ rte_atomic16_dec_and_test()

◆ rte_atomic16_test_and_set()

◆ rte_atomic16_clear()

◆ rte_atomic32_cmpset()

◆ rte_atomic32_exchange()

◆ rte_atomic32_init()

◆ rte_atomic32_read()

◆ rte_atomic32_set()

◆ rte_atomic32_add()

◆ rte_atomic32_sub()

◆ rte_atomic32_inc()

◆ rte_atomic32_dec()

◆ rte_atomic32_add_return()

◆ rte_atomic32_sub_return()

◆ rte_atomic32_inc_and_test()

◆ rte_atomic32_dec_and_test()

◆ rte_atomic32_test_and_set()

◆ rte_atomic32_clear()

◆ rte_atomic64_cmpset()

◆ rte_atomic64_exchange()

◆ rte_atomic64_init()

◆ rte_atomic64_read()

◆ rte_atomic64_set()

◆ rte_atomic64_add()

◆ rte_atomic64_sub()

◆ rte_atomic64_inc()

◆ rte_atomic64_dec()

◆ rte_atomic64_add_return()

◆ rte_atomic64_sub_return()

◆ rte_atomic64_inc_and_test()

◆ rte_atomic64_dec_and_test()

◆ rte_atomic64_test_and_set()

◆ rte_atomic64_clear()

◆ rte_atomic128_cmp_exchange()