xcb_set_screen_saver(3)

💖 xcb_set_screen_saver 💖

okay bestie, welcome to the xcb_set_screen_saver page — it's part of the XCB Requests crew (XCB = that X11 C binding we all know and love) 🦋

so like. you wanna tell the X server how to behave when your screen's been idle? that's literally this. let's go 💅

---

✨ SYNOPSIS ✨

#include <xcb/xproto.h>

🎀 Request function 🎀

xcb_void_cookie_t xcb_set_screen_saver(xcb_connection_t *conn,
       int16_t timeout, int16_t interval, uint8_t prefer_blanking,
       uint8_t allow_exposures);

that's the whole vibe right there. one function, four args, and a void cookie. slay ✨

---

🌸 REQUEST ARGUMENTS 🌸

• conn — the XCB connection to X11. your lil link to the server, no cap 🫶
• timeout — TODO: NOT YET DOCUMENTED. 😭 (yeah the docs really said "figure it out bestie")
• interval — TODO: NOT YET DOCUMENTED. 🙈 (same energy, same mystery)
• prefer_blanking — pick one of these cuties:
  • XCB_BLANKING_NOT_PREFERRED — TODO: NOT YET DOCUMENTED.
  • XCB_BLANKING_PREFERRED — TODO: NOT YET DOCUMENTED.
  • XCB_BLANKING_DEFAULT — TODO: NOT YET DOCUMENTED. and then, one more time for the people in the back: TODO: NOT YET DOCUMENTED. 💀
• allow_exposures — also a choose-your-own-adventure:
  • XCB_EXPOSURES_NOT_ALLOWED — TODO: NOT YET DOCUMENTED.
  • XCB_EXPOSURES_ALLOWED — TODO: NOT YET DOCUMENTED.
  • XCB_EXPOSURES_DEFAULT — TODO: NOT YET DOCUMENTED. and yes, once again: TODO: NOT YET DOCUMENTED. 💀

---

💜 DESCRIPTION 💜

so bestie… the DESCRIPTION section on this page is empty. like, genuinely nothing. main character walked in, said absolutely nothing, and left. iconic behaviour honestly 👑

(we're not gonna make stuff up for it either — no cap, we keep it exactly as empty as it is 💖)

---

🔥 RETURN VALUE 🔥

it hands you back an xcb_void_cookie_t. that's the whole return vibe.

and here's the thing: any errors (if there even are any) have to be handled in the event loop, so don't come crying to the return value about it 😌

now — if you'd rather deal with errors directly with xcb_request_check instead, then use xcb_set_screen_saver_checked and go off. xcb-requests(3) has the full tea on how that works 🍓

---

🌈 ERRORS 🌈

this request does never generate any errors. never ever. zero. zilch. clean sheet. periodt ✨

---

🌟 SEE ALSO 🌟

nothing listed here, bestie — the SEE ALSO section is empty. an empty shelf. we respect it 🎀

---

👑 AUTHOR 👑

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements 🫶

---

and that's the page!! ok bye, go write some X11 code, you absolute legend 💅🌸

X Version 11 · libxcb 1.17.0 · this was xcb_set_screen_saver(3) — mwah, catch you in the next manpage, bestie 💖✨🦋