xcb_shape_select_input(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_shape_select_input — the girlies' guide to libxcb 💖

okay so this is xcb_shape_select_input, and it lives in the XCB Requests manual, section 3 of your friendly neighbourhood Unix man pages. it's a request function, it's short, and honestly? it's giving "quiet luxury" because the original docs are like 80% TODO. we're gonna work with what we've got. no cap. ✨

🌸 NAME 🌸

xcb_shape_select_input — and that's it, bestie. that's the whole name line. the description after the dash is just... blank. an empty slot. a little void. 🕳️ we respect it anyway.

🦋 SYNOPSIS 🦋

first things first, you gotta pull in the header:

#include <xcb/shape.h>

and then here's the request function, exactly as it is:

xcb_void_cookie_t xcb_shape_select_input(xcb_connection_t *conn,
       xcb_window_t destination_window, uint8_t enable);

look at her. three args, one return type, zero drama. 💅

🎀 REQUEST ARGUMENTS 🎀

  • conn — your xcb_connection_t *, aka your XCB connection to X11. this is the little thread that ties you to the server. you know her, you love her. 🫶
  • destination_window — an xcb_window_t. and here's the tea: the original manpage literally says "TODO: NOT YET DOCUMENTED." 😭 so that's the whole story on this one, fr fr.
  • enable — a uint8_t. and guess what, bestie? "TODO: NOT YET DOCUMENTED." again. iconic behaviour from the documentation team, truly. 🙈
not me pointing out that two of the three arguments are undocumented. that's not a me problem, that's canon. i'm just the messenger. 💀

💜 DESCRIPTION 💜

okay so... the DESCRIPTION section is empty. nothing in it. not a single word. the vibe check came back and there was no vibe. 🧚

🔥 RETURN VALUE 🔥

she returns an xcb_void_cookie_t. and because it's a void cookie, that means any errors have to be handled in the event loop — you don't get them handed to you right away, bestie. that's the whole deal with void cookies. 💫

but listen, if you'd rather handle errors directly instead of waiting around in the event loop, you can use xcb_request_check — in that case you want the _checked version of this request: xcb_shape_select_input_checked. ✨

for the full deets on how all of that works, go read xcb-requests(3). it's the lore. 👑

🌈 ERRORS 🌈

good news, bestie: this request does never generate any errors. zero. none. not a single one. she is unproblematic, and honestly, we love that for her. 💖

⭐ SEE ALSO ⭐

...it's empty. there's nothing here. just vibes and silence. 🌸

👑 AUTHOR 👑

this page was generated from shape.xml. and if you spot something wrong or want to send corrections and improvements, hit up the XCB girlies at xcb@lists.freedesktop.org. they're taking notes, fr fr. 📧

and that's the whole page, bestie!! this absolute masterpiece of documentation came to you courtesy of X Version 11 and libxcb 1.17.0, with the man page title xcb_shape_select_input(3) right there at the top and the bottom. slay, go write some X11 code, mwah 💅✨🎀🦋🌸💖

📦 where this page comes from