xcb_dri2_authenticate(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_dri2_authenticate 💖

okay bestie, so this one lives in the libxcb crew — it's the manual page for xcb_dri2_authenticate(3), part of XCB Requests. it's a lil DRI2 authenticate situation and honestly it's giving "mystery box" energy because half the fields are literally undocumented 😭 but we're gonna walk through every single one anyway because that's what we do. 🫶

✨ NAME ✨

xcb_dri2_authenticate — [the original has no description here, bestie, it's just vibes and a blank]

🌸 SYNOPSIS 🌸

#include <xcb/dri2.h>

🎀 Request function

xcb_dri2_authenticate_cookie_t
xcb_dri2_authenticate(xcb_connection_t *conn,
              xcb_window_t window, uint32_t magic);

🦋 Reply datastructure

typedef struct xcb_dri2_authenticate_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t authenticated;
} xcb_dri2_authenticate_reply_t;

⭐ Reply function

xcb_dri2_authenticate_reply_t
*xcb_dri2_authenticate_reply(xcb_connection_t *conn,
              xcb_dri2_authenticate_cookie_t cookie, xcb_generic_error_t **e);

💅 REQUEST ARGUMENTS 💅

  • conn — your XCB connection to X11. the whole portal to the server, no biggie. 👑
  • window — TODO: NOT YET DOCUMENTED. bestie they really said "figure it out" 😭 it's a window, you pass a window, we move on.
  • magic — TODO: NOT YET DOCUMENTED. also undocumented! it's a uint32_t and it's called magic, which is honestly the most honest name in this entire library ✨

🌈 REPLY FIELDS 🌈

  • response_type — the type of this reply, which in this specific case is XCB_DRI2_AUTHENTICATE. this field is also chillin' inside xcb_generic_reply_t, and it's literally how you tell your replies apart from each other. vibe check for replies, fr fr. 🔍
  • sequence — the sequence number of the last request that got processed by the X11 server. it's the receipts. 🧾
  • length — how long the reply is, counted in words. and a word here is 4 bytes, so don't come at it with your letter-counting, this is not that kind of length. 💀
  • authenticated — TODO: NOT YET DOCUMENTED. yeah. again. three for three on mystery fields, slay I guess 🙈

💜 DESCRIPTION 💜

this section is empty in the original. absolutely nothing here. no notes. silence. 🤫

🔥 RETURN VALUE 🔥

so you get back an xcb_dri2_authenticate_cookie_t — a lil cookie, a promise of a reply to come. 🍪

errors? you do not handle them here, bestie. you handle them when you call the reply function xcb_dri2_authenticate_reply.

and if you're the type who wants to catch errors in the event loop instead? use xcb_dri2_authenticate_unchecked for that. peek xcb-requests(3) for the deets. 🫶

💀 ERRORS 💀

this request never generates any errors. never ever. not one. iconic behaviour honestly, zero drama. periodt. ✨

🌸 SEE ALSO 🌸

nothing listed in the original — the section exists but it's empty. ghosted. 👻

🎀 AUTHOR 🎀

generated from dri2.xml. if you spot something wrong and wanna make it better, hit up xcb@lists.freedesktop.org for corrections and improvements. they're accepting submissions, bestie, go be the main character. 💌

and that's the whole page!! this came to you from X Version 11, libxcb 1.17.0 — stay authentic, stay hydrated, and remember: undocumented fields are just ✨mysterious✨, not scary. mwah 💅💖✨

📦 where this page comes from