xref: /openbsd/share/man/man4/safte.4 (revision 7b36286a)
1.\"	$OpenBSD: safte.4,v 1.5 2007/05/31 19:19:51 jmc 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.\" TORTIOUS ACTION, ARISING OUT OF
15.\" PERFORMANCE OF THIS SOFTWARE.
16.Dd $Mdocdate: May 31 2007 $
17.Dt SAFTE 4
18.Os
19.Sh NAME
20.Nm safte
21.Nd SCSI Accessed Fault-Tolerant Enclosure
22.Sh SYNOPSIS
23.Cd "safte* at scsibus?"
24.Sh DESCRIPTION
25The
26.Nm
27driver provides support for monitoring the various environmental sensors
28present in SCSI enclosures using the SCSI Accessed Fault-Tolerant Enclosure
29command set.
30The hardware monitor is used with the
31.Xr sysctl 8
32interface.
33.Pp
34SAF-TE compliant devices can provide an arbitrary set of sensors from the
35following types:
36.Bl -column "Sensor" "Units" "Typical" -offset indent
37.It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use"
38.It Li "temp" Ta "uK" Ta "temperature"
39.It Li "fan" Ta "RPM" Ta "fan"
40.It Li "psu" Ta "On/Off" Ta "power supply"
41.It Li "doorlock" Ta "On/Off" Ta "door lock"
42.It Li "alarm" Ta "On/Off" Ta "enclosure alarm"
43.El
44.Pp
45Sensor data is updated every 10 seconds.
46.Pp
47An enclosure may provide environmental information using an alternative
48to the SCSI Accessed Fault-Tolerant Enclosure command set used by this driver.
49Enclosures using the SCSI Enclosure Services command set
50may be monitored by the
51.Xr ses 4
52driver.
53.Sh SEE ALSO
54.Xr intro 4 ,
55.Xr scsibus 4 ,
56.Xr ses 4 ,
57.Xr sensorsd 8 ,
58.Xr sysctl 8
59.Sh HISTORY
60The
61.Nm
62driver first appeared in
63.Ox 3.8 .
64.Sh AUTHORS
65The
66.Nm
67driver was written by
68.An David Gwynne Aq dlg@openbsd.org .
69