xas_pause(9)

🦋 xas_pause — fresh from the Kernel API Manual 🦋

✨ NAME ✨

xas_pause — Pause a walk to drop a lock. 💅

🌸 SYNOPSIS 🌸

void xas_pause (struct xa_state *xas );

🫶 ARGUMENTS 🫶

• xas — XArray operation state. like, the lil state object for your XArray operation ✨

💖 DESCRIPTION 💖

okay so bestie, sometimes you need to pause a walk and drop the lock you're holding, so you can yield to a higher priority thread or carry out an operation on an entry. those users should call this function before they drop the lock. it resets the xas to be suitable for the next iteration of the loop after the user has reacquired the lock. slay 🎀

if most entries found during a walk require you to call xas_pause, the xa_for_each iterator may be more appropriate. iykyk 🦋

⚠️ real talk: xas_pause only works for forward iteration. if a user needs to pause a reverse iteration, we will need a xas_pause_rev. no cap 💀

🌈 SEE ALSO 🌈

Kernel file ./lib/xarray.c — the whole squad: xas_load(9), xas_nomem(9), xas_free_nodes(9), xas_create_range(9), xas_store(9), xas_get_mark(9), xas_set_mark(9), xas_clear_mark(9), xas_init_marks(9), xas_split_alloc(9), xas_split(9), xas_try_split_min_order(9), xas_try_split(9), xas_find(9), xas_find_marked(9), xas_find_conflict(9), xa_load(9), __xa_erase(9), xa_erase(9), __xa_store(9), xa_store(9), __xa_cmpxchg(9), __xa_insert(9), xa_store_range(9), xas_get_order(9), xa_get_order(9), __xa_alloc(9), __xa_alloc_cyclic(9), __xa_set_mark(9), __xa_clear_mark(9), xa_get_mark(9), xa_set_mark(9), xa_clear_mark(9), xa_find(9), xa_find_after(9), xa_extract(9), xa_delete_node(9), xa_destroy(9). 💜

mwah 💋 this page is from source/version ./lib, dated October 2026, and it's literally xas_pause(9). periodt 🌙