NAME    [Toc]    [Back]

     ses - SCSI Environmental Services Driver

SYNOPSIS    [Toc]    [Back]

     ses* at scsibus? target ? lun ?

DESCRIPTION    [Toc]    [Back]

     The ses driver provides support for all SCSI devices of  the
environmental
     services  class  that  are  attached to the system through a
supported SCSI
     Host Adapter, as well as emulated support for  SAF-TE  (SCSI
Accessible
     Fault  Tolerant  Enclosures).   The  environmental  services
class generally
     are enclosure devices that provide environmental information
such as number
  of  power  supplies  (and  state),  temperature, device
slots, and so on.

     A SCSI Host adapter must also be separately configured  into
the system
     before  a  SCSI Environmental Services device can be configured.

IOCTLS    [Toc]    [Back]

     The following ioctl(2) calls apply to SES devices.  They are
defined in
     the header file <scsi/ses.h>.

     SESIOC_GETNOBJ     Used to find out how many SES objects are
driven by
                        this particular device instance.

     SESIOC_GETOBJMAP   Read, from the kernel, an  array  of  SES
objects which
                        contains  the  object  identifier,  which
subenclosure it
                        is in, and the SES type of the object.

     SESIOC_GETENCSTAT  Get the overall enclosure status.

     SESIOC_SETENCSTAT  Set the overall enclosure status.

     SESIOC_GETOBJSTAT  Get the status of a particular object.

     SESIOC_SETOBJSTAT  Set the status of a particular object.

     SESIOC_GETTEXT     Get the associated help text for  an  object (not yet
                        implemented).  SES devices often have descriptive text
                        for an object which can provide  information such as
                        location (e.g. "power supply left").

     SESIOC_INIT        Initialize the enclosure.

FILES    [Toc]    [Back]

     /dev/sesN   The Nth SES device.

DIAGNOSTICS    [Toc]    [Back]

     When  the kernel is configured with DEBUG enabled, the first
open to an
     SES device will spit out overall enclosure parameters to the
console.

SEE ALSO    [Toc]    [Back]

     intro(4),  scsi(4),  getencstat(8),  sesd(8), setencstat(8),
setobjstat(8)

HISTORY    [Toc]    [Back]

     The ses driver was written for the SCSI subsystem by Matthew
Jacob.  This
     is  the  functional equivalent of a similar driver available
in Solaris,
     Release 7.

OpenBSD     3.6                        February     22,      2000