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   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

UPSDAEMON(8)		  BSD 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 ker‐
     nel (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 shut‐
     down 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 emer‐
		  gency 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

Vote for polarhome