xcb_test_grab_control(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_test_grab_control ✨

okay bestie, gather round 💖 we're looking at xcb_test_grab_control, one of the lil request functions hanging out in the XCB Requests corner of the libxcb manual, page 3. yes it's a whole manual page. yes it's mostly empty. we're still gonna read it together, because that's what friends do 🫶

🌸 NAME 🌸

xcb_test_grab_control —

ngl the description here is literally blank in the original. the name is the whole vibe. no cap. 💀

🎀 SYNOPSIS 🎀

First things first, you gotta pull in the header:

#include <xcb/xtest.h>

💅 Request function

xcb_void_cookie_t xcb_test_grab_control(xcb_connection_t *conn,
       uint8_t impervious);

that's it, that's the whole signature, slay ✨

🦋 REQUEST ARGUMENTS 🦋

  • conn — the XCB connection to X11. your lil line to the server, your main character hotline ☎️
  • impervious — it's a uint8_t, it's giving mysterious, and the source says TODO: NOT YET DOCUMENTED. so like… nobody has written the lore yet 🙈 i am NOT gonna make something up, that's not the move.

🌈 DESCRIPTION 🌈

this section is empty in the original, bestie. nothing. zero. a whole vibe void. 🕳️ i refuse to invent lore for it because that would be lying and lying is not cute. ✋

⭐ RETURN VALUE ⭐

you get back an xcb_void_cookie_t. that's the whole return, and honestly? iconic.

and listen — if any errors happen, you do NOT get them handed to you right here. you handle them in the event loop, periodt. that's the deal.

but if you'd rather catch errors directly with xcb_request_check instead, then you want to call xcb_test_grab_control_checked 💖 and if you want the full tea on how that whole requests-and-replies thing works, go read xcb-requests(3). iykyk.

💀 ERRORS 💀

okay this is the good news section: this request does never generate any errors. zero. none. clean run, no drama, we love that for us 😌✨

🧚 SEE ALSO 🧚

also empty in the original 🥲 there are no cross-references listed here. just vibes and the void. 🍓

👑 AUTHOR 👑

This page was generated from xtest.xml. If you spot something that needs fixing or improving, hit up xcb@lists.freedesktop.org — they're the ones who want to hear about corrections and improvements 💌

X Version 11 · libxcb 1.17.0 — that's the source and the version this page is serving, and the manual page is xcb_test_grab_control(3) in case you lost track (you didn't, you're doing great 🫶). mwah, go write some X11 code, bestie 💅🌸

📦 where this page comes from