3  *  libata-eh.c - libata error handling
121 /* The following table determines timeouts to use for EH internal
328  *	EH context.
351  *	Notify EH that internal command @cmd for @dev timed out.  This
356  *	EH context.
446 		/* doesn't make sense for port-wide EH actions */  in ata_eh_clear_action()
463  *	ata_eh_acquire - acquire EH ownership
464  *	@ap: ATA port to acquire EH ownership for
466  *	Acquire EH ownership for @ap.  This is the basic exclusion
468  *	the same host can claim the ownership of EH.
471  *	EH context.
481  *	ata_eh_release - release EH ownership
482  *	@ap: ATA port to release EH ownership for
484  *	Release EH ownership for @ap if the caller.  The caller must
485  *	have acquired EH ownership using ata_eh_acquire() previously.
488  *	EH context.
603 	 * For EH, all qcs are finished in one of three ways -  in ata_scsi_cmd_error_handler()
606 	 * completion wins, the qc never reaches EH.  When error  in ata_scsi_cmd_error_handler()
658 	 * If we have timed out qcs.  They belong to EH from  in ata_scsi_cmd_error_handler()
687 	/* acquire EH ownership */  in ata_scsi_port_error_handler()
696 	/* fetch & clear EH info */  in ata_scsi_port_error_handler()
722 	ap->excl_link = NULL;	/* don't maintain exclusion over EH */  in ata_scsi_port_error_handler()
726 	/* invoke EH, skip if unloading or suspended */  in ata_scsi_port_error_handler()
742 	 * port but before this point.  Repeat EH in such case.  in ata_scsi_port_error_handler()
752 			     "EH pending after %d tries, giving up\n",  in ata_scsi_port_error_handler()
757 	/* this run is complete, make sure EH info is clear */  in ata_scsi_port_error_handler()
762 	 * end eh (clear host_eh_scheduled) while holding ap->lock such that if  in ata_scsi_port_error_handler()
763 	 * exception occurs after this point but before EH completion, SCSI  in ata_scsi_port_error_handler()
764 	 * midlayer will re-initiate EH.  in ata_scsi_port_error_handler()
785 		ata_port_info(ap, "EH complete\n");  in ata_scsi_port_error_handler()
798  *	ata_port_wait_eh - Wait for the currently pending EH to complete
799  *	@ap: Port to wait EH for
801  *	Wait until the currently pending EH is complete.
824 	/* make sure SCSI EH is complete */  in ata_port_wait_eh()
892  *	is non-zero and EH wasn't pending before.  Fast drain ensures
893  *	that EH kicks in in timely manner.
927  *	Schedule error handling for @qc.  EH will kick in as soon as
941 	 * ata_scsi_error() takes care of such scmds on EH entry.  in ata_qc_schedule_eh()
949  * ata_std_sched_eh - non-libsas ata_ports issue eh with this common routine
950  * @ap: ATA port to schedule EH for
968  * ata_std_end_eh - non-libsas ata_ports complete eh with this common routine
969  * @ap: ATA port to end EH for
990  *	@ap: ATA port to schedule EH for
992  *	Schedule error handling for @ap.  EH will kick in as soon as
1032  *	Abort all active qc's active on @link and schedule EH.
1050  *	Abort all active qc's of @ap and schedule EH.
1115  *	ata_eh_freeze_port - EH helper to freeze port
1134  *	ata_eh_thaw_port - EH helper to thaw port
1179  *	ata_eh_qc_complete - Complete an active ATA command from EH
1183  *	completed.  To be used from EH.
1193  *	ata_eh_qc_retry - Tell midlayer to retry an ATA command after EH
1197  *	should be retried.  To be used from EH.
1218  *	EH context.
1265 	/* clear per-dev EH info */  in ata_eh_detach_dev()
1280  *	Called just before performing EH actions to clear related bits
1281  *	in @link->eh_info such that eh actions are not unnecessarily
1301 	/* About to take EH action, set RECOVERED.  Ignore actions on  in ata_eh_about_to_do()
1311  *	ata_eh_done - EH action complete
1312  *	@link: ATA link for which EH actions are complete
1316  *	Called right after performing EH actions to clear related bits
1379  *	EH context (may sleep).
1407  *	SENSE.  This function is an EH helper.
1464  *	SENSE.  This function is EH helper.
2062 	 * context, the sense data for successful commands are fetched by EH.  in ata_eh_link_autopsy()
2123 	/* enforce default EH actions */  in ata_eh_link_autopsy()
2132 	 * perform per-dev EH action only on the offending device.  in ata_eh_link_autopsy()
2328  *	@link: ATA link EH is going on
2330  *	Report EH to user.
2523  *	@ap: ATA port to report EH about
2525  *	Report EH to user.
2709 		/* mark that this EH session started with reset */  in ata_eh_reset()
2913 		 * repeated EH runs but seems to be a better tradeoff than  in ata_eh_reset()
2968 	 * requirements of ATA_EH_PARK handling. Since the EH thread  in ata_eh_pull_park_action()
3237  *	EH context (may sleep).
3291  *	0 if EH can continue, -errno if EH needs to be repeated.
3329 		 * successfully complete a failed command from EH.  in ata_eh_maybe_retry_flush()
3364  *	EH context.
3607 	/* -EAGAIN from EH routine indicates retry without prejudice.  in ata_eh_handle_dev_fail()
3728 	/* prep for EH */  in ata_eh_recover()
3732 		/* skip EH if possible. */  in ata_eh_recover()
3821 		/* if PMP got attached, return, pmp EH will take care of it */  in ata_eh_recover()
3909  *	ata_eh_finish - finish up EH
3910  *	@ap: host port to finish EH for
3912  *	Recovery is complete.  Clean up EH states and retry or finish
3929 			/* FIXME: Once EH migration is complete,  in ata_eh_finish()
3962 	/* make sure nr_active_links is zero after EH */  in ata_eh_finish()