hlist_bl_for_each_entry(9)

💅 hlist_bl_for_each_entry (Kernel API Manual, bestie)

okay so this is a page from the Kernel API Manual and honestly? it's a little one but it's iconic. sit down, grab a strawberry 🍓, we're learning to walk a list.

✨ NAME ✨

hlist_bl_for_each_entry — literally iterate over a list of a given type. that's the whole vibe. main character energy for your linked list 🦋

🌸 SYNOPSIS 🌸

hlist_bl_for_each_entry (tpos , pos , head , member );

so you've got the macro, you've got four things going in, and it's gonna loop for you. slay.

🎀 ARGUMENTS 🎀

four besties walk into a macro:

• tpos — the type * you're using as your loop cursor. that's your main character pointer, the one you actually get to touch inside the loop. 💖
• pos — the struct hlist_node you're using as a loop cursor. yes it's also a cursor, no it's not the same one, they're different cursors, it's giving two-cursor household 🫶
• head — the head of your list. like, the very start of it. the front door. the entrance. 👑
• member — the name of the hlist_node inside the struct. iykyk — it's the field name that lets the macro figure out where the node lives inside your type. 🌈

ngl, tpos and pos both being cursors is a lot, but that's the design and we respect it 💅

🌟 SEE ALSO 🌟

• Kernel file ./include/linux/list_bl.h — go read it, it's right there 🌸
• hlist_bl_for_each_entry_safe(9) — the safe one. the responsible sibling. check it out fr fr 🔥

that's the page!! no cap, that's genuinely all of it, every argument accounted for, nothing skipped, we ate and left no crumbs 🎀✨

made with love from ./include/linux, dated October 2026, and yeah the page is literally called hlist_bl_for_each_entry(9) — bye bestie, go walk some lists 💜🧚