Devices                                                   ses(7D)



NAME
     ses - SCSI enclosure services device driver

SYNOPSIS
     ses@target,lun


DESCRIPTION
     The  ses device driver is an  interface  to  SCSI  enclosure
     services devices. These devices sense and monitor the physi-
     cal conditions in an enclosure as well as  allow  access  to
     the  status  reporting  and  configuration  features  of the
     enclosure (such as indicator LEDs on the enclosure.)


     ioctl(9E) calls may be issued to ses to determine the  state
     of the enclosure and to set parameters on the enclosure ser-
     vices device.


     No ses driver properties are defined. Use the ses.conf  file
     to configure the ses driver.

EXAMPLES
     Example 1 ses.conf File Format


     The following is an example of the ses.conf file format:


       #
       # Copyright (c) 1996, by Sun Microsystems, Inc.
       # All rights reserved.
       #
       #
       #ident "@(#)ses.conf 1.1    97/02/10 SMI"
       #

       name="ses" parent="sf"
             target=15;

       name="ses" parent="SUNW,pln" port=0 target=15;
       name="ses" parent="SUNW,pln" port=1 target=15;
       name="ses" parent="SUNW,pln" port=2 target=15;
       name="ses" parent="SUNW,pln" port=3 target=15;
       name="ses" parent="SUNW,pln" port=4 target=15;
       name="ses" parent="SUNW,pln" port=5 target=15;

       name="ses" class="scsi"
             target=15 lun=0;





SunOS 5.11          Last change: 27 May 2008                    1






Devices                                                   ses(7D)



IOCTLS
     The SES driver currently supports the  SES,  SAFTE  and  SEN
     enclosure  service  chipsets.  SEN  and  SAFTE protocols are
     translated internally in the driver into SES compliant  data
     structures.  This  enables the SES driver to work seamlessly
     with  different protocols and eliminates the need to enhance
     user applications.

     SESIOCGETNOBJ       Returns  an   unsigned   integer   that
                          represents   the  number  of  SES  data
                          structures in  the  enclosure  services
                          chip.


     SESIOCGETOBJMAP     Returns   a   size   array   containing
                          sesobject     elements    communicated
                          through SESIOCGETNOBJ(). sesobject is
                          defined in sesio.h.


     SESIOCINIT          Instructs  the  device  to  perform   a
                          self-diagnostic  test.  Currently SES &
                          SEN devices always return success.


     SESIOCGETENCSTAT    Returns  an  unsigned  character   that
                          represents  status enclosure as defined
                          by Table 25 in Section 7.1.2 of the SES
                          specification NCITS 305-199x.


     SESIOCGETOBJSTAT    This ioctl is passed an sesobjarg con-
                          taining  the  objid  you  want to set,
                          then  fills  in  the  remaining  fields
                          according to element status page of the
                          SES specification.


     SESIOCSETOBJSTAT    Sets options in the control field.  You
                          set  control  field  options by filling
                          out all  fields  in  sesobjarg.  Field
                          definitions  are  presented  in Section
                          7.2.2 of the SES specification.


FILES
     /kernel/drv/ses.conf    Driver configuration file


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



SunOS 5.11          Last change: 27 May 2008                    2






Devices                                                   ses(7D)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SPARC                       
    


SEE ALSO
     driver.conf(4), scsi(4),  attributes(5),  esp(7D),  isp(7D),
     ioctl(9E)













































SunOS 5.11          Last change: 27 May 2008                    3