xcb_xfixes_ch...ursor_by_name(3)

πŸ“¦
version 1.17.0 Β· 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– xcb_xfixes_change_cursor_by_name β€” bestie edition πŸ’–

okay so welcome to the xcb_xfixes_ch...ursor_by_name(3) page, part of the XCB Requests family, and yes the title in the header is literally truncated with dots like that, that's just how the man page gods named it, we don't ask questions πŸ’…


✨ NAME ✨

xcb_xfixes_change_cursor_by_name β€” and that's it. no little dash-description after it. the original page just left that part blank, so we're leaving it blank too. iconic mystery behaviour, honestly πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

first, the include, because you can't slay what you can't #include:

#include <xcb/xfixes.h

wait no. it's this, exactly this:

#include <xcb/xfixes.h>

then, the request function itself:

xcb_void_cookie_t
       xcb_xfixes_change_cursor_by_name(xcb_connection_t *conn,
       xcb_cursor_t src, uint16_t nbytes, const char *name);

🌸 REQUEST ARGUMENTS 🌸

  • conn β€” the XCB connection to X11. your lil pipeline to the X server, your main character link, the whole vibe 🫢
  • src β€” TODO: NOT YET DOCUMENTED. yeah. the docs said "not yet". we're passing that energy straight through, no cap πŸ™ˆ
  • nbytes β€” also TODO: NOT YET DOCUMENTED. πŸ’€
  • name β€” and also TODO: NOT YET DOCUMENTED. bestie the entire argument list is a mystery box and i'm obsessed 😭
real talk: those three TODOs are copied straight from the original. i'm not out here inventing lore about what they do. iykyk, and the docs do not know πŸŽ€

πŸ’œ DESCRIPTION πŸ’œ

okay so… there is no description. the DESCRIPTION section on this page is empty. truly giving minimalist. nothing to summarise, nothing to expand, nothing i'm allowed to make up. we respect the silence ✨


πŸ”₯ RETURN VALUE πŸ”₯

it returns an xcb_void_cookie_t. and the way that errors work here? if there are any, you have to handle them in the event loop. that's the assignment, bestie, you don't get them handed to you directly πŸ“¬

but lowkey if you'd rather handle errors directly with xcb_request_check instead? then use xcb_xfixes_change_cursor_by_name_checked for that. and go read xcb-requests(3) for the details, that's where the real tea is πŸ“


πŸ‘‘ ERRORS πŸ‘‘

this request does never generate any errors.

literally never. zero. no errors, no drama, no chaos. it's giving peaceful. it's giving serene. it ate and left no crumbs 🌈


🧚 SEE ALSO 🧚

nothing here either bestie, the original section is empty. no cross references, no friends, no links. it's a solo act and honestly? respect πŸ’…


⭐ AUTHOR ⭐

Generated from xfixes.xml. Contact xcb@lists.freedesktop.org for corrections and improvements πŸ’Œ β€” that's the original author block, kept exactly, because credit is non-negotiable 🫢


okay and finally, the cute lil sign-off that used to live in the footer: this page is from X Version 11, libxcb 1.17.0. that's the source, that's the version, that's the whole thing. stay hydrated, go read your event loop, and slay πŸ’–βœ¨πŸŽ€