xcb_xv_select_port_notify(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_xv_select_port_notify 💖

okay bestie, we're in the XCB Requests section of the manual, and today's main character is xcb_xv_select_port_notify(3). yes the header says it twice, it's just that iconic. 💅

✨ NAME ✨

so… the NAME field is literally blank. like, empty empty. nobody wrote a one-liner here. it's giving mystery. it's giving "the function speaks for itself". we move. 🦋

🌸 SYNOPSIS 🌸

first you gotta bring the header in:

#include <xcb/xv.h>

🎀 Request function

xcb_void_cookie_t xcb_xv_select_port_notify(xcb_connection_t *conn,
       xcb_xv_port_t port, uint8_t onoff);

that's the whole vibe. one function, three args, no notes. ✨

🫶 REQUEST ARGUMENTS 🫶

  • conn — your XCB connection to X11. it's the link to the server, the group chat you're sending messages into. 👑
  • port — TODO: NOT YET DOCUMENTED. yeah. the docs said "later" and then never came back. 💀
  • onoff — TODO: NOT YET DOCUMENTED. same energy fr fr. the manual is keeping secrets. 🙈
not me pointing out that two of the three arguments are literally undocumented — i'm just telling you what the page says, no cap. 🍓

💜 DESCRIPTION 💜

…and the DESCRIPTION section is empty too. nothing. nada. zero words. the page really said "figure it out, bestie" and dipped. 😭

⭐ RETURN VALUE ⭐

it hands you back an xcb_void_cookie_t. 🎀 and here's the important part: errors (if any) have to be handled in the event loop. so you don't get them shoved in your face right away — they show up later, in the loop.

but if you do wanna handle errors directly with xcb_request_check instead? then use xcb_xv_select_port_notify_checked. that's your girl for the direct route. ✨

peep xcb-requests(3) for all the details, iykyk.

💀 ERRORS 💀

this request does never generate any errors.

not "rarely". not "sometimes". never. slay. 🔥

🌈 SEE ALSO 🌈

nothing here. the SEE ALSO is empty, bestie. no cross-references, no friends, just vibes. 🦋

💖 AUTHOR 💖

Generated from xv.xml. if you spotted something wrong and wanna help fix it, hit up xcb@lists.freedesktop.org for corrections and improvements. they're nice, promise. 🫶

and that's the whole page, gorgeous. this lil doc came to you courtesy of X Version 11 and libxcb 1.17.0 — go forth and select your port notifications, main character. 💅✨🌸

📦 where this page comes from