xas_set_err(9)

💅 xas_set_err — like, the Kernel API Manual page you actually wanna read

okay so bestie, welcome to Kernel API Manual energy. This is xas_set_err(9), and it does exactly one little job, but it does it correctly, and we're gonna respect that.

---

✨ NAME ✨

xas_set_err — note an error in the xa_state 🫶

Like, literally, you're jotting down "hey something went wrong" inside the xa_state. That's the whole gig. Iconic, lowkey.

---

✨ SYNOPSIS ✨

void xas_set_err (struct xa_state *xas , long err );

Look at her. Flawless signature. No return value, she just does things. 💅

---

✨ ARGUMENTS ✨

• xas — the XArray operation state. This is the whole context of your little XArray adventure, and it's where the error gets written.
• err — a negative error number. Negative!! We'll get to that. 🚨

---

✨ DESCRIPTION ✨

So here's the tea ☕ — ok so, you only call this function with a negative err. That's the vibe. Negative error numbers, that's the assignment, that's what she was built for.

⚠️ fr fr read this part: if you pass a zero or positive err, it will probably not behave the way you think it should. Not me warning you, that's just what the page says. Do not test her. Do not play with her. 🫠

And if what you actually want is to clear the error from an xa_state? Then xas_reset is your girl. Different function, different job. Don't ask xas_set_err to do xas_reset's job, it's giving main character energy and it's not hers. 🎀

---

🌈 SEE ALSO 🌈

okay this list is LONG and honestly kind of a flex, so buckle up bestie. These all live in the kernel file ./include/linux/xarray.h:

• 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_bh(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_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)

Slay. Go read them. Or don't, I'm not your mom, but like… you should. 💖

---

🦋 SIGN-OFF 🦋

This little beauty comes from the ./include/linux directory, dated October 2026, and it's page xas_set_err(9) in the Kernel API Manual. Drink some water, use negative error codes only, and go be the main character of your own XArray. 🌸✨💜