Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14563 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GENTEST(8)							    GENTEST(8)

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  set‐
       tings 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  sys‐
       tem  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)

								    GENTEST(8)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome