xcb_dpms_set_timeouts(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_dpms_set_timeouts

okay bestie, so this one lives in the XCB family of manual pages β€” xcb_dpms_set_timeouts(3) β€” and it is, and I say this with love, the most mysterious little page. Let's get into it πŸ’–


✨ NAME ✨

xcb_dpms_set_timeouts β€” and that's it, that's the whole description. no tagline. no blurb. she simply did not elaborate. πŸ™ˆ


✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/dpms.h>

🌸 Request function 🌸

xcb_void_cookie_t xcb_dpms_set_timeouts(xcb_connection_t *conn,
       uint16_t standby_timeout, uint16_t suspend_timeout,
       uint16_t off_timeout);

look at that signature, so clean, so structured, main character energy fr fr ✨


✨ REQUEST ARGUMENTS ✨

  • conn β€” your XCB connection to X11. the whole vibe starts here, you literally cannot do anything without her 🫢
  • standby_timeout β€” TODO: NOT YET DOCUMENTED. yeah. that's what it says. the docs are giving blank stare 😭
  • suspend_timeout β€” TODO: NOT YET DOCUMENTED. same energy. no cap, nothing else is written here πŸ’€
  • off_timeout β€” TODO: NOT YET DOCUMENTED. three for three bestie, the documentation team was on vacation 🌈
ngl, I am not gonna make stuff up for you here. if the page says TODO, it says TODO, and I'm not about to invent a meaning for a parameter and have you out here debugging your whole setup because of me. periodt.

✨ DESCRIPTION ✨

...it's empty. genuinely empty. a void. she left it on read πŸ¦‹


✨ RETURN VALUE ✨

okay so she does talk about this part, thank goodness:

Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the event loop.

and if you're the type who wants to handle errors directly with xcb_request_check instead? then use xcb_dpms_set_timeouts_checked. it's giving checked-girl era. See xcb-requests(3) for details πŸ“š


✨ ERRORS ✨

good news bestie: this request does never generate any errors. iconic. flawless. no notes πŸ’…


✨ SEE ALSO ✨

nothing. absolutely nothing. not a single cross-reference. she stands alone, unbothered, in her own lane πŸ‘‘


✨ AUTHOR ✨

Generated from dpms.xml. Contact xcb@lists.freedesktop.org for corrections and improvements β€” so like, if you spot something, email the list, don't just suffer in silence πŸ’Œ


and that's the whole page, babes. this came to you from X Version 11 / libxcb 1.17.0, in the xcb_dpms_set_timeouts(3) man page slot β€” and since the footer doesn't hand us a date, we're just gonna say it's timeless, like all the best girls πŸ’– mwah, go read xcb-requests(3) and slay ✨