nut/docs/man/nutscan_scan_nut.txt
2011-09-29 20:14:46 +02:00

37 lines
1.4 KiB
Text

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.
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
--------
linkman:nutscan_scan_usb[3], linkman:nutscan_scan_xml_http[3],
linkman:nutscan_scan_snmp[3], linkman:nutscan_scan_avahi[3],
linkman:nutscan_scan_ipmi[3], linkman:nutscan_display_ups_conf[3],
linkman:nutscan_display_parsable[3], linkman:nutscan_new_device[3],
linkman:nutscan_free_device[3], linkman:nutscan_add_option_to_device[3],
linkman:nutscan_add_device_to_device[3], linkman:nutscan_cidr_to_ip[3]