xcb_xkb_use_extension(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_xkb_use_extension ✨

okay bestie, so this is a page from the XCB Requests corner of the manual β€” it's xcb_xkb_use_extension(3), and yes she's a libxcb girlie πŸ’…. Basically you're sliding into the X11 server's DMs to ask "hey, do you speak the XKB extension, and which version, babe?" πŸ¦‹


🌸 NAME 🌸

xcb_xkb_use_extension β€”

(that's it. the NAME section literally has no description. mysterious. iconic. she said "no thoughts, head empty" πŸ™ˆ)


✨ SYNOPSIS ✨

First things first, you gotta bring her in:

#include <xcb/xkb.h>

πŸŽ€ Request function

xcb_xkb_use_extension_cookie_t
       xcb_xkb_use_extension(xcb_connection_t *conn,
       uint16_t wantedMajor, uint16_t wantedMinor);

πŸ’– Reply datastructure

typedef struct xcb_xkb_use_extension_reply_t {
    uint8_t  response_type;
    uint8_t  supported;
    uint16_t sequence;
    uint32_t length;
    uint16_t serverMajor;
    uint16_t serverMinor;
    uint8_t  pad0[20];
} xcb_xkb_use_extension_reply_t;

πŸ¦‹ Reply function

xcb_xkb_use_extension_reply_t
       *xcb_xkb_use_extension_reply(xcb_connection_t *conn,
       xcb_xkb_use_extension_cookie_t cookie, xcb_generic_error_t **e);

πŸ’œ REQUEST ARGUMENTS πŸ’œ

  • conn β€” the XCB connection to X11. your hotline to the server, your group chat with the display, the whole vibe πŸ”₯
  • wantedMajor β€” TODO: NOT YET DOCUMENTED. (ngl nobody wrote this one down, it's giving unfinished homework 😭)
  • wantedMinor β€” TODO: NOT YET DOCUMENTED. (same energy, bestie, we simply do not know fr fr πŸ’€)

🌈 REPLY FIELDS 🌈

  • response_type β€” the type of this reply, which in this case is XCB_XKB_USE_EXTENSION. this field also lives inside xcb_generic_reply_t, so you can use it to tell your replies apart from each other. it's the little name tag at the party 🏷️
  • sequence β€” the sequence number of the last request processed by the X11 server. it's the server's "last seen" timestamp, lowkey πŸ“
  • length β€” the length of the reply, measured in words. and a word here is 4 bytes, periodt ✨
  • supported β€” TODO: NOT YET DOCUMENTED. (undocumented, she's mysterious, we stan a cryptic queen πŸ™ˆ)
  • serverMajor β€” TODO: NOT YET DOCUMENTED. (also undocumented, no cap πŸ’€)
  • serverMinor β€” TODO: NOT YET DOCUMENTED. (yep, this one too, the docs said "not today" 😭)

🌟 DESCRIPTION 🌟

(there is literally nothing here. the DESCRIPTION section is empty. she's serving silence, and honestly? valid. main character energy πŸ‘‘)


🫢 RETURN VALUE 🫢

She hands you back an xcb_xkb_use_extension_cookie_t. that's your lil receipt, your claim ticket, your "I'll be back for this" note πŸŽ€

heads up bestie: errors have to be handled when you call the reply function xcb_xkb_use_extension_reply. don't just leave your cookie hanging, that's rude πŸ’…

If you'd rather handle errors in the event loop instead, use xcb_xkb_use_extension_unchecked. See xcb-requests(3) for the deets πŸ“š


πŸ’€ ERRORS πŸ’€

This request does never generate any errors. not one. zero. she's unproblematic, she's drama-free, she's the friend who never starts anything 🌸✨


πŸ”₯ SEE ALSO πŸ”₯

(empty, bestie. nothing to see here. go touch some grass, or like, go read xcb-requests(3) again πŸ¦‹)


πŸ’Œ AUTHOR πŸ’Œ

Generated from xkb.xml. Contact xcb@lists.freedesktop.org for corrections and improvements β€” they're literally begging you to send fixes, so if you spot something, slide into their inbox πŸ“§


and that's the whole page, bestie!! this lil icon came to you from X Version 11, running libxcb 1.17.0, and she's still rocking the xcb_xkb_use_extension(3) name tag πŸ’– thanks for reading all the way to the bottom, you're a real one β€” mwah, bye!! πŸŽ€βœ¨πŸ¦‹