Provided by: nut_2.0.3-4build1_i386 bug

NAME

       upsc - example lightweight UPS client

SYNOPSIS

       upsc ups [variable]

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

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

              For example, "myups@mybox:1234" would poll a UPS called  "myups"
              on a host called "mybox", with upsd(8) running on port 1234.

       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.

DIAGNOSTICS

       upsc will either print 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/

                                Fri May  9 2003                        UPSC(8)