NUTSCAN_IP_RANGES_IT(3)

💖 NUTSCAN_IP_RANGES_IT(3) 💖

okay so bestie, this is a page from the NUT Manual — yes, the Network UPS Tools one, not the other kind of nut 😭 — and it's all about nutscan_ip_ranges_iter_inc, the little function that keeps your IP range walk moving. It's literally the "next bestie please" of the scan world ✨

---

🌸 NAME 🌸

nutscan_ip_ranges_iter_inc — proceed with iteration of an IP address range using a nutscan_ip_range_list_iter_t structure. basically: walk the iterator one step forward, no cap 🚶‍♀️💨

---

🎀 SYNOPSIS 🎀

#include <nut-scan.h>

char * nutscan_ip_ranges_iter_inc(nutscan_ip_range_list_iter_t *irliter);

look at her. one include, one function, one pointer. iconic 💅

---

🦋 DESCRIPTION 🦋

So the nutscan_ip_ranges_iter_inc() function can walk an iterator from the specified nutscan_ip_range_list_iter_t helper object — and that helper object gets prepared for you by nutscan_ip_ranges_iter_init(3), working off a nutscan_ip_range_list_t structure. it's a whole little ecosystem, iykyk 🫶

Now here's the part where she's lowkey just being polite — this function skips work (like, does nothing, returns NULL) if:

• the structure pointer is NULL (NULL is returned);
• the structure pointer's ip_range list is NULL (NULL is returned);
• the structure pointer's ip_range_iter pointer is NULL (NULL is returned).

three whole vibe checks that all fail the same way 💀

Otherwise? She returns the next IP address from the currently iterated registered IP address range — or, if no addresses remained in the current one, she switches iteration to the next range. main character energy: finish one range, sashay straight into the next 🌈

⚠️ The caller SHOULD NOT free this string while iterating. Like, do NOT. put the free() down bestie, it's not yours right now 🙈

---

👑 NOTES 👑

Technically, the function is currently defined in nutscan-ip.h file. yes even though the synopsis shows <nut-scan.h>. she contains multitudes 🎀

---

⭐ SEE ALSO ⭐

• nutscan_init_ip_ranges(3)
• nutscan_free_ip_ranges(3)
• nutscan_cidr_to_ip(3)
• nutscan_ip_ranges_iter_init(3)

the whole friend group fr fr 🫶✨

---

and that's the page, bestie!! 🍓 this was Network UPS Tools 2.8.5, dated 06/21/2026 — literally go drink some water and iterate responsibly, mwah 💜🧚‍♀️