xcb_input_xi_grab_device(3)

💅 xcb_input_xi_grab_device(3) — XCB Requests

okay so bestie, welcome to the libxcb corner of the X11 universe ✨ this one is xcb_input_xi_grab_device, straight out of the XCB request gang. she grabs devices, she's mysterious, and half her docs are literally just TODO: NOT YET DOCUMENTED. we love an unfinished icon 💀

---

🌸 NAME 🌸

xcb_input_xi_grab_device —

bestie the description here is literally blank in the original. not me leaving it empty. it's giving "author said no thoughts head empty" 🙈

---

✨ SYNOPSIS ✨

#include <xcb/xinput.h>

🎀 Request function

xcb_input_xi_grab_device_cookie_t
       xcb_input_xi_grab_device(xcb_connection_t *conn,
       xcb_window_t window, xcb_timestamp_t time, xcb_cursor_t cursor,
       xcb_input_device_id_t deviceid, uint8_t mode,
       uint8_t paired_device_mode, uint8_t owner_events,
       uint16_t mask_len, const uint32_t *mask);

🦋 Reply datastructure

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

🌈 Reply function

xcb_input_xi_grab_device_reply_t
       *xcb_input_xi_grab_device_reply(xcb_connection_t *conn,
       xcb_input_xi_grab_device_cookie_t cookie,
       xcb_generic_error_t **e);

---

💖 REQUEST ARGUMENTS 💖

• conn — the XCB connection to X11. she's the whole reason you're here, the main character, the plug 🔌
• window — TODO: NOT YET DOCUMENTED. yep. that's it. that's the whole description 😭
• time — TODO: NOT YET DOCUMENTED.
• cursor — TODO: NOT YET DOCUMENTED.
• deviceid — TODO: NOT YET DOCUMENTED.
• mode — TODO: NOT YET DOCUMENTED.
• paired_device_mode — TODO: NOT YET DOCUMENTED.
• owner_events — TODO: NOT YET DOCUMENTED.
• mask_len — TODO: NOT YET DOCUMENTED.
• mask — TODO: NOT YET DOCUMENTED.

not the entire argument list being one big "we'll get to it" 🫠 no cap, that's genuinely all the original says. respect the honesty I guess.

---

👑 REPLY FIELDS 👑

• response_type — the type of this reply, and in this case it's XCB_INPUT_XI_GRAB_DEVICE. this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other like a lil name tag 🏷️
• sequence — the sequence number of the last request the X11 server processed. her receipts, basically 🧾
• length — how long the reply is, measured in words. and reminder: a word is 4 bytes, bestie, don't forget 💅
• status — TODO: NOT YET DOCUMENTED.

---

🧚 DESCRIPTION 🧚

okay so this section is empty in the original. nothing. void. silence. the vibe check came back blank 🕳️✨

---

🍓 RETURN VALUE 🍓

she hands you back an xcb_input_xi_grab_device_cookie_t 🍪 and listen — errors have to be handled when you call the reply function xcb_input_xi_grab_device_reply.

but if you'd rather catch those errors in the event loop instead, use xcb_input_xi_grab_device_unchecked. see xcb-requests(3) for the deets 👀

---

💀 ERRORS 💀

this request does never generate any errors. not one. zero. flawless behaviour, she simply doesn't miss 👑

---

🔥 SEE ALSO 🔥

literally nothing listed here in the original. the section exists, the contents said "no thoughts" 🙈

---

⭐ AUTHOR ⭐

generated from xinput.xml. contact xcb@lists.freedesktop.org for corrections and improvements 💌

---

and that's the whole page, bestie 🫶 go forth and grab those devices, and remember — when the docs say TODO: NOT YET DOCUMENTED, you're not confused, the docs are just under construction 🚧💖

X Version 11 · libxcb 1.17.0 · xcb_input_xi_grab_device(3) — mwah, that's a wrap, ily, bye 👋✨