APCD(8)                     System Manager's Manual                    APCD(8)

       apcd - daemon for APC SmartUPS support

       /usr/sbin/apcd {--version , -v}

       apcd can be used for controlling the APC SmartUPS. After the power
       failure, apcd will inform the users about the power failure once per
       minute. When the power is restored during user defined timeout, apcd
       will inform users about this fact. If power is not restored, the system
       shutdown will follow when the timeout expires. The whole shutdown is
       made inside the apcd , so no changes in the inittab are necessary.
       There is no communication between apcd and init(1) process.

       apcd daemon also supports the networking mode. In this mode, one
       machine is configured as a master, with UPS attached to the serial
       port. Other machines (max. 10) are configured as a slaves. Master has a
       network connection with slaves and send them informations about
       timeouts, power restore etc. The master machine is also logging the UPS
       status informations to the text file.

       The apcd must be run as root!

       If you uses the --version or -v parameter, apcd prints the version
       infromation and exits.

       If you send SIGUSR1 signal to apcd , it will dump status into

       Firstly, you will need the cable between APC Smart UPS and PC computer
       running Linux. You can use either the special cable which is enclosed
       with the PowerChute (TM) software or you can make your own cable
       connected as follows:

            PC (9 pin)     APC (9 pin)
            2 RxD          2
            3 TxD          1
            5 GND          9

       Further, it is necessary to write configuration info to the file

       This file is a plain ASCII file and you can use your favorite editor
       for configuration. For simple configuration, see enclosed sample file.

       Configuration commands in /etc/apcd.conf are:

       PORT - for Master machine. Please specify which device is used for UPS
       communication. The default is /dev/ups.

       NOTEST - for Master machine. Skip the beep and the led test when apcd

       TIMEOUT - for Master machine. This is the timeout between power failure
       and system shutdown. The default is 10 minutes for the master and 9
       minutes for slaves.  The timeout for slaves is always one minute less
       than master timeout.

       LOGFILENAME - for Master machine. The name of the file for logging of
       UPS statistics.

       SLAVE - for Master machine. The name of the slave machine attached to
       the master.  There can be max. 10 slaves attached to one master.

       MASTER - for Slave machine. The name of the master which is authorised
       to send commands to this slave

       Error and information messages are logged to the syslog daemon.

       /etc/apcd.conf - configuration file
       /var/adm/upsstat.log - the UPS status is logged in this file. The file
       name can be configured in /etc/apcd.conf

       upsstat.log - FILE FORMAT

       upsstat.log is a simple ascii file with several floating point numbers
       on one line. The format of the line is:

       BatteryLoad LineMin LineMax UPSLoad LineFreq LineVoltage OutputVoltage
       UPSTemp BattVoltage

       Pavel Korensky <pavelk@dator3.anet.cz>

       Bug fixes by Tibor Koleszar <oldw@debian.org>

                             APCD 0.6 - 02.01.2000                     APCD(8)