|SENSORSD.CONF(5)||File Formats Manual||SENSORSD.CONF(5)|
sensorsd.conffile is read by sensorsd(8) to configure hardware sensor monitoring. Each variable in the sysctl(2) hw.sensors subtree represents a sensor. Each sensor is matched by at most one entry in
sensorsd.conf, which may specify high and low limits, and whether sensor status changes provided by the driver should be ignored. Each time the limits are crossed in either direction or the status provided by the driver changes, sensorsd(8)'s alert functionality is triggered and a command, if specified, is executed.
sensorsd.conf follows the syntax of
configuration databases as documented in
getcap(3). Sensors may be specified by
their full hw.sensors
sysctl(8) variable name or by type, with
the full name taking precedence. For example, if an entry
“hw.sensors.lm0.temp1” is not found, then an entry for
“temp” will instead be looked for.
The following attributes may be used:
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. For Boolean sensors, specify 0 for “Off” or 1 for “On”. Values for all other types of sensors can be specified in the same units as they appear under the sysctl(8) hw.sensors tree.
Sensors that provide status (such as those from bio(4), esm(4), or ipmi(4)) do not require boundary values specified and simply trigger on status transitions. If boundaries are specified nonetheless, then they are used in addition to automatic status monitoring, unless the “istatus” attribute is specified to ignore status values that are provided by the drivers.
The command is executed when there is any change in sensor state. Tokens in the command are substituted as follows:
For Boolean sensors, %2, %3, and %4 are substituted with “On” or “Off”.
By default, sensorsd(8) monitors status changes on all sensors that keep their state. This behaviour may be altered by using the “istatus” attribute to ignore status changes of sensors of a certain type or individual sensors.
# Comments are allowed hw.sensors.ipmi0.temp0:high=80C:command=/etc/sensorsd/log_warning %t %n %2 hw.sensors.lm0.volt3:low=4.8V:high=5.2V hw.sensors.lm0.fan1:low=1000 drive:command=/etc/sensorsd/drive %n timedelta:istatus #ignore status changes for timedelta
sensorsd.conffile format first appeared in OpenBSD 3.5. The format was altered in OpenBSD 4.1 to accommodate hierarchical device-based sensor addressing. The “istatus” attribute was introduced in OpenBSD 4.2. sensorsd(8) is started, the status of each monitored sensor changes from undefined to whatever it is. One must keep this in mind when using commands that may unconditionally perform adverse actions (e.g. shutdown(8)), as they will be executed even when all sensors perform to specification. If this is undesirable, then a wrapper shell script should be used instead.
|January 12, 2018||OpenBSD-current|