NUTSCAN_SCAN_NUT_SIM(3)

💖 NUTSCAN_SCAN_NUT_SIM(3) — the NUT manual, but make it cute 💖

okay bestie, so this is the nutscan_scan_nut_simulation page from the NUT Manual (that's Network UPS Tools, section 3 of the manual, iykyk) 🦋

---

✨ NAME ✨

nutscan_scan_nut_simulation — Scan your sysconfig directory for NUT simulation devices. yes literally that's the whole job, she's a little detective 🔍💅

---

🌸 SYNOPSIS 🌸

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

nutscan_device_t * nutscan_scan_nut_simulation();

not me including <unistd.h> just for useconds_t, iconic behavior fr fr 🎀

---

🦋 DESCRIPTION 🦋

So here's the tea ☕ — the nutscan_scan_nut_simulation() function tries to detect available NUT simulation devices by finding *.dev and *.seq files in your "sysconfig" directory. that's it, that's the vibe check, she's just looking for those two file patterns and reporting back 👑

BESTIE. LISTEN. You MUST call nutscan_init(3) before using this function. Like, mandatory mandatory. Do not skip this step, I am begging 🙏 it's giving "read the prerequisites" energy and she means it 💀

---

💀 BUGS 💀

ngl this one's a little goofy 😭 — this function currently uses the built-in location of the "sysconfig" directory, and does not consider an override with the NUT_CONFPATH environment variable accepted by most of the NUT code base.

so yeah, everyone else takes the NUT_CONFPATH override and she just… doesn't 🙈 known behavior, not a mystery, just the way it is rn.

---

⭐ RETURN VALUE ⭐

The nutscan_scan_nut_simulation() function returns a pointer to a nutscan_device_t structure containing all found devices 🎀 — or NULL if an error occurs or no device is found. so if you get NULL, either something went wrong or there was just nothing to find, no cap 💜

---

🌈 SEE ALSO 🌈

• nutscan_init(3)
• nutscan_scan_usb(3)
• nutscan_scan_xml_http_range(3)
• nutscan_scan_snmp(3)
• nutscan_scan_avahi(3)
• nutscan_scan_ipmi(3)
• nutscan_scan_nut(3)
• nutscan_display_sanity_check(3)
• nutscan_display_sanity_check_serial(3)
• nutscan_display_ups_conf_with_sanity_check(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)
• nutscan_cidr_to_ip(3)

---

and that's the whole page, you ate that 🫶

Network UPS Tools 2.8.5 — 10/07/2026 — NUTSCAN_SCAN_NUT_SIM(3)

mwah 💋 go call nutscan_init(3) first, bestie, I'm serious 😤✨