pci-error-recovery: doc cleanup
Include whitespace shooting; correction; typo fix; superfluous word dropping. Signed-off-by: Cao jin <caoj.fnst@cn.fujitsu.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net>zero-colors
parent
3bdadc86dc
commit
97e4e959c9
|
@ -11,7 +11,7 @@
|
||||||
|
|
||||||
Many PCI bus controllers are able to detect a variety of hardware
|
Many PCI bus controllers are able to detect a variety of hardware
|
||||||
PCI errors on the bus, such as parity errors on the data and address
|
PCI errors on the bus, such as parity errors on the data and address
|
||||||
busses, as well as SERR and PERR errors. Some of the more advanced
|
buses, as well as SERR and PERR errors. Some of the more advanced
|
||||||
chipsets are able to deal with these errors; these include PCI-E chipsets,
|
chipsets are able to deal with these errors; these include PCI-E chipsets,
|
||||||
and the PCI-host bridges found on IBM Power4, Power5 and Power6-based
|
and the PCI-host bridges found on IBM Power4, Power5 and Power6-based
|
||||||
pSeries boxes. A typical action taken is to disconnect the affected device,
|
pSeries boxes. A typical action taken is to disconnect the affected device,
|
||||||
|
@ -173,7 +173,7 @@ is STEP 6 (Permanent Failure).
|
||||||
>>> a value of 0xff on read, and writes will be dropped. If more than
|
>>> a value of 0xff on read, and writes will be dropped. If more than
|
||||||
>>> EEH_MAX_FAILS I/O's are attempted to a frozen adapter, EEH
|
>>> EEH_MAX_FAILS I/O's are attempted to a frozen adapter, EEH
|
||||||
>>> assumes that the device driver has gone into an infinite loop
|
>>> assumes that the device driver has gone into an infinite loop
|
||||||
>>> and prints an error to syslog. A reboot is then required to
|
>>> and prints an error to syslog. A reboot is then required to
|
||||||
>>> get the device working again.
|
>>> get the device working again.
|
||||||
|
|
||||||
STEP 2: MMIO Enabled
|
STEP 2: MMIO Enabled
|
||||||
|
@ -231,14 +231,14 @@ proceeds to STEP 4 (Slot Reset)
|
||||||
STEP 3: Link Reset
|
STEP 3: Link Reset
|
||||||
------------------
|
------------------
|
||||||
The platform resets the link. This is a PCI-Express specific step
|
The platform resets the link. This is a PCI-Express specific step
|
||||||
and is done whenever a non-fatal error has been detected that can be
|
and is done whenever a fatal error has been detected that can be
|
||||||
"solved" by resetting the link.
|
"solved" by resetting the link.
|
||||||
|
|
||||||
STEP 4: Slot Reset
|
STEP 4: Slot Reset
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
In response to a return value of PCI_ERS_RESULT_NEED_RESET, the
|
In response to a return value of PCI_ERS_RESULT_NEED_RESET, the
|
||||||
the platform will perform a slot reset on the requesting PCI device(s).
|
the platform will perform a slot reset on the requesting PCI device(s).
|
||||||
The actual steps taken by a platform to perform a slot reset
|
The actual steps taken by a platform to perform a slot reset
|
||||||
will be platform-dependent. Upon completion of slot reset, the
|
will be platform-dependent. Upon completion of slot reset, the
|
||||||
platform will call the device slot_reset() callback.
|
platform will call the device slot_reset() callback.
|
||||||
|
@ -258,7 +258,7 @@ configuration registers to initialize to their default conditions.
|
||||||
|
|
||||||
For most PCI devices, a soft reset will be sufficient for recovery.
|
For most PCI devices, a soft reset will be sufficient for recovery.
|
||||||
Optional fundamental reset is provided to support a limited number
|
Optional fundamental reset is provided to support a limited number
|
||||||
of PCI Express PCI devices for which a soft reset is not sufficient
|
of PCI Express devices for which a soft reset is not sufficient
|
||||||
for recovery.
|
for recovery.
|
||||||
|
|
||||||
If the platform supports PCI hotplug, then the reset might be
|
If the platform supports PCI hotplug, then the reset might be
|
||||||
|
@ -303,7 +303,7 @@ driver performs device init only from PCI function 0:
|
||||||
Same as above.
|
Same as above.
|
||||||
|
|
||||||
Drivers for PCI Express cards that require a fundamental reset must
|
Drivers for PCI Express cards that require a fundamental reset must
|
||||||
set the needs_freset bit in the pci_dev structure in their probe function.
|
set the needs_freset bit in the pci_dev structure in their probe function.
|
||||||
For example, the QLogic qla2xxx driver sets the needs_freset bit for certain
|
For example, the QLogic qla2xxx driver sets the needs_freset bit for certain
|
||||||
PCI card types:
|
PCI card types:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue