xa_is_err(9)

💖 xa_is_err — like, does your XArray result mean "error"? 💖

Hey bestie 🫶 real talk: this one's from the Kernel API Manual (xa_is_err(9)), and it's a tiny little icon of a function. Let's get into it ✨

---

🌸 NAME 🌸

xa_is_err — reports whether an XArray operation came back with an error 👀

---

✨ SYNOPSIS ✨

bool xa_is_err (const void *entry );

---

🎀 ARGUMENTS 🎀

• entry — this is the result you got back from calling an XArray function. Just hand it over as-is, girl, don't overthink it 💅

---

🦋 DESCRIPTION 🦋

Okay so here's the vibe: when an XArray operation cannot complete what you asked it to do, it doesn't just throw a tantrum — it returns a special value that's basically a little flag saying "an error happened" 🔥

This function is the vibe check. It tells you whether an error occurred. That's it. That's the whole job, no cap.

If you also need to know which error occurred, that's a different function, bestie — xa_err is the one who spills the tea 🍵

---

🌈 CONTEXT 🌈

Any context. Literally any. Sleep in it, call it from an interrupt, it does not care 🧚

---

⭐ RETURN ⭐

true if the entry indicates an error. Periodt 💅

---

👑 SEE ALSO 👑

Kernel file ./include/linux/xarray.h

• Value & tag helpers: 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_err(9)
• Structs & macros: struct xa_limit(9), struct xarray(9), DEFINE_XARRAY_FLAGS(9), DEFINE_XARRAY(9), DEFINE_XARRAY_ALLOC(9), DEFINE_XARRAY_ALLOC1(9)
• Setup & state: xa_init_flags(9), xa_init(9), xa_empty(9), xa_marked(9)
• Iteration: xa_for_each_range(9), xa_for_each_start(9), xa_for_each(9), xa_for_each_marked(9)
• Storing: xa_store_bh(9), xa_store_irq(9), xa_erase_bh(9), xa_erase_irq(9)
• Compare & swap: xa_cmpxchg(9), xa_cmpxchg_bh(9), xa_cmpxchg_irq(9)
• Inserting: xa_insert(9), xa_insert_bh(9), xa_insert_irq(9)
• Allocating: 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)
• Reserve & release: xa_reserve(9), xa_reserve_bh(9), xa_reserve_irq(9), xa_release(9)
• More xa_is_* checks: xa_is_sibling(9), xa_is_retry(9), xa_is_advanced(9)
• Node updating: xa_update_node_t(9)
• State macros: XA_STATE(9), XA_STATE_ORDER(9)
• xas error handling: xas_error(9), xas_set_err(9), xas_invalid(9), xas_valid(9), xas_is_node(9)
• xas navigation: 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)

---

Okay that's the whole page, you ate that 🍓 This one lives in ./include/linux and it's dated October 2026 — so yeah, future icon behaviour, iykyk 😭💜 Go forth and check your errors, bestie! 💖