DPDK  19.08.0-rc0
Data Structures | Macros | Functions
rte_rwlock.h File Reference
#include <rte_common.h>
#include <rte_atomic.h>
#include <rte_pause.h>

Go to the source code of this file.

Data Structures

struct  rte_rwlock_t
 

Macros

#define RTE_RWLOCK_INITIALIZER   { 0 }
 

Functions

static void rte_rwlock_init (rte_rwlock_t *rwl)
 
static void rte_rwlock_read_lock (rte_rwlock_t *rwl)
 
static __rte_experimental int rte_rwlock_read_trylock (rte_rwlock_t *rwl)
 
static void rte_rwlock_read_unlock (rte_rwlock_t *rwl)
 
static __rte_experimental int rte_rwlock_write_trylock (rte_rwlock_t *rwl)
 
static void rte_rwlock_write_lock (rte_rwlock_t *rwl)
 
static void rte_rwlock_write_unlock (rte_rwlock_t *rwl)
 
static void rte_rwlock_read_lock_tm (rte_rwlock_t *rwl)
 
static void rte_rwlock_read_unlock_tm (rte_rwlock_t *rwl)
 
static void rte_rwlock_write_lock_tm (rte_rwlock_t *rwl)
 
static void rte_rwlock_write_unlock_tm (rte_rwlock_t *rwl)
 

Detailed Description

RTE Read-Write Locks

This file defines an API for read-write locks. The lock is used to protect data that allows multiple readers in parallel, but only one writer. All readers are blocked until the writer is finished writing.

Definition in file rte_rwlock.h.

Macro Definition Documentation

◆ RTE_RWLOCK_INITIALIZER

#define RTE_RWLOCK_INITIALIZER   { 0 }

A static rwlock initializer.

Definition at line 40 of file rte_rwlock.h.

Function Documentation

◆ rte_rwlock_init()

static void rte_rwlock_init ( rte_rwlock_t rwl)
inlinestatic

Initialize the rwlock to an unlocked state.

Parameters
rwlA pointer to the rwlock structure.

Definition at line 49 of file rte_rwlock.h.

◆ rte_rwlock_read_lock()

static void rte_rwlock_read_lock ( rte_rwlock_t rwl)
inlinestatic

Take a read lock. Loop until the lock is held.

Parameters
rwlA pointer to a rwlock structure.

Definition at line 61 of file rte_rwlock.h.

◆ rte_rwlock_read_trylock()

static __rte_experimental int rte_rwlock_read_trylock ( rte_rwlock_t rwl)
inlinestatic
Warning
EXPERIMENTAL: this API may change without prior notice.

try to take a read lock.

Parameters
rwlA pointer to a rwlock structure.
Returns
  • zero if the lock is successfully taken
  • -EBUSY if lock could not be acquired for reading because a writer holds the lock

Definition at line 92 of file rte_rwlock.h.

◆ rte_rwlock_read_unlock()

static void rte_rwlock_read_unlock ( rte_rwlock_t rwl)
inlinestatic

Release a read lock.

Parameters
rwlA pointer to the rwlock structure.

Definition at line 116 of file rte_rwlock.h.

◆ rte_rwlock_write_trylock()

static __rte_experimental int rte_rwlock_write_trylock ( rte_rwlock_t rwl)
inlinestatic
Warning
EXPERIMENTAL: this API may change without prior notice.

try to take a write lock.

Parameters
rwlA pointer to a rwlock structure.
Returns
  • zero if the lock is successfully taken
  • -EBUSY if lock could not be acquired for writing because it was already locked for reading or writing

Definition at line 135 of file rte_rwlock.h.

◆ rte_rwlock_write_lock()

static void rte_rwlock_write_lock ( rte_rwlock_t rwl)
inlinestatic

Take a write lock. Loop until the lock is held.

Parameters
rwlA pointer to a rwlock structure.

Definition at line 154 of file rte_rwlock.h.

◆ rte_rwlock_write_unlock()

static void rte_rwlock_write_unlock ( rte_rwlock_t rwl)
inlinestatic

Release a write lock.

Parameters
rwlA pointer to a rwlock structure.

Definition at line 178 of file rte_rwlock.h.

◆ rte_rwlock_read_lock_tm()

static void rte_rwlock_read_lock_tm ( rte_rwlock_t rwl)
inlinestatic

Try to execute critical section in a hardware memory transaction, if it fails or not available take a read lock

NOTE: An attempt to perform a HW I/O operation inside a hardware memory transaction always aborts the transaction since the CPU is not able to roll-back should the transaction fail. Therefore, hardware transactional locks are not advised to be used around rte_eth_rx_burst() and rte_eth_tx_burst() calls.

Parameters
rwlA pointer to a rwlock structure.

◆ rte_rwlock_read_unlock_tm()

static void rte_rwlock_read_unlock_tm ( rte_rwlock_t rwl)
inlinestatic

Commit hardware memory transaction or release the read lock if the lock is used as a fall-back

Parameters
rwlA pointer to the rwlock structure.

◆ rte_rwlock_write_lock_tm()

static void rte_rwlock_write_lock_tm ( rte_rwlock_t rwl)
inlinestatic

Try to execute critical section in a hardware memory transaction, if it fails or not available take a write lock

NOTE: An attempt to perform a HW I/O operation inside a hardware memory transaction always aborts the transaction since the CPU is not able to roll-back should the transaction fail. Therefore, hardware transactional locks are not advised to be used around rte_eth_rx_burst() and rte_eth_tx_burst() calls.

Parameters
rwlA pointer to a rwlock structure.

◆ rte_rwlock_write_unlock_tm()

static void rte_rwlock_write_unlock_tm ( rte_rwlock_t rwl)
inlinestatic

Commit hardware memory transaction or release the write lock if the lock is used as a fall-back

Parameters
rwlA pointer to a rwlock structure.