nutscan_scan_xml_http_range3

Usage

        #include <nut-scan.h>
        #include <unistd.h> /* useconds_t */
        nutscan_device_t * nutscan_scan_xml_http_range(
                const char * start_ip,
                const char * end_ip,
                useconds_t usec_timeout,
                nutscan_xml_t * sec)
        nutscan_device_t * nutscan_scan_ip_range_xml_http(
                nutscan_ip_range_list_t * irl,
                useconds_t usec_timeout,
                nutscan_xml_t * sec)

Overview

The nutscan_scan_xml_http_range() and nutscan_scan_ip_range_xml_http() functions try to detect NUT compatible XML/HTTP devices.

If start_ip for the former or irl for the latter are NULL, the respective function does this by issuing a broadcast message on all currently configured network interfaces.

Otherwise, the former queries every IP ranging from start_ip to stop_ip, , where startIP is mandatory and stopIP is optional (one startIP address is scanned if stopIP is NULL); while the latter can walk several IP address ranges represented by a nutscan_ip_range_list_t structure.

Those IP arguments may be either IPv4 or IPv6 addresses or host names.

It waits up to usec_timeout microseconds for a response from potential devices.

You MUST call nutscan_init(3) before using this function.

Return value

The nutscan_scan_xml_http_range() function returns a pointer to a nutscan_device_t structure containing all found devices or NULL if an error occurs or no device is found.