<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML
><HEAD
><TITLE
>pci_pool_create</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="PCI Support Library"
HREF="x8182.html"><LINK
REL="PREVIOUS"
TITLE="pci_setup_device"
HREF="r9057.html"><LINK
REL="NEXT"
TITLE="pci_pool_destroy"
HREF="r9148.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="r9057.html"
ACCESSKEY="P"
><<< Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="r9148.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="AEN9083"
></A
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>pci_pool_create</SPAN
></SPAN
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN9087"
></A
><H2
>Name</H2
>pci_pool_create -- Creates a pool of pci consistent memory blocks, for dma.
</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN9090"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN9092"
></A
><P
></P
><P
><CODE
><CODE
CLASS="FUNCDEF"
>struct pci_pool * <TT
CLASS="FUNCTION"
>pci_pool_create </TT
></CODE
>(const char * <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>, struct pci_dev * <TT
CLASS="PARAMETER"
><I
>pdev</I
></TT
>, size_t <TT
CLASS="PARAMETER"
><I
>size</I
></TT
>, size_t <TT
CLASS="PARAMETER"
><I
>align</I
></TT
>, size_t <TT
CLASS="PARAMETER"
><I
>allocation</I
></TT
>, int <TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9108"
></A
><H2
>Arguments</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
></DT
><DD
><P
> name of pool, for diagnostics
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>pdev</I
></TT
></DT
><DD
><P
> pci device that will be doing the DMA
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>size</I
></TT
></DT
><DD
><P
> size of the blocks in this pool.
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>align</I
></TT
></DT
><DD
><P
> alignment requirement for blocks; must be a power of two
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>allocation</I
></TT
></DT
><DD
><P
> returned blocks won't cross this boundary (or zero)
</P
></DD
><DT
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
></DT
><DD
><P
> SLAB_* flags (not all are supported).
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9141"
></A
><H2
>Description</H2
><P
> Returns a pci allocation pool with the requested characteristics, or
null if one can't be created. Given one of these pools, <TT
CLASS="FUNCTION"
>pci_pool_alloc</TT
>
may be used to allocate memory. Such memory will all have <SPAN
CLASS="QUOTE"
>"consistent"</SPAN
>
DMA mappings, accessible by the device and its driver without using
cache flushing primitives. The actual size of blocks allocated may be
larger than requested because of alignment.
</P
><P
> If allocation is nonzero, objects returned from <TT
CLASS="FUNCTION"
>pci_pool_alloc</TT
> won't
cross that size boundary. This is useful for devices which have
addressing restrictions on individual DMA transfers, such as not crossing
boundaries of 4KBytes.
</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="r9057.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="r9148.html"
ACCESSKEY="N"
>Next >>></A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>pci_setup_device</SPAN
></SPAN
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="x8182.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><SPAN
CLASS="phrase"
><SPAN
CLASS="PHRASE"
>pci_pool_destroy</SPAN
></SPAN
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
