CPG_LOCAL_GET(3)

💖 CPG_LOCAL_GET 💖

okay so bestie, welcome to the Corosync Cluster Engine Programmer's Manual page for cpg_local_get — yes it's a section 3 (library calls) situation, and yes it's about to be your new fave little function. it's giving "who am I" but for nodes. let's go 🦋

✨ NAME ✨

cpg_local_get — returns the local node id 👑

🌸 SYNOPSIS 🌸

#include <corosync/cpg.h>

int cpg_local_get(cpg_handle_t handle, unsigned int *local_nodeid);

💅 DESCRIPTION 💅

so the cpg_local_get function is literally the "hey, what's my node id?" function. you use it to determine the local node's identifier. no cap. 🫶

the argument handle is what references the cpg instantiation — it's your lil VIP pass to the cpg world, so hand it over exactly like that.

and the argument local_nodeid? that's where the good stuff comes out: it will return the 32 bit node id. thirty-two bits of pure identity. slay. ✨

😭 ERRORS 😭

the errors are undocumented. iconic of them, honestly. we simply do not know. 💀

🌈 SEE ALSO 🌈

go read these next, they're the whole squad fr fr:

• 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 here's the error-code lineup that comes with this corner of the world 👇 keep these in your notes bestie, they're literally the vocabulary:

• CS_ERR_TRY_AGAIN — Resource temporarily unavailable
• CS_ERR_INVALID_PARAM — Invalid argument
• CS_ERR_ACCESS — Permission denied
• CS_ERR_LIBRARY — The connection failed
• CS_ERR_INTERRUPT — System call interrupted by a signal
• CS_ERR_NOT_SUPPORTED — The requested protocol/functionality not supported
• CS_ERR_MESSAGE_ERROR — Incorrect auth message received
• CS_ERR_NO_MEMORY — Not enough memory to complete the requested task

and that's the whole page, bestie!! this lil cutie is from the corosync Man Page, dated 2007-06-12, and it lives at CPG_LOCAL_GET(3) — a true vintage icon, we respect the elders 💜✨👑