DOKK / manpages / debian 13 / dpdk-doc / RTE_PFLOCK_INITIALIZER.3.en
rte_pflock.h(3) Library Functions Manual rte_pflock.h(3)

rte_pflock.h

#include <rte_common.h>
#include <rte_pause.h>
#include <rte_stdatomic.h>


struct rte_pflock


#define RTE_PFLOCK_INITIALIZER { }


static void rte_pflock_init (struct rte_pflock *pf)
static void rte_pflock_read_lock (rte_pflock_t *pf)
static void rte_pflock_read_unlock (rte_pflock_t *pf)
static void rte_pflock_write_lock (rte_pflock_t *pf)
static void rte_pflock_write_unlock (rte_pflock_t *pf)

Phase-fair locks

This file defines an API for phase-fair reader writer locks, which is a variant of typical reader-writer locks that prevent starvation. In this type of lock, readers and writers alternate. This significantly reduces the worst-case blocking for readers and writers.

This is an implementation derived from FreeBSD based on the work described in: Brandenburg, B. and Anderson, J. 2010. Spin-Based Reader-Writer Synchronization for Multiprocessor Real-Time Systems

All locks must be initialised before use, and only initialised once.

Definition in file rte_pflock.h.

A static pflock initializer.

Definition at line 79 of file rte_pflock.h.

Initialize the pflock to an unlocked state.

Parameters

pf A pointer to the pflock.

Definition at line 88 of file rte_pflock.h.

Take a pflock for read.

Parameters

pf A pointer to a pflock structure.

Definition at line 103 of file rte_pflock.h.

Release a pflock locked for reading.

Parameters

pf A pointer to the pflock structure.

Definition at line 127 of file rte_pflock.h.

Take the pflock for write.

Parameters

pf A pointer to the pflock structure.

Definition at line 139 of file rte_pflock.h.

Release a pflock held for writing.

Parameters

pf A pointer to a pflock structure.

Definition at line 173 of file rte_pflock.h.

Generated automatically by Doxygen for DPDK from the source code.

Version 24.11.3 DPDK