nutscan_cidr_to_ip(3) [debian man page]

NUTSCAN_CIDR_TO_IP(3)						    NUT Manual						     NUTSCAN_CIDR_TO_IP(3)

NAME

       nutscan_cidr_to_ip - Convert a CIDR IP to a range of IP address.

SYNOPSIS

       #include <nut-scan.h>

       int nutscan_cidr_to_ip(const char * cidr, char ** start_ip, char ** stop_ip);

DESCRIPTION

       The nutscan_cidr_to_ip() function converts a range of IP address in the CIDR format given as a string in cidr, to two IPs in strings
       pointed by start_ip and stop_ip which can be used as input paramters in the scanning functions of the libnutscan API. It is the caller's
       responsability to free start_ip and stop_ip strings.

RETURN VALUE

       The nutscan_cidr_to_ip() function returns 0 if an error occured (invalid cidr address) or 1 if successful.

SEE ALSO

       nutscan_scan_usb(3), nutscan_scan_xml_http(3), nutscan_scan_nut(3), nutscan_scan_avahi(3), nutscan_scan_ipmi(3), nutscan_scan_snmp(3),
       nutscan_display_parsable(3), nutscan_display_ups_conf(3)

Network UPS Tools						    05/22/2012						     NUTSCAN_CIDR_TO_IP(3)

NUTSCAN_SCAN_NUT(3)						    NUT Manual						       NUTSCAN_SCAN_NUT(3)

NAME

       nutscan_scan_nut - Scan network for available NUT services.

SYNOPSIS

       #include <nut-scan.h>

       nutscan_device_t * nutscan_scan_nut(const char * startIP, const char * stopIP, const char * port, long usec_timeout);

DESCRIPTION

       The nutscan_scan_nut() function try to detect available NUT services and their associated devices. It issues a NUT request on every IP
       ranging from startIP to stopIP. startIP is mandatory, stopIP is optional. Those IP may be either IPv4 or IPv6 addresses or host names.

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

       A specific port number may be passed, or NULL to use the default NUT port.

       This function waits up to usec_timeout microseconds before considering an IP address does not respond to NUT queries.

RETURN VALUE

       The nutscan_scan_nut() 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.

SEE ALSO

       nutscan_init(3), nutscan_scan_usb(3), nutscan_scan_xml_http(3), nutscan_scan_snmp(3), nutscan_scan_avahi(3), nutscan_scan_ipmi(3),
       nutscan_display_ups_conf(3), nutscan_display_parsable(3), nutscan_new_device(3), nutscan_free_device(3), nutscan_add_option_to_device(3),
       nutscan_add_device_to_device(3), nutscan_cidr_to_ip(3)

Network UPS Tools						    05/22/2012						       NUTSCAN_SCAN_NUT(3)