Desc: How to use the dummycons driver
File: dummycons.txt
Date: 7 February 2002
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 used to require pthreads, so it was not built by default as 
it would have posed a portability problem for some users.  It has since
been redesigned, but still requires a manual build as most users will
never use it.  Run "make dummycons" in your models directory to get a
binary, then install it someplace handy.

To start it, just run "dummycons" or "dummycons <portname>".  You will
also need a section for it in your ups.conf.  For the port setting, just
use "port = /dev/<portname>", as above.  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.

Using lots of variables
-----------------------

dummycons allows you to set 64 variables by default.  If you need to go
beyond that, start it with -m <num> and it will give you more room.
