SENSORSD.CONF(5)          OpenBSD Programmer's Manual         SENSORSD.CONF(5)

NAME
     sensorsd.conf - configuration file for sensorsd

SYNOPSIS
     sensorsd.conf

DESCRIPTION
     The sensorsd.conf file is read by sensorsd(8) to configure hardware sen-
     sor monitoring.  Each entry represents one sensor and may specify high
     and low limits.  If the limits are crossed, sensorsd(8)'s alert function-
     ality is triggered and a command, if specified, is executed.

     sensorsd.conf follows the syntax of configuration databases as documented
     in getcap(3).  The following attributes may be used:

           command    Specify a command to be executed if limits are crossed.
           high       Specify an upper limit.
           low        Specify a lower limit.

     The values for temperature sensors can be given in degrees Celsius or
     Fahrenheit, for voltage sensors in volts, and fan speed sensors take a
     unit-less number representing RPM.

     Sensors that provide status (such as from bio(4), esm(4), or ipmi(4)) do
     not require boundary values specified (that otherwise will be ignored)
     and simply trigger on status transitions.

     The command is executed on transitions out of, and back into, given lim-
     its.  Tokens in the command are substituted as follows:

           %1      the sensor number
           %2      the sensor's current value
           %3      the sensor's low limit
           %4      the sensor's high limit

FILES
     /etc/sensorsd.conf  Configuration file for sensorsd(8).

EXAMPLES
     In the following configuration file, if hw.sensors.0 goes above 80C, the
     command /etc/sensorsd/log_warning will be executed, with the sensor num-
     ber and current value passed to it.  Alerts will be sent if hw.sensors.1
     goes above 170F; if hw.sensors.2 goes below 4.8V or above 5.2V; if the
     speed of the fan attached to hw.sensors.3 goes below 1000RPM or above
     8000RPM; or if hw.sensors.4, attached to raid volume sd0, goes into a
     state other than ``OK'', such as drive failure, rebuild, or a complete
     failure.

           # Comments are allowed
           hw.sensors.0:high=80C:command=/etc/sensorsd/log_warning %1 %2
           hw.sensors.1:high=170F
           hw.sensors.2:low=4.8V:high=5.2V
           hw.sensors.3:low=1000:high=8000
           hw.sensors.4:           # raid volume status changes

SEE ALSO
     getcap(3), bio(4), esm(4), ipmi(4), sensorsd(8), sysctl(8)

HISTORY
     The sensorsd.conf file format first appeared in OpenBSD 3.5.

OpenBSD 4.0                     March 15, 2005                               1
