Documentation/PCI/pcieaer-howto.rst

20 Reporting (AER) driver and provides information on how to use it, as
22 PCI Express AER driver.
25 What is the PCI Express AER Driver?
37 The PCI Express AER driver provides the infrastructure to support PCI
38 Express Advanced Error Reporting capability. The PCI Express AER
45 AER driver only attaches root ports which support PCI-Express AER
52 Include the PCI Express AER Root Driver into the Linux Kernel
55 The PCI Express AER Root driver is a Root Port service driver attached
61 Load PCI Express AER Root Driver
64 Some systems have AER support in firmware. Enabling Linux AER support at
65 the same time the firmware handles AER may result in unpredictable
66 behavior. Therefore, Linux does not handle AER events unless the firmware
67 grants AER control to the OS via the ACPI _OSC method. See the PCI FW 3.0
70 AER error output
73 When a PCIe AER error is captured, an error message will be output to
89 AER Statistics / Counters
92 When PCIe AER errors are captured, the counters / statistics are also exposed
99 To enable AER aware support requires a software driver to configure
100 the AER capability structure within its device and to provide callbacks.
102 To support AER better, developers need understand how AER does work
122 When AER is enabled, a PCI Express device will automatically send an
129 Status Register accordingly. If AER error reporting is enabled in Root
138 Configure the AER capability structure
141 AER aware drivers of PCI Express component need change the device
142 control registers to enable AER. They also could change AER registers,
144 pci_enable_pcie_error_reporting could be used to enable AER. See
165 The PCI Express AER Root driver uses error callbacks to coordinate
171 pointers. AER driver follows the rules defined in
184 require any recovery actions. The AER driver clears the device's
191 at upstream is not required. The AER driver calls error_detected(dev,
197 If Upstream port A captures an AER error, the hierarchy consists of
202 whether it can recover or the AER driver calls mmio_enabled as next.
208 to reset link, AER port service driver is required to provide the
272   with the PCI Express AER Root driver?
275   It could call the helper functions to enable AER in devices and
282 Debugging PCIe AER error recovery code is quite difficult because it
286 First you should enable PCIe AER software error injection in kernel