xcb_xfixes_set_cursor_name(3)

💅 xcb_xfixes_set_cursor_name(3) — the XCB Requests girlies' page

okay so bestie, welcome to section 3 of the manual (that's XCB Requests, iykyk) and today's main character is xcb_xfixes_set_cursor_name. she's a request function from the X Fixes crew and she is... lowkey a mystery box. let's get into it 🎀

---

✨ SYNOPSIS ✨

first things first, you gotta bring her in:

#include <xcb/xfixes.h>

🌸 Request function

here's the whole vibe, signature and all:

xcb_void_cookie_t xcb_xfixes_set_cursor_name(xcb_connection_t *conn,
       xcb_cursor_t cursor, uint16_t nbytes, const char *name);

she returns a xcb_void_cookie_t, she takes four args, she's doing her thing 💖

---

🦋 REQUEST ARGUMENTS 🦋

• conn — the XCB connection to X11. your lil pipeline to the server, the group chat you're actually sending messages in.
• cursor — TODO: NOT YET DOCUMENTED. 🫠 fr fr the docs said "figure it out bestie"
• nbytes — TODO: NOT YET DOCUMENTED. 💀 same energy
• name — TODO: NOT YET DOCUMENTED. 🙈 yeah. we know. iconic of them honestly.

not me reading three whole TODOs in a row 😭 the documentation team said "we'll do it later" and then simply did not

---

🌈 DESCRIPTION 🌈

so here's the thing. the original page has a DESCRIPTION heading and then... absolutely nothing under it. empty. void. a whole section with no content, giving ctrl+alt+del energy. I'm not gonna invent stuff for you because that would be lying to my bestie and we don't do that here 💜 so: nothing documented, nothing added.

---

👑 RETURN VALUE 👑

she hands you back an xcb_void_cookie_t. periodt. and the errors — if there even are any — have to be handled in the event loop, so don't go looking for them on the return value, bestie.

if you'd rather handle errors directly with xcb_request_check instead, then use xcb_xfixes_set_cursor_name_checked. that's the checked version, she's the one who'll tell you what went wrong.

see xcb-requests(3) for the details on how all that works 🌟

---

🔥 ERRORS 🔥

plot twist: this request does never generate any errors. not one. zero. she's unbothered, moisturized, in her lane, error-free. slay ✨

---

🌸 SEE ALSO 🌸

the original page lists this section and then... nothing. no references, no friends, no links. she's mysterious like that 🦋

---

💖 AUTHOR 💖

generated from xfixes.xml. if you spot something wrong and wanna send corrections and improvements, hit up xcb@lists.freedesktop.org — they're the ones who actually know what nbytes is supposed to mean (affectionate) 🫶

---

and that's the whole page, no cap. this beauty lives in X Version 11, ships with libxcb 1.17.0, and goes by xcb_xfixes_set_cursor_name(3) — take care of her, she's doing her best 💅⭐