hlist_add_head(9)

💖 hlist_add_head(9) 💖

okay so this is a page from the Kernel API Manual, and bestie, it's a short one but it's literally iconic. sit down, grab a boba, let's go ✨

---

🌸 NAME 🌸

hlist_add_head — add a new entry at the beginning of the hlist 🎀

like, the very beginning. front of the line. main character spot. no cap 💅

---

✨ SYNOPSIS ✨

void hlist_add_head (struct hlist_node *n , struct hlist_head *h );

that's it. two pointers, zero drama, returns nothing (void bestie, it's giving "I do this for the plot, not for the return value") 🦋

---

🫶 ARGUMENTS 🫶

• n — the new entry you're adding. your little guy. your blorbo. the fresh node going in 💖
• h — the hlist head you're adding it after. the vibe anchor. the boss of the list 👑

---

🔥 DESCRIPTION 🔥

Insert a new entry after the specified head. periodt. that's the whole thing.

and the best part? this is good for implementing stacks. the way that a stack is literally just "newest thing on top" and this function is literally "newest thing at the front" — the synergy is unmatched, I'm obsessed 😭🔥 LIFO girlies stay winning fr fr.

ngl it's a tiny function but it's carrying entire data structures on its back. respect the hustle 💅

---

💜 SEE ALSO 💜

Kernel file ./scripts/include/list.h — that's where the magic lives, go read it, iykyk 📖✨

and then the whole friend group:

• 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_is_head(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_for_each_entry(9)
• hlist_for_each_entry_safe(9)

---

anyway that's the page 🎀 this came out of ./scripts/include, dated October 2026, and honestly? slay. go add something to the head of a list, you've earned it 💖✨🦋