.\" 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 "BLK_STOP_QUEUE" "" "06 October 2005" "" ""

.SH NAME
blk_stop_queue \- stop a queue
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
void blk_stop_queue  (request_queue_t * \fIq\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIq\fB\fR
The &request_queue_t in question
.SH "DESCRIPTION"
.PP
The Linux block layer assumes that a block driver will consume all
entries on the request queue when the request_fn strategy is called.
Often this will not happen, because of hardware limitations (queue
depth settings). If a device driver gets a 'queue full' response,
or if it simply chooses not to queue more I/O at one point, it can
call this function to prevent the request_fn from being called until
the driver has signalled it's ready to go again. This happens by calling
\fBblk_start_queue\fR to restart queue operations. Queue lock must be held.