redhat man page for snmp-ups

snmp-ups(8)						      Network UPS Tools (NUT)						       snmp-ups(8)

NAME
       snmp-ups - Driver for RFC 1628 SNMP UPS equipment

NOTE
       This  man  page	only  documents the hardware-specific features of the snmp-ups driver.	For information about the core driver, see nutups-
       drv(8).

SUPPORTED HARDWARE
       Any UPS that is RFC 1628 (UPS MIB) compliant.

EXPERIMENTAL DRIVER
       This driver has been tagged experimental and is not built by default.

REQUIREMENTS
       This driver needs UCD SNMP, aka Net-SNMP installed to compile successfully.  See http://www.net-snmp.org/ for more information.

       On Red Hat 7.2, these packages are required:

	    ucd-snmp-devel-4.2.3-1, ucd-snmp-4.2.3-1, ucd-snmp-utils-4.2.3-1

       You must install SNMP-UPS-MIB.txt in your MIBs directory - typically /usr/share/snmp/mibs/, but it may vary from system to system.  You can
       generate this from chapter 4 of RFC 1628 (see http://www.faqs.org).

EXTRA ARGUMENTS
       This driver supports the following optional settings in the ups.conf(5):

       community=name
	      Set community name (default = public)

       snmp_version=version
	      Set SNMP version (default = v1, the other allowed value is v2c)

INSTALLATION
       This driver is not built by default.  You can build it by using "configure --with-drivers=snmp-ups" before calling make.

IMPLEMENTATION
       The hostname of the UPS is specified with the "port" value in ups.conf, i.e.:

	    [snmp]
		 driver = snmp-ups
		 port = snmp-ups.example.com
		 community = public
		 snmp_version = v1

SUPPORTED VARIABLES
	    INFO_MFR  UPS Manufacturer
	    INFO_MODEL	   UPS Model
	    INFO_FIRMREV   Firmware/Software Version
	    INFO_STATUS    OFF, OL, OB, BOOST, TRIM
	    INFO_BATTPCT   Battery percentage
	    INFO_RUNTIME   Predicted runtime on battery
	    INFO_BATTVOLT  Battery Voltage
	    INFO_OUTVOLT   Output Voltage

PLANNED SUPPORT
	    INFO_UTILITY   Input Voltage
	    INFO_ACFREQ    AC Frequency
	    INFO_UPSTEM    UPS Temperature
	    INFO_LOADPCT   Load Percentage
	    CMD_?	   Not determined

AUTHORS
       Arnaud Quette, Hans Ekkehard Plesser

SEE ALSO
   The core driver:
       nutupsdrv(8)

   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/

       NUT mailing list archives and information: http://lists.exploits.org/

								  Tue Oct 22 2002						       snmp-ups(8)