40 lines
1.5 KiB
Text
40 lines
1.5 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.
|
|
|
|
You MUST call linkman: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
|
|
--------
|
|
linkman:nutscan_init[3],
|
|
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]
|