NUTSCAN_SCAN_XML_HTT(3)

💖 NAME 💖

nutscan_scan_xml_http — bestie, it goes and finds your XML/HTTP devices on the network 🦋

✨ SYNOPSIS ✨

#include <nut-scan.h>

nutscan_device_t * nutscan_scan_xml_http(long usec_timeout);

🌸 DESCRIPTION 🌸

okay so nutscan_scan_xml_http() is literally on a mission: it tries to detect NUT compatible XML/HTTP devices. the way it does that? it sends out a broadcast message on the network interfaces that are currently configured, and then it just… waits. patiently. for up to usec_timeout microseconds to hear back from any potential devices 👑 like it's holding its breath for a text back fr fr.

🫶 YOU MUST CALL nutscan_init(3) BEFORE USING THIS FUNCTION. no skipping, no "I'll do it later", it's giving prerequisites, periodt.

🎀 RETURN VALUE 🎀

if it ate, it hands you a pointer to a nutscan_device_t structure holding all the found devices 🌈. and if something went wrong, or genuinely no device showed up? you get NULL. it's giving nothing, literally 💀.

💅 SEE ALSO 💅

• nutscan_init(3)
• nutscan_scan_usb(3)
• nutscan_scan_snmp(3)
• nutscan_scan_nut(3)
• nutscan_scan_avahi(3)
• nutscan_scan_ipmi(3)
• nutscan_display_ups_conf(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_scan_eaton_serial(3)

that's the whole vibe bestie, no cap 🧚 and just so you know who's behind this masterpiece: it's Network UPS Tools version 2.7.3, dated 03/02/2016, and it lives in the NUT Manual section 3. slay 💖✨