ses(7d) - osol9

1ses(7D)                             Devices                            ses(7D)
2
3
4

NAME

6       ses - SCSI enclosure services device driver
7

SYNOPSIS

9       ses@target,lun
10
11

DESCRIPTION

13       The   ses  device  driver  is  an  interface to SCSI enclosure services
14       devices. These devices sense and monitor the physical conditions in  an
15       enclosure  as well as allow access to the status reporting and configu‐
16       ration features of the enclosure (such as indicator LEDs on the  enclo‐
17       sure.)
18
19
20       ioctl(9E)  calls  may  be  issued  to ses to determine the state of the
21       enclosure and to set parameters on the enclosure services device.
22
23
24       No ses driver properties are defined. Use the ses.conf file to  config‐
25       ure the ses driver.
26

EXAMPLES

28       Example 1 ses.conf File Format
29
30
31       The following is an example of the ses.conf file format:
32
33
34         #
35         # Copyright (c) 1996, by Sun Microsystems, Inc.
36         # All rights reserved.
37         #
38         #
39         #ident "@(#)ses.conf 1.1    97/02/10 SMI"
40         #
41
42         name="ses" parent="sf"
43               target=15;
44
45         name="ses" parent="SUNW,pln" port=0 target=15;
46         name="ses" parent="SUNW,pln" port=1 target=15;
47         name="ses" parent="SUNW,pln" port=2 target=15;
48         name="ses" parent="SUNW,pln" port=3 target=15;
49         name="ses" parent="SUNW,pln" port=4 target=15;
50         name="ses" parent="SUNW,pln" port=5 target=15;
51
52         name="ses" class="scsi"
53               target=15 lun=0;
54
55

IOCTLS

57       The SES driver currently supports the SES, SAFTE and SEN enclosure ser‐
58       vice chipsets. SEN and SAFTE protocols are translated internally in the
59       driver  into SES compliant data structures. This enables the SES driver
60       to work seamlessly with  different protocols and eliminates the need to
61       enhance user applications.
62
63       SESIOC_GETNOBJ       Returns  an  unsigned  integer that represents the
64                            number of SES data  structures  in  the  enclosure
65                            services chip.
66
67
68       SESIOC_GETOBJMAP     Returns  a  size  array containing ses_object ele‐
69                            ments   communicated   through   SESIOC_GETNOBJ().
70                            ses_object is defined in sesio.h.
71
72
73       SESIOC_INIT          Instructs  the device to perform a self-diagnostic
74                            test. Currently SES & SEN  devices  always  return
75                            success.
76
77
78       SESIOC_GETENCSTAT    Returns an unsigned character that represents sta‐
79                            tus enclosure as defined by Table  25  in  Section
80                            7.1.2 of the SES specification NCITS 305-199x.
81
82
83       SESIOC_GETOBJSTAT    This  ioctl is passed an ses_objarg containing the
84                            obj_id you want to set, then fills in the  remain‐
85                            ing fields according to element status page of the
86                            SES specification.
87
88
89       SESIOC_SETOBJSTAT    Sets options in the control field. You set control
90                            field   options  by  filling  out  all  fields  in
91                            ses_objarg. Field  definitions  are  presented  in
92                            Section 7.2.2 of the SES specification.
93
94

FILES

96       /kernel/drv/ses.conf    Driver configuration file
97
98

ATTRIBUTES

100       See attributes(5) for descriptions of the following attributes:
101
102
103
104
105       ┌─────────────────────────────┬─────────────────────────────┐
106       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
107       ├─────────────────────────────┼─────────────────────────────┤
108       │Architecture                 │SPARC                        │
109       └─────────────────────────────┴─────────────────────────────┘
110