| 1 |
PCIe Device AER statistics |
| 2 |
-------------------------- |
| 3 |
|
| 4 |
These attributes show up under all the devices that are AER capable. These |
| 5 |
statistical counters indicate the errors "as seen/reported by the device". |
| 6 |
Note that this may mean that if an endpoint is causing problems, the AER |
| 7 |
counters may increment at its link partner (e.g. root port) because the |
| 8 |
errors may be "seen" / reported by the link partner and not the |
| 9 |
problematic endpoint itself (which may report all counters as 0 as it never |
| 10 |
saw any problems). |
| 11 |
|
| 12 |
What: /sys/bus/pci/devices/<dev>/aer_dev_correctable |
| 13 |
Date: July 2018 |
| 14 |
KernelVersion: 4.19.0 |
| 15 |
Contact: [email protected], [email protected] |
| 16 |
Description: List of correctable errors seen and reported by this |
| 17 |
PCI device using ERR_COR. Note that since multiple errors may |
| 18 |
be reported using a single ERR_COR message, thus |
| 19 |
TOTAL_ERR_COR at the end of the file may not match the actual |
| 20 |
total of all the errors in the file. Sample output:: |
| 21 |
|
| 22 |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_correctable |
| 23 |
Receiver Error 2 |
| 24 |
Bad TLP 0 |
| 25 |
Bad DLLP 0 |
| 26 |
RELAY_NUM Rollover 0 |
| 27 |
Replay Timer Timeout 0 |
| 28 |
Advisory Non-Fatal 0 |
| 29 |
Corrected Internal Error 0 |
| 30 |
Header Log Overflow 0 |
| 31 |
TOTAL_ERR_COR 2 |
| 32 |
|
| 33 |
What: /sys/bus/pci/devices/<dev>/aer_dev_fatal |
| 34 |
Date: July 2018 |
| 35 |
KernelVersion: 4.19.0 |
| 36 |
Contact: [email protected], [email protected] |
| 37 |
Description: List of uncorrectable fatal errors seen and reported by this |
| 38 |
PCI device using ERR_FATAL. Note that since multiple errors may |
| 39 |
be reported using a single ERR_FATAL message, thus |
| 40 |
TOTAL_ERR_FATAL at the end of the file may not match the actual |
| 41 |
total of all the errors in the file. Sample output:: |
| 42 |
|
| 43 |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_fatal |
| 44 |
Undefined 0 |
| 45 |
Data Link Protocol 0 |
| 46 |
Surprise Down Error 0 |
| 47 |
Poisoned TLP 0 |
| 48 |
Flow Control Protocol 0 |
| 49 |
Completion Timeout 0 |
| 50 |
Completer Abort 0 |
| 51 |
Unexpected Completion 0 |
| 52 |
Receiver Overflow 0 |
| 53 |
Malformed TLP 0 |
| 54 |
ECRC 0 |
| 55 |
Unsupported Request 0 |
| 56 |
ACS Violation 0 |
| 57 |
Uncorrectable Internal Error 0 |
| 58 |
MC Blocked TLP 0 |
| 59 |
AtomicOp Egress Blocked 0 |
| 60 |
TLP Prefix Blocked Error 0 |
| 61 |
TOTAL_ERR_FATAL 0 |
| 62 |
|
| 63 |
What: /sys/bus/pci/devices/<dev>/aer_dev_nonfatal |
| 64 |
Date: July 2018 |
| 65 |
KernelVersion: 4.19.0 |
| 66 |
Contact: [email protected], [email protected] |
| 67 |
Description: List of uncorrectable nonfatal errors seen and reported by this |
| 68 |
PCI device using ERR_NONFATAL. Note that since multiple errors |
| 69 |
may be reported using a single ERR_FATAL message, thus |
| 70 |
TOTAL_ERR_NONFATAL at the end of the file may not match the |
| 71 |
actual total of all the errors in the file. Sample output:: |
| 72 |
|
| 73 |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_nonfatal |
| 74 |
Undefined 0 |
| 75 |
Data Link Protocol 0 |
| 76 |
Surprise Down Error 0 |
| 77 |
Poisoned TLP 0 |
| 78 |
Flow Control Protocol 0 |
| 79 |
Completion Timeout 0 |
| 80 |
Completer Abort 0 |
| 81 |
Unexpected Completion 0 |
| 82 |
Receiver Overflow 0 |
| 83 |
Malformed TLP 0 |
| 84 |
ECRC 0 |
| 85 |
Unsupported Request 0 |
| 86 |
ACS Violation 0 |
| 87 |
Uncorrectable Internal Error 0 |
| 88 |
MC Blocked TLP 0 |
| 89 |
AtomicOp Egress Blocked 0 |
| 90 |
TLP Prefix Blocked Error 0 |
| 91 |
TOTAL_ERR_NONFATAL 0 |
| 92 |
|
| 93 |
PCIe Rootport AER statistics |
| 94 |
---------------------------- |
| 95 |
|
| 96 |
These attributes show up under only the rootports (or root complex event |
| 97 |
collectors) that are AER capable. These indicate the number of error messages as |
| 98 |
"reported to" the rootport. Please note that the rootports also transmit |
| 99 |
(internally) the ERR_* messages for errors seen by the internal rootport PCI |
| 100 |
device, so these counters include them and are thus cumulative of all the error |
| 101 |
messages on the PCI hierarchy originating at that root port. |
| 102 |
|
| 103 |
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_cor |
| 104 |
Date: July 2018 |
| 105 |
KernelVersion: 4.19.0 |
| 106 |
Contact: [email protected], [email protected] |
| 107 |
Description: Total number of ERR_COR messages reported to rootport. |
| 108 |
|
| 109 |
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_fatal |
| 110 |
Date: July 2018 |
| 111 |
KernelVersion: 4.19.0 |
| 112 |
Contact: [email protected], [email protected] |
| 113 |
Description: Total number of ERR_FATAL messages reported to rootport. |
| 114 |
|
| 115 |
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_nonfatal |
| 116 |
Date: July 2018 |
| 117 |
KernelVersion: 4.19.0 |
| 118 |
Contact: [email protected], [email protected] |
| 119 |
Description: Total number of ERR_NONFATAL messages reported to rootport. |
| 120 |
|
| 121 |
PCIe AER ratelimits |
| 122 |
------------------- |
| 123 |
|
| 124 |
These attributes show up under all the devices that are AER capable. |
| 125 |
They represent configurable ratelimits of logs per error type. |
| 126 |
|
| 127 |
See Documentation/PCI/pcieaer-howto.rst for more info on ratelimits. |
| 128 |
|
| 129 |
What: /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_interval_ms |
| 130 |
Date: May 2025 |
| 131 |
KernelVersion: 6.16.0 |
| 132 |
Contact: [email protected] |
| 133 |
Description: Writing 0 disables AER correctable error log ratelimiting. |
| 134 |
Writing a positive value sets the ratelimit interval in ms. |
| 135 |
Default is DEFAULT_RATELIMIT_INTERVAL (5000 ms). |
| 136 |
|
| 137 |
What: /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_burst |
| 138 |
Date: May 2025 |
| 139 |
KernelVersion: 6.16.0 |
| 140 |
Contact: [email protected] |
| 141 |
Description: Ratelimit burst for correctable error logs. Writing a value |
| 142 |
changes the number of errors (burst) allowed per interval |
| 143 |
before ratelimiting. Reading gets the current ratelimit |
| 144 |
burst. Default is DEFAULT_RATELIMIT_BURST (10). |
| 145 |
|
| 146 |
What: /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_interval_ms |
| 147 |
Date: May 2025 |
| 148 |
KernelVersion: 6.16.0 |
| 149 |
Contact: [email protected] |
| 150 |
Description: Writing 0 disables AER non-fatal uncorrectable error log |
| 151 |
ratelimiting. Writing a positive value sets the ratelimit |
| 152 |
interval in ms. Default is DEFAULT_RATELIMIT_INTERVAL |
| 153 |
(5000 ms). |
| 154 |
|
| 155 |
What: /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_burst |
| 156 |
Date: May 2025 |
| 157 |
KernelVersion: 6.16.0 |
| 158 |
Contact: [email protected] |
| 159 |
Description: Ratelimit burst for non-fatal uncorrectable error logs. |
| 160 |
Writing a value changes the number of errors (burst) |
| 161 |
allowed per interval before ratelimiting. Reading gets the |
| 162 |
current ratelimit burst. Default is DEFAULT_RATELIMIT_BURST |
| 163 |
(10). |