NODEUPDOWN_HANDLE_DESTROY(3)

💅 NODEUPDOWN_HANDLE_DESTROY 💅

okay so bestie, welcome to the libnodeupdown corner of the manual, section 3 (that's the library-functions girlies, iykyk). today's main character is nodeupdown_handle_destroy — she's the one who cleans up after the party. no cap.

---

✨ NAME ✨

nodeupdown_handle_destroy — destroys a nodeupdown handle 🎀

---

🌸 SYNOPSIS 🌸

#include <nodeupdown.h>

int nodeupdown_handle_destroy(nodeupdown_t handle);

---

🦋 DESCRIPTION 🦋

nodeupdown_handle_destroy() destroys the nodeupdown handle pointed to by handle and frees all the allocated memory associated with it. like, all of it. she's the responsible friend who actually takes the trash out at the end of the night. 🫶

---

💖 RETURN VALUES 💖

On success, 0 is returned. slay. ✨

On error, -1 is returned, and an error code is returned in handle. that error code? you can go grab it with nodeupdown_errnum(3), and a lil description of what it means comes from nodeupdown_strerror(3). the error codes themselves live in nodeupdown.h. periodt.

---

😭 ERRORS 😭

• NODEUPDOWN_ERR_NULLHANDLE — the handle parameter is NULL. not me passing a null handle bestie 💀. the nodeupdown handle has to be created with nodeupdown_handle_create(3) first, fr fr.
• NODEUPDOWN_ERR_MAGIC — handle has an incorrect magic number ✨🪄. that means handle does not point to a nodeupdown handle, or handle has already been destroyed. so like… either she's not who she says she is, or you already sent her home. either way, no.

---

🍓 FILES 🍓

• /usr/include/nodeupdown.h

---

👑 SEE ALSO 👑

• libnodeupdown(3)
• nodeupdown_handle_create(3)
• nodeupdown_load_data(3)
• nodeupdown_errnum(3)
• nodeupdown_strerror(3)

---

and that's the whole vibe check, bestie 💜 this one came straight from LLNL, dated August 2003 — old money, honestly, she ate and left no crumbs 🌈💅 go forth and free your memory responsibly ✨