xcb_input_xi_...ungrab_device(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_xi_passive_ungrab_device(3) πŸ’œ

okay bestie, so this is a page from the XCB Requests manual β€” that's the X protocol C binding situation β€” and it's literally called xcb_input_xi_...ungrab_device. yes the name is abbreviated like that, it's giving mysterious main character energy and we're not gonna argue with it. 🌸


✨ NAME ✨

xcb_input_xi_passive_ungrab_device β€” the passive ungrab device request, bestie. that's it, that's the whole name, the description line is literally just vibes and a dash. πŸ’…


✨ SYNOPSIS ✨

first up, you gotta pull in the header, no cap:

#include <xcb/xinput.h>

πŸŽ€ Request function

and here's the actual function, character for character, don't @ me:

xcb_void_cookie_t
       xcb_input_xi_passive_ungrab_device(xcb_connection_t *conn,
       xcb_window_t grab_window, uint32_t detail,
       xcb_input_device_id_t deviceid, uint16_t num_modifiers,
       uint8_t grab_type, const uint32_t *modifiers);

she's long, she's loaded, she's iconic. πŸ‘‘


✨ REQUEST ARGUMENTS ✨

here's every single thing you're feeding her, and what the docs say about each one:

  • conn β€” the XCB connection to X11, obvi. it's your link to the whole X situation, the group chat with the server if you will. 🫢
  • grab_window β€” TODO: NOT YET DOCUMENTED. yeah girl, they left it blank, we report the blank faithfully. 😭
  • detail β€” TODO: NOT YET DOCUMENTED. same energy, same blank. πŸ™ˆ
  • deviceid β€” TODO: NOT YET DOCUMENTED. mystery device, mystery docs. πŸ’€
  • num_modifiers β€” TODO: NOT YET DOCUMENTED. how many modifiers? the docs refuse to say. ✨
  • grab_type β€” TODO: NOT YET DOCUMENTED. type of grab, allegedly, per the name, but the page is silent. πŸŒ™
  • modifiers β€” TODO: NOT YET DOCUMENTED. the pointer to the modifiers, also undocumented. ⭐
ngl bestie, that's a LOT of TODO: NOT YET DOCUMENTED. in one place. it's not me being lazy, that's literally what the page says. i would never leave you hanging like that. πŸ’–

✨ DESCRIPTION ✨

okay so… the DESCRIPTION section? it's empty. completely, absolutely empty. not a single word. it's giving "we'll finish this later" and later never came. 😭

what i can tell you is that this is the xcb_input_xi_passive_ungrab_device request function from <xcb/xinput.h>, generated from xinput.xml β€” and that's all the page itself gives us. no invented lore, no guessing, periodt. πŸ’…


✨ RETURN VALUE ✨

she returns an xcb_void_cookie_t, bestie. πŸ”₯ and listen β€” errors (if any) have to be handled in the event loop. that's the deal.

but if you'd rather handle errors directly, you use xcb_request_check instead, and for that you want:

xcb_input_xi_passive_ungrab_device_checked

and if you want the whole tea on how request checking works, go read xcb-requests(3). it's all in there. 🫢


✨ ERRORS ✨

good news, babe: this request does never generate any errors. 🌈 zero. none. clean slate, no drama, no error codes to catch. slay.


✨ SEE ALSO ✨

this section is… empty. nothing listed. that's just how the page is, we don't make stuff up around here. πŸ¦‹


✨ AUTHOR ✨

this whole thing was generated from xinput.xml. if you spot something wrong and wanna help fix it, hit up xcb@lists.freedesktop.org β€” they take corrections and improvements, fr fr. πŸ’Œ


and that's the page, bestie!! πŸŽ€ go forth and ungrab those passive devices (once somebody documents what all those arguments actually do, lmaooo). mwah. πŸ’…βœ¨

X Version 11 Β· libxcb 1.17.0 Β· xcb_input_xi_...ungrab_device(3) β€” that's the footer tea, sourcing and version and everything, signing off like the icon she is. πŸ‘‘πŸ’–