dummy-ups(8)

NAME

   dummy-ups - Driver for multi-purpose UPS emulation

NOTE

   This man page only documents the specific features of the dummy-ups
   driver. For information about the core driver, see nutupsdrv(8).

DESCRIPTION

   This program is a multi-purpose UPS emulation tool. Its behavior
   depends on the running mode:

   Dummy Mode
   dummy-ups looks like a standard device driver to upsd(8) and allows one
   to change any value for testing purposes. It is both interactive,
   controllable through the upsrw(1) and upscmd(1) commands (or equivalent
   graphical tool), and batchable through script files. It can be
   configured, launched and used as any other real driver. This mode is
   mostly useful for development and testing purposes.

   Repeater Mode
   dummy-ups acts as a NUT client, simply forwarding data. This can be
   useful for supervision purposes. This can also allow some load sharing
   between several UPS instances, using a point-to-point communication
   with the UPS.

IMPLEMENTATION

   The port specification depends on the running mode, and allows the
   driver to select the right mode.

   Dummy Mode
   Port is a definition file name for dummy-ups. This can either be an
   absolute or a relative path name. In the latter case the NUT sysconfig
   directory (ie /etc/nut, /usr/local/ups/etc, ...) is prepended.

   For instance:

       [dummy]
               driver = dummy-ups
               port = evolution500.dev
               desc = "dummy-ups in dummy mode"

   This file is generally named "something.dev". It contains a list of all
   valid data and associated values, and has the same format as an upsc(8)
   dump (<varname>: <value>). So you can easily create definition files
   from an existing UPS using "upsc > file.dev". It can also be empty, in
   which case only a basic set of data is available: device., driver.,
   ups.mfr, ups.model, ups.status

   Samples definition files are available in the "data" directory of the
   nut source tree, and generally in the sysconfig directory of your
   system distribution.

   Since dummy-ups will loop on reading this file, you can dynamically
   modify it to interact with the driver. This will avoid message spam
   into your system log files, if you are using NUT default configuration.

   You can also use the "TIMER <seconds>" instruction to create scheduled
   events sequences. For example, the following sequence will loop on
   switching ups.status between "OL", "OB" and "OB LB" every minute:

       ups.status: OL
       TIMER 60
       ups.status: OB
       TIMER 60
       ups.status: LB
       TIMER 60

   It is wise to end the script with a TIMER. Otherwise dummy-ups will
   directly go back to the beginning of the file.

   Repeater Mode
   Port is the name of a remote UPS, using the NUT form, ie:

       <upsname>[@<hostname>[:<port>]]

   For instance:

       [repeater]
                   driver = dummy-ups
                   port = ups@hostname
                   desc = "dummy-ups in repeater mode"

INTERACTION

   Once the driver is loaded in dummy mode, you can change any variables,
   except those of the driver.* and server.* collections. You can do this
   by either editing the definition file, or use the upsrw(1) and
   upscmd(1) commands.

   Note that in simulation mode, new variables can be added on the fly, by
   adding these to the definition file. Conversely, if you need to remove
   variable (such as transient ones, like ups.alarm), simply update these
   by setting an empty value. As a result, they will get removed from the
   data.

   In repeater mode, the driver acts according to the capabilities of the
   UPS, and so support the same instant commands and settable values.

BACKGROUND

   This driver was written in one evening to replace the previous
   dummycons testing driver. It was too limited and required to work from
   a terminal to interact.

   dummy-ups is useful for NUT client development, and other testing
   purpose.

   It also helps the NUT Quality Assurance effort, by automating some
   tests on the NUT framework.

   It now offers a repeater mode. This will help in building the Meta UPS
   approach, which allows one to build a virtual device, composed of
   several other devices (either UPS, PDUs).

BUGS

   Instant commands are not yet supported in Dummy Mode, and data need
   name/value checking enforcement, as well as boundaries or enumeration
   definition.

AUTHOR

   Arnaud Quette

SEE ALSO

   upscmd(1), upsrw(1), ups.conf(5), nutupsdrv(8)

   Internet Resources:
   The NUT (Network UPS Tools) home page: http://www.networkupstools.org/

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.