nutscan_init_ip_ranges(3)

Usage

        #include <nut-scan.h>
        nutscan_ip_range_list_t * nutscan_init_ip_ranges(nutscan_ip_range_list_t *irl);

Overview

The nutscan_init_ip_ranges() function can prepare a nutscan_ip_range_list_t structure by zeroing out its fields. If the argument is NULL, the structure is dynamically allocated. Either way, a pointer to it is returned.

A structure passed by caller is not assumed to have any valid contents to free, as it may have garbage from stack after allocation.

The caller must free the contents of the structure after completing its use by calling nutscan_free_ip_ranges (after which the structure can be re-used), and explicitly free() the structure object itself 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.

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_add_ip_range(3) Add an entry with IP address range (starting and ending addresses) to a `nutscan_ip_range_list_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. nutscan_cidr_to_ip(3) Convert a CIDR IP to a range of IP address. nutscan_ip_ranges_iter_init(3) Begin iteration of an IP address range using a `nutscan_ip_range_list_iter_t` structure. 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(3) Network UPS Tools (NUT) device discovery library nutscan_scan_nut(3) Scan network for available NUT services. nutscan_scan_ipmi(3) Scan local IPMI devices. nutscan_scan_snmp(3) Scan network for SNMP devices. 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_ip_ranges_iter_inc(3) Proceed with iteration of an IP address range using a `nutscan_ip_range_list_iter_t` structure. nutscan_ip_ranges_iter_init(3) Begin iteration of an IP address range using a `nutscan_ip_range_list_iter_t` structure. nutscan_scan_xml_http_range(3) Scan network for XML/HTTP devices. nut(7) Overview of the Network UPS Tools (NUT)

Usage

Overview

Notes

See also

Referred to by