UPSCLI_FD(3)

💖 UPSCLI_FD(3) 💖

okay bestie, welcome to the NUT Manual — that's Network UPS Tools, not the other thing, pls 😭 — and today we're talking about the lil function that tells you whether your connection is still alive. it's giving vibe check for sockets. periodt.

---

✨ NAME ✨

upscli_fd — get the file descriptor for a connection 🫶

---

🌸 SYNOPSIS 🌸

#include <upsclient.h>

int upscli_fd(UPSCONN_t *ups);

no cap, that's the whole thing. two lines. iconic.

---

🎀 DESCRIPTION 🎀

so upscli_fd() takes the pointer ups — which points at a UPSCONN_t state structure, iykyk — and it hands you back the value of the file descriptor for that connection, if any exists. like, if there isn't one, there's nothing to hand over, obviously. 🙈

and why do we care?? because this is lowkey useful for figuring out whether the connection to upsd(8) has been lost. that's it. that's the whole job. she's simple, she's reliable, she ate. 💅

---

⭐ RETURN VALUE ⭐

she returns the file descriptor, which may be any non-negative number. could be 0, could be 42, could be anything in that zone. no judgement. ✨

and if an error happens? she returns -1. that's the bad vibes number, bestie. 😭

---

🦋 SEE ALSO 🦋

• upscli_connect(3)
• upscli_strerror(3)
• upscli_upserror(3)

---

fr fr, if you're out here calling upscli_fd() in a loop to poll your connection, you're doing great, keep going, main character energy only. 👑

---

okay that's the page!! this whole thing is from Network UPS Tools 2.8.5, dated 10/07/2026 — so yes, she's current, she's fresh, she's slaying. mwah 💋 go check if your socket is still alive bestie, ily, bye!! 🌈🍓🧚💜