xcb_change_save_set(3)

💖 xcb_change_save_set — bestie, let's talk save sets 💖

okay so this is a page from the XCB Requests corner of the xcb_change_save_set(3) manual, and honestly? It's a little chaotic but we're gonna get through it together. 🫶

---

✨ NAME ✨

xcb_change_save_set — changes a client's save set. That's it, that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

First things first, you gotta bring in the header, no cap:

#include <xcb/xproto.h>

🦋 Request function 🦋

Here's the function signature, copy it exactly bestie, character for character:

xcb_void_cookie_t xcb_change_save_set(xcb_connection_t *conn,
       uint8_t mode, xcb_window_t window);

---

💅 REQUEST ARGUMENTS 💅

• conn — the XCB connection to X11. Your little lifeline to the server, periodt.
• mode — one of these values, pick your fighter:
  • XCB_SET_MODE_INSERT — TODO: NOT YET DOCUMENTED. 😭 (the docs really said "figure it out", and I respect the honesty ngl)
  • XCB_SET_MODE_DELETE — TODO: NOT YET DOCUMENTED. 🙈 (same energy, same mystery)
  • Insert to add the specified window to the save set, or Delete to delete it from the save set. That's the actual functional difference, lowkey.
• window — the window to add or delete to/from your save set. The main character of this whole operation. 👑

---

💖 DESCRIPTION 💖

TODO: explain what the save set is for. (Yeah. The original manpage literally says that. Not me being lazy, that's canon. 💀)

What we do know: this function either adds or removes the specified window to the client's (your application's) save set. So it's giving "either/or", it's giving binary, it's giving insert-or-delete. That's the whole move. ✨

---

🍓 RETURN VALUE 🍓

It returns an xcb_void_cookie_t. Errors (if any) have to be handled in the event loop — so don't be out here ignoring your event loop, it's not a vibe. 🚫

If you want to handle errors directly with xcb_request_check instead, use xcb_change_save_set_checked. See xcb-requests(3) for details. iykyk. 🧚

---

🔥 ERRORS 🔥

• xcb_match_error_t — you created the specified window. Bestie. This does not make sense, you can only add windows created by other clients to your save set. Not your window, not your save set. 🙅‍♀️
• xcb_value_error_t — you specified an invalid mode. The mode was not moding. 😭
• xcb_window_error_t — the specified window does not exist. She's not real, she's gone, ghosted. 👻

---

🌈 SEE ALSO 🌈

xcb-requests(3), xcb_reparent_window(3) — go read these too, they're iconic in their own right. 💜

---

👑 AUTHOR 👑

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. They're literally asking for your feedback, so don't be shy. 🎀

---

okay so real talk: this page has two big fat "TODO"s in it, and I'm not about to invent lore that isn't there. If the docs say TODO, I say TODO. Facts are facts, no cap. 💯

---

and that's the whole page, bestie!! 💖 go forth and manage your save set responsibly. this was X Version 11, libxcb 1.17.0, and the page is xcb_change_save_set(3) — mwah, slay, bye!! ✨🦋🌸