xcb_copy_colormap_and_free(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_copy_colormap_and_free

okay bestie, welcome to the ✨ xcb_copy_colormap_and_free ✨ page β€” it's part of XCB Requests, and ngl she's a little mysterious because half this page is still a TODO πŸ’€. But we're gonna walk through it together, no cap.


🌸 NAME 🌸

okay so the NAME section here is literally empty? Like, blank. Nothing. The manpage never filled in a one-line description, so there's no cute summary tagline for this one. It's giving "mystery icon" πŸ™ˆ. Just know the whole page is about xcb_copy_colormap_and_free, and that's the vibe.


✨ SYNOPSIS ✨

First up, you gotta pull in the header:

#include <xcb/xproto.h>

πŸŽ€ Request function πŸŽ€

And here's the actual request function signature, character for character:

xcb_void_cookie_t xcb_copy_colormap_and_free(xcb_connection_t *conn,
       xcb_colormap_t mid, xcb_colormap_t src_cmap);

πŸ¦‹ REQUEST ARGUMENTS πŸ¦‹

  • conn β€” the XCB connection to X11. Your lil hotline to the server, fr fr πŸ’….
  • mid β€” TODO: NOT YET DOCUMENTED. yeah... the docs just never said. We don't invent lore here, so this is all we got πŸ™ˆ.
  • src_cmap β€” TODO: NOT YET DOCUMENTED. same situation bestie, the manpage left it blank 😭.

🌈 DESCRIPTION 🌈

So the DESCRIPTION section? Completely empty. No prose, no explanation, nothing. The page just moves right along. We are NOT making stuff up to fill it in β€” that's the rule πŸ‘‘. If you need the tea on what this request actually does, it's not on this page.


πŸ’œ RETURN VALUE πŸ’œ

She returns an xcb_void_cookie_t. And because that's a void cookie, any errors (if there even are any) have to be handled over in the event loop, not right here.

If you'd rather handle errors directly with xcb_request_check instead, then you want the checked version: xcb_copy_colormap_and_free_checked. See xcb-requests(3) for all the deets on how that whole thing works 🫢.


πŸ”₯ ERRORS πŸ”₯

Good news era: this request does never generate any errors. Zero. None. Not a single one. Slay πŸ’…βœ¨

⭐ SEE ALSO ⭐

Nothing listed here! The SEE ALSO section is empty, so there's no cross-reference posse to send you to. (The only page it nods at in the prose above is xcb-requests(3), for the request-handling details.)


πŸ‘‘ AUTHOR πŸ‘‘

Generated from xproto.xml. If you've got corrections or improvements, hmu at xcb@lists.freedesktop.org β€” they're literally asking for the fixes, bestie πŸ’Œ.


and that's the whole page!! πŸ¦‹ thank you for coming to my ted talk. this one came from X Version 11, libxcb 1.17.0, and it's the xcb_copy_colormap_and_free(3) page itself. go forth and be iconic πŸŒΈπŸ’–βœ¨