linux-imx/Documentation/ABI/testing/sysfs-class-intel_pmt
Alexander Duyck 5ef9998c96 platform/x86: Intel PMT Crashlog capability driver
Add support for the Intel Platform Monitoring Technology crashlog
interface. This interface provides a few sysfs values to allow for
controlling the crashlog telemetry interface as well as a character
driver to allow for mapping the crashlog memory region so that it can be
accessed after a crashlog has been recorded.

This driver is meant to only support the server version of the crashlog
which is identified as crash_type 1 with a version of zero. Currently no
other types are supported.

Signed-off-by: Alexander Duyck <alexander.h.duyck@linux.intel.com>
Signed-off-by: David E. Box <david.e.box@linux.intel.com>
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
2020-11-04 11:14:38 +00:00

4.2 KiB

What: /sys/class/intel_pmt/ Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: The intel_pmt/ class directory contains information for devices that expose hardware telemetry using Intel Platform Monitoring Technology (PMT)

What: /sys/class/intel_pmt/telem Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: The telem directory contains files describing an instance of a PMT telemetry device that exposes hardware telemetry. Each telem directory has an associated telem file. This file may be opened and mapped or read to access the telemetry space of the device. The register layout of the telemetry space is determined from an XML file that matches the PCI device id and GUID for the device.

What: /sys/class/intel_pmt/telem/telem Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: (RO) The telemetry data for this telemetry device. This file may be mapped or read to obtain the data.

What: /sys/class/intel_pmt/telem/guid Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: (RO) The GUID for this telemetry device. The GUID identifies the version of the XML file for the parent device that is to be used to get the register layout.

What: /sys/class/intel_pmt/telem/size Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: (RO) The size of telemetry region in bytes that corresponds to the mapping size for the telem file.

What: /sys/class/intel_pmt/telem/offset Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: (RO) The offset of telemetry region in bytes that corresponds to the mapping for the telem file.

What: /sys/class/intel_pmt/crashlog Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: The crashlog directory contains files for configuring an instance of a PMT crashlog device that can perform crash data recording. Each crashlog device has an associated crashlog file. This file can be opened and mapped or read to access the resulting crashlog buffer. The register layout for the buffer can be determined from an XML file of specified GUID for the parent device.

What: /sys/class/intel_pmt/crashlog/crashlog Date: October 2020 KernelVersion: 5.10 Contact: David Box david.e.box@linux.intel.com Description: (RO) The crashlog buffer for this crashlog device. This file may be mapped or read to obtain the data.

What: /sys/class/intel_pmt/crashlog/guid Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: (RO) The GUID for this crashlog device. The GUID identifies the version of the XML file for the parent device that should be used to determine the register layout.

What: /sys/class/intel_pmt/crashlog/size Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: (RO) The length of the result buffer in bytes that corresponds to the size for the crashlog buffer.

What: /sys/class/intel_pmt/crashlog/offset Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: (RO) The offset of the buffer in bytes that corresponds to the mapping for the crashlog device.

What: /sys/class/intel_pmt/crashlog/enable Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: (RW) Boolean value controlling if the crashlog functionality is enabled for the crashlog device.

What: /sys/class/intel_pmt/crashlog/trigger Date: October 2020 KernelVersion: 5.10 Contact: Alexander Duyck alexander.h.duyck@linux.intel.com Description: (RW) Boolean value controlling the triggering of the crashlog device node. When read it provides data on if the crashlog has been triggered. When written to it can be used to either clear the current trigger by writing false, or to trigger a new event if the trigger is not currently set.