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