list_is_head(9)

💅 list_is_head(9) 💅

ok so we're in the Kernel API Manual bestie, and today's main character is list_is_head — a tiny little icon that answers exactly one question: is @list literally the head of @head's list? that's it. that's the whole vibe. 🎀

---

✨ NAME ✨

list_is_head — tests whether @list is the list @head 🫶

---

🌸 SYNOPSIS 🌸

int list_is_head (const struct list_head *list , const struct list_head
*head );

like yes she's just one function call, no cap. 💅

---

🦋 ARGUMENTS 🦋

• list — the entry to test 👀 like the one you're side-eyeing
• head — the head of the list 👑

so you hand her the entry and the head and she's like "hmm, is this THE head?" and gets back at you with an int. periodt. 🔥

---

🌈 SEE ALSO 🌈

all her besties live in the Kernel file ./scripts/include/list.h — go say hi:

• container_of(9)
• INIT_LIST_HEAD(9)
• list_add(9)
• list_add_tail(9)
• list_del(9)
• list_replace(9)
• list_replace_init(9)
• list_move(9)
• list_move_tail(9)
• list_is_first(9)
• list_is_last(9)
• list_empty(9)
• list_entry(9)
• list_first_entry(9)
• list_last_entry(9)
• list_next_entry(9)
• list_prev_entry(9)
• list_entry_is_head(9)
• list_for_each_entry(9)
• list_for_each_entry_reverse(9)
• list_for_each_entry_safe(9)
• hlist_unhashed(9)
• hlist_del(9)
• hlist_del_init(9)
• hlist_add_head(9)
• hlist_for_each_entry(9)
• hlist_for_each_entry_safe(9)

---

and that's the whole page, bestie — short and slay, just how we like her. 💖

ok final lil sign-off because i'm obsessed with sourcing my info: this one comes from ./scripts/include and it's dated October 2026. manifesting that energy for u. 🧚‍♀️✨🌸