XCB_INPUT_CHANGE_DEVICE_KEY_MAPPING_CHECKED(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_input_change_device_key_mapping β€” bestie's guide to the XCB Input extension

okay so you're in section 3 of the manual, which means we're in C-library land, and this one lives in libxcb (the XCB Requests family). It's called xcb_input_change_device_key_mapping, and yes, that name is a whole mouthful, but we move. πŸ¦‹


✨ SYNOPSIS ✨

first, the include. you literally cannot do anything without it:

#include <xcb/xinput.h>

then, the request function itself:

xcb_void_cookie_t
       xcb_input_change_device_key_mapping(xcb_connection_t *conn,
       uint8_t device_id, xcb_input_key_code_t first_keycode,
       uint8_t keysyms_per_keycode, uint8_t keycode_count, const
       xcb_keysym_t *keysyms);

it's giving very "six arguments and a dream", but slay, we got this. πŸ’–


πŸŽ€ REQUEST ARGUMENTS πŸŽ€

here's the whole roster, one by one, no skipping:

  • conn β€” the XCB connection to X11. your little lifeline to the server, your main character connection, periodt.
  • device_id β€” TODO: NOT YET DOCUMENTED. πŸ’€ yeah. the docs simply did not show up. it's an open invitation, bestie.
  • first_keycode β€” TODO: NOT YET DOCUMENTED. same energy, same mystery.
  • keysyms_per_keycode β€” TODO: NOT YET DOCUMENTED. still not a single word. iconic in a "we know nothing" way.
  • keycode_count β€” TODO: NOT YET DOCUMENTED. 🫢
  • keysyms β€” TODO: NOT YET DOCUMENTED. yes, even this one. the whole argument list is a group chat with everyone on read.
not me pointing out that literally every argument here is undocumented 😭 that's just how the XML came out, and I'm not about to invent lore that isn't real. if it says TODO, it's TODO. no cap.

🌸 DESCRIPTION 🌸

there is genuinely no description text on this page. like, none. the section exists and it is empty. the vibe is "we came, we saw, we left". πŸ’…


🌈 RETURN VALUE 🌈

it returns an xcb_void_cookie_t. and because it's a void cookie, any errors (if there even are any) have to be handled in the event loop β€” that's the whole point of the void-cookie life, you go get your answer later. πŸ”₯

if you'd rather handle errors directly with xcb_request_check instead, then use xcb_input_change_device_key_mapping_checked. see xcb-requests(3) for the details, because that page is the one with the receipts.


πŸ’€ ERRORS πŸ’€

good news, bestie: this request does never generate any errors. that's it, that's the section. nothing to catch, nothing to panic about. go off. ✨


πŸ‘‘ SEE ALSO πŸ‘‘

this page's SEE ALSO section is empty β€” no references listed, so there's nothing to send you off to. (the return-value prose above does nod at xcb-requests(3), and that's where you'd look for request-handling details.)


🧚 AUTHOR 🧚

Generated from xinput.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.


and that's the whole page, bestie. this one ships with X Version 11 and libxcb 1.17.0 β€” take care of her, she's been waiting in the docs since forever. mwah. πŸ’–βœ¨