SYNOPSIS

       /sbin/mgeupsd [options] serial-device

DESCRIPTION

       mgeupsd is a daemon process that sits in the background and check state
       of  the  UPS  every  10 (by default) seconds. As soon as mgeupsd senses
       that the power is failing it notifies init(8) and init will execute the
       powerwait  and  powerfail entries. If mgeupsd senses that the power has
       been restored, it  notifies  init  again  and  init  will  execute  the
       powerokwait  entries. If mgeupsd senses that the UPS batteries has less
       than 20% of its energy it notifies init again and init will execute the
       powerfailnow entries.

OPTIONS

       -pwroff
              turn ups off.

       -q     same as -pwroff.

       -l     use  syslog  for  reporting.  off  by  default,  but very useful
              option.

       -i N   set UPS checking interval to N seconds. Default 10

       -li N  set to N interval for reporting battery low status.  Usually  if
              battery  low status reported init must start immediate shutdown.
              When shutdown started it must  kill  mgeupsd.   If  mgeupsd  not
              killed  during N seconds the low battery status will be reported
              again. Default 30

       -s on|off
              turn power saving mode on or off (see UPS manual for more infor-
              mation about power saving mode)

       -p on|off
              turn  total  discharge  protection on or off (see UPS manual for
              more information about  total discharge protection)

       -t trace_file
              turn on trace of  UPS<->computer  communication  protocol.   Use
              only  for  debugging  -  this  produce  a  huge  output.   Since
              trace_file stay opened all time to its remove you must kill mge-
              upsd before.

       serial-device
              Some serial port that is connected to your MGE Pulsar device.

       Since version 0.3 you may use your UPS not only for protecting the com-
       puter, powered from UPS. You may connect to computer UPS which  protect
       any  other  equipment (f.e. rack-mount modems). For this case there are
       some additional options:

              Switch (turn off/on) power. Argument W set the time  in  minutes
              to wait before turning power back to on. Argument B set the time
              in seconds to wait before turning power off. You  may  set  only
              one time (f.e. -swpwr W or -swpwr ,B or even -swpwr ,) - in this
              case unspecified time will be set  to  0.  Note  that  the  time
              before  power  off must be in seconds, but the time before power
              on - in minutes. If waiting time for turn UPS back to on set  to
              0, power will be turned off just about 5 seconds.

DIAGNOSTICS

       Just  because UPS communicate with macine through RS-232 interface mge-
       upsd report to syslog if communication  with  UPS  lost.  Mgeupsd  will
       notify  you about this fact every minute. When it sees that the connec-
       tion has been restored it will say so.

BUGS

       Well, when you found bug in this program send me E-mail about this.

SEE ALSO

       shutdown(8), init(8), inittab(5).

AUTHOR

       Stanislav Voronyi, stas@esc.kharkov.com



                                 Dec 23, 1998                       MGEUPSD(8)