nut-debian/docs/man/nutscan_scan_nut.txt
2012-01-24 11:22:33 +01:00

41 lines
1.5 KiB
Plaintext

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]