Merge tag 'gpio-v4.17-1' of git://git.kernel.org/pub/scm/linux/kernel/git/linusw...
[sfrench/cifs-2.6.git] / Documentation / ABI / testing / sysfs-devices-platform-ipmi
1 What:           /sys/devices/platform/ipmi_bmc.*/firmware_revision
2 Date:           Mar, 2006
3 KernelVersion:  v2.6.17
4 Contact:        openipmi-developer@lists.sourceforge.net
5 Description:
6                 (RO) The major and minor revision of the firmware.
7
8
9 What:           /sys/devices/platform/ipmi_bmc.*/aux_firmware_revision
10 Date:           Mar, 2006
11 KernelVersion:  v2.6.17
12 Contact:        openipmi-developer@lists.sourceforge.net
13 Description:
14                 (RO) Holds additional information about the firmware revision,
15                 such as boot block or internal data structure version numbers.
16                 The meanings of the numbers are specific to the vendor
17                 identified by Manufacturer ID.
18
19
20 What:           /sys/devices/platform/ipmi_bmc.*/revision
21 Date:           Mar, 2006
22 KernelVersion:  v2.6.17
23 Contact:        openipmi-developer@lists.sourceforge.net
24 Description:
25                 (RO) Device revision. Useful for identifying if significant
26                 hardware changes have been made to the implementation of the
27                 management controller.
28
29
30 What:           /sys/devices/platform/ipmi_bmc.*/provides_device_sdrs
31 Date:           Mar, 2006
32 KernelVersion:  v2.6.17
33 Contact:        openipmi-developer@lists.sourceforge.net
34 Description:
35                 (RO) Indicates whether device provides device sensor data
36                 records (1) or not (0).
37
38
39 What:           /sys/devices/platform/ipmi_bmc.*/device_id
40 Date:           Mar, 2006
41 KernelVersion:  v2.6.17
42 Contact:        openipmi-developer@lists.sourceforge.net
43 Description:
44                 (RO) Device id is specified by the manufacturer identified by
45                 the Manufacturer ID field. This field allows controller specific
46                 software to identify the unique application command, OEM
47                 fields, and functionality that are provided by the controller
48
49
50 What:           /sys/devices/platform/ipmi_bmc.*/additional_device_support
51 Date:           Mar, 2006
52 KernelVersion:  v2.6.17
53 Contact:        openipmi-developer@lists.sourceforge.net
54 Description:
55                 (RO) Lists the IPMI ‘logical device’ commands and functions
56                 that the controller supports that are in addition to the
57                 mandatory IPM and Application commands.
58
59
60 What:           /sys/devices/platform/ipmi_bmc.*/ipmi_version
61 Date:           Mar, 2006
62 KernelVersion:  v2.6.17
63 Contact:        openipmi-developer@lists.sourceforge.net
64 Description:
65                 (RO) Displays the IPMI Command Specification Version.
66
67
68 What:           /sys/devices/platform/ipmi_bmc.*/manufacturer_id
69 Date:           Mar, 2006
70 KernelVersion:  v2.6.17
71 Contact:        openipmi-developer@lists.sourceforge.net
72 Description:
73                 (RO) Identifies the manufacturer responsible for the
74                 specification of functionality of the vendor (OEM)-specific
75                 commands, codes, and interfaces used in the controller.
76
77
78 What:           /sys/devices/platform/ipmi_bmc.*/product_id
79 Date:           Mar, 2006
80 KernelVersion:  v2.6.17
81 Contact:        openipmi-developer@lists.sourceforge.net
82 Description:
83                 (RO) Displays a number that identifies a particular system,
84                 module, add-in card, or board set. The number is specified
85                 according to the manufacturer given by Manufacturer ID.
86
87 For detailed definitions of the above attributes, refer to section 20.1 'Get
88 Device ID Command' of the IPMI specification v2.0.
89
90
91 What:           /sys/devices/platform/ipmi_bmc.*/guid
92 Date:           Mar, 2006
93 KernelVersion:  v2.6.17
94 Contact:        openipmi-developer@lists.sourceforge.net
95 Description:
96                 (RO) A GUID (Globally Unique ID), also referred to as a UUID
97                 (Universally Unique Identifier), for the management controller,
98                 as described in section 20.8 'Get Device GUID Command' of the
99                 IPMI specification v2.0.
100
101
102 What:           /sys/devices/platform/ipmi_si.*/type
103 Date:           Sep, 2017
104 KernelVersion:  v4.15
105 Contact:        openipmi-developer@lists.sourceforge.net
106 Description:
107                 (RO) The device interface for IPMI "kcs", "smic", "bt" or
108                 "invalid"
109
110 What:           /sys/devices/platform/ipmi_si.*/idles
111 What:           /sys/devices/platform/ipmi_si.*/watchdog_pretimeouts
112 What:           /sys/devices/platform/ipmi_si.*/complete_transactions
113 What:           /sys/devices/platform/ipmi_si.*/events
114 What:           /sys/devices/platform/ipmi_si.*/interrupts
115 What:           /sys/devices/platform/ipmi_si.*/hosed_count
116 What:           /sys/devices/platform/ipmi_si.*/long_timeouts
117 What:           /sys/devices/platform/ipmi_si.*/flag_fetches
118 What:           /sys/devices/platform/ipmi_si.*/attentions
119 What:           /sys/devices/platform/ipmi_si.*/incoming_messages
120 What:           /sys/devices/platform/ipmi_si.*/short_timeouts
121 Date:           Sep, 2017
122 KernelVersion:  v4.15
123 Contact:        openipmi-developer@lists.sourceforge.net
124 Description:
125
126                 idles:                  (RO) Number of times the interface was
127                                         idle while being polled.
128
129                 watchdog_pretimeouts:   (RO) Number of watchdog pretimeouts.
130
131                 complete_transactions:  (RO) Number of completed messages.
132
133                 events:                 (RO) Number of IPMI events received from
134                                         the hardware.
135
136                 interrupts:             (RO) Number of interrupts the driver
137                                         handled.
138
139                 hosed_count:            (RO) Number of times the hardware didn't
140                                         follow the state machine.
141
142                 long_timeouts:          (RO) Number of times the driver
143                                         requested a timer while nothing was in
144                                         progress.
145
146                 flag_fetches:           (RO) Number of times the driver
147                                         requested flags from the hardware.
148
149                 attentions:             (RO) Number of time the driver got an
150                                         ATTN from the hardware.
151
152                 incoming_messages:      (RO) Number of asynchronous messages
153                                         received.
154
155                 short_timeouts:         (RO) Number of times the driver
156                                         requested a timer while an operation was
157                                         in progress.
158
159
160 What:           /sys/devices/platform/ipmi_si.*/interrupts_enabled
161 Date:           Sep, 2017
162 KernelVersion:  v4.15
163 Contact:        openipmi-developer@lists.sourceforge.net
164 Description:
165                 (RO) Indicates whether interrupts are enabled or not. The driver
166                 disables interrupts when it gets into a situation where it
167                 cannot handle messages due to lack of memory. Once that
168                 situation clears up, it will re-enable interrupts.
169
170
171 What:           /sys/devices/platform/ipmi_si.*/params
172 Date:           Sep, 2017
173 KernelVersion:  v4.15
174 Contact:        openipmi-developer@lists.sourceforge.net
175 Description:
176                 [to be documented]
177
178
179 What:           /sys/devices/platform/dmi-ipmi-ssif.*/type
180 Date:           Sep, 2017
181 KernelVersion:  v4.15
182 Contact:        openipmi-developer@lists.sourceforge.net
183 Description:
184                 (RO) Shows the IMPI device interface type - "ssif" here.
185
186
187 What:           /sys/devices/platform/dmi-ipmi-ssif.*/hosed
188 What:           /sys/devices/platform/dmi-ipmi-ssif.*/alerts
189 What:           /sys/devices/platform/dmi-ipmi-ssif.*/sent_messages
190 What:           /sys/devices/platform/dmi-ipmi-ssif.*/sent_messages_parts
191 What:           /sys/devices/platform/dmi-ipmi-ssif.*/received_messages
192 What:           /sys/devices/platform/dmi-ipmi-ssif.*/received_message_parts
193 What:           /sys/devices/platform/dmi-ipmi-ssif.*/events
194 What:           /sys/devices/platform/dmi-ipmi-ssif.*/watchdog_pretimeouts
195 What:           /sys/devices/platform/dmi-ipmi-ssif.*/flag_fetches
196 What:           /sys/devices/platform/dmi-ipmi-ssif.*/send_retries
197 What:           /sys/devices/platform/dmi-ipmi-ssif.*/receive_retries
198 What:           /sys/devices/platform/dmi-ipmi-ssif.*/send_errors
199 What:           /sys/devices/platform/dmi-ipmi-ssif.*/receive_errors
200 Date:           Sep, 2017
201 KernelVersion:  v4.15
202 Contact:        openipmi-developer@lists.sourceforge.net
203 Description:
204                 hosed:                  (RO) Number of times the hardware didn't
205                                         follow the state machine.
206
207                 alerts:                 (RO) Number of alerts received.
208
209                 sent_messages:          (RO) Number of total messages sent.
210
211                 sent_message_parts:     (RO) Number of message parts sent.
212                                         Messages may be broken into parts if
213                                         they are long.
214
215                 receieved_messages:     (RO) Number of message responses
216                                         received.
217
218                 received_message_parts: (RO) Number of message fragments
219                                         received.
220
221                 events:                 (RO) Number of received events.
222
223                 watchdog_pretimeouts:   (RO) Number of watchdog pretimeouts.
224
225                 flag_fetches:           (RO) Number of times a flag fetch was
226                                         requested.
227
228                 send_retries:           (RO) Number of time a message was
229                                         retried.
230
231                 receive_retries:        (RO) Number of times the receive of a
232                                         message was retried.
233
234                 send_errors:            (RO) Number of times the send of a
235                                         message failed.
236
237                 receive_errors:         (RO) Number of errors in receiving
238                                         messages.