summaryrefslogtreecommitdiffstats
path: root/usr.sbin
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2007-10-14 19:38:11 +0000
committerru <ru@FreeBSD.org>2007-10-14 19:38:11 +0000
commit5211e6aaa08d534e0c7a55f7e68711702bbe4d88 (patch)
treeec2c4ac42609d60853aa3b6a5f63fd6272e6a3e0 /usr.sbin
parentc687aeaf1c2e64cf4734f91823843af4763c0bfd (diff)
downloadFreeBSD-src-5211e6aaa08d534e0c7a55f7e68711702bbe4d88.zip
FreeBSD-src-5211e6aaa08d534e0c7a55f7e68711702bbe4d88.tar.gz
Fix makrup. There are still some OpenBSD-specific things
in there that need tweaking.
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/sensorsd/sensorsd.815
-rw-r--r--usr.sbin/sensorsd/sensorsd.conf.554
2 files changed, 40 insertions, 29 deletions
diff --git a/usr.sbin/sensorsd/sensorsd.8 b/usr.sbin/sensorsd/sensorsd.8
index a1f15d6..c068a42 100644
--- a/usr.sbin/sensorsd/sensorsd.8
+++ b/usr.sbin/sensorsd/sensorsd.8
@@ -1,4 +1,3 @@
-.\" $FreeBSD$
.\" $OpenBSD: sensorsd.8,v 1.16 2007/08/11 20:45:35 cnst Exp $
.\"
.\" Copyright (c) 2003 Henning Brauer <henning@openbsd.org>
@@ -17,14 +16,16 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
+.\" $FreeBSD$
+.\"
.Dd August 11, 2007
.Dt SENSORSD 8
.Os
.Sh NAME
.Nm sensorsd
-.Nd hardware sensors monitor
+.Nd "hardware sensors monitor"
.Sh SYNOPSIS
-.Nm sensorsd
+.Nm
.Op Fl d
.Sh DESCRIPTION
The
@@ -57,7 +58,7 @@ This file is reloaded upon receiving
.Dv SIGHUP .
.Pp
The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width indent
.It Fl d
Do not daemonize.
If this option is specified,
@@ -65,8 +66,8 @@ If this option is specified,
will run in the foreground.
.El
.Sh FILES
-.Bl -tag -width "/etc/sensorsd.conf"
-.It /etc/sensorsd.conf
+.Bl -tag -width ".Pa /etc/sensorsd.conf"
+.It Pa /etc/sensorsd.conf
Configuration file for
.Nm .
.El
@@ -87,7 +88,7 @@ To guard against false reports,
implements a state dumping mechanism.
However, this inevitably introduces
an additional delay in status reporting and command execution,
-e.g. one may notice that
+e.g.\& one may notice that
.Nm
makes its initial report about the state of monitored sensors
not immediately, but either 1 or 2 minutes after it is being started up.
diff --git a/usr.sbin/sensorsd/sensorsd.conf.5 b/usr.sbin/sensorsd/sensorsd.conf.5
index 96aa3d7..c48ce40 100644
--- a/usr.sbin/sensorsd/sensorsd.conf.5
+++ b/usr.sbin/sensorsd/sensorsd.conf.5
@@ -1,4 +1,3 @@
-.\" $FreeBSD$
.\" $OpenBSD: sensorsd.conf.5,v 1.18 2007/08/14 17:10:02 cnst Exp $
.\"
.\" Copyright (c) 2003 Henning Brauer <henning@openbsd.org>
@@ -17,6 +16,8 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
+.\" $FreeBSD$
+.\"
.Dd August 14, 2007
.Dt SENSORSD.CONF 5
.Os
@@ -35,11 +36,13 @@ is matched by at most one entry in
which may specify high and low limits,
and whether sensor status changes provided by the driver should be ignored.
If the limits are crossed or if the status provided by the driver changes,
-.Xr sensorsd 8 's
+.Xr sensorsd 8 Ap s
alert functionality is triggered and a command, if specified, is
executed.
.Pp
+The
.Nm
+file
follows the syntax of configuration databases as documented in
.Xr getcap 3 .
Sensors may be specified by their full
@@ -48,14 +51,14 @@ Sensors may be specified by their full
variable name or by type,
with the full name taking precedence.
For example, if an entry
-.Dq hw.sensors.lm0.temp1
+.Va hw.sensors.lm0.temp1
is not found, then an entry for
-.Dq temp
+.Dq Li temp
will instead be looked for.
.Pp
The following attributes may be used:
.Pp
-.Bl -tag -width "commandXX" -offset indent -compact
+.Bl -tag -width ".Li command" -offset indent -compact
.It Li command
Specify a command to be executed on state change.
.It Li high
@@ -85,24 +88,26 @@ and simply trigger on status transitions.
If boundaries are specified nonetheless,
then they are used in addition to automatic status monitoring,
unless the
-.Dq istatus
+.Dq Li istatus
attribute is specified to ignore status values that are provided by the drivers.
.Pp
The command is executed when there is any change in sensor state.
Tokens in the command are substituted as follows:
.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It %x
-the xname of the device the sensor sits on
-.It %t
+.Bl -tag -width indent -offset indent -compact
+.It Li %x
+the
+.Va xname
+of the device the sensor sits on
+.It Li %t
the type of sensor
-.It %n
+.It Li %n
the sensor number
-.It %2
+.It Li %2
the sensor's current value
-.It %3
+.It Li %3
the sensor's low limit
-.It %4
+.It Li %4
the sensor's high limit
.El
.Pp
@@ -110,19 +115,21 @@ By default,
.Xr sensorsd 8
monitors status changes on all sensors that keep their state.
This behaviour may be altered by using the
-.Dq istatus
+.Dq Li istatus
attribute to ignore
status changes of sensors of a certain type
or individual sensors.
.Sh FILES
-.Bl -tag -width "/etc/sensorsd.conf"
-.It /etc/sensorsd.conf
+.Bl -tag -width ".Pa /etc/sensorsd.conf"
+.It Pa /etc/sensorsd.conf
Configuration file for
.Xr sensorsd 8 .
.El
.Sh EXAMPLES
In the following configuration file,
-if hw.sensors.ipmi0.temp0 transitions 80C or
+if
+.Va hw.sensors.ipmi0.temp0
+transitions 80C or
if its status as provided by
.Xr ipmi 4
changes, the command
@@ -130,13 +137,16 @@ changes, the command
will be executed,
with the sensor type, number and current value passed to it.
Alerts will be sent
-if hw.sensors.lm0.volt3 transitions to being within or outside
+if
+.Va hw.sensors.lm0.volt3
+transitions to being within or outside
a range of 4.8V and 5.2V;
-if the speed of the fan attached to hw.sensors.lm0.fan1
+if the speed of the fan attached to
+.Va hw.sensors.lm0.fan1
transitions to being below or above 1000RPM;
if any RAID volume drive
changes its status from, for example,
-.Dq OK ,
+.Dq Li OK ,
such as in the case of drive failure, rebuild, or a complete failure,
the command
.Pa /etc/sensorsd/drive
@@ -169,7 +179,7 @@ The format was altered in
.Ox 4.1
to accommodate hierarchical device-based sensor addressing.
The
-.Dq istatus
+.Dq Li istatus
attribute was introduced in
.Ox 4.2 .
.Sh CAVEATS
OpenPOWER on IntegriCloud