xcb_change_hosts(3)

💖 xcb_change_hosts — the manual page, bestie edition (section 3) 💖

okay so. picture this: you're deep in XCB, you're vibing with X11, and you need to touch the host list. that's this. xcb_change_hosts lives in section 3 of the manual, and it's giving "small request, big responsibilities." let's get into it ✨

---

🌸 NAME 🌸

xcb_change_hosts —

(and that's it. that's the whole name section. the original left it blank, so we leave it blank, no cap 🫶)

---

🎀 SYNOPSIS 🎀

first up, the include. you need the X protocol header, obviously:

#include <xcb/xproto.h>

✨ Request function ✨

and here's the function signature, character for character, don't you dare touch it:

xcb_void_cookie_t xcb_change_hosts(xcb_connection_t *conn, uint8_t mode,
       uint8_t family, uint16_t address_len, const uint8_t *address);

---

🦋 REQUEST ARGUMENTS 🦋

let's go through the args one by one, main character energy only 💅

• conn — your XCB connection to X11. the whole link to the display, the lifeline, the situationship. you need it.
• mode — one of these values, okay?
  • XCB_HOST_MODE_INSERT — TODO: NOT YET DOCUMENTED.
  • XCB_HOST_MODE_DELETE — TODO: NOT YET DOCUMENTED.
  • TODO: NOT YET DOCUMENTED.

yes bestie, that last dangling TODO: NOT YET DOCUMENTED. is really sitting there in the original, just hanging out with no option name next to it. we're not deleting it. it stays. it's part of the family now 😭

• family — one of these values, bestie:
  • XCB_FAMILY_INTERNET — TODO: NOT YET DOCUMENTED.
  • XCB_FAMILY_DECNET — TODO: NOT YET DOCUMENTED.
  • XCB_FAMILY_CHAOS — TODO: NOT YET DOCUMENTED.
  • XCB_FAMILY_SERVER_INTERPRETED — TODO: NOT YET DOCUMENTED.
  • XCB_FAMILY_INTERNET_6 — TODO: NOT YET DOCUMENTED.
  • TODO: NOT YET DOCUMENTED.

and look, another orphaned TODO: NOT YET DOCUMENTED. floating at the bottom of the list. iconic. we keep it. 🫶

• address_len — TODO: NOT YET DOCUMENTED.
• address — TODO: NOT YET DOCUMENTED.

---

🌈 DESCRIPTION 🌈

...and that's literally it. the DESCRIPTION section is empty in the original. no description. zero. void. nothing. the audacity? lowkey legendary. 🙈

---

💜 RETURN VALUE 💜

this one hands you back an xcb_void_cookie_t. and because it's a void cookie, any errors (if there even are any) have to be handled over in the event loop, not right here. that's just how the void cookie girlies operate.

but if you'd rather grab your errors directly, bestie, use xcb_request_check instead — and for that you want xcb_change_hosts_checked, not this one. head over to xcb-requests(3) for all the deets on how that works. 💖

---

⭐ ERRORS ⭐

good news, and it's genuinely good news: this request never generates any errors. none. not a single one. a peaceful, drama-free request. we love that for us. 🕊️✨

---

🎀 SEE ALSO 🎀

(empty. nothing here. the SEE ALSO section said absolutely nothing, so we say absolutely nothing back. respectfully. 🫶)

---

👑 AUTHOR 👑

generated from xproto.xml. wanna send corrections or improvements? contact xcb@lists.freedesktop.org — they're the ones to hit up, fr fr. 💌

---

and that's the whole page, babes. sending you off with all the love: this one came from X Version 11, shipping as part of libxcb 1.17.0 — go forth, change those hosts, and stay hydrated. mwah. 💅💖🦋🌸✨