Poster of Linux kernelThe best gift for a Linux geek
GENTEST

GENTEST

Section: Maintenance Commands (8)
Local index Up
 

NAME

gentest - tests communication with UPS  

SYNOPSIS

/usr/sbin/gentest [ -d ] [ -r ] serial-device  

DESCRIPTION

Gentest monitors the serial port connected to a UPS and allows DTR and/or RTS lines to be stet to simulate the genpowerd UPS monitoring software.

The gentest program will show the state of the control lines in the serial connection. Its primary purpose is to help discover the settings for UPS monitoring cables.  

ARGUMENTS

Serial-Device
Some serial port that is not being used by some other device, and does not share an interrupt with any other serial port.
 

OPTIONS

gentest has the following command line options:
-d
Causes gentest to assert DTR on the serial line.
-r
Causes gentest to assert RTS on the serial line.
 

EXAMPLE

If we were to start gentest with the command line

genpower -r /dev/ttyS1


while /dev/ttyS1 was connected to a LAN Manager cable and a TrippLite BC750/LAN, gentest would display:

---------------
DTR = Cleared
RTS = Set

CAR = Low   ( )
CTS = Low   ( )
DSR = Low   ( )
RNG = Low   ( )


If the line power to the UPS were shut off, gentest would update the screen with:

---------------
DTR = Cleared
RTS = Set

CAR = Low   ( )
CTS = High  (*)
DSR = Low   ( )
RNG = Low   ( )


indicating that the CTS line had changed status and that the new status of the CTS line is HIGH.

Gentest is valuable in determining the parameters to use in genpowerd.h with unfamiliar cables and UPSs. In the example above, it could be determined that RTS probably provides power to the cable and that CTS is the line that shows changes in the line power's status (with LOW being the normal status of the line).  

WARNING

If your UPS supports an inverter shutdown, either RTS or DTR could be used to kill the inverter. Tests should not be performed if your system is using the UPS. Specifically, the use of the -r and -d options together is not recomended.  

ENVIRONMENT VARIABLES

Gentest does not use environment variables.  

FILES

None used.  

BUGS

None known.  

SEE ALSO

genpowerd(8), genwrite(8).  

AUTHORS

Tom Webster <webster@kaiwan.com> (for the program) Raphael Manfredi <Raphael_Manfredi@pobox.com> (manpage only)


 

Index

NAME
SYNOPSIS
DESCRIPTION
ARGUMENTS
OPTIONS
EXAMPLE
WARNING
ENVIRONMENT VARIABLES
FILES
BUGS
SEE ALSO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 22:01:41 GMT, April 16, 2011