SAM_FINALIZE(3)

💖 SAM_FINALIZE(3) 💖

okay bestie, welcome to the Corosync Cluster Engine Programmer's Manual — this is the page for sam_finalize, and yes she's a whole mood. sit down, grab a strawberry 🍓, let's get into it.

✨ NAME ✨

sam_finalize — Terminate SAM service

🦋 SYNOPSIS 🦋

#include <corosync/sam.h>

cs_error_t sam_finalize (void);

🌸 DESCRIPTION 🌸

so, the sam_finalize function is the one you call when you're done-done with the SAM API. like, closing the group chat, turning off read receipts, gone girl era. 💅

and the way this is a one-way street?? once the connection is finalized, SAM may not be used again by application. no comeback tour, no "hey can we talk". it's over over. 😭

here's the part you actually need to know: the whole functionality (health checking) will be stopped and after application fail, recovery action will not be taken. so like... your app trips, and nobody's there to catch it. no safety net, no bestie holding your hand. just vibes and consequences. 🔥

fr fr, do not call this unless you mean it.

💜 RETURN VALUE 💜

this call returns the CS_OK value if it's successful. otherwise, an error is returned. that's it, that's the whole thing. ✨

💀 ERRORS 💀

• CS_ERR_BAD_HANDLE — the library was not initialized by sam_init(3) function or was finished already. iykyk, you skipped the intro or you already said goodbye. 🙈

🎀 SEE ALSO 🎀

• sam_initialize(3)
• 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

🌈 that's the page, bestie. written up under the corosync Man Page umbrella, dated 12/01/2009 — yes she's vintage, and she still ate. go forth and finalize responsibly. 🫶👑