LIBNUTCLIENT_GENERAL(3)

🌸 LIBNUTCLIENT_GENERAL 💖

okay bestie, so this is a page from the NUT Manual — that's Network UPS Tools — and it's about the general + utility functions in the high-level client access library. yes it's giving "boring C library docs" but honestly? it's kinda iconic. let's go. ✨

---

✨ NAME ✨

libnutclient_general, nutclient_destroy, strarr_alloc, strarr_free — General and utility functions in Network UPS Tools high-level client access library 🦋

---

🎀 SYNOPSIS 🎀

#include <nutclient.h>

typedef void* NUTCLIENT_t;

void nutclient_destroy(NUTCLIENT_t client);

typedef char** strarr;

strarr strarr_alloc(unsigned short count);

void strarr_free(strarr arr);

like. look at it. so clean. so demure. 💅

---

💜 DESCRIPTION 💜

the functions, one by one, no skips, no cap

• nutclient_destroy() — this one destroys a NUTCLIENT_t or a derived connection object (think NUTCLIENT_TCP_t, you know, the whole family 👑) and it frees the allocated memory. it's the "okay we're done here, go home, bye" function. 🫶
• the strarr type is literally just an array of C strings — like, an array of char pointer. and here's the thing bestie, the array must always be terminated by a NULL pointer. always. no exceptions. it's the rule. ⭐
  • the pointed strings have to be allocated by (x)calloc or (x)strdup. that's the assignment. that's the requirement. don't get creative. 🙈
• strarr_alloc() — allocates a strarr array with however many string pointers you asked for. and note: those pointers are (non-initialized). so like, don't go reading them before you fill them in, that's not the vibe. 🦋
  • also, another additional pointer set to NULL gets added at the end of the array. automatic. built in. slay. ✨
• strarr_free — frees a strarr array. and not just the array itself, it also frees all pointed strings. so like, it's thorough. it's a clean break. no loose ends, no situationships, periodt. 💖

🍓 Common arguments 🍓

• dev — is the device name. that's it. that's the whole thing. main character energy from a three-word parameter ngl. 👑

---

🌈 SEE ALSO 🌈

libnutclient(3) — go read it, it's the whole point, iykyk 💫

---

reminder bestie: strarr arrays are terminated by a NULL pointer, and the strings inside them must come from (x)calloc or (x)strdup. that's not a suggestion, that's the contract. 🎀

---

okay that's the whole page! this was Network UPS Tools 2.8.5, dated 10/07/2026, and it's LIBNUTCLIENT_GENERAL(3) — love that for us. mwah, bye bestie 💋💖✨