xcb_sync_create_counter(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_sync_create_counter — bestie edition 💫

okay so this is a page from the XCB Requests manual, specifically xcb_sync_create_counter(3). pull up a chair, we're doing X11 sync stuff today and honestly? it's giving very demure, very undocumented. 🎀

✨ NAME ✨

xcb_sync_create_counter — and then... literally nothing. the description slot is empty. no cap, the manpage just trails off into the void. iconic of it, honestly. 🫶

🌸 SYNOPSIS 🌸

first things first, you gotta pull in the header:

#include <xcb/sync.h>

🦋 Request function 🦋

here's the whole entire function signature, character for character, don't come for me:

xcb_void_cookie_t xcb_sync_create_counter(xcb_connection_t *conn,
       xcb_sync_counter_t id, xcb_sync_int64_t initial_value);

three args, one void cookie, zero chill. let's break it down 👑

💅 REQUEST ARGUMENTS 💅

  • conn — the XCB connection to X11. that's your link to the server, your main character connection, the whole vibe. 🔥
  • id — TODO: NOT YET DOCUMENTED. yeah. bestie. that's the actual text. we know nothing. 🙈
  • initial_value — also TODO: NOT YET DOCUMENTED. two for two. the mystery continues. 💀

🧚 DESCRIPTION 🧚

...nothing. absolutely nothing. the DESCRIPTION section is empty, like a group chat at 3am. this page simply does not elaborate. periodt. 🌈

⭐ RETURN VALUE ⭐

it hands you back an xcb_void_cookie_t. and because it's a void cookie, any errors (if there are any) have to be handled over in the event loop — you don't get them shoved in your face right here. 😭

now, if you'd rather handle errors directly with xcb_request_check instead of waiting around in the event loop, use xcb_sync_create_counter_checked. that's your girl for immediate feedback. 💖

for the full tea on how requests and cookies work, go read xcb-requests(3). it's all in there, iykyk.

🎀 ERRORS 🎀

good news, bestie: this request never generates any errors. zero. none. not a single one. slay. ✨

👑 SEE ALSO 👑

nothing here either. no cross-references, no friends, just vibes. 🦋

💜 AUTHOR 💜

this page was generated from sync.xml. so if something's wrong, missing, or just plain mysterious (looking at you, two TODOs), hit up xcb@lists.freedesktop.org with your corrections and improvements. they're taking notes, fr fr. 📝

okay that's the whole page, bestie — short, sweet, and honestly a little mysterious. this one shipped with X Version 11, libxcb 1.17.0, and it's xcb_sync_create_counter(3) forever and always. mwah. 💋 go forth and create some counters. 🫶✨

📦 where this page comes from