CMAP_FINALIZE(3)

📦 version 3.1.10, in debian bookworm, debian trixie, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 CMAP_FINALIZE — bestie, we're logging OFF 💖

okay so this is a page from the Corosync Cluster Engine Programmer's Manual, and it's about closing up shop. like when you leave the group chat but, y'know, for a connection. let's get into it ✨

🌸 NAME 🌸

cmap_finalize — the "okay bye, love u, talk later" of the CMAP API. it finalizes your connection. periodt.

🎀 SYNOPSIS 🎀

#include <corosync/cmap.h>

cs_error_t cmap_finalize (cmap_handle_t handle);

🦋 DESCRIPTION 🦋

so cmap_finalize is the function you call to close a connection to the CMAP API. no cap.

once the connection is finalized, the handle may not be used again by applications. like, at all. it's done. it's giving expired. do not text back. 💀

also, no more callbacks will be dispatched from the cmap_dispatch function after this. the party's over, the lights are on, everyone go home 🫶

👑 RETURN VALUE 👑

this call returns the CS_OK value if it went well (slay ✨), otherwise an error gets returned. and specifically: the CS_ERR_BAD_HANDLE error shows up when the handle is invalid. like if you handed it a handle that was never a handle. rude, but valid.

🌈 SEE ALSO 🌈

and now, the full error-code lineup, because we do not gatekeep 💅:

  • 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 the CS_ERR_NO_MEMORY one is the saddest, bestie. not enough memory to complete the requested task 😭 the computer is tired.

okay that's the whole page!! this was pulled straight from the corosync Man Page, dated 20/01/2012 — iconic vintage, honestly, it ate. now go finalize that handle and live your main character life 🧚💜

📦 where this page comes from