Desc: How to use the dummycons driver
File: dummycons.txt
Date: 19 October 2001
Auth: Russell Kroll <rkroll@exploits.org>

Like the dummyups driver, dummycons is provided for testing purposes.  It
is probably a bit more useful than dummyups, as it does not require X and
allows you to set any value in any variable that is currently supported by
the software.

dummycons is not built by default since it needs pthreads and probably
isn't very portable as a result.  Run "make dummycons" in your models 
directory to get a binary, and install it someplace handy.

To start it, just run "dummycons" or "dummycons <portname>".  Then add
"port = /dev/<portname>" to your ups.conf.  If you don't specify a
port, it'll use "null", so just put "port = /dev/null" in there.

This driver may have to be started as root depending on your system's
configuration.  If you are using the "security domains" approach from the
FAQ, you will probably need to do the same "su user -c ..." to get it
running properly.

You can run multiple instances of dummycons if needed.  Just use a
different portname argument.

Interacting with dummycons
--------------------------

By default, you get 3 variables setup for you by the driver:

	INFO_MFR (Manufacturer)                            = Console testing
	INFO_MODEL (Model)                                 = Dummy UPS
	INFO_STATUS (Status)                               = OL

If you need more, just (a)dd one.  To change the value of an existing
variable, (s)et it to something else.  To see what's currently being
defined, use the (l)ist command.  If you want to see all of the possible
variables that can be used in this version of the software, bring up
the master (L)ist.
