sunrpc_cache...sts_snapshot(9)

💅 sunrpc_cache_requests_snapshot(9) 💅

okay bestie, welcome to the Kernel API Manual, section 9 — this one's all about grabbing a lil snapshot of the upcall requests that are still pending ✨

---

🌸 NAME 🌸

sunrpc_cache_requests_snapshot — literally just snapshot pending upcall requests. that's the whole vibe 🫶

---

🎀 SYNOPSIS 🎀

int sunrpc_cache_requests_snapshot (struct cache_detail *cd , struct cache_head **items , u64 *seqnos , int max , u64 min_seqno );

---

💖 ARGUMENTS 💖

• cd — the cache_detail you're querying. this is the main character of the operation 👑
• items — an array you (yes, you, the caller) allocated, and it gets filled up with cache_head pointers 🧚
• seqnos — another caller-allocated array, this one gets the sequence numbers dropped into it 🎀
• max — the size of those arrays. don't overfill, bestie, that's the whole point of this number 💀
• min_seqno — only entries with seqno > min_seqno get included. pass 0 and you get everything 🌈

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓 only entries that have CACHE_PENDING set make it into the snapshot. no pending, no entry, periodt.

for each one it takes a reference on the cache_head via cache_get — so like, it's holding onto them for you 💅 which means you gotta call cache_put on every single returned item when you're done with it. every one. don't leave them hanging 😭

fr fr, remember the cache_put. that's not optional, that's the rules 🫶

it returns the number of entries filled. that's it, that's the count 🌟

---

⭐ SEE ALSO ⭐

• the kernel file ./net/sunrpc/cache.c — go read it, iykyk 👀
• sunrpc_cache_requests_count(9)
• sunrpc_cache_notify(9)

---

and that's the page, bestie!! 🎉 brought to you straight out of ./net/sunrpc, dated October 2026 — same iconic header, same iconic footer, just with way more sparkle ✨💜 slay, go snapshot some requests 🔥