XCB_INPUT_SET_DEVICE_BUTTON_MAPPING(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

✨ NAME ✨

xcb_input_set_device_button_mapping β€” bestie... the description slot is literally empty πŸ’€ the manpage just leaves a lil dash hanging there with nothing after it. Iconic of it, honestly.


🌸 SYNOPSIS 🌸

First things first, you gotta pull in the header:

#include <xcb/xinput.h>

πŸŽ€ Request function

xcb_input_set_device_button_mapping_cookie_t
       xcb_input_set_device_button_mapping(xcb_connection_t *conn,
       uint8_t device_id, uint8_t map_size, const uint8_t *map);

πŸ¦‹ Reply datastructure

typedef struct xcb_input_set_device_button_mapping_reply_t {
    uint8_t  response_type;
    uint8_t  xi_reply_type;
    uint16_t sequence;
    uint32_t length;
    uint8_t  status;
    uint8_t  pad0[23];
} xcb_input_set_device_button_mapping_reply_t;

πŸ’œ Reply function

xcb_input_set_device_button_mapping_reply_t
       *xcb_input_set_device_button_mapping_reply(xcb_connection_t *conn,
       xcb_input_set_device_button_mapping_cookie_t cookie,
       xcb_generic_error_t **e);

πŸ“ REQUEST ARGUMENTS πŸ“

  • conn β€” the XCB connection to X11, your lil hotline to the server πŸ’–
  • device_id β€” TODO: NOT YET DOCUMENTED. yeah bestie, they left it blank πŸ™ˆ
  • map_size β€” TODO: NOT YET DOCUMENTED. also blank, we love a mystery ✨
  • map β€” TODO: NOT YET DOCUMENTED. blank blank blank, the trio of unknown πŸ’€

🌈 REPLY FIELDS 🌈

  • response_type β€” the type of this reply, and in this case it's XCB_INPUT_SET_DEVICE_BUTTON_MAPPING. this same field also lives inside xcb_generic_reply_t, so you can use it to tell your replies apart from each other πŸ‘‘
  • sequence β€” the sequence number of the last request the X11 server processed, fr fr
  • length β€” how long the reply is, in words (and a word here = 4 bytes, no cap)
  • xi_reply_type β€” TODO: NOT YET DOCUMENTED. mystery field, we don't know her 🫢
  • status β€” TODO: NOT YET DOCUMENTED. also unknown, also slaying in silence πŸ’…

⭐ DESCRIPTION ⭐

literally nothing here. the DESCRIPTION section is empty, bestie. not a single word. the void ate it. 😭


🧚 RETURN VALUE 🧚

You get back an xcb_input_set_device_button_mapping_cookie_t. errors? those get handled when you call the reply function xcb_input_set_device_button_mapping_reply.

If you'd rather deal with errors in the event loop instead, use xcb_input_set_device_button_mapping_unchecked. peep xcb-requests(3) for the deets πŸ’œ


πŸ’€ ERRORS πŸ’€

This request does never generate any errors. zero. none. clean record, main character energy πŸ”₯

πŸŽ€ SEE ALSO πŸŽ€

nothing listed here either β€” the SEE ALSO section is just vibes and silence. 🌸


🌟 AUTHOR 🌟

Generated from xinput.xml. got corrections or improvements? hit up xcb@lists.freedesktop.org β€” they're taking notes πŸ“


okay and that's the whole page bestie!! 🫢 this was xcb_input_set...button_mapping(3) from the XCB Requests manual, brought to you by X Version 11 and libxcb 1.17.0. go forth and map those buttons, mwah πŸ’–βœ¨