<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML
><HEAD
><TITLE
>blk_queue_headactive</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="The Linux Kernel API"
HREF="book1.html"><LINK
REL="UP"
TITLE="Block Devices"
HREF="c11504.html"><LINK
REL="PREVIOUS"
TITLE="blk_cleanup_queue"
HREF="r11506.html"><LINK
REL="NEXT"
TITLE="blk_queue_make_request"
HREF="r11576.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Linux Kernel API</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="r11506.html"
ACCESSKEY="P"
><<< Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="r11576.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="AEN11537"
></A
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>blk_queue_headactive</SPAN
></SPAN
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN11541"
></A
><H2
>Name</H2
>blk_queue_headactive -- indicate whether head of request queue may be active
</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN11544"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN11546"
></A
><P
></P
><P
><CODE
><CODE
CLASS="FUNCDEF"
>void <TT
CLASS="FUNCTION"
>blk_queue_headactive </TT
></CODE
>(request_queue_t * <TT
CLASS="PARAMETER"
><I
>q</I
></TT
>, int <TT
CLASS="PARAMETER"
><I
>active</I
></TT
>);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11554"
></A
><H2
>Arguments</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="PARAMETER"
><I
>q</I
></TT
></DT
><DD
><P
> The queue which this applies to.
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>active</I
></TT
></DT
><DD
><P
> A flag indication where the head of the queue is active.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11567"
></A
><H2
>Description</H2
><P
> The driver for a block device may choose to leave the currently active
request on the request queue, removing it only when it has completed.
The queue handling routines assume this by default for safety reasons
and will not involve the head of the request queue in any merging or
reordering of requests when the queue is unplugged (and thus may be
working on this particular request).
</P
><P
> If a driver removes requests from the queue before processing them, then
it may indicate that it does so, there by allowing the head of the queue
to be involved in merging and reordering. This is done be calling
<TT
CLASS="FUNCTION"
>blk_queue_headactive</TT
> with an <TT
CLASS="PARAMETER"
><I
>active</I
></TT
> flag of <TT
CLASS="CONSTANT"
>0</TT
>.
</P
><P
> If a driver processes several requests at once, it must remove them (or
at least all but one of them) from the request queue.
</P
><P
> When a queue is plugged the head will be assumed to be inactive.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="r11506.html"
ACCESSKEY="P"
><<< Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="book1.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="r11576.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>blk_cleanup_queue</SPAN
></SPAN
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="c11504.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>blk_queue_make_request</SPAN
></SPAN
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
