NOZZLE_G...BY_HANDLE(3)

💖 NOZZLE_GET_NAME_BY_HANDLE 💖

okay bestie so we're in section 3 of the Kronosnet Programmer's Manual, and today's main character is nozzle_get_name_by_handle — it does exactly one (1) iconic thing: it retrieves the nozzle interface name by handle. that's it. that's the whole vibe. 🎀

---

✨ SYNOPSIS ✨

#include <libnozzle.h>

const char * nozzle_get_name_by_handle(
    const nozzle_t  nozzle
);

---

🌸 DESCRIPTION 🌸

so nozzle_get_name_by_handle is the function, and honestly it's giving "small but mighty".

• nozzle — pointer to the nozzle struct 🫶

that's the whole parameter list. one arg. no cap.

---

💅 RETURN VALUE 💅

it hands you back a pointer to the interface name — yay!

but if things go sideways it returns NULL on error, and errno is set. so like. always check, bestie. don't be out here dereferencing NULL and acting surprised. 😭

---

👑 SEE ALSO 👑

the whole friend group, fr fr:

• 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_run_updown(3)
• nozzle_open(3)
• nozzle_del_ip(3)
• nozzle_get_mac(3)
• nozzle_set_mac(3)
• nozzle_add_ip(3)

---

🌈 COPYRIGHT 🌈

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

---

and that's the tea ☕ — this page is brought to you by kronosnet, dated 2026-07-20, and you can find it hanging out at NOZZLE_G...BY_HANDLE(3). stay hydrated, go read your errno, mwah 💋💖