nutscan_ip_ranges_iter_init(3)

Usage

        #include <nut-scan.h>
        char * nutscan_ip_ranges_iter_init(
                nutscan_ip_range_list_iter_t *irliter,
                const nutscan_ip_range_list_t *irl);

Overview

The nutscan_ip_ranges_iter_init() function can prepare an iterator from the specified nutscan_ip_range_list_t structure, saving it into the caller-provided nutscan_ip_range_list_iter_t helper object.

Different iterators may be created to walk the same nutscan_ip_range_list_t list from different scans independently, but the list and its contents should not be freed while anyone references it.

This function skips work if:

• the structure pointer is NULL (NULL is returned);

• the structure pointer’s ip_range list is NULL (NULL is returned).

Returns the first IP address from the first registered IP address range. Subsequent addresses can be returned by nutscan_ip_ranges_iter_inc(). The caller SHOULD NOT free this string while iterating.

Notes

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

nutscan_init_ip_ranges(3) Initialize contents of a `nutscan_ip_range_list_t` structure (and optionally create one in the first place). nutscan_free_ip_ranges(3) 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. nutscan_cidr_to_ip(3) Convert a CIDR IP to a range of IP address. nutscan_ip_ranges_iter_inc(3) Proceed with iteration of an IP address range using a `nutscan_ip_range_list_iter_t` structure.

Referred to by

nutscan_add_ip_range(3) Add an entry with IP address range (starting and ending addresses) to a `nutscan_ip_range_list_t` structure. nutscan_free_ip_ranges(3) 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. nutscan_init_ip_ranges(3) Initialize contents of a `nutscan_ip_range_list_t` structure (and optionally create one in the first place). nutscan_ip_ranges_iter_inc(3) Proceed with iteration of an IP address range using a `nutscan_ip_range_list_iter_t` structure. nutscan_stringify_ip_ranges(3) Collect contents of a `nutscan_ip_range_list_t` structure into a string buffer that can be further printed into logs. nut(7) Overview of the Network UPS Tools (NUT)

Usage

Overview

Notes

See also

Referred to by