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.
591 	 * For EH, all qcs are finished in one of three ways -  in ata_scsi_cmd_error_handler()
594 	 * completion wins, the qc never reaches EH.  When error  in ata_scsi_cmd_error_handler()
622 		 * If the scmd was added to EH, via ata_qc_schedule_eh() ->  in ata_scsi_cmd_error_handler()
655 	 * If we have timed out qcs.  They belong to EH from  in ata_scsi_cmd_error_handler()
684 	/* acquire EH ownership */  in ata_scsi_port_error_handler()
693 	/* fetch & clear EH info */  in ata_scsi_port_error_handler()
721 	ap->excl_link = NULL;	/* don't maintain exclusion over EH */  in ata_scsi_port_error_handler()
725 	/* invoke EH, skip if unloading or suspended */  in ata_scsi_port_error_handler()
741 	 * port but before this point.  Repeat EH in such case.  in ata_scsi_port_error_handler()
751 			     "EH pending after %d tries, giving up\n",  in ata_scsi_port_error_handler()
756 	/* this run is complete, make sure EH info is clear */  in ata_scsi_port_error_handler()
761 	 * end eh (clear host_eh_scheduled) while holding ap->lock such that if  in ata_scsi_port_error_handler()
762 	 * exception occurs after this point but before EH completion, SCSI  in ata_scsi_port_error_handler()
763 	 * midlayer will re-initiate EH.  in ata_scsi_port_error_handler()
784 		ata_port_info(ap, "EH complete\n");  in ata_scsi_port_error_handler()
797  *	ata_port_wait_eh - Wait for the currently pending EH to complete
798  *	@ap: Port to wait EH for
800  *	Wait until the currently pending EH is complete.
823 	/* make sure SCSI EH is complete */  in ata_port_wait_eh()
891  *	is non-zero and EH wasn't pending before.  Fast drain ensures
892  *	that EH kicks in in timely manner.
926  *	Schedule error handling for @qc.  EH will kick in as soon as
940 	 * ata_scsi_error() takes care of such scmds on EH entry.  in ata_qc_schedule_eh()
948  * ata_std_sched_eh - non-libsas ata_ports issue eh with this common routine
949  * @ap: ATA port to schedule EH for
967  * ata_std_end_eh - non-libsas ata_ports complete eh with this common routine
968  * @ap: ATA port to end EH for
989  *	@ap: ATA port to schedule EH for
991  *	Schedule error handling for @ap.  EH will kick in as soon as
1031  *	Abort all active qc's active on @link and schedule EH.
1049  *	Abort all active qc's of @ap and schedule EH.
1114  *	ata_eh_freeze_port - EH helper to freeze port
1133  *	ata_eh_thaw_port - EH helper to thaw port
1178  *	ata_eh_qc_complete - Complete an active ATA command from EH
1182  *	completed.  To be used from EH.
1192  *	ata_eh_qc_retry - Tell midlayer to retry an ATA command after EH
1196  *	should be retried.  To be used from EH.
1217  *	EH context.
1270 	/* clear per-dev EH info */  in ata_eh_detach_dev()
1285  *	Called just before performing EH actions to clear related bits
1286  *	in @link->eh_info such that eh actions are not unnecessarily
1306 	/* About to take EH action, set RECOVERED.  Ignore actions on  in ata_eh_about_to_do()
1316  *	ata_eh_done - EH action complete
1317  *	@link: ATA link for which EH actions are complete
1321  *	Called right after performing EH actions to clear related bits
1384  *	EH context (may sleep).
1412  *	SENSE.  This function is an EH helper.
1469  *	SENSE.  This function is EH helper.
2074 	 * context, the sense data for successful commands are fetched by EH.  in ata_eh_link_autopsy()
2135 	/* enforce default EH actions */  in ata_eh_link_autopsy()
2144 	 * perform per-dev EH action only on the offending device.  in ata_eh_link_autopsy()
2340  *	@link: ATA link EH is going on
2342  *	Report EH to user.
2535  *	@ap: ATA port to report EH about
2537  *	Report EH to user.
2721 		/* mark that this EH session started with reset */  in ata_eh_reset()
2925 		 * repeated EH runs but seems to be a better tradeoff than  in ata_eh_reset()
2978 	 * requirements of ATA_EH_PARK handling. Since the EH thread  in ata_eh_pull_park_action()
3257  *	EH context (may sleep).
3311  *	0 if EH can continue, -errno if EH needs to be repeated.
3349 		 * successfully complete a failed command from EH.  in ata_eh_maybe_retry_flush()
3384  *	EH context.
3627 	/* -EAGAIN from EH routine indicates retry without prejudice.  in ata_eh_handle_dev_fail()
3748 	/* prep for EH */  in ata_eh_recover()
3752 		/* skip EH if possible. */  in ata_eh_recover()
3841 		/* if PMP got attached, return, pmp EH will take care of it */  in ata_eh_recover()
3918  *	ata_eh_finish - finish up EH
3919  *	@ap: host port to finish EH for
3921  *	Recovery is complete.  Clean up EH states and retry or finish
3938 			/* FIXME: Once EH migration is complete,  in ata_eh_finish()
3971 	/* make sure nr_active_links is zero after EH */  in ata_eh_finish()