xcb_res_query_clients(3)

💖 xcb_res_query_clients — the XCB glow-up

okay bestie, gather round, because this is xcb_res_query_clients(3) from the XCB Requests lineup and it's giving "I just want to know who's out here on the X server" energy. ✨

---

✨ NAME ✨

xcb_res_query_clients -

(yeah the description is literally empty, she's mysterious, we respect it 💅)

---

🌸 SYNOPSIS 🌸

#include <xcb/res.h>

🎀 Request function

xcb_res_query_clients_cookie_t
       xcb_res_query_clients(xcb_connection_t *conn,

🦋 Reply datastructure

typedef struct xcb_res_query_clients_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t num_clients;
    uint8_t  pad1[20];
} xcb_res_query_clients_reply_t;

🧚 Reply function

xcb_res_query_clients_reply_t
       *xcb_res_query_clients_reply(xcb_connection_t *conn,
       xcb_res_query_clients_cookie_t cookie, xcb_generic_error_t **e);

💜 Reply accessors

xcb_res_client_t *xcb_res_query_clients_clients(const
       xcb_res_query_clients_request_t *reply);

int xcb_res_query_clients_clients_length(const
       xcb_res_query_clients_reply_t *reply);

xcb_res_client_iterator_t xcb_res_query_clients_clients_iterator(const
       xcb_res_query_clients_reply_t *reply);

---

👑 REQUEST ARGUMENTS 👑

• conn — the XCB connection to X11, aka your little hotline to the server. 📞 no connection, no vibes.

---

🌈 REPLY FIELDS 🌈

• response_type — the type of this reply, in this case XCB_RES_QUERY_CLIENTS. This field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other. it's the little name tag so you know which reply just walked in 💖
• sequence — the sequence number of the last request processed by the X11 server. it's the server's "okay we got up to here" receipt ⭐
• length — the length of the reply, in words (a word is 4 bytes). not wordle words bestie, 4-byte words 🫶
• num_clients — TODO: NOT YET DOCUMENTED. yeah she's undocumented, we're all just out here living 😭

---

💀 DESCRIPTION 💀

(empty. nothing. the void. she said "no notes" and meant it 🙈)

---

🔥 RETURN VALUE 🔥

Returns an xcb_res_query_clients_cookie_t. Errors have to be handled when calling the reply function xcb_res_query_clients_reply.

If you want to handle errors in the event loop instead, use xcb_res_query_clients_unchecked. See xcb-requests(3) for details.

so basically: you get a cookie now 🍪, and the actual answer comes later when you call the reply function. that's the whole async moment, no cap.

---

💅 ERRORS 💅

This request does never generate any errors.

periodt. zero errors. she's not like other requests ✨

---

🌟 SEE ALSO 🌟

(empty — she's self-sufficient, main character energy 👑)

---

🎀 AUTHOR 🎀

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

---

and that's the whole page bestie, iykyk 💖 go forth and query those clients, you absolute icon 🦋

sign-off time: this was X Version 11, libxcb 1.17.0, and yeah, xcb_res_query_clients(3) — mwah, obsessed 💋