1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
|
.TH DUMMY-UPS 8 "Sat Jul 02 2005" "" "Network UPS Tools (NUT)"
.SH NAME
dummy-ups \- Driver for testing UPS software
.SH SYNOPSIS
.B dummy-ups [\fIport\fB]
.SH DESCRIPTION
This program looks like a standard UPS driver to \fBupsd\fR(8) and
allows you to set any value for testing purposes. It is interactive,
through upsrw command or equivalent graphical tool. It can be
configured, launch and used as any other real driver.
.SH ARGUMENTS
The port specify a definition file name for dummy-ups. This can either
be an absolute or a relative path name. In the latter case the NUT
"etc" directory (ie /etc/nut, /usr/local/ups/etc, ...) is prepended.
This file, generally named something.dev, contains a list of all
valid data and associated values, and has the same format as an upsc
dump (<varname>: <value>), so you can easilly create definition
files from existing UPS.
With no arguments, dummy-ups will assume a port name of "null", and
will preload the following data:
.nf
driver.name = dummy-ups
driver.version = (varies)
driver.version.internal = (varies)
ups.mfr = Dummy Manufacturer
ups.model = Dummy UPS
ups.status = OL
.fi
You can also add an entry in \fBups.conf\fR(5), and run multiple
instances if needed.
.SH INTERACTION
Once the driver is loaded, you can set any variables, except those
of the driver.* and server.* collections.
.SH BACKGROUND
This driver was written in an evening to replace the previous
dummycons which required to work from a terminal to interact.
It is useful for NUT client development, and other testing purpose.
.SH BUGS
Instant commands are not yet supported, and data need value checking
enforcement, as well as boundaries or enumeration definition.
.SH AUTHOR
Arnaud Quette
.SH SEE ALSO
\fBups.conf\fR(5)
\fBnutupsdrv\fR(8)
.SS Internet resources:
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|