1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>blk_queue_dma_drain</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="The Linux Kernel API"><link rel="up" href="blkdev.html" title="Chapter&#160;14.&#160;Block Devices"><link rel="prev" href="API-blk-queue-update-dma-pad.html" title="blk_queue_update_dma_pad"><link rel="next" href="API-blk-queue-segment-boundary.html" title="blk_queue_segment_boundary"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">blk_queue_dma_drain</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-blk-queue-update-dma-pad.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;14.&#160;Block Devices</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-blk-queue-segment-boundary.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-blk-queue-dma-drain"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>blk_queue_dma_drain &#8212; 
2     Set up a drain buffer for excess dma.
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">blk_queue_dma_drain </b>(</code></td><td>struct request_queue * <var class="pdparam">q</var>, </td></tr><tr><td>&#160;</td><td>dma_drain_needed_fn * <var class="pdparam">dma_drain_needed</var>, </td></tr><tr><td>&#160;</td><td>void * <var class="pdparam">buf</var>, </td></tr><tr><td>&#160;</td><td>unsigned int <var class="pdparam">size</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1128581012"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>q</code></em></span></dt><dd><p>
4     the request queue for the device
5    </p></dd><dt><span class="term"><em class="parameter"><code>dma_drain_needed</code></em></span></dt><dd><p>
6     fn which returns non-zero if drain is necessary
7    </p></dd><dt><span class="term"><em class="parameter"><code>buf</code></em></span></dt><dd><p>
8     physically contiguous buffer
9    </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
10     size of the buffer in bytes
11    </p></dd></dl></div></div><div class="refsect1"><a name="idp1128585724"></a><h2>Description</h2><p>
12   Some devices have excess DMA problems and can't simply discard (or
13   zero fill) the unwanted piece of the transfer.  They have to have a
14   real area of memory to transfer it into.  The use case for this is
15   ATAPI devices in DMA mode.  If the packet command causes a transfer
16   bigger than the transfer size some HBAs will lock up if there
17   aren't DMA elements to contain the excess transfer.  What this API
18   does is adjust the queue so that the buf is always appended
19   silently to the scatterlist.
20</p></div><div class="refsect1"><a name="idp1128586836"></a><h2>Note</h2><p>
21   This routine adjusts max_hw_segments to make room for appending
22   the drain buffer.  If you call <code class="function">blk_queue_max_segments</code> after calling
23   this routine, you must set the limit to one fewer than your device
24   can support otherwise there won't be room for the drain buffer.
25</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-blk-queue-update-dma-pad.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="blkdev.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-blk-queue-segment-boundary.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">blk_queue_update_dma_pad</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">blk_queue_segment_boundary</span></td></tr></table></div></body></html>
26