xcb_randr_select_input(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_randr_select_input β€” bestie edition πŸ’–

ok so this is a page from libxcb (that's the XCB Requests crew, X Version 11 energy) and it's literally called xcb_randr_select_input. That's it, that's the NAME. No subtitle, no vibe description, just the name and a lil dash hanging there like a stray eyelash. We move. ✨


🌸 SYNOPSIS 🌸

first things first, you gotta pull in the header, no cap:

#include <xcb/randr.h>

πŸŽ€ Request function πŸŽ€

and here's the actual function, the main character:

xcb_void_cookie_t xcb_randr_select_input(xcb_connection_t *conn,
       xcb_window_t window, uint16_t enable);

πŸ¦‹ REQUEST ARGUMENTS πŸ¦‹

  • conn β€” the XCB connection to X11. your lil lifeline to the server, bestie. 🫢
  • window β€” TODO: NOT YET DOCUMENTED. yeah. the docs said "we'll get to it" and then never did. iconic behaviour honestly. πŸ’€
  • enable β€” TODO: NOT YET DOCUMENTED. same energy. same empty promise. πŸ™ˆ

πŸ’… DESCRIPTION πŸ’…

so like… there is no description. it's giving blank canvas. it's giving nothing. the DESCRIPTION section exists and contains absolutely zero words, which is honestly kind of a flex. we know nothing more than the synopsis told us. periodt. ✨


⭐ RETURN VALUE ⭐

it hands you back an xcb_void_cookie_t. that's the return type, that's what you get, no more no less. πŸ“

and here's the important part: if any errors pop off, you have to deal with them in the event loop, okay? not right here, not right now. in the loop. πŸ‘‘

but wait β€” if you'd rather handle errors directly, like a girlboss, use xcb_request_check with xcb_randr_select_input_checked instead. peek xcb-requests(3) for the deets on how that whole situation works. πŸ”₯


πŸ’€ ERRORS πŸ’€

ok so the gag is: this request does never generate any errors. none. zero. not a single one. she's unproblematic. she's never in the group chat drama. we love a low-maintenance request. 🌈


🌸 SEE ALSO 🌸

so the SEE ALSO section is… empty. nothing listed. no cross-references. just vibes and silence. 🧚 (well, except that xcb-requests(3) we shouted out up in RETURN VALUE, iykyk.)


πŸ’œ AUTHOR πŸ’œ

this whole thing was generated from randr.xml β€” yes, auto-generated, she was born in a build script. 😭 if you spot something wrong or wanna send corrections and improvements, hit up xcb@lists.freedesktop.org. they're literally asking for it, so don't be shy. πŸŽ€


lowkey a warning: window and enable are still TODO: NOT YET DOCUMENTED in the official docs. i'm not making anything up for you, bestie β€” that's genuinely all the page says, so go read the source if you need the real tea. πŸ™ˆ

and that's the whole page!! big thanks to X Version 11 and libxcb 1.17.0 for bringing us this absolute masterpiece, and the date on the original footer was the classic manpage date slot, so consider this your cute lil sign-off. stay slaying, drink water, and always check your return cookies πŸ’–βœ¨