hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/ABI/testing/sysfs-firmware-dmi-entries
....@@ -33,7 +33,7 @@
3333 doesn't matter), they will be represented in sysfs as
3434 entries "T-0" through "T-(N-1)":
3535
36
- Example entry directories:
36
+ Example entry directories::
3737
3838 /sys/firmware/dmi/entries/17-0
3939 /sys/firmware/dmi/entries/17-1
....@@ -50,61 +50,65 @@
5050 Each DMI entry in sysfs has the common header values
5151 exported as attributes:
5252
53
- handle : The 16bit 'handle' that is assigned to this
53
+ ======== =================================================
54
+ handle The 16bit 'handle' that is assigned to this
5455 entry by the firmware. This handle may be
5556 referred to by other entries.
56
- length : The length of the entry, as presented in the
57
+ length The length of the entry, as presented in the
5758 entry itself. Note that this is _not the
5859 total count of bytes associated with the
59
- entry_. This value represents the length of
60
+ entry. This value represents the length of
6061 the "formatted" portion of the entry. This
6162 "formatted" region is sometimes followed by
6263 the "unformatted" region composed of nul
6364 terminated strings, with termination signalled
6465 by a two nul characters in series.
65
- raw : The raw bytes of the entry. This includes the
66
+ raw The raw bytes of the entry. This includes the
6667 "formatted" portion of the entry, the
6768 "unformatted" strings portion of the entry,
6869 and the two terminating nul characters.
69
- type : The type of the entry. This value is the same
70
+ type The type of the entry. This value is the same
7071 as found in the directory name. It indicates
7172 how the rest of the entry should be interpreted.
72
- instance: The instance ordinal of the entry for the
73
+ instance The instance ordinal of the entry for the
7374 given type. This value is the same as found
7475 in the parent directory name.
75
- position: The ordinal position (zero-based) of the entry
76
+ position The ordinal position (zero-based) of the entry
7677 within the entirety of the DMI entry table.
78
+ ======== =================================================
7779
78
- === Entry Specialization ===
80
+ **Entry Specialization**
7981
8082 Some entry types may have other information available in
8183 sysfs. Not all types are specialized.
8284
83
- --- Type 15 - System Event Log ---
85
+ **Type 15 - System Event Log**
8486
8587 This entry allows the firmware to export a log of
8688 events the system has taken. This information is
8789 typically backed by nvram, but the implementation
8890 details are abstracted by this table. This entry's data
89
- is exported in the directory:
91
+ is exported in the directory::
9092
91
- /sys/firmware/dmi/entries/15-0/system_event_log
93
+ /sys/firmware/dmi/entries/15-0/system_event_log
9294
9395 and has the following attributes (documented in the
9496 SMBIOS / DMI specification under "System Event Log (Type 15)":
9597
96
- area_length
97
- header_start_offset
98
- data_start_offset
99
- access_method
100
- status
101
- change_token
102
- access_method_address
103
- header_format
104
- per_log_type_descriptor_length
105
- type_descriptors_supported_count
98
+ - area_length
99
+ - header_start_offset
100
+ - data_start_offset
101
+ - access_method
102
+ - status
103
+ - change_token
104
+ - access_method_address
105
+ - header_format
106
+ - per_log_type_descriptor_length
107
+ - type_descriptors_supported_count
106108
107109 As well, the kernel exports the binary attribute:
108110
109
- raw_event_log : The raw binary bits of the event log
111
+ ============= ====================================
112
+ raw_event_log The raw binary bits of the event log
110113 as described by the DMI entry.
114
+ ============= ====================================