xcb_glx_get_error(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_glx_get_error πŸ’…

okay bestie, welcome to the xcb_glx_get_error page from libxcb β€” that's the XCB Requests family, manual section 3, the whole GLX-flavored corner of the X11 universe. pull up a chair, we're doing this together 🫢


✨ NAME ✨

xcb_glx_get_error β€” and that's it, that's the whole name. the manpage literally leaves the description blank, so no cap, there is no fancy tagline here. it's giving mysterious. πŸŽ€


✨ SYNOPSIS ✨

first up, the include, because nothing happens without it:

#include <xcb/glx.h>

🌸 Request function

xcb_glx_get_error_cookie_t xcb_glx_get_error(xcb_connection_t *conn,
       xcb_glx_context_tag_t context_tag);

🌸 Reply datastructure

typedef struct xcb_glx_get_error_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    int32_t  error;
} xcb_glx_get_error_reply_t;

🌸 Reply function

xcb_glx_get_error_reply_t
       *xcb_glx_get_error_reply(xcb_connection_t *conn,
       xcb_glx_get_error_cookie_t cookie, xcb_generic_error_t **e);

✨ REQUEST ARGUMENTS ✨

  • conn β€” your XCB connection to X11. the whole portal to the server, your main character link. πŸ”₯
  • context_tag β€” TODO: NOT YET DOCUMENTED. yeah bestie, the docs really said "no thoughts, head empty" on this one. it's literally written in the source like that, so we keep it real and pass it through untouched. πŸ™ˆ

✨ REPLY FIELDS ✨

  • response_type β€” the type of this reply, and in this case it's XCB_GLX_GET_ERROR. this field is also hanging out in the xcb_generic_reply_t, which is how you tell one reply apart from another in a crowd. πŸ’…
  • sequence β€” the sequence number of the last request the X11 server actually processed. your lil timestamp of progress. ⭐
  • length β€” the length of the reply, measured in words. and just so we're clear: a word is 4 bytes. remember it, it comes up. 🧚
  • error β€” TODO: NOT YET DOCUMENTED. again!! the manpage is gatekeeping. we report it exactly as written and move on. 😭

✨ DESCRIPTION ✨

and… that's it. there is nothing here. the DESCRIPTION section is empty, the original said nothing, and I'm not about to make stuff up about it. moving on, periodt. πŸ’€


✨ RETURN VALUE ✨

you get back an xcb_glx_get_error_cookie_t. a cookie!! cute, but like, a cookie you have to actually do something with.

errors have to be handled when you call the reply function xcb_glx_get_error_reply. that's the deal. 🀝

but if you'd rather handle errors in the event loop instead, use xcb_glx_get_error_unchecked β€” see xcb-requests(3) for the details on that whole situation.


✨ ERRORS ✨

this request does never generate any errors. not one. zero. iconic behaviour honestly. πŸ‘‘

✨ SEE ALSO ✨

nothing listed here, bestie. the section exists but it's empty. iykyk. πŸ¦‹


✨ AUTHOR ✨

generated from glx.xml. if you've got corrections or improvements, contact xcb@lists.freedesktop.org β€” they'd genuinely love to hear from you. πŸ’œ


and that's the whole page, start to finish!! πŸŽ€ this one came to you from X Version 11, libxcb 1.17.0, and it's the xcb_glx_get_error(3) page. go forth and slay your GLX errors, bestie β€” you've got this fr fr πŸ’–βœ¨πŸŒΈ