xcb_composite_query_version(3)

💅 xcb_composite_query_version — bestie, let's negotiate 💅

okay so this is xcb_composite_query_version(3), from the XCB Requests fam, and it's literally the vibe-check you do before you talk to the Composite extension. you show up, you say "hey what version are we on", and the server tells you. that's the whole plot. 🎀

---

✨ NAME ✨

xcb_composite_query_version — Negotiate the version of Composite

---

✨ SYNOPSIS ✨

#include <xcb/composite.h>

🦋 Request function

xcb_composite_query_version_cookie_t
       xcb_composite_query_version(xcb_connection_t *conn,
       uint32_t client_major_version, uint32_t client_minor_version);

🦋 Reply datastructure

typedef struct xcb_composite_query_version_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t major_version;
    uint32_t minor_version;
    uint8_t  pad1[16];
} xcb_composite_query_version_reply_t;

🦋 Reply function

xcb_composite_query_version_reply_t
       *xcb_composite_query_version_reply(xcb_connection_t *conn,
       xcb_composite_query_version_cookie_t cookie,
       xcb_generic_error_t **e);

---

🌸 REQUEST ARGUMENTS 🌸

• conn — your XCB connection to X11, the group chat you're posting in. 💬
• client_major_version — the major version your client supports. this is you stating your terms, bestie.
• client_minor_version — the minor version your client supports. the little number riding along with the big one. ✨

---

🫶 REPLY FIELDS 🫶

• response_type — what kind of reply this is, and in this case it's XCB_COMPOSITE_QUERY_VERSION. this field also lives in xcb_generic_reply_t, so it's the thing that lets you tell replies apart from each other. it's giving name tag at a party. 🏷️
• sequence — the sequence number of the last request the X11 server actually got around to processing. 📋
• length — how long the reply is, measured in words. and no, not vibes-words — a word here is 4 bytes. 🧮
• major_version — the major version the server chose. the server has opinions and this is them.
• minor_version — the minor version the server chose. the sequel number. 💖

---

👑 DESCRIPTION 👑

This negotiates the version of the Composite extension. that's the whole job, no notes.

⚠️ no cap, this part matters: it must precede all other requests using Composite. like, all of them. Failure to do so will cause a BadRequest error. so do the handshake first or the server WILL be petty about it. 💀

---

🔥 RETURN VALUE 🔥

It returns an xcb_composite_query_version_cookie_t. Errors have to be handled when calling the reply function xcb_composite_query_version_reply.

If you'd rather handle errors in the event loop instead, use xcb_composite_query_version_unchecked. See xcb-requests(3) for details. pick your fighter, both are valid. ✨

---

😭 ERRORS 😭

This request does never generate any errors. iconic behaviour honestly, zero drama, we love a clean request. 👑

---

💜 SEE ALSO 💜

• xcb-requests(3)

---

🧚 AUTHOR 🧚

Generated from composite.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. so if something's off, that's the inbox, go be helpful. 🫶

---

and that's the whole page, bestie!! this one shipped with X Version 11, libxcb 1.17.0, and it answers to xcb_composite_query_version(3) — go forth, negotiate your versions, and slay 💅✨🌈