.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SCSI_UNJAM_HOST" "" "06 October 2005" "" ""

.SH NAME
scsi_unjam_host \- Attempt to fix a host which has a cmd that failed.
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
void scsi_unjam_host  (struct Scsi_Host * \fIshost\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIshost\fB\fR
Host to unjam.
.SH "NOTES"
.PP
When we come in here, we *know* that all commands on the bus have
either completed, failed or timed out.  we also know that no further
commands are being sent to the host, so things are relatively quiet
and we have freedom to fiddle with things as we wish.
.PP
This is only the *default* implementation.  it is possible for
individual drivers to supply their own version of this function, and
if the maintainer wishes to do this, it is strongly suggested that
this function be taken as a template and modified.  this function
was designed to correctly handle problems for about 95% of the
different cases out there, and it should always provide at least a
reasonable amount of error recovery.
.PP
Any command marked 'failed' or 'timeout' must eventually have
\fBscsi_finish_cmd\fR called for it.  we do all of the retry stuff
here, so when we restart the host after we return it should have an
empty queue.