powerpc/eeh: Clean up and document event handling functions

 */

#define MAX_WAIT_FOR_RECOVERY 300

/**

 * eeh_handle_normal_event - Handle EEH events on a specific PE

 * @pe: EEH PE

 *

 * Attempts to recover the given PE.  If recovery fails or the PE has failed

 * too many times, remove the PE.

 *

 * Returns true if @pe should no longer be used, else false.

 */

static bool eeh_handle_normal_event(struct eeh_pe *pe)

{

	struct pci_bus *frozen_bus;

	eeh_pe_update_time_stamp(pe);

	pe->freeze_count++;

	if (pe->freeze_count > eeh_max_freezes)

		goto excess_failures;

	if (pe->freeze_count > eeh_max_freezes) {

		pr_err("EEH: PHB#%x-PE#%x has failed %d times in the\n"

		       "last hour and has been permanently disabled.\n",

		       pe->phb->global_number, pe->addr,

		       pe->freeze_count);

		goto hard_fail;

	}

	pr_warn("EEH: This PCI device has failed %d times in the last hour\n",

		pe->freeze_count);

	return false;

excess_failures:

hard_fail:

	/*

	 * About 90% of all real-life EEH failures in the field

	 * are due to poorly seated PCI cards. Only 10% or so are

	 * due to actual, failed cards.

	 */

	pr_err("EEH: PHB#%x-PE#%x has failed %d times in the\n"

	       "last hour and has been permanently disabled.\n"

	       "Please try reseating or replacing it.\n",

		pe->phb->global_number, pe->addr,

		pe->freeze_count);

	goto perm_error;

hard_fail:

	pr_err("EEH: Unable to recover from failure from PHB#%x-PE#%x.\n"

	       "Please try reseating or replacing it\n",

		pe->phb->global_number, pe->addr);

perm_error:

	eeh_slot_error_detail(pe, EEH_LOG_PERM);

	/* Notify all devices that they're about to go down. */

	return false;

}

/**

 * eeh_handle_special_event - Handle EEH events without a specific failing PE

 *

 * Called when an EEH event is detected but can't be narrowed down to a

 * specific PE.  Iterates through possible failures and handles them as

 * necessary.

 */

static void eeh_handle_special_event(void)

{

	struct eeh_pe *pe, *phb_pe;