xcb_input_xi_allow_events(3)

💅 xcb_input_xi_allow_events — bestie edition

okay so this one is from xcb_input_xi_allow_events(3) in the XCB Requests manual, and yes the title is literally just the function name with a little dash after it and nothing else, because the NAME section is out here living its mysterious main character era. no cap, the description field is empty. iconic behaviour honestly. 🎀

---

✨ SYNOPSIS ✨

first things first, you gotta pull in the header, she's not optional:

#include <xcb/xinput.h>

🌸 Request function 🌸

and here's the actual request function, copy it exactly bestie, every type matters:

xcb_void_cookie_t xcb_input_xi_allow_events(xcb_connection_t *conn,
       xcb_timestamp_t time, xcb_input_device_id_t deviceid,
       uint8_t event_mode, uint32_t touchid, xcb_window_t grab_window);

---

🫶 REQUEST ARGUMENTS 🫶

here's the whole squad of parameters, and yes, the docs really do say this for most of them:

• conn — the XCB connection to X11. she's the plug, the lifeline, your link to the server 💖
• time — TODO: NOT YET DOCUMENTED. 😭 (the docs said "figure it out", not me)
• deviceid — TODO: NOT YET DOCUMENTED. 🙈
• event_mode — TODO: NOT YET DOCUMENTED. 💀
• touchid — TODO: NOT YET DOCUMENTED. ✨
• grab_window — TODO: NOT YET DOCUMENTED. 🦋

not me reading "TODO: NOT YET DOCUMENTED" five times like it was gonna change. it did not. iykyk. 💅

---

🌈 DESCRIPTION 🌈

there is literally nothing here. the DESCRIPTION section is empty. a whole vibe. we move. ✨

---

👑 RETURN VALUE 👑

she hands you back an xcb_void_cookie_t. any errors (if there even are any) have to be handled in the event loop, so don't go looking for them on the return value, bestie.

but wait — if you'd rather handle errors directly with xcb_request_check, then use xcb_input_xi_allow_events_checked instead. and for the full tea on how all of that works, go read xcb-requests(3). 📖

---

💀 ERRORS 💀

this request does never generate any errors. periodt. zero drama, zero chaos, just a peaceful little request. 🕊️

---

🦋 SEE ALSO 🦋

the SEE ALSO section is empty too. nothing to link, nothing to reference, just vibes and silence. 🎀

---

💜 AUTHOR 💜

Generated from xinput.xml. If something looks off and you want corrections and improvements, contact xcb@lists.freedesktop.org. they're literally asking for your feedback, so slay responsibly. 🫶

---

and that's the whole page, bestie! this lil beauty comes to you from X Version 11, libxcb 1.17.0 — go forth and allow those events, you absolute icon 💅✨🌈