VOTEQ...KSTART(3)

💖 VOTEQ...KSTART(3) 💖

okay bestie, this one is from the Corosync Cluster Engine Programmer's Manual and it's literally called votequorum_trackstart. it's giving "tell me everything the second it changes" energy and we're obsessed 🦋

---

✨ NAME ✨

votequorum_trackstart — Enable callbacks notification.

---

🎀 SYNOPSIS 🎀

#include <corosync/votequorum.h>

int votequorum_trackstart(votequorum_handle_t *handle, uint64_t context,
unsigned int flags);

---

🌸 DESCRIPTION 🌸

so, votequorum_trackstart is the function you call when you want the votequorum API to start sending you callbacks. it's the "hey bestie, keep me posted" button. ✨

every time your voting configuration changes (like, a node joins the cluster or dips out 👋) or the quorum status flips or the expected votes change, a notification gets queued. it doesn't just barge in — it waits its turn, lowkey.

those notifications get dispatched through the votequorum_dispatch() function, and that's the one that actually runs the callback. so trackstart queues 'em, dispatch delivers 'em. teamwork, fr fr 🫶

the context option is where you set your tracking context. whatever you wanna carry along, that's your moment.

the flags argument gets defined by one or more of these values, and you can bitwise-or them together to stack them:

#define CS_TRACK_CURRENT      0x01
#define CS_TRACK_CHANGES      0x02
#define CS_TRACK_CHANGES_ONLY 0x04

💅 careful with the flag math, babe — it's bitwise-or'd, not vibes-or'd.

---

👑 RETURN VALUE 👑

this call returns the CS_OK value if everything slayed, otherwise an error gets returned. periodt.

---

💀 ERRORS 💀

here's the full roster of ways it can go "no 💖":

• 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

😭 the CS_ERR_NO_MEMORY one is the saddest. give the poor thing some RAM.

---

🌈 SEE ALSO 🌈

go read these next, bestie, they're all part of the same little friend group:

• votequorum_overview(3)
• votequorum_initialize(3)
• votequorum_finalize(3)
• votequorum_getinfo(3)
• votequorum_trackstop(3)
• votequorum_fd_get(3)
• votequorum_dispatch(3)
• votequorum_context_set(3)
• votequorum_context_get(3)
• votequorum_setexpected(3)
• votequorum_setvotes(3)

---

and that's the whole page, no cap. this one's from the corosync Man Page, dated 2026-09-04, and it's the VOTEQ...KSTART(3) page. go forth and track, queen 👑💅✨