NUTSCAN_SCAN_AVAHI(3)
=====================

NAME
----

nutscan_scan_avahi - Scan network for NUT services via mDNS

SYNOPSIS
--------

------
	#include <nut-scan.h>
	#include <unistd.h> /* useconds_t */

	nutscan_device_t * nutscan_scan_avahi(useconds_t usec_timeout);
------

DESCRIPTION
-----------

The *nutscan_scan_avahi()* function tries to detect the NUT service via
mDNS, and its associated devices. It uses the Avahi library to do so.

You MUST call linkman:nutscan_init[3] before using this function.

This function can query perspective IP addresses using NUT protocol, and
in this case it waits up to 'usec_timeout' microseconds before considering
an IP address to be unresponsive.

RETURN VALUE
------------

The *nutscan_scan_avahi()* function returns a pointer to a
`nutscan_device_t` structure containing all found devices.

It returns NULL if an error occurs, or if no device is found.

SEE ALSO
--------

linkman:nutscan_init[3],
linkman:nutscan_scan_usb[3], linkman:nutscan_scan_xml_http_range[3],
linkman:nutscan_scan_nut[3], linkman:nutscan_scan_snmp[3],
linkman:nutscan_scan_ipmi[3], linkman:nutscan_display_ups_conf[3],
linkman:nutscan_display_sanity_check[3],
linkman:nutscan_display_sanity_check_serial[3],
linkman:nutscan_display_ups_conf_with_sanity_check[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],
linkman:nutscan_scan_eaton_serial[3]

Internet resources:
~~~~~~~~~~~~~~~~~~~

http://avahi.org/
