CPG_C...XT_SET(3)

💖 CPG_CONTEXT_SET 💖

ok so bestie, we're in the Corosync Cluster Engine Programmer's Manual and today's main character is cpg_context_set from section 3 of the manual. yes it's a tiny little function. yes it still deserves a whole glow-up. let's go 🎀

✨ NAME ✨

cpg_context_set — sets the context variable for a CPG instance 🦋

🌸 SYNOPSIS 🌸

#include <corosync/cpg.h>

int cpg_context_set(cpg_handle_t handle, void *context);

like. that's it. that's the whole thing. iconic behavior honestly 👑

💅 DESCRIPTION 💅

so the cpg_context_set function is literally just here to set the context variable for a cpg instance. that's the assignment. that's the mission. slay.

and here's the tea: inside libcpg itself, this thing has no meaning whatsoever. the library will not touch it. it's your little pocket of vibes, completely untouched, living rent-free in the handle. if you wanna get it back later, that's a whole other function — use cpg_context_get(3) 🫶

🍓 RETURN VALUE 🍓

if everything goes right, this call hands you back the CS_OK value. and if it doesn't? bestie, an error comes back instead. no in-between, no grey area, periodt 💀

🙈 ERRORS 🙈

ngl the errors are undocumented. that's it. that's the whole section. we don't know and neither does the manpage 😭

💜 SEE ALSO 💜

go read these too, they're all in the same friend group:

• cpg_overview(3)
• cpg_initialize(3)
• cpg_finalize(3)
• cpg_fd_get(3)
• cpg_dispatch(3)
• cpg_join(3)
• cpg_leave(3)
• cpg_mcast_joined(3)
• cpg_membership_get(3)
• cpg_zcb_alloc(3)
• cpg_zcb_free(3)
• cpg_zcb_mcast_joined(3)
• cpg_context_get(3)
• cpg_context_set(3)
• cpg_local_get(3)

and the error code squad, for when things go sideways:

• CS_ERR_TRY_AGAIN — resource temporarily unavailable, she's busy, try again later 🕐
• CS_ERR_INVALID_PARAM — invalid argument, bestie that input was NOT it 🚫
• CS_ERR_ACCESS — permission denied, no entry for you 💅
• CS_ERR_LIBRARY — the connection failed, we lost her 📵
• CS_ERR_INTERRUPT — system call interrupted by a signal, rude honestly ⚡
• CS_ERR_NOT_SUPPORTED — the requested protocol/functionality not supported, we simply don't do that here 🙅
• CS_ERR_MESSAGE_ERROR — incorrect auth message received, sus 👀
• CS_ERR_NO_MEMORY — not enough memory to complete the requested task, brain empty, no thoughts 🧠💀

lowkey reminder bestie: this page is the corosync Man Page, dated 2004-08-31, and it lives under the name CPG_C...XT_SET(3). that's the source, the version, and the date, all wrapped up with a bow 🎀✨

go forth and set your context, queen 👑💖