wmnut(1) [debian man page]

WMNUT(1)						      General Commands Manual							  WMNUT(1)

NAME

       WMNUT - Dockable UPS Monitor

SYNOPSIS

       wmnut [-A T1 T2] [-b BlinkRate] [-B BeepVolume] [-C CriticalLevel] [-d display] [-h] [-l] [-L LowLevel] [-U upsname] [-v] [-V] [-w]

DESCRIPTION

       WMNUT is an UPS Monitor. It is used to visually display and interpret details of up to 9 UPSs status via NUT - Network UPS Tools framework.

       WMNUT  is  dockable  using WindowMaker and AfterStep window-managers; under other window-managers, WMNUT should be used with "-w" option to
       appear as a nicely-sized 64x64 application with a background.

       WMNUT provides the following information:

       - Status of power supply (Blinking Red/Yellow/Green colored meter/battery),

       - Percentage of battery remaining (numeric and meter),

       - Load level percentage on output (numeric, if available),

       - Runtime to empty, ie time left to battery depletion (MM:SS),

       - Communication status with UPS (Blinking Red/Green "C").

OPTIONS

       -A <T1 T2>
	      Send messages to users terminals when Low and critical.  T1 is seconds between messages when Low.  T2 is	seconds  between  messages
	      when Critical.

       -b <BlinkRate>
	      Blink rate for red LED. (0 for no blinking.)

       -B <Volume>
	      Beep at Critical Level. Volume is between -100% to 100%. This function has been disabled, at least temporarily.

       -C <CriticalLevel>
	      Define level at which red LED turns on.

       -d <display>
	      Use alternate display.

       -h     Display help screen.

       -l     Use a low-color pixmap to conserve colors on 8-bit displays.

       -L <LowLevel>
	      Define level at which yellow LED turns on.  CriticalLevel takes precedence if LowLevel<CriticalLevel.

       -U <upsname>
	      Define upsname ([upsname@]hostname, default is localhost).  You can use up to 9 call to -U <upsname> to monitor multiple UPSs.

       -v     Print version (includes important WMNUT info).

       -V     Verbose mode : display NUT available feature and base value.

       -w     Windowed mode (opposite to native withdrawn mode for Window Maker).

BUGS

       None are known

AUTHOR

       Arnaud Quette <arnaud.quette@free.fr>

								   01 June 2012 							  WMNUT(1)

UPSC(8) 							    NUT Manual								   UPSC(8)

NAME

       upsc - example lightweight UPS client

SYNOPSIS

       upsc -l | -L [host]

       upsc ups [variable]

       upsc -c ups

DESCRIPTION

       upsc is provided as a quick way to poll the status of a UPS server. It can be used inside shell scripts and other programs that need UPS
       data but don't want to include the full interface.

OPTIONS

       -l host
	   List all UPS names configured at host, one name per line. The hostname defaults to "localhost". You may optionally add a colon and a
	   port number.

       -L host
	   As above, list all UPS names configured at host, including their description provided by the remote upsd(8) from ups.conf(5). The
	   hostname defaults to "localhost". You may optionally add a colon and a port number to override the default port.

       -c ups
	   Lists each client connected on ups, one name per line.

       ups
	   Display the status of that UPS. The format for this option is upsname[@hostname[:port]]. The default hostname is "localhost".

       variable
	   Display the value of this variable only. By default, upsc retrieves the list of variables from the server and then displays the value
	   for each. This may be useful in shell scripts to save an additional pipe into grep.

EXAMPLES

       To list all variables on an UPS named "myups" on a host called "mybox", with upsd(8) running on port 1234:

	   $ upsc myups@mybox:1234
	   battery.charge: 100.0
	   battery.voltage: 13.9
	   battery.voltage.nominal: 13.6
	   . . .

       To list the UPSes configured on this system, along with their descriptions:

	   $ upsc -L
	   apc: Back-UPS 500
	   ppro2: Patriot Pro II

       To retrieve the status for all UPSes connected to mybox, using Bourne-shell syntax:

	   $ for UPS in `upsc -l mybox:1234`; do
	       upsc $UPS ups.status
	   done

       To list clients connected on "myups":

	   $ upsc -c myups
	   127.0.0.1
	   ::1
	   192.168.1.2

DIAGNOSTICS

       upsc will either print a list of UPS names, a list of all supported variables and their values on the UPS, or an error message. If you
       receive an error, make sure you have specified a valid UPS on the command line, that upsd(8) is really running on the other host and that
       no firewalls are blocking you.

HISTORY

       Earlier versions of this program used the upsfetch library and UDP sockets to talk to upsd. This version of upsc uses the new upsclient
       library, which only talks TCP. This is why upsct no longer exists.

SEE ALSO

       upsd(8)

INTERNET RESOURCES

       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/

Network UPS Tools						    05/21/2012								   UPSC(8)