xcb_dri2_swap_interval(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_dri2_swap_interval β€” the manual page, but make it cute

okay so bestie, we're looking at xcb_dri2_swap_interval(3) from the XCB Requests family. she's part of libxcb, she lives in section 3 of the manual, and honestly? she's a little mysterious. let's get into it 🫢


✨ NAME ✨

xcb_dri2_swap_interval β€”

no cap, that's it. the description line is literally empty in the original. she's giving mystery, she's giving enigma, she's giving nothing. πŸ’€


✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/dri2.h>

πŸŽ€ Request function

xcb_void_cookie_t xcb_dri2_swap_interval(xcb_connection_t *conn,
       xcb_drawable_t drawable, uint32_t interval);

that's the whole vibe. three arguments, one cookie, zero drama. ✨


✨ REQUEST ARGUMENTS ✨

  • conn β€” your XCB connection to X11. she's the bridge, the connector, the main character that lets you talk to the X server at all. πŸŒ‰
  • drawable β€” TODO: NOT YET DOCUMENTED. yeah bestie, the docs just said "figure it out". iconic behaviour honestly πŸ™ˆ
  • interval β€” TODO: NOT YET DOCUMENTED. same energy. nobody wrote it down. we move. πŸ’€

✨ DESCRIPTION ✨

so… there's nothing here. the DESCRIPTION section is empty in the original. like, fully empty. a void. a liminal space. πŸ¦‹

ngl this is the part where a normal manpage would explain what swapping the interval actually does, and this one simply does not. no tea, no shade, just facts.

✨ RETURN VALUE ✨

she hands you back an xcb_void_cookie_t. that's the whole return situation. πŸͺ

and here's the important part, bestie: errors (if any) have to be handled in the event loop. you don't get them handed to you directly, you gotta go find them. it's giving look for it yourself. πŸ‘‘

but WAIT β€” if you'd rather handle errors directly with xcb_request_check instead, use:

xcb_dri2_swap_interval_checked

for the details on all of that, go read xcb-requests(3). she explains the whole cookie-and-error thing way better than I can in a group chat. πŸ“–


✨ ERRORS ✨

this request does never generate any errors. πŸŽ‰

not one. not ever. she's chill like that. no error codes, no stress, no 3am debugging session. slay. πŸ’–


✨ SEE ALSO ✨

…empty. literally nothing listed here. this section is a ghost town and I respect her for it. πŸ‘»


✨ AUTHOR ✨

this page was Generated from dri2.xml. if you've got corrections or improvements, hit up xcb@lists.freedesktop.org β€” they're literally asking for it, bestie, so if you know something, say something. πŸ“§


🌸 a gentle reminder that empty DESCRIPTION and empty SEE ALSO sections are not me being lazy β€” that's genuinely what the page says. I would never gatekeep info from you. 🫢

okay that's the whole page!! this was X Version 11, libxcb 1.17.0, and she's filed under xcb_dri2_swap_interval(3). thanks for reading my little manpage essay, you're the bestie fr fr πŸ’œβœ¨πŸŽ€