Page MenuHomeFreeBSD
Differential D8911 Diff 23267 usr.sbin/sensorsd/sensorsd.8

Changeset View

Standalone View

View Options

usr.sbin/sensorsd/sensorsd.8

  • This file was added.
PropertyOld ValueNew Value
svn:eol-stylenullnative
\ No newline at end of property
svn:keywordsnullFreeBSD=%H
\ No newline at end of property
svn:mime-typenulltext/plain
\ No newline at end of property
.\" $FreeBSD$
.\" $OpenBSD: sensorsd.8,v 1.16 2007/08/11 20:45:35 cnst Exp $
.\"
.\" Copyright (c) 2003 Henning Brauer <henning@openbsd.org>
.\" Copyright (c) 2005 Matthew Gream <matthew.gream@pobox.com>
.\" Copyright (c) 2007 Constantine A. Murenin <cnst@FreeBSD.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd August 11, 2007
.Dt SENSORSD 8
.Os
.Sh NAME
.Nm sensorsd
.Nd hardware sensors monitor
.Sh SYNOPSIS
.Nm sensorsd
.Op Fl d
.Sh DESCRIPTION
The
.Nm
utility retrieves sensor monitoring data like fan speed,
temperature, voltage and
wblockUnsubmitted
Not Done
Inline Actions

Use the serial comma: s/voltage/voltage,/

wblock: Use the serial comma: s/voltage/voltage,/
.Xr ami 4
logical disk status via
.Xr sysctl 3 .
When the state of any monitored sensor changes, an alert is sent using
.Xr syslog 3
and a command, if specified, is executed.
.Pp
By default,
.Nm
monitors status changes on all sensors that keep their state,
thus sensors that automatically provide status do not require
any additional configuration.
In addition, for every sensor,
no matter whether it automatically provides its state or not,
custom low and high limits may be set,
so that a local notion of sensor status can be computed by
.Nm ,
indicating whether the sensor is within or is exceeding its limits.
wblockUnsubmitted
Not Done
Inline Actions

This is a long sentence that is not very clear:

High and low limits can be set for every sensor, regardless of whether the
sensor automatically provides a current state.
This allows a local notion of sensor status to be computed by
indicating whether the sensor is within or is exceeding the limits.

The second sentence is still somewhat unclear, the meaning of "local notion" particularly.

wblock: This is a long sentence that is not very clear: ```High and low limits can be set for every…
.Pp
Limit and command values for a particular sensor may be specified in the
wblockUnsubmitted
Not Done
Inline Actions

"may be" implies permission, "are" is probably better here.

wblock: "may be" implies permission, "are" is probably better here.
.Xr sensorsd.conf 5
configuration file.
This file is reloaded upon receiving
.Dv SIGHUP .
.Pp
The options are as follows:
wblockUnsubmitted
Not Done
Inline Actions

s/ as follows//

wblock: s/ as follows//
.Bl -tag -width Ds
.It Fl d
Do not daemonize.
If this option is specified,
.Nm
will run in the foreground.
wblockUnsubmitted
Not Done
Inline Actions

s/will run/runs/

wblock: s/will run/runs/
.El
.Sh FILES
.Bl -tag -width "/etc/sensorsd.conf"
.It /etc/sensorsd.conf
Configuration file for
.Nm .
.El
.Sh SEE ALSO
.Xr sysctl 3 ,
.Xr syslog 3 ,
.Xr sensorsd.conf 5 ,
.Xr syslogd 8
.Sh HISTORY
The
.Nm
program first appeared in
.Ox 3.5 .
.Sh CAVEATS
Certain sensors may flip status from time to time.
To guard against false reports,
.Nm
implements a state dumping mechanism.
However, this inevitably introduces
an additional delay in status reporting and command execution,
wblockUnsubmitted
Not Done
Inline Actions
an additional delay in status reporting and command execution.
This can result in sensor state not being reported until one or two minutes
after starting
.Nm .
wblock: ```an additional delay in status reporting and command execution. This can result in sensor…
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.