Desc: Network protocol info
File: protocol.txt
Date: 2 May 1999

Here's a quick description of how the network protocol works...

First, it is UDP based and uses English words to perform operations.  It  
is not case sensitive, but the examples here will be all uppercase to
clearly show what is being sent and received.

LISTVARS
========

Form: LISTVARS

Returns: VARS <varlist>

<varlist> is a space delimited list of all possible variables that
the server process knows about for this UPS.

REQ
===

Form: REQ <varname>

<varname> is a variable name returned by LISTVARS

Returns: ANS <varname> <value>

<varname> is the variable you requested, repeated just to be sure

<value> is the current value as the server knows it, or a special meaning:

NOT-SUPPORTED: this UPS model doesn't gather data for this variable
   DATA-STALE: the server hasn't gotten an update for this data recently

Other commands
==============

HELP - lists the commands supported by this server
VER  - shows the version of the server currently in use

These two are not intended to be used directly by programs.  Humans can
make use of this program by using netcat in UDP mode.  Try something like
'nc -u localhost 3305' and it should talk to you.
