xref: /openbsd/share/man/man4/ses.4 (revision 09467b48)
1.\"	$OpenBSD: ses.4,v 1.20 2013/07/16 16:05:49 schwarze Exp $
2.\"
3.\" Copyright (c) 2005 David Gwynne <dlg@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.Dd $Mdocdate: July 16 2013 $
17.Dt SES 4
18.Os
19.Sh NAME
20.Nm ses
21.Nd SCSI Enclosure Services
22.Sh SYNOPSIS
23.Cd "ses* at scsibus?"
24.Sh DESCRIPTION
25The
26.Nm
27driver provides support for monitoring the various environmental sensors
28present in SCSI enclosures using the SCSI Enclosure Services command set.
29The hardware monitoring is accessed via the
30.Va hw.sensors
31.Xr sysctl 8
32variable.
33.Pp
34SCSI devices have a fairly high level interface to the system and talk to it
35via a SCSI host adapter (e.g.\&
36.Xr ahc 4 ) .
37A SCSI adapter must also be separately configured into the system before a
38SCSI enclosure can be configured.
39.Pp
40When the SCSI adapter is probed during boot, the SCSI bus is scanned for
41devices.
42Any SCSI-2 devices of type
43.Dq Enclosure service
44or SCSI-3 devices of type
45.Dq Processor
46will be attached to the
47.Nm
48driver.
49.Pp
50SES compliant devices can provide an arbitrary set of sensors which may
51include the following types:
52.Bl -column "Sensor" "Units" "Typical" -offset indent
53.It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use"
54.It Li "temp" Ta "uK" Ta "temperature"
55.It Li "fan" Ta "RPM" Ta "fan"
56.It Li "psu" Ta "On/Off" Ta "power supply"
57.It Li "doorlock" Ta "On/Off" Ta "door lock"
58.It Li "alarm" Ta "On/Off" Ta "enclosure alarm"
59.El
60.Pp
61Sensor data is updated every 10 seconds.
62.Pp
63An enclosure may provide environmental information using an alternative
64command set to the SCSI Enclosure Services used by this driver.
65Enclosures using the SCSI Accessed Fault-Tolerant Enclosure command set
66may be monitored by the
67.Xr safte 4
68driver.
69.Sh SEE ALSO
70.Xr intro 4 ,
71.Xr safte 4 ,
72.Xr scsibus 4 ,
73.Xr sensorsd 8 ,
74.Xr sysctl 8
75.Sh HISTORY
76The
77.Nm
78driver first appeared in
79.Ox 3.8 .
80.Sh AUTHORS
81The
82.Nm
83driver was written by
84.An David Gwynne Aq Mt dlg@openbsd.org .
85