NAME

nutscan_init_ip_ranges - Initialize contents of a nutscan_ip_range_list_t structure (and optionally create one in the first place).

SYNOPSIS

Note
Two NUT websites

This version of the page reflects NUT release v2.8.3 with codebase commited c0acf09af at 2025-04-21T23:59:59+00:00

Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here.

 
        #include <nut-scan.h>

        nutscan_ip_range_list_t * nutscan_init_ip_ranges(nutscan_ip_range_list_t *irl);

DESCRIPTION

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.

SEE ALSO

nutscan_free_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)