GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NUTSCAN (3)

.ds Aq ’

NAME

nutscan - Network UPS Tools (NUT) device discovery library

CONTENTS

DESCRIPTION

The Network UPS Tools (NUT) nutscan library provides the same discovery related features that are also offered by nut-scanner(8).

It enables the discovery of supported NUT devices (USB, SNMP, Eaton XML/HTTP and IPMI) and NUT servers (using Avahi, or the classic connection method).

DISCOVERY FUNCTIONS

First, include the required header file:

#include <nut-scan.h>

Then, to discover new devices, use the appropriate function:

o

o nutscan_scan_usb(3) for supported USB devices,

o

o nutscan_scan_snmp(3) for supported SNMP agents,

o

o nutscan_scan_xml_http(3) for Eaton Network Management Card,

o

o nutscan_scan_nut(3) for NUT servers (upsd), using the classic method,

o

o nutscan_scan_avahi(3) for NUT servers (upsd), using the mDNS (Avahi) method,

o

o nutscan_scan_ipmi(3) for supported IPMI PSU.

All of these functions return a list of devices found, using the nutscan_device_t structure. This structure is described in nutscan_add_device_to_device(3).

Helper functions are also provided to output data using standard formats:

o

o nutscan_display_parsable(3) for parsable output,

o

o nutscan_display_ups_conf(3) for ups.conf style.

ERROR HANDLING

There is currently no specific mechanism for error handling.

SEE ALSO

nut-scanner(8), nutscan_scan_usb(3), nutscan_scan_snmp(3), nutscan_scan_xml_http(3), nutscan_scan_nut(3), nutscan_scan_avahi(3), nutscan_scan_ipmi(3), nutscan_display_parsable(3), nutscan_display_ups_conf(3), nutscan_new_device(3), nutscan_free_device(3), nutscan_add_device_to_device(3), nutscan_add_option_to_device(3), nutscan_cidr_to_ip(3), http://avahi.org/

Search for    or go to Top of page |  Section 3 |  Main Index


Network UPS Tools 2&.7&.3&. NUTSCAN (3) 03/02/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.