xas_find(9)

💅 xas_find(9) — or, "where's the next thing bestie"

okay so this is a page from the Kernel API Manual, and honestly it's a short one but it's important, so pay attention 🫶

---

✨ NAME ✨

xas_find — find the next present entry in the XArray. that's it. that's the whole job. slay 💅

---

🌸 SYNOPSIS 🌸

void * xas_find (struct xa_state *xas , unsigned long max );

---

🎀 ARGUMENTS 🎀

• xas — the XArray operation state. this is your little cursor bestie, it's holding the whole vibe of where you are in the array 💖
• max — highest index to return. like, the ceiling. the limit. do not pass go past this number, bestie 🚫

---

🦋 DESCRIPTION 🦋

so here's the tea ☕

if the xas has not yet been walked to an entry, you get the entry that has an index >= xas.xa_index. simple. iconic. no notes.

but if it has been walked? then the entry currently being pointed at has already been processed — been there, done that, ate and left no crumbs — so we move on to the next entry. next!! ✨

and now the lowkey important part: if no entry is found and the array is smaller than max, the iterator gets set to the smallest index not yet in the array. why does that matter, you ask? because it means xas can be handed straight over to xas_store with zero extra steps. it's giving convenience, it's giving main character energy 👑

---

⭐ RETURN ⭐

the entry, if found 💖 otherwise NULL 😭 (ngl, NULL is always the villain in these stories)

---

🔥 SEE ALSO 🔥

so xas_find does not exist in a vacuum, bestie — it runs with a whole squad. literally the Kernel file ./lib/xarray.c plus:

• 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_pause(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)

like I said. a whole squad. 🧚

---

and that's the page, bestie 🎀 it lives in ./lib, and this version is dated October 2026 — so if you're reading this in the future, hi, hope the kernel is thriving 💜✨