nutscan_free_ip_ranges - Man Page

Free contents of a `nutscan_ip_range_list_t` structure populated (and optionally created) by `nutscan_init_ip_ranges()` and, more importantly, filled by a series of `nutscan_add_ip_range()` calls.

Synopsis

        #include <nut-scan.h>

        void nutscan_free_ip_ranges(nutscan_ip_range_list_t *irl);

Description

The nutscan_free_ip_ranges() function can free a nutscan_ip_range_list_t structure. Doing so, it frees the whole linked list of nutscan_ip_range_t entries, and zeroes out helper properties.

The structure itself is not freed (as it can be a statically allocated variable on the stack), and can be re-used for a new list if needed.

The caller must ultimately free the structure object if it was allocated dynamically (e.g. by originally calling nutscan_init_ip_ranges(NULL)).

Notes

Technically, the function is currently defined in nutscan-ip.h file.

See Also

nutscan_init_ip_ranges(3), nutscan_add_ip_range(3), nutscan_stringify_ip_ranges(3), nutscan_cidr_to_ip(3), nutscan_ip_ranges_iter_init(3), nutscan_ip_ranges_iter_inc(3)

Referenced By

nutscan(3), nutscan_add_ip_range(3), nutscan_init_ip_ranges(3), nutscan_ip_ranges_iter_inc(3), nutscan_ip_ranges_iter_init(3), nutscan_scan_ipmi(3), nutscan_scan_nut(3), nutscan_scan_snmp(3), nutscan_scan_xml_http_range(3), nutscan_stringify_ip_ranges(3).

04/22/2025 Network UPS Tools 2.8.3 NUT Manual