hlists_swap_heads_rcu(9)

🌸 NAME 🌸

hlists_swap_heads_rcu — swap the lists the hlist heads point to.

okay bestie, hiii 👋 you're reading the Kernel API Manual page for hlists_swap_heads_rcu(9) — yes, the title/manual-name situation is folded right here, cute and compact, no giant duplicated header line needed 💖

---

✨ SYNOPSIS ✨

the signature, exactly as it lands:

void hlists_swap_heads_rcu (struct hlist_head *left , struct hlist_head *right );

---

🎀 ARGUMENTS 🎀

• left — the hlist head on the left. left-side head, bestie, that's the vibe 🫶
• right — the hlist head on the right. right-side head, no cap 💅

---

🦋 DESCRIPTION 🦋

okay so here's the swap glow-up this function is serving — the before/after is literally this:

The lists start out as [left  ][node1 ... ] and [right ][node2 ... ]
The lists end up as    [left  ][node2 ... ] [right ][node1 ... ]

so yeah, the lists trade places under those heads, and that's the whole iconic move 💅✨

---

👀 SEE ALSO 👀

go peek at the kernel file ./include/linux/rculist.h, plus this entire iconic lineup — all the references, zero skips:

• Kernel file: ./include/linux/rculist.h
• list_for_each_rcu(9)
• list_tail_rcu(9)
• list_add_rcu(9)
• list_add_tail_rcu(9)
• list_del_rcu(9)
• list_bidir_del_rcu(9)
• hlist_del_init_rcu(9)
• list_replace_rcu(9)
• list_splice_rcu(9)
• __list_splice_init_rcu(9)
• list_splice_init_rcu(9)
• list_splice_tail_init_rcu(9)
• list_entry_rcu(9)
• list_first_or_null_rcu(9)
• list_next_or_null_rcu(9)
• list_for_each_entry_rcu(9)
• list_for_each_entry_srcu(9)
• list_entry_lockless(9)
• list_for_each_entry_lockless(9)
• list_for_each_entry_continue_rcu(9)
• list_for_each_entry_from_rcu(9)
• hlist_del_rcu(9)
• hlist_replace_rcu(9)
• hlist_add_head_rcu(9)
• hlist_add_tail_rcu(9)
• hlist_add_before_rcu(9)
• hlist_add_behind_rcu(9)
• hlist_for_each_entry_rcu(9)
• hlist_for_each_entry_srcu(9)
• hlist_for_each_entry_rcu_notrace(9)
• hlist_for_each_entry_rcu_bh(9)
• hlist_for_each_entry_continue_rcu(9)
• hlist_for_each_entry_continue_rcu_bh(9)
• hlist_for_each_entry_from_rcu(9)

---

xoxo, your kernel bestie 💖 source/version says ./include/linux, date says October 2026, and the page is hlists_swap_heads_rcu(9). slay and goodbye 🫶