xcb_randr_set_monitor(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_set_monitor β€” the XCB Requests era

okay bestie, welcome to xcb_randr_set_monitor(3) πŸ’– this one lives in the XCB Requests family, and honestly? it's giving "short and mysterious." let's get into it πŸŽ€


✨ NAME ✨

xcb_randr_set_monitor β€” no description, and we're just gonna sit with that πŸ’€ the manpage literally leaves this blank, so no cap, that's all the NAME section gives us.


🌸 SYNOPSIS 🌸

first thing's first, you gotta pull in the header, periodt:

#include <xcb/randr.h>

πŸ¦‹ Request function πŸ¦‹

and here's the actual function, character for character, don't you dare paraphrase it:

xcb_void_cookie_t xcb_randr_set_monitor(xcb_connection_t *conn,
       xcb_window_t window, xcb_randr_monitor_info_t *monitorinfo);

πŸ’… REQUEST ARGUMENTS πŸ’…

  • conn β€” your XCB connection to X11. your lil hotline to the server, basically πŸ“ž
  • window β€” TODO: NOT YET DOCUMENTED. i know, i know 😭 the docs really said "figure it out bestie."
  • monitorinfo β€” TODO: NOT YET DOCUMENTED. same energy, same silence πŸ™ˆ
ngl, two of the three arguments here are literally undocumented in the source. i'm not gonna make stuff up β€” that would be so not slay. all we know is what's written, and what's written is "TODO."

πŸ‘‘ DESCRIPTION πŸ‘‘

there is no DESCRIPTION text. that's it. that's the whole vibe. the section exists, the words do not 🌈✨


πŸŽ€ RETURN VALUE πŸŽ€

this one hands you back an xcb_void_cookie_t. and because it's a void cookie, any errors (if there even are any) have to get handled in the event loop, okay? that's the whole deal πŸ”₯

but wait β€” if you'd rather handle errors directly with xcb_request_check instead, then you wanna use xcb_randr_set_monitor_checked πŸ’– that's your girl for the direct-check route.

for all the deets on how that whole checked/unchecked thing works, go read xcb-requests(3). iykyk ⭐


πŸ’€ ERRORS πŸ’€

good news, icon behavior: this request does never generate any errors. zero. none. nothing. clean sheet, no drama, we love to see it 🫢


🌈 SEE ALSO 🌈

the original page has nothing listed here. nothing! so there's nothing for me to send you to, bestie. go forth unguided 🧚


πŸ’œ AUTHOR πŸ’œ

generated from randr.xml πŸ“ if you spot something wrong and wanna fix it or improve it, hmu at xcb@lists.freedesktop.org β€” they're the ones taking corrections and improvements πŸ’Œ


and that's the whole page, fr fr. X Version 11, libxcb 1.17.0 β€” that's the version energy this beauty is running on, so when you cite it, cite it proud βœ¨πŸ’–πŸŒΈ bye bestie, go set some monitors πŸ’