VOTEQ...FD_GET(3)

💖 VOTEQ...FD_GET(3) 💖

okay bestie, welcome to the Corosync Cluster Engine Programmer's Manual — this one's short but she's mighty, and she's about to save your event loop from doing the most.

---

✨ NAME ✨

votequorum_fd_get — she dispatches callbacks from the votequorum service, that's the whole job description 🎀

---

🌸 SYNOPSIS 🌸

#include <corosync/votequorum.h>

int votequorum_fd_get(votequorum_handle_t handle, int *fd);

---

🦋 DESCRIPTION 🦋

okay so, votequorum_fd_get is the function you call when you wanna get your hands on the file descriptor — the one you can hand over to the poll system call so you can figure out when votequorum_dispatch(3) won't block. no cap, that's literally it. 🫶

and here's the part that gets people every single time, so listen up: you cannot just pass the handle argument straight into poll. it's giving file descriptor but it is not a file descriptor, bestie 😭 it's actually an internal identifier that the votequorum library uses for its own business. so no, don't do that. get the real fd with this function instead. periodt. 💅

---

🔥 RETURN VALUE 🔥

this call pulls up with CS_OK if everything went slay, otherwise you're getting an error back. that's the vibe check. ✨

---

💀 ERRORS 💀

• CS_ERR_TRY_AGAIN — resource is temporarily unavailable, like she's busy rn, try again later 🙈
• CS_ERR_INVALID_PARAM — invalid argument, you gave her something cursed 👑
• CS_ERR_ACCESS — permission denied, not your lane, bestie 🚫
• CS_ERR_LIBRARY — the connection failed. it's giving ghosted 💔
• CS_ERR_INTERRUPT — system call got interrupted by a signal, rude honestly ⚡
• CS_ERR_NOT_SUPPORTED — the requested protocol/functionality is not supported, she simply doesn't do that 🌈
• CS_ERR_MESSAGE_ERROR — incorrect auth message received, sus 😭
• CS_ERR_NO_MEMORY — not enough memory to complete the requested task. tragic. iconic. unavoidable. 🍓

---

🧚 SEE ALSO 🧚

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

---

and that's the whole page, bestie!! this lil icon dropped as part of the corosync man pages, dated 2026-09-04. go poll something responsibly 💖✨🎀