LIST_HEAD_GUARDED(9)

💅 LIST_HEAD_GUARDED 💅

okay so bestie, welcome to the Kernel API Manual, section 9 — the manual name is LIST_HEAD_GUARDED(9), and this page is about defining a &struct list_head annotated with __guarded_by(). lowkey iconic. 🫶✨

🎀 NAME 🎀

LIST_HEAD_GUARDED — define a &struct list_head annotated with __guarded_by(). that's it, that's the name, and it ate. 💖

🌸 SYNOPSIS 🌸

LIST_HEAD_GUARDED (name , lock );

🦋 ARGUMENTS 🦋

• name — name of the list_head. simple, slay.
• lock — lock protecting the list. the lock girlie is doing the guarding, iykyk. 🔥

👑 SEE ALSO 👑

the whole friend group is here, no one left behind:

• Kernel file ./include/linux/list.h
• LIST_HEAD_INIT(9), LIST_HEAD(9), INIT_LIST_HEAD(9), list_add(9), list_add_tail(9)
• list_add_tail_release(9), list_del(9), list_replace(9), list_replace_init(9), list_swap(9)
• list_del_init(9), list_move(9), list_move_tail(9), list_bulk_move_tail(9), list_is_first(9)
• list_is_last(9), list_is_head(9), list_empty(9), list_del_init_careful(9), list_empty_careful(9)
• list_rotate_left(9), list_rotate_to_front(9), list_is_singular(9), list_cut_position(9), list_cut_before(9)
• list_splice(9), list_splice_tail(9), list_splice_init(9), list_splice_tail_init(9), list_entry(9)
• list_first_entry(9), list_last_entry(9), list_first_entry_or_null(9), list_first_entry_or_null_acquire(9), list_last_entry_or_null(9)
• list_next_entry(9), list_next_entry_circular(9), list_prev_entry(9), list_prev_entry_circular(9), list_for_each(9)
• list_for_each_continue(9), list_for_each_prev(9), list_for_each_safe(9), list_for_each_prev_safe(9), list_count_nodes(9)
• list_entry_is_head(9), list_for_each_entry(9), list_for_each_entry_reverse(9), list_prepare_entry(9), list_for_each_entry_continue(9)
• list_for_each_entry_continue_reverse(9), list_for_each_entry_from(9), list_for_each_entry_from_reverse(9), list_for_each_entry_safe(9), list_for_each_entry_safe_continue(9)
• list_for_each_entry_safe_from(9), list_for_each_entry_safe_reverse(9), list_safe_reset_next(9), hlist_unhashed(9), hlist_unhashed_lockless(9)
• hlist_empty(9), hlist_del(9), hlist_del_init(9), hlist_add_head(9), hlist_add_before(9)
• hlist_add_behind(9), hlist_add_fake(9), hlist_fake(9), hlist_is_singular_node(9), hlist_move_list(9)
• hlist_splice_init(9), hlist_for_each_entry(9), hlist_for_each_entry_continue(9), hlist_for_each_entry_from(9), hlist_for_each_entry_safe(9)
• hlist_count_nodes(9)

mwah 💋 — signed off by the ./include/linux source girlies, dated October 2026, and stamped LIST_HEAD_GUARDED(9). periodt. 🎀