POWERD(8)POWERD(8)NAMEpowerd - UPS monitoring daemon
SYNOPSIS
/sbin/powerd [tty]
DESCRIPTIONpowerd monitors the serial port connected to an UPS device and will
perform an unattended shutdown of the system if the UPS is on battery
longer than a specified number of minutes. powerd needs to watch a tty
with modem control properties. Please refer to the powerd documenta‐
tion for further information.
powerd also has the capabilities of notifying other clients on the net‐
work that may have a UPS but not be connected to the serial line that
there is a power outage, and id configured through the powerd.conf file
CONFIGURATION FILE
Here is the configuration format:
Lines beginning with '#' are ignored.
MODE <mode>
specifies the mode the UPS should be in. Valid arguements are
MONITOR and PEER MONITOR being the mode to actually watch a UPS
serial port, and PEER being to listen for a connection from a
machine in MONITOR mode
MONITOR <device>
Specifies which device to monitor while in MONITOR mode. Specify
an actual device file. Example: /dev/ttyS0
POWERFAIL <line> <high|low>
Specifies which lines on the serial ports indicate that the
power is out. Valid arguements are DCD, CAR, CTS, and RNG. Also
specify if the line being HIGH or LOW indicates a power failure.
Since most people may not know this arguement, Please use the
enclosed upsdetect program to automatically find this line.
NOTIFY <hostname[:port]> <password>
Specified in MONITOR mode to notify a client running in PEER
mode. Specify the hostname of the machine, and optional port the
daemon is running on, And the password as specified by their
LISTEN command. See below for more details.
LISTEN <hostname> <password>
Specified in PEER mode, specifies a hostname that is allowed to
notify us of when the power is out, and the password they shall
give us to authenticate themselves. The 2 passwords should match
on the MONITOR mode machines NOTIFY password, and the PEER modes
LISTEN password.
LISTENPORT <port>
Specified in PEER mode, specifies the port that powerd should
listen on. If you use this arguement, powerd shall not default
to using port 532, and the machine in MONITOR mode must specify
the port you use in their NOTIFY command.
DELAY <delayinseconds>
Specifies how many seconds before notifying init of a power out‐
age. Note that this doesnt mean that the system will shut down
in that many seconds, as it depends on how init is configured.
Init usually issues a 2 min shutdown.
USER <username>
Specifies which username to drop to from root. The program will
reobtain root access only when it needs to, Like when notifying
init that the power is out. This is simply a security feature,
and not needed for powerd to operate. Note: powerd must still be
run initially as root. It will then drop to the user if, and
only if, a username is specified.
ARGUMENTS
None: Please use the configuration file /etc/powerd.conf which can be
generated with detectups. See detectups(8) for more information
FILES
/etc/powerd.conf powerd configuration file
/etc/powerstatus indicates line power status
/etc/inittab init is what actually issues the
shutdown
SEE ALSOpowerd(8), shutdown(8), wall(1), init(8), inittab(5).
AUTHOR
James Brents <James@nistix.com> (with parts of this man page borrowed
from all over the Linux community)
POWERD(8)
