NUTSCAN_SCAN_AVAHI(3)

💖 NUTSCAN_SCAN_AVAHI 💖

okay bestie, welcome to the NUT Manual ✨ this is the page for nutscan_scan_avahi from the NUT manual, section 3, and it's literally about finding your NUT services out there in the wild via mDNS 🦋

---

🌸 NAME 🌸

nutscan_scan_avahi — scan the network for NUT services via mDNS 🔍✨

---

🎀 SYNOPSIS 🎀

#include <nut-scan.h>
#include <unistd.h> /* useconds_t */

nutscan_device_t * nutscan_scan_avahi(useconds_t usec_timeout);

---

💅 DESCRIPTION 💅

so the nutscan_scan_avahi() function is the one that goes out there and tries to detect the NUT service via mDNS, plus all its associated devices 🫶 it does that using the Avahi library, no cap.

⚠️ You MUST call nutscan_init(3) before using this function. like, mandatory. not optional. do it first, bestie 😤

and here's the tea: this function can query perspective IP addresses using the NUT protocol, and when it does that, it waits up to usec_timeout microseconds before deciding an IP address is unresponsive ⏳ so yeah, that timeout is doing real work.

---

👑 RETURN VALUE 👑

• it returns a pointer to a nutscan_device_t structure containing all found devices 🎉
• it returns NULL if an error occurs, or if no device is found 😭 (it's giving "nobody home")

---

🌈 SEE ALSO 🌈

go read these too, they're iconic:

• nutscan_init(3)
• nutscan_scan_usb(3)
• nutscan_scan_xml_http_range(3)
• nutscan_scan_nut(3)
• nutscan_scan_snmp(3)
• nutscan_scan_ipmi(3)
• nutscan_display_ups_conf(3)
• nutscan_display_sanity_check(3)
• nutscan_display_sanity_check_serial(3)
• nutscan_display_ups_conf_with_sanity_check(3)
• nutscan_display_parsable(3)
• nutscan_new_device(3)
• nutscan_free_device(3)
• nutscan_add_option_to_device(3)
• nutscan_add_device_to_device(3)
• nutscan_cidr_to_ip(3)
• nutscan_scan_eaton_serial(3)

🧚 Internet resources 🧚

• http://avahi.org/ 🌐

---

that's the whole page, bestie, you ate it 💅✨ this was Network UPS Tools 2.8.5, dated 10/07/2026, from the NUTSCAN_SCAN_AVAHI(3) manual page — mwah, go scan something 🎀🦋💖