2 * PCI Error Recovery Driver for RPA-compliant PPC64 platform.
3 * Copyright IBM Corp. 2004 2005
4 * Copyright Linas Vepstas <linas@linas.org> 2004, 2005
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or (at
11 * your option) any later version.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
16 * NON INFRINGEMENT. See the GNU General Public License for more
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 * Send comments and feedback to Linas Vepstas <linas@austin.ibm.com>
25 #include <linux/delay.h>
26 #include <linux/interrupt.h>
27 #include <linux/irq.h>
28 #include <linux/module.h>
29 #include <linux/pci.h>
31 #include <asm/eeh_event.h>
32 #include <asm/ppc-pci.h>
33 #include <asm/pci-bridge.h>
38 * eeh_pcid_name - Retrieve name of PCI device driver
41 * This routine is used to retrieve the name of PCI device driver
44 static inline const char *eeh_pcid_name(struct pci_dev
*pdev
)
46 if (pdev
&& pdev
->dev
.driver
)
47 return pdev
->dev
.driver
->name
;
52 * eeh_pcid_get - Get the PCI device driver
55 * The function is used to retrieve the PCI device driver for
56 * the indicated PCI device. Besides, we will increase the reference
57 * of the PCI device driver to prevent that being unloaded on
58 * the fly. Otherwise, kernel crash would be seen.
60 static inline struct pci_driver
*eeh_pcid_get(struct pci_dev
*pdev
)
62 if (!pdev
|| !pdev
->driver
)
65 if (!try_module_get(pdev
->driver
->driver
.owner
))
72 * eeh_pcid_put - Dereference on the PCI device driver
75 * The function is called to do dereference on the PCI device
76 * driver of the indicated PCI device.
78 static inline void eeh_pcid_put(struct pci_dev
*pdev
)
80 if (!pdev
|| !pdev
->driver
)
83 module_put(pdev
->driver
->driver
.owner
);
87 static void print_device_node_tree(struct pci_dn
*pdn
, int dent
)
90 struct device_node
*pc
;
94 for (i
= 0; i
< dent
; i
++)
96 printk("dn=%s mode=%x \tcfg_addr=%x pe_addr=%x \tfull=%s\n",
97 pdn
->node
->name
, pdn
->eeh_mode
, pdn
->eeh_config_addr
,
98 pdn
->eeh_pe_config_addr
, pdn
->node
->full_name
);
100 pc
= pdn
->node
->child
;
102 print_device_node_tree(PCI_DN(pc
), dent
);
109 * eeh_disable_irq - Disable interrupt for the recovering device
112 * This routine must be called when reporting temporary or permanent
113 * error to the particular PCI device to disable interrupt of that
114 * device. If the device has enabled MSI or MSI-X interrupt, we needn't
115 * do real work because EEH should freeze DMA transfers for those PCI
116 * devices encountering EEH errors, which includes MSI or MSI-X.
118 static void eeh_disable_irq(struct pci_dev
*dev
)
120 struct eeh_dev
*edev
= pci_dev_to_eeh_dev(dev
);
122 /* Don't disable MSI and MSI-X interrupts. They are
123 * effectively disabled by the DMA Stopped state
124 * when an EEH error occurs.
126 if (dev
->msi_enabled
|| dev
->msix_enabled
)
129 if (!irq_has_action(dev
->irq
))
132 edev
->mode
|= EEH_DEV_IRQ_DISABLED
;
133 disable_irq_nosync(dev
->irq
);
137 * eeh_enable_irq - Enable interrupt for the recovering device
140 * This routine must be called to enable interrupt while failed
141 * device could be resumed.
143 static void eeh_enable_irq(struct pci_dev
*dev
)
145 struct eeh_dev
*edev
= pci_dev_to_eeh_dev(dev
);
147 if ((edev
->mode
) & EEH_DEV_IRQ_DISABLED
) {
148 edev
->mode
&= ~EEH_DEV_IRQ_DISABLED
;
149 enable_irq(dev
->irq
);
154 * eeh_report_error - Report pci error to each device driver
156 * @userdata: return value
158 * Report an EEH error to each device driver, collect up and
159 * merge the device driver responses. Cumulative response
160 * passed back in "userdata".
162 static void *eeh_report_error(void *data
, void *userdata
)
164 struct eeh_dev
*edev
= (struct eeh_dev
*)data
;
165 struct pci_dev
*dev
= eeh_dev_to_pci_dev(edev
);
166 enum pci_ers_result rc
, *res
= userdata
;
167 struct pci_driver
*driver
;
169 /* We might not have the associated PCI device,
170 * then we should continue for next one.
172 if (!dev
) return NULL
;
173 dev
->error_state
= pci_channel_io_frozen
;
175 driver
= eeh_pcid_get(dev
);
176 if (!driver
) return NULL
;
178 eeh_disable_irq(dev
);
180 if (!driver
->err_handler
||
181 !driver
->err_handler
->error_detected
) {
186 rc
= driver
->err_handler
->error_detected(dev
, pci_channel_io_frozen
);
188 /* A driver that needs a reset trumps all others */
189 if (rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
190 if (*res
== PCI_ERS_RESULT_NONE
) *res
= rc
;
197 * eeh_report_mmio_enabled - Tell drivers that MMIO has been enabled
199 * @userdata: return value
201 * Tells each device driver that IO ports, MMIO and config space I/O
202 * are now enabled. Collects up and merges the device driver responses.
203 * Cumulative response passed back in "userdata".
205 static void *eeh_report_mmio_enabled(void *data
, void *userdata
)
207 struct eeh_dev
*edev
= (struct eeh_dev
*)data
;
208 struct pci_dev
*dev
= eeh_dev_to_pci_dev(edev
);
209 enum pci_ers_result rc
, *res
= userdata
;
210 struct pci_driver
*driver
;
212 driver
= eeh_pcid_get(dev
);
213 if (!driver
) return NULL
;
215 if (!driver
->err_handler
||
216 !driver
->err_handler
->mmio_enabled
) {
221 rc
= driver
->err_handler
->mmio_enabled(dev
);
223 /* A driver that needs a reset trumps all others */
224 if (rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
225 if (*res
== PCI_ERS_RESULT_NONE
) *res
= rc
;
232 * eeh_report_reset - Tell device that slot has been reset
234 * @userdata: return value
236 * This routine must be called while EEH tries to reset particular
237 * PCI device so that the associated PCI device driver could take
238 * some actions, usually to save data the driver needs so that the
239 * driver can work again while the device is recovered.
241 static void *eeh_report_reset(void *data
, void *userdata
)
243 struct eeh_dev
*edev
= (struct eeh_dev
*)data
;
244 struct pci_dev
*dev
= eeh_dev_to_pci_dev(edev
);
245 enum pci_ers_result rc
, *res
= userdata
;
246 struct pci_driver
*driver
;
248 if (!dev
) return NULL
;
249 dev
->error_state
= pci_channel_io_normal
;
251 driver
= eeh_pcid_get(dev
);
252 if (!driver
) return NULL
;
256 if (!driver
->err_handler
||
257 !driver
->err_handler
->slot_reset
) {
262 rc
= driver
->err_handler
->slot_reset(dev
);
263 if ((*res
== PCI_ERS_RESULT_NONE
) ||
264 (*res
== PCI_ERS_RESULT_RECOVERED
)) *res
= rc
;
265 if (*res
== PCI_ERS_RESULT_DISCONNECT
&&
266 rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
273 * eeh_report_resume - Tell device to resume normal operations
275 * @userdata: return value
277 * This routine must be called to notify the device driver that it
278 * could resume so that the device driver can do some initialization
279 * to make the recovered device work again.
281 static void *eeh_report_resume(void *data
, void *userdata
)
283 struct eeh_dev
*edev
= (struct eeh_dev
*)data
;
284 struct pci_dev
*dev
= eeh_dev_to_pci_dev(edev
);
285 struct pci_driver
*driver
;
287 if (!dev
) return NULL
;
288 dev
->error_state
= pci_channel_io_normal
;
290 driver
= eeh_pcid_get(dev
);
291 if (!driver
) return NULL
;
295 if (!driver
->err_handler
||
296 !driver
->err_handler
->resume
) {
301 driver
->err_handler
->resume(dev
);
308 * eeh_report_failure - Tell device driver that device is dead.
310 * @userdata: return value
312 * This informs the device driver that the device is permanently
313 * dead, and that no further recovery attempts will be made on it.
315 static void *eeh_report_failure(void *data
, void *userdata
)
317 struct eeh_dev
*edev
= (struct eeh_dev
*)data
;
318 struct pci_dev
*dev
= eeh_dev_to_pci_dev(edev
);
319 struct pci_driver
*driver
;
321 if (!dev
) return NULL
;
322 dev
->error_state
= pci_channel_io_perm_failure
;
324 driver
= eeh_pcid_get(dev
);
325 if (!driver
) return NULL
;
327 eeh_disable_irq(dev
);
329 if (!driver
->err_handler
||
330 !driver
->err_handler
->error_detected
) {
335 driver
->err_handler
->error_detected(dev
, pci_channel_io_perm_failure
);
342 * eeh_reset_device - Perform actual reset of a pci slot
344 * @bus: PCI bus corresponding to the isolcated slot
346 * This routine must be called to do reset on the indicated PE.
347 * During the reset, udev might be invoked because those affected
348 * PCI devices will be removed and then added.
350 static int eeh_reset_device(struct eeh_pe
*pe
, struct pci_bus
*bus
)
354 /* pcibios will clear the counter; save the value */
355 cnt
= pe
->freeze_count
;
358 * We don't remove the corresponding PE instances because
359 * we need the information afterwords. The attached EEH
360 * devices are expected to be attached soon when calling
361 * into pcibios_add_pci_devices().
364 __pcibios_remove_pci_devices(bus
, 0);
366 /* Reset the pci controller. (Asserts RST#; resets config space).
367 * Reconfigure bridges and devices. Don't try to bring the system
368 * up if the reset failed for some reason.
370 rc
= eeh_reset_pe(pe
);
375 eeh_ops
->configure_bridge(pe
);
376 eeh_pe_restore_bars(pe
);
378 /* Give the system 5 seconds to finish running the user-space
379 * hotplug shutdown scripts, e.g. ifdown for ethernet. Yes,
380 * this is a hack, but if we don't do this, and try to bring
381 * the device up before the scripts have taken it down,
382 * potentially weird things happen.
386 pcibios_add_pci_devices(bus
);
388 pe
->freeze_count
= cnt
;
393 /* The longest amount of time to wait for a pci device
394 * to come back on line, in seconds.
396 #define MAX_WAIT_FOR_RECOVERY 150
399 * eeh_handle_event - Reset a PCI device after hard lockup.
402 * While PHB detects address or data parity errors on particular PCI
403 * slot, the associated PE will be frozen. Besides, DMA's occurring
404 * to wild addresses (which usually happen due to bugs in device
405 * drivers or in PCI adapter firmware) can cause EEH error. #SERR,
406 * #PERR or other misc PCI-related errors also can trigger EEH errors.
408 * Recovery process consists of unplugging the device driver (which
409 * generated hotplug events to userspace), then issuing a PCI #RST to
410 * the device, then reconfiguring the PCI config space for all bridges
411 * & devices under this slot, and then finally restarting the device
412 * drivers (which cause a second set of hotplug events to go out to
415 void eeh_handle_event(struct eeh_pe
*pe
)
417 struct pci_bus
*frozen_bus
;
419 enum pci_ers_result result
= PCI_ERS_RESULT_NONE
;
421 frozen_bus
= eeh_pe_bus_get(pe
);
423 pr_err("%s: Cannot find PCI bus for PHB#%d-PE#%x\n",
424 __func__
, pe
->phb
->global_number
, pe
->addr
);
429 if (pe
->freeze_count
> EEH_MAX_ALLOWED_FREEZES
)
430 goto excess_failures
;
431 pr_warning("EEH: This PCI device has failed %d times in the last hour\n",
434 /* Walk the various device drivers attached to this slot through
435 * a reset sequence, giving each an opportunity to do what it needs
436 * to accomplish the reset. Each child gets a report of the
437 * status ... if any child can't handle the reset, then the entire
438 * slot is dlpar removed and added.
440 eeh_pe_dev_traverse(pe
, eeh_report_error
, &result
);
442 /* Get the current PCI slot state. This can take a long time,
443 * sometimes over 3 seconds for certain systems.
445 rc
= eeh_ops
->wait_state(pe
, MAX_WAIT_FOR_RECOVERY
*1000);
446 if (rc
< 0 || rc
== EEH_STATE_NOT_SUPPORT
) {
447 printk(KERN_WARNING
"EEH: Permanent failure\n");
451 /* Since rtas may enable MMIO when posting the error log,
452 * don't post the error log until after all dev drivers
453 * have been informed.
455 eeh_slot_error_detail(pe
, EEH_LOG_TEMP
);
457 /* If all device drivers were EEH-unaware, then shut
458 * down all of the device drivers, and hope they
459 * go down willingly, without panicing the system.
461 if (result
== PCI_ERS_RESULT_NONE
) {
462 rc
= eeh_reset_device(pe
, frozen_bus
);
464 printk(KERN_WARNING
"EEH: Unable to reset, rc=%d\n", rc
);
469 /* If all devices reported they can proceed, then re-enable MMIO */
470 if (result
== PCI_ERS_RESULT_CAN_RECOVER
) {
471 rc
= eeh_pci_enable(pe
, EEH_OPT_THAW_MMIO
);
476 result
= PCI_ERS_RESULT_NEED_RESET
;
478 result
= PCI_ERS_RESULT_NONE
;
479 eeh_pe_dev_traverse(pe
, eeh_report_mmio_enabled
, &result
);
483 /* If all devices reported they can proceed, then re-enable DMA */
484 if (result
== PCI_ERS_RESULT_CAN_RECOVER
) {
485 rc
= eeh_pci_enable(pe
, EEH_OPT_THAW_DMA
);
490 result
= PCI_ERS_RESULT_NEED_RESET
;
492 result
= PCI_ERS_RESULT_RECOVERED
;
495 /* If any device has a hard failure, then shut off everything. */
496 if (result
== PCI_ERS_RESULT_DISCONNECT
) {
497 printk(KERN_WARNING
"EEH: Device driver gave up\n");
501 /* If any device called out for a reset, then reset the slot */
502 if (result
== PCI_ERS_RESULT_NEED_RESET
) {
503 rc
= eeh_reset_device(pe
, NULL
);
505 printk(KERN_WARNING
"EEH: Cannot reset, rc=%d\n", rc
);
508 result
= PCI_ERS_RESULT_NONE
;
509 eeh_pe_dev_traverse(pe
, eeh_report_reset
, &result
);
512 /* All devices should claim they have recovered by now. */
513 if ((result
!= PCI_ERS_RESULT_RECOVERED
) &&
514 (result
!= PCI_ERS_RESULT_NONE
)) {
515 printk(KERN_WARNING
"EEH: Not recovered\n");
519 /* Tell all device drivers that they can resume operations */
520 eeh_pe_dev_traverse(pe
, eeh_report_resume
, NULL
);
526 * About 90% of all real-life EEH failures in the field
527 * are due to poorly seated PCI cards. Only 10% or so are
528 * due to actual, failed cards.
530 pr_err("EEH: PHB#%d-PE#%x has failed %d times in the\n"
531 "last hour and has been permanently disabled.\n"
532 "Please try reseating or replacing it.\n",
533 pe
->phb
->global_number
, pe
->addr
,
538 pr_err("EEH: Unable to recover from failure from PHB#%d-PE#%x.\n"
539 "Please try reseating or replacing it\n",
540 pe
->phb
->global_number
, pe
->addr
);
543 eeh_slot_error_detail(pe
, EEH_LOG_PERM
);
545 /* Notify all devices that they're about to go down. */
546 eeh_pe_dev_traverse(pe
, eeh_report_failure
, NULL
);
548 /* Shut down the device drivers for good. */
550 pcibios_remove_pci_devices(frozen_bus
);