Documentation/PCI/pcieaer-howto.rst

20 Reporting (AER) driver and provides information on how to use it, as
22 the PCIe AER driver.
25 What is the PCIe AER Driver?
37 The PCIe AER driver provides the infrastructure to support PCIe Advanced
38 Error Reporting capability. The PCIe AER driver provides three basic
45 The AER driver only attaches to Root Ports and RCECs that support the PCIe
46 AER capability.
52 Include the PCIe AER Root Driver into the Linux Kernel
55 The PCIe AER driver is a Root Port service driver attached
60 Load PCIe AER Root Driver
63 Some systems have AER support in firmware. Enabling Linux AER support at
64 the same time the firmware handles AER would result in unpredictable
65 behavior. Therefore, Linux does not handle AER events unless the firmware
66 grants AER control to the OS via the ACPI _OSC method. See the PCI Firmware
69 AER error output
72 When a PCIe AER error is captured, an error message will be output to
88 AER Statistics / Counters
91 When PCIe AER errors are captured, the counters / statistics are also exposed
100 To support AER better, developers need to understand how AER works.
124 internally processes and logs the error message in its AER
128 Status Register accordingly. If AER error reporting is enabled in the Root
144 fatal error happens. The Root Port AER service driver provides a
155 The PCIe AER Root driver uses error callbacks to coordinate
161 pointers. The AER driver follows the rules defined in
174 require any recovery actions. The AER driver clears the device's
181 at upstream is not required. The AER driver calls error_detected(dev,
187 If Upstream Port A captures an AER error, the hierarchy consists of
192 whether it can recover or the AER driver calls mmio_enabled as next.
198 to reset link, AER port service driver is required to provide the
229 Debugging PCIe AER error recovery code is quite difficult because it
233 First you should enable PCIe AER software error injection in kernel