plist_first_entry(9)

plist_first_entry(9) — Kernel API Manual 💖

okay so welcome to the Kernel API Manual page for plist_first_entry ✨ this one is short and sweet, and honestly it’s giving “little helper, big main character energy.”

💖 NAME 💖

plist_first_entry — get the struct for the first entry.

That’s the whole assignment, bestie: you want the struct for the first entry, and this API is how you get it. No cap. 🎀

✨ SYNOPSIS ✨

Here’s the exact call shape, character for character:

plist_first_entry (head , type , member );

🎀 ARGUMENTS 🎀

Three little pieces of info, three little slays:

• head — the struct plist_head pointer.
• type — the type of the struct this is embedded in.
• member — the name of the list_head within the struct.

🦋 SEE ALSO 🦋

The SEE ALSO section is giving very much “community support group”: it points at the Kernel file ./include/linux/plist.h and this full lineup of references — all of them, no skips:

• PLIST_HEAD_INIT(9)
• PLIST_HEAD(9)
• PLIST_NODE_INIT(9)
• plist_head_init(9)
• plist_node_init(9)
• plist_for_each(9)
• plist_for_each_continue(9)
• plist_for_each_safe(9)
• plist_for_each_entry(9)
• plist_for_each_entry_continue(9)
• plist_for_each_entry_safe(9)
• plist_head_empty(9)
• plist_node_empty(9)
• plist_last_entry(9)
• plist_next(9)
• plist_prev(9)
• plist_first(9)
• plist_last(9)

source/version: ./include/linux · date: October 2026 · page: plist_first_entry(9) — mwah 💋🫶