NUTSCAN_IP_RANGES_IT(3)

💅 NUTSCAN_IP_RANGES_IT(3) — like, the NUT Manual bestie ✨

okay so real talk, this is the NUTSCAN_IP_RANGES_IT page from the NUT Manual, and it's all about one very specific little function that gets your IP-address-range walk started 🎀

---

💖 NAME 💖

nutscan_ip_ranges_iter_init — start iterating over an IP address range using a nutscan_ip_range_list_iter_t structure 🦋

---

✨ SYNOPSIS ✨

#include <nut-scan.h>

char * nutscan_ip_ranges_iter_init(
        nutscan_ip_range_list_iter_t *irliter,
        const nutscan_ip_range_list_t *irl);

---

🌸 DESCRIPTION 🌸

So nutscan_ip_ranges_iter_init() is the glow-up moment for your iterator 💅 What it does is take the nutscan_ip_range_list_t structure you hand it and prep an iterator out of it, tucking it all neatly into the caller-provided nutscan_ip_range_list_iter_t helper object. Very demure, very mindful, very "here's your iterator bestie" 🫶

You can absolutely make different iterators to walk the same nutscan_ip_range_list_t list from different scans, all independently — no gatekeeping here 👑 BUT (and this is the important part, ngl) the list and everything inside it should not be freed while literally anyone still references it. That's a one-way ticket to undefined-behavior city 😭💀

Also, the way this function is not about doing work when it doesn't have to be — it skips work if:

• the structure pointer is NULL (NULL is returned) 🙈
• the structure pointer's ip_range list is NULL (NULL is returned) 🙈

When it does do the thing, it returns the first IP address from the first registered IP address range ✨ The addresses after that one? Those come from nutscan_ip_ranges_iter_inc(), iykyk 🔥

The caller SHOULD NOT free this string while iterating. fr fr, don't do it 🚨

---

🧚 NOTES 🧚

Technically (and this is the fun little lore drop 🍓), the function is currently defined in the nutscan-ip.h file.

---

🦋 SEE ALSO 🦋

• nutscan_init_ip_ranges(3)
• nutscan_free_ip_ranges(3)
• nutscan_cidr_to_ip(3)
• nutscan_ip_ranges_iter_inc(3)

---

mwah, that's the whole page 💜 — brought to you by Network UPS Tools 2.8.5, dated 06/21/2026. go forth and iterate, bestie 🌈⭐