NOZZLE_RUN_UPDOWN(3)

✨ NOZZLE_RUN_UPDOWN ✨

okay bestie so this is nozzle_run_updown(3) from the Kronosnet Programmer's Manual and it's literally the glow-up your nozzle device deserves 💅

---

💖 NAME 💖

nozzle_run_updown — run the updown commands that are associated with a nozzle device 🎀

---

🌸 SYNOPSIS 🌸

#include <libnozzle.h>

int nozzle_run_updown(
    const nozzle_t  nozzle,
    uint8_t         action,
    char          **exec_string
);

---

🦋 DESCRIPTION 🦋

so nozzle_run_updown is the moment okay, here's the whole vibe:

• nozzle — pointer to the nozzle struct 🫶
• action — pre-up.d / up.d / down.d / post-down.d (peep the defines above, they're right there 👀)
• exec_string — pointers to string to record executing action stdout/stderr. The string is malloc'ed, so the caller needs to free the buffer. If the script generates no output this string might be NULL. 🙈

and like, it is the application responsibility to call helper scripts before or after creating/destroying interfaces or IP addresses. that's on you, not on the library, no cap 👑

---

⭐ RETURN VALUE ⭐

• 0 on success 😌
• -1 on error and errno is set (sanity checks and internal calls. — yes, that sentence is doing its own thing, we're keeping it fr fr)
• -2 on error from executing the shell scripts, and no errno is set. the shell scripts said no 💀

---

🔥 SEE ALSO 🔥

your reading list, bestie, go off 📚

• nozzle_close(3)
• nozzle_set_mtu(3)
• nozzle_get_fd(3)
• nozzle_get_mtu(3)
• nozzle_reset_mtu(3)
• nozzle_set_up(3)
• nozzle_get_ips(3)
• nozzle_set_down(3)
• nozzle_reset_mac(3)
• nozzle_get_handle_by_name(3)
• nozzle_open(3)
• nozzle_del_ip(3)
• nozzle_get_mac(3)
• nozzle_set_mac(3)
• nozzle_get_name_by_handle(3)
• nozzle_add_ip(3)

---

👑 COPYRIGHT 👑

Copyright (C) 2010-2026 Red Hat, Inc. All rights reserved. 🫡

---

and that's the whole page babes — this is from kronosnet, dated 2026-07-20, and the manual is NOZZLE_RUN_UPDOWN(3) 💜 stay hydrated, free your malloc'ed strings, mwah 🎀✨