DragonFly On-Line Manual Pages

Search: Section:  

UPSDAEMON(8)           DragonFly System Manager's Manual          UPSDAEMON(8)


NAME

     upsdaemon - Simple Program UPS for Unix


SYNOPSIS

     upsdaemon [device]


DESCRIPTION

     The upsdaemon is a simple program to monitor os (UPS) series APC-Pro.
     When the power fail, the UpsDaemon it effects shutdown the system.

     To use the upsdaemon you must posses the qualified serial, device in
     kernel (sio).

     The device is assumed to be /dev/cuad0 by default.

     UpsDaemon: The program monitors the serial port, keeys DTR (Data Terminal
     Ready) raised and RTS (Request To Send) lowered.  When the upsdaemon sees
     the RNG high, runs the upsdaemon-alerts (powerfail warning) and reports
     failure to syslog.  If the power failure continued for 5 minutes
     (defined), the upsdaemon runs the upsdaemon-alerts (down), reports to
     syslog and makes the UPS to sleep by RTS. The power recovered within 5
     minutes, the upsdaemon runs the upsdaemon-alerts (recovery) and continues
     to monitor the serial port for another powerfilure. In case the batter
     low is observed, the upsdaemon runs the upsdaemon-alerts (emergency
     shutdown now) immediately, reports to syslog and makes the UPS to sleep.


FILES

     /usr/local/libexec/upsdaemon/upsdaemon-alerts [options]

     -battery     Power failure warning Shell: A shell-script to inform users
                  the power goes out and the system will be down soon.  It
                  generates log in: (/var/log/upsdaemon-alerts.log)

     -down        Shutdown Shell: A shell-script to shutdown the system
                  cleanly. Its generates log in:
                  (/var/log/upsdaemon-alerts.log)

     -failed      Emergency shutdown Shellt: A shell-script to execute
                  emergency halt for battery power failing.  Its generates log
                  in: (/var/log/upsdaemon-alerts.log)

     -recovery    Power recovery Shell: A shell-script to inform users the
                  power has been restored and system shutdown was canceled.
                  Its generates log in: (/var/log/upsdaemon-alerts.log)

                  Starting upsdaemon: /usr/local/etc/rc.d/upsdaemon


EXAMPLE

     The UpsDaemon is connected to the serial  port1 and  default value
     /dev/cuad0 is used.

       $ upsdaemon /dev/cuad0

     The upsdaemon port is specified to be the serial port2 /dev/cuad1 using
     command argument.

       $ upsdaemon /dev/cuad1


OTHER INFO

     Webpage for UpsDaemon is at http://www.ederbs.org/projects/upsdaemon/


SEE ALSO

     upsdaemon(8)


AUTHORS

     Ederson de Moura <ederbs@ederbs.org>

FreeBSD                          June 18, 2006                         FreeBSD

Search: Section: