UPSCLI_SET_DEFAULT_C(3)

✨ UPSCLI_SET_DEFAULT_C(3) ✨

okay so this is a page from the NUT Manual (Network UPS Tools, ilysfm) and it's all about one tiny little function that sets how long the upsclient module waits before giving up on a connection 💅

---

🌸 NAME 🌸

upscli_set_default_connect_timeout — configure the upsclient module's side of the default timeout for initial connections, bestie 🫶

---

🎀 SYNOPSIS 🎀

#include <upsclient.h>

int upscli_set_default_connect_timeout(const char *secs);

---

🦋 DESCRIPTION 🦋

okay so picture this: upscli_set_default_connect_timeout() sets the upsclient module internal default connection timeout for upscli_connect(3). and where does that value come from? a C string, bestie 🌈 — one that represents a floating-point non-negative number. that's it, that's the whole vibe.

now, the tea ☕: if the parsing is invalid, it just gets ignored and does not modify the previously stored value. no chaos, no drama, it simply refuses to touch what's already there 🙈.

and if you pass a NULL argument value? that sets the internal timeout to 0, which means indefinitely blocking, no cap. and like, that's been the NUT default for this method for at least 20 years 💀 iconic behaviour honestly.

lowkey important: while this method can be called explicitly, it's recommended that you call upscli_init_default_connect_timeout(3) instead — for consistent setting from a number of sources with different priority. trust, it's the move 👑

---

⭐ RETURN VALUE ⭐

okay so the returns, let's get into it:

• 0 — success, slay 💖. this happens either when the string was NULL (so the built-in default 0 is applied) or when its content was valid and its value got applied.
• -1 — an error occurred 😭. specifically when the string was not NULL and its content was not valid — so like, not a number, negative, etc. vibe check failed fr fr.

---

💜 SEE ALSO 💜

• upscli_connect(3)
• upscli_tryconnect(3)
• upscli_init_default_connect_timeout(3)
• upscli_get_default_connect_timeout(3)

---

and that's the whole page, bestie — go forth and timeout responsibly 🧚✨

Network UPS Tools 2.8.5 · 06/21/2026 · mwah, catch you on the next manpage 💋🎀