list_for_eac...continue_rcu(9)

📦 version 7.3.1, in nixpkgs unstable

💫 list_for_eac...continue_rcu(9) — the kernel API manual, bestie edition

Okay so picture this: it's a kernel API manual page, the title got abbreviated by the terminal like it always does, and the vibe is very RCU. Welcome to list_for_eac...continue_rcu(9) 🦋 no cap, that truncated name is literally how it shows up, we don't fix it, we respect it.

✨ SYNOPSIS ✨

list_for_each_entry_continue_rcu (pos , head , member );

Three args, one macro, endless iteration energy 💅

🎀 ARGUMENTS 🎀

  • pos — the type * you're using as your loop cursor. She's the main character, she walks the list.
  • head — the head of your list. The starting point, the home base, the anchor 🫶
  • member — the name of the list_head inside the struct. ykyk, the little connector field that makes the whole thing work.

🌸 DESCRIPTION 🌸

So here's the tea: this iterates over a list of the given type, continuing after the current position — and that current position must have been in the list at the time the RCU read lock was taken. Important!! ⚠️

Which typically means you need one of these two situations going on:

  1. You got the node from a previous walk of the list, in the same RCU read-side critical section — same lock, same section, no cheating 🧚
  2. Or you held some sort of non-RCU reference (like a reference count, bestie) to keep the node alive and in the list.
Yeah, both of those conditions matter — alive and still in the list. Not just alive. Not just linked. Both. 💀

And the comparison you've all been waiting for: this iterator is similar to list_for_each_entry_from_rcu, except this one starts after the given position, and that one starts at the given position. One is "next bestie," one is "current bestie." Don't mix them up, I'm begging 🙈

👑 SEE ALSO 👑

Kernel file ./include/linux/rculist.h — and like, the entire extended RCU family reunion. Everyone showed up:

That's the whole group chat, fr fr 📋✨

Anyway bestie, that's the page 🌈 — source path ./include/linux, dated October 2026, and she's filed under list_for_eac...continue_rcu(9) in the Kernel API Manual. Go forth and iterate responsibly, mwah 💖

📦 where this page comes from