upsd(1M) DG/UX R4.11MU05 upsd(1M)
NAME
upsd - uninterruptible power supply server
SYNOPSIS
upsd -d -p port [ -i interval ] [ -t timeout ]
upsd -p port [ -l ] [ -b ]
upsd [ -p port ] [ -w ]
DESCRIPTION
The upsd program is the low-level program for monitoring and
reporting the condition of uninterruptible power supply hardware.
The interface described in admups(1M) is easier to use. In
particular, upsd does not retain the value of its parameters; they
must be re-specified each time upsd is invoked.
Options
-d Daemon (server) mode. Causes upsd to fork off a child
process that monitors the UPS hardware. If a server is
already running, upsd detects this and delivers the new
values of portname, interval, and timeout (if any) to the
running server.
-p portname
Specifies to which serial port (e.g. /dev/tty00) the UPS
hardware is connected.
-i interval
Specifies that the UPS hardware is to be polled every
interval seconds. If not specified, this defaults to 30
seconds.
-t timeout
Specifies that at most timeout seconds should be allowed to
elapse between the detection of the loss of line power and
the initiation of system shutdown, even if the UPS hardware
has not yet indicated that its battery is running low. If
the value of timeout is zero, then it is treated as if it
were infinite. By default, the value of timeout is zero.
-l Line condition. Causes upsd to report the condition of
line power as either '1' (good) or '0' (failed).
-b Battery condition. Causes upsd to report the condition of
its battery as either '1' (more than roughly two minutes of
reserve), or '0'. This reflects only what the UPS hardware
reports, not whether the timeout timer has expired.
-w Waiting. Reports whether the running server is 'waiting
for a reprieve'. This condition occurs after the server
has initiated a system shutdown due to loss of line power,
and imminent loss of battery power. When in this
condition, upsd watches for the return of line power. If
line power returns before the UPS battery expires, upsd
initiates a simulated power failure (reboot) to get the
system back to the default multi-user state. This option
can be useful in determining whether certain system
shutdown operations should be accelerated in order to get
them done before the battery expires, possibly at the
expense of some tidyness.
Output
When a combination of the -l, -b, or -w options are specified, the
output consists of one line for each of these options specified, with
a single digit on each line. The lines are output in the order:
line, battery, waiting. It doesn't matter what order the options are
specified on the command line.
FILES
/var/ups/status
Holds upsd status information, and is used by upsd for
locking.
DIAGNOSTICS
Exit Codes
This section lists the possible exit codes and what they mean.
0 The operation was successful.
1 The operation failed due to access restrictions.
2 There was an error in the command line.
100 The operation was unsuccessful for some other reason.
SEE ALSO
admups(1M).
NOTES
For correct operation, UPS hardware must be connected to serial port
portname via a special cable provided by Data General. The serial
port must provide modem control. The UPS hardware must have the
relay-closure style of interface.
The UPS software should not be run on diskless workstations, i.e.
machines on which the file system containing /var/ups/ is mounted via
NFS (remotely). Such machines have no practical use for the UPS
software anyway, since the principal purpose of this software is to
protect the contents of physical disks. Such a machine may be
plugged into a UPS, and this will allow the user to continue running
in the face of power failures (assuming the host to which the
diskless workstation is connected is similarly protected), but the
UPS software should not be invoked.
Licensed material--property of copyright holder(s)