rte_prefetch.h(3)

✨ rte_prefetch.h ✨

okay bestie, welcome to the rte_prefetch.h manual page, third section of the manual, and it's giving speed. this is the DPDK header that teaches your CPU to grab data before it's even asked for it. main character energy fr fr 💅

---

🎀 SYNOPSIS 🎀

#include <rte_compat.h>

🌸 Functions 🌸

static void rte_prefetch0 (const volatile void *p)
static void rte_prefetch1 (const volatile void *p)
static void rte_prefetch2 (const volatile void *p)
static void rte_prefetch_non_temporal (const volatile void *p)
static __rte_experimental void rte_prefetch0_write (const void *p)
static __rte_experimental void rte_prefetch1_write (const void *p)
static __rte_experimental void rte_prefetch2_write (const void *p)
static __rte_experimental void rte_cldemote (const volatile void *p)

---

💖 Detailed Description 💖

Prefetch operations. that's the whole vibe. ✨

ngl this file defines an API for prefetch macros / inline-functions, and bestie, they are architecture-dependent. what does prefetching even mean? it's when a processor requests an instruction or data from memory to cache before it is actually needed, potentially speeding up the execution of the program. it's the CPU equivalent of ordering your boba before you even get to the shop. iconic. 🧋

Definition in file rte_prefetch.h.

---

👑 Function Documentation 👑

🦋 void rte_prefetch0 (const volatile void * p) [inline], [static] 🦋

Prefetch a cache line into all cache levels. every single one. no crumbs left.

Parameters

• p — Address to prefetch

---

🦋 void rte_prefetch1 (const volatile void * p) [inline], [static] 🦋

Prefetch a cache line into all cache levels except the 0th cache level. like, we're skipping one, and it's the first one, and that's a choice but it's the documented one. 💅

Parameters

• p — Address to prefetch

---

🦋 void rte_prefetch2 (const volatile void * p) [inline], [static] 🦋

Prefetch a cache line into all cache levels except the 0th and 1th cache levels. yes bestie, the original says "1th" and I am not correcting it, that's load-bearing lore. 😭

Parameters

• p — Address to prefetch

---

🦋 void rte_prefetch_non_temporal (const volatile void * p) [inline], [static] 🦋

Prefetch a cache line into all cache levels, but make it non-temporal/transient ✨

so here's the tea: the non-temporal prefetch is intended as a prefetch hint that the processor will use the prefetched data only once or for a short period — unlike the rte_prefetch0() function, which implies that the prefetched data is going to be used repeatedly. one-time hangout vs. situationship. you get it.

Parameters

• p — Address to prefetch

---

🔥 __rte_experimental void rte_prefetch0_write (const void * p) [inline], [static] 🔥

Warning 🚨 EXPERIMENTAL: this API may change, or be removed, without prior notice

Prefetch a cache line into all cache levels, with intention to write. this prefetch variant hints to the CPU that the program is expecting to write to the cache line being prefetched. telling the CPU your plans ahead of time? communication, we love to see it. 🫶

Parameters

• p — Address to prefetch

Definition at line 72 of file rte_prefetch.h.

---

🔥 __rte_experimental void rte_prefetch1_write (const void * p) [inline], [static] 🔥

Warning 🚨 EXPERIMENTAL: this API may change, or be removed, without prior notice

Prefetch a cache line into all cache levels, except the 0th, with intention to write. this prefetch variant hints to the CPU that the program is expecting to write to the cache line being prefetched. same energy, one less cache level. ⭐

Parameters

• p — Address to prefetch

Definition at line 97 of file rte_prefetch.h.

---

🔥 __rte_experimental void rte_prefetch2_write (const void * p) [inline], [static] 🔥

Warning 🚨 EXPERIMENTAL: this API may change, or be removed, without prior notice

Prefetch a cache line into all cache levels, except the 0th and 1st, with intention to write. this prefetch variant hints to the CPU that the program is expecting to write to the cache line being prefetched. (yes, "1st" this time, no "1th", the source said "1st" here — we report, we don't editorialize 🙈)

Parameters

• p — Address to prefetch

Definition at line 122 of file rte_prefetch.h.

---

💜 __rte_experimental void rte_cldemote (const volatile void * p) [inline], [static] 💜

Warning 🚨 EXPERIMENTAL: this API may change, or be removed, without prior notice

Demote a cache line to a more distant level of cache from the processor.

CLDEMOTE hints to hardware to move (demote) a cache line from the closest to the processor to a level more distant from the processor. and before you come for me: it is a hint and not guaranteed. rte_cldemote is intended to move the cache line to the more remote cache, where it expects sharing to be efficient and to indicate that a line may be accessed by a different core in the future. it's the "you're not my problem anymore, but like, in a collaborative way" of cache lines. 🦋

Parameters

• p — Address to demote

---

🌈 Author 🌈

Generated automatically by Doxygen for DPDK from the source code. not a human, just a very diligent little script doing its thing. 🤖💖

---

and that's the whole page, bestie — stay hydrated, stay cache-hot, and may your prefetches always land. bye babes 💅✨

DPDK, Version 25.11.3 — that's the source and version of this rte_prefetch.h(3) page right there. mwah. 🎀