plist_first(9)

💅 plist_first — the Kernel API Manual, but make it cute

Okay bestie, welcome to the plist_first(9) page from the Kernel API Manual, aka the glow-up era of linked lists ✨

🌸 NAME 🌸

plist_first — grab the first node, and like… that also means the one with the highest priority, no cap 👑

🎀 SYNOPSIS 🎀

struct plist_node * plist_first (const struct plist_head *head );

🦋 DESCRIPTION 🦋

So real talk: this function hands you back the first node in the plist, which is also the highest-priority one 💖

Heads up bestie! This assumes the plist is _not_ empty. That's the whole vibe check here — it does not check for you. 🙈

✨ ARGUMENTS ✨

• head — the struct plist_head pointer, like, the head of the whole thing 🫶

💜 SEE ALSO 💜

Kernel file ./include/linux/plist.h — plus the whole friend group:

• 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_first_entry(9)
• plist_last_entry(9)
• plist_next(9)
• plist_prev(9)
• plist_last(9)

And that's the tea ☕ — that was plist_first(9), served fresh from ./include/linux, dated October 2026. Stan the kernel, mwah 💋🎀