xcb_screensaver_query_version(3)

📦
version 1.17.0 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 xcb_screensaver_query_version — the XCB Requests girlies' guide ✨

okay so bestie, welcome to xcb_screensaver_query_version, a lil request from the XCB Requests corner of the universe (that's the manual section, section 3, iykyk). she's giving "hey server, what version of the screensaver extension are you on" and honestly? iconic behavior. 💅

🌸 NAME 🌸

xcb_screensaver_query_version — literally the whole name, and the description field in the original is just… empty. a mystery. a blank canvas. we move. 🎀

🦋 SYNOPSIS 🦋

first up, the include, don't forget her:

#include <xcb/screensaver.h>

💜 Request function

xcb_screensaver_query_version_cookie_t
       xcb_screensaver_query_version(xcb_connection_t *conn,
       uint8_t client_major_version, uint8_t client_minor_version);

💜 Reply datastructure

typedef struct xcb_screensaver_query_version_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint16_t server_major_version;
    uint16_t server_minor_version;
    uint8_t  pad1[20];
} xcb_screensaver_query_version_reply_t;

💜 Reply function

xcb_screensaver_query_version_reply_t
       *xcb_screensaver_query_version_reply(xcb_connection_t *conn,
       xcb_screensaver_query_version_cookie_t cookie,
       xcb_generic_error_t **e);

✨ REQUEST ARGUMENTS ✨

  • conn — your XCB connection to X11. your ride or die. the link between you and the server, no cap. 🔥
  • client_major_version — TODO: NOT YET DOCUMENTED. yeah bestie, the docs just… never filled this one in. it is what it is. 🙈
  • client_minor_version — TODO: NOT YET DOCUMENTED. same vibe, same void. 😭

🎀 REPLY FIELDS 🎀

  • response_type — the type of this reply, and in this case it's XCB_SCREENSAVER_QUERY_VERSION. this field is also hanging out in the xcb_generic_reply_t, and you can use it to tell replies apart from each other. very "which one of y'all is this" energy. 👑
  • sequence — the sequence number of the last request the X11 server processed. she's keeping receipts. 💅
  • length — the length of the reply, measured in words. and a word is 4 bytes, so jot that down. ⭐
  • server_major_version — TODO: NOT YET DOCUMENTED. the mystery continues. 🫶
  • server_minor_version — TODO: NOT YET DOCUMENTED. and the mystery continues again. 🦋

🌈 DESCRIPTION 🌈

so… the original leaves this section completely blank. empty. a vibe, honestly. nothing to add here because bestie, there is nothing there. periodt. 💖

💜 RETURN VALUE 💜

she hands you back an xcb_screensaver_query_version_cookie_t. 🍓 and listen — errors have to be handled when you call the reply function, xcb_screensaver_query_version_reply.

if you'd rather handle your errors in the event loop instead, use xcb_screensaver_query_version_unchecked. see xcb-requests(3) for the details, she explains it better than me. 😌

😭 ERRORS 😭

good news bestie: this request never generates any errors. zero. none. not a single one. she's that chill. ✨

👑 SEE ALSO 👑

nothing listed here in the original — an empty section, a silent queen. 💀

🫶 AUTHOR 🫶

generated from screensaver.xml. for corrections and improvements, hit up xcb@lists.freedesktop.org — they're the ones who actually made this, not me, I'm just the messenger. 💌

and that's the whole page, bestie!! this was brought to you by X Version 11 and libxcb 1.17.0 — go forth and query those versions, you absolute main character. 💅🎀💖

📦 where this page comes from