XSetEventQueueOwner(3)

✨ XSetEventQueueOwner ✨

okay bestie, so this is a lil function from the XLIB FUNCTIONS corner of the world — XSetEventQueueOwner(3) — and it's the one that decides who actually owns the event queue when you're running a shared Xlib/XCB connection. it's giving "two roommates, one mailbox" energy fr fr 💌

---

🌸 NAME 🌸

XSetEventQueueOwner — set the event queue owner on a shared Xlib/XCB connection 🫶

---

🎀 SYNTAX 🎀

#include <X11/Xlib-xcb.h>

void XSetEventQueueOwner(Display *dpy, enum XEventQueueOwner owner);

---

💅 ARGUMENTS 💅

• dpy — the connection to the X server, obviously 💖
• owner — the whole point of the function: who's holding the event queue now? your options are:
  • XlibOwnsEventQueue (this is the default, no cap) — Xlib owns the event queue. so use the Xlib event-handling functions. and do NOT call the XCB event-handling functions, i'm serious 😤
  • XCBOwnsEventQueue — XCB owns the event queue now, main character shift ✨ so use the XCB event-handling functions. and do NOT call the Xlib event-handling functions. pick a lane bestie 💀

---

🌈 DESCRIPTION 🌈

so here's the tea ☕ — a client using Xlib/XCB can totally issue requests and handle their replies or errors with either Xlib or XCB. iconic, flexible, love that for you. but here's the catch: only one of them can own and handle the event queue. just one. that's the rule 🎀

by default, Xlib must own the event queue — that's for compatibility with legacy Xlib clients, so the old heads keep working 🫶

but if you want XCB to be the one holding the queue instead, you can call XSetEventQueueOwner — and you gotta do it immediately after XOpenDisplay. like, right after. no detours, no side quests 🧚

⚠️ and you may not call XSetEventQueueOwner at any other time — because doing that will potentially lose responses 😭 like, actual data going poof. don't do it. that's the vibe check and you would fail it.

---

🦋 SEE ALSO 🦋

• XOpenDisplay(3)
• XGetXCBConnection(3)
• Xlib - C Language X Interface

---

and that's the whole page, bestie!! 💜 this one ships with X Version 11, libX11 1.8.13 — so go forth, set your event queue owner correctly, and slay 👑✨💖