Documentation/PCI/pcieaer-howto.rst

1 .. SPDX-License-Identifier: GPL-2.0
8 :Authors: - T. Long Nguyen <tom.l.nguyen@intel.com>
9           - Yanmin Zhang <yanmin.zhang@intel.com>
17 ----------------
26 ----------------------------
29 or on behalf of transactions initiated on the link. PCIe
41   - Gathers the comprehensive error information if errors occurred.
42   - Reports error to the users.
43   - Performs error recovery actions.
53 ------------------------------------------------------
61 -------------------------
70 ----------------
89 -------------------------
93 Documentation/ABI/testing/sysfs-bus-pci-devices-aer_stats
98 To enable error recovery, a software driver must provide callbacks.
108 interface. The PCIe protocol can recover without any software
116 errors are further classified into non-fatal errors and fatal errors.
117 Non-fatal errors cause the particular transaction to be unreliable,
138 -----------------
152 PCI error-recovery callbacks
162 pci-error-recovery.rst except PCIe-specific parts (e.g.
163 reset_link). Please refer to pci-error-recovery.rst for detailed
173 software intervention or any loss of data. These errors do not
177 Non-correctable (non-fatal and fatal) errors
180 If an error message indicates a non-fatal error, performing link reset
206 ------------------------
210   error recovery handler (pci_driver->err_handler is equal to NULL)?
226 Software error injection
230 is hard to trigger real hardware errors. Software based error
233 First you should enable PCIe AER software error injection in kernel
241 Then, you need a user space tool named aer-inject, which can be gotten
244     https://github.com/intel/aer-inject.git
246 More information about aer-inject can be found in the document in