xa_erase_bh(9)

✨ NAME ✨

okay bestie, this is xa_erase_bh(9) from the Kernel API Manual 💖 — and its whole personality is: erase this entry from the XArray. No cap, that's the name.

🌸 SYNOPSIS 🌸

void * xa_erase_bh (struct xarray *xa , unsigned long index );

🎀 ARGUMENTS 🎀

• xa — XArray. That's the container, bestie.
• index — Index of entry. The exact spot.

🦋 DESCRIPTION 🦋

After this function returns, loading from index will return NULL. If index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.

💅 CONTEXT 💅

Any context. Takes and releases the xa_lock while disabling softirqs.

💖 RETURN 💖

The entry which used to be at this index.

🌈 SEE ALSO 🌈

Kernel file ./include/linux/xarray.h has the whole extended universe. Also literally go look at: xa_mk_value(9), xa_to_value(9), xa_is_value(9), xa_tag_pointer(9), xa_untag_pointer(9), xa_pointer_tag(9), xa_is_zero(9), xa_is_err(9), xa_err(9), struct xa_limit(9), struct xarray(9), DEFINE_XARRAY_FLAGS(9), DEFINE_XARRAY(9), DEFINE_XARRAY_ALLOC(9), DEFINE_XARRAY_ALLOC1(9), xa_init_flags(9), xa_init(9), xa_empty(9), xa_marked(9), xa_for_each_range(9), xa_for_each_start(9), xa_for_each(9), xa_for_each_marked(9), xa_store_bh(9), xa_store_irq(9), xa_erase_irq(9), xa_cmpxchg(9), xa_cmpxchg_bh(9), xa_cmpxchg_irq(9), xa_insert(9), xa_insert_bh(9), xa_insert_irq(9), xa_alloc(9), xa_alloc_bh(9), xa_alloc_irq(9), xa_alloc_cyclic(9), xa_alloc_cyclic_bh(9), xa_alloc_cyclic_irq(9), xa_reserve(9), xa_reserve_bh(9), xa_reserve_irq(9), xa_release(9), xa_is_sibling(9), xa_is_retry(9), xa_is_advanced(9), xa_update_node_t(9), XA_STATE(9), XA_STATE_ORDER(9), xas_error(9), xas_set_err(9), xas_invalid(9), xas_valid(9), xas_is_node(9), xas_reset(9), xas_retry(9), xas_reload(9), xas_set(9), xas_advance(9), xas_set_order(9), xas_set_update(9), xas_next_entry(9), xas_next_marked(9), xas_for_each(9), xas_for_each_marked(9), xas_for_each_conflict(9), xas_prev(9), xas_next(9)

mwah 💋 that's the whole page. source/version: ./include/linux, date: October 2026 — xa_erase_bh(9) is out, byeee 🎀