xcb_res_query_resource_bytes(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_res_query_resource_bytes πŸ’–

okay so bestie, welcome to the XCB Requests section of the manual, and today's main character is xcb_res_query_resource_bytes(3). pull up a chair, grab a boba, we're doing X11 resource byte queries and we're doing them adorably. πŸ¦‹


✨ NAME ✨

xcb_res_query_resource_bytes β€”

ngl the original manpage left this part blank. empty. a whole void. so like… the name is the name, bestie, that's all we got. πŸ’€

🌸 SYNOPSIS 🌸

first things first, you gotta pull in the header:

#include <xcb/res.h>

πŸŽ€ Request function

xcb_res_query_resource_bytes_cookie_t
       xcb_res_query_resource_bytes(xcb_connection_t *conn,
       uint32_t client, uint32_t num_specs, const
       xcb_res_resource_id_spec_t *specs);

πŸŽ€ Reply datastructure

typedef struct xcb_res_query_resource_bytes_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t num_sizes;
    uint8_t  pad1[20];
} xcb_res_query_resource_bytes_reply_t;

πŸŽ€ Reply function

xcb_res_query_resource_bytes_reply_t
       *xcb_res_query_resource_bytes_reply(xcb_connection_t *conn,
       xcb_res_query_resource_bytes_cookie_t cookie,
       xcb_generic_error_t **e);

πŸŽ€ Reply accessors

int xcb_res_query_resource_bytes_sizes_length(const
       xcb_res_query_resource_bytes_reply_t *reply);

xcb_res_resource_size_value_iterator_t
       xcb_res_query_resource_bytes_sizes_iterator(const
       xcb_res_query_resource_bytes_reply_t *reply);

πŸ‘‘ REQUEST ARGUMENTS πŸ‘‘

  • conn β€” the XCB connection to X11, obvi. your lil phone line to the server. πŸ’…
  • client β€” TODO: NOT YET DOCUMENTED. yeah bestie, they left us on read. πŸ™ˆ
  • num_specs β€” TODO: NOT YET DOCUMENTED. also left on read. 😭
  • specs β€” TODO: NOT YET DOCUMENTED. the trio of mystery. iconic behaviour honestly.

πŸ¦‹ REPLY FIELDS πŸ¦‹

  • response_type β€” the type of this reply, which in this case is XCB_RES_QUERY_RESOURCE_BYTES. this field is also chillin' inside xcb_generic_reply_t, so you can use it to tell replies apart from each other. it's giving name tag at a party. πŸŽ€
  • sequence β€” the sequence number of the last request processed by the X11 server. the server's lil receipt number. 🧾
  • length β€” the length of the reply, in words. and heads up, a word is 4 bytes. not a dictionary word. a byte word. iykyk. ⭐
  • num_sizes β€” TODO: NOT YET DOCUMENTED. once again, the docs said "no thoughts, head empty". πŸ’€

🌈 DESCRIPTION 🌈

literally nothing here, bestie. the DESCRIPTION section is empty. a blank canvas. the manpage equivalent of a notes app draft titled "ideas". 😭

πŸ’œ RETURN VALUE πŸ’œ

Returns an xcb_res_query_resource_bytes_cookie_t. πŸͺ

Errors have to be handled when you call the reply function xcb_res_query_resource_bytes_reply.

But wait β€” if you'd rather handle errors in the event loop instead, use xcb_res_query_resource_bytes_unchecked. see xcb-requests(3) for the deets. 🫢


πŸ”₯ ERRORS πŸ”₯

This request does never generate any errors. not one. zero. flawless. no notes. periodt. πŸ’…βœ¨


πŸŽ€ SEE ALSO πŸŽ€

the original left this section empty too. so… see also: nothing. see also: the void. see also: your own heart. πŸ’–

πŸ’– AUTHOR πŸ’–

Generated from res.xml. if you've got corrections or improvements, hit up xcb@lists.freedesktop.org. they're literally asking, bestie, don't be shy. 🌸


okay and the lil sign-off at the bottom of the page said X Version 11 and libxcb 1.17.0, so there you have it β€” that's the vibe, that's the version, that's the whole page. mwah. πŸ’‹βœ¨πŸ¦‹