CMAP_...IALIZE(3)

💖 NAME 💖

cmap_initialize — bestie, this is how you initialize the CMAP API ✨

🌸 SYNOPSIS 🌸

#include <corosync/cmap.h>

cs_error_t cmap_initialize (cmap_handle_t *handle);

🦋 DESCRIPTION 🦋

okay so. the cmap_initialize function is literally the vibe-check moment where you set up a connection to the Configuration Map API. that's it, that's the whole job 🫶

and here's the cute part — each application can have several connections to the CMAP API at the same time. no cap. so how do you keep them straight? you use the handle argument, which uniquely identifies the connection. it's giving name tags at a party 🎀

then you pass that same handle into other function calls, so they know which connection to use when talking to the CMAP service. like, "hi yes this one, the one with the handle, mwah 💅"

👑 RETURN VALUE 👑

this call returns the CS_OK value if everything slayed. otherwise, an error gets returned 😭 (see the lil error roster down below, it's all there fr fr)

🔥 SEE ALSO 🔥

• cmap_finalize(3)
• cmap_initialize_map(3)
• cmap_overview(3)

💀 the error lineup 💀

these are the errors that can show up when things are not giving:

• 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

lowkey if you see any of those, it's not your moment. but you got this 🧚

and that's the whole page, bestie!! this lil treasure came from the corosync Man Page, dated 20/01/2012 — so it's vintage, it's iconic, it's a classic 👑✨ stay hydrated and go initialize something 💖🌈⭐