€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ$/translations/zh_CN/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/zh_TW/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/it_IT/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ja_JP/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ko_KR/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/sp_SP/core-api/dma-api”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ,Dynamic DMA mapping using the generic device”h]”hŒ,Dynamic DMA mapping using the generic device”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ>/var/lib/git/docbuild/linux/Documentation/core-api/dma-api.rst”h KubhŒ field_list”“”)”}”(hhh]”hŒfield”“”)”}”(hhh]”(hŒ field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhh¾hŸh¶h KubhŒ field_body”“”)”}”(hŒ=James E.J. Bottomley ”h]”hŒ paragraph”“”)”}”(hŒ”h]”(hŒJames E.J. Bottomley <”…””}”(hhÙhžhhŸNh NubhŒ reference”“”)”}”(hŒ%James.Bottomley@HansenPartnership.com”h]”hŒ%James.Bottomley@HansenPartnership.com”…””}”(hhãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ,mailto:James.Bottomley@HansenPartnership.com”uh1háhhÙubhŒ>”…””}”(hhÙhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KhhÓubah}”(h]”h ]”h"]”h$]”h&]”uh1hÑhh¾ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hŸh¶h Khh¹hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hh£hžhhŸh¶h KubhØ)”}”(hŒ”This document describes the DMA API. For a more gentle introduction of the API (and actual examples), see Documentation/core-api/dma-api-howto.rst.”h]”hŒ”This document describes the DMA API. For a more gentle introduction of the API (and actual examples), see Documentation/core-api/dma-api-howto.rst.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khh£hžhubhØ)”}”(hX9This API is split into two pieces. Part I describes the basic API. Part II describes extensions for supporting non-coherent memory machines. Unless you know that your driver absolutely has to support non-coherent platforms (this is usually only legacy platforms) you should only use the API described in part I.”h]”hX9This API is split into two pieces. Part I describes the basic API. Part II describes extensions for supporting non-coherent memory machines. Unless you know that your driver absolutely has to support non-coherent platforms (this is usually only legacy platforms) you should only use the API described in part I.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K hh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒPart I - DMA API”h]”hŒPart I - DMA API”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj+hžhhŸh¶h KubhØ)”}”(hŒzTo get the DMA API, you must #include . This provides dma_addr_t and the interfaces described below.”h]”hŒzTo get the DMA API, you must #include . This provides dma_addr_t and the interfaces described below.”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khj+hžhubhØ)”}”(hX A dma_addr_t can hold any valid DMA address for the platform. It can be given to a device to use as a DMA source or target. A CPU cannot reference a dma_addr_t directly because there may be translation between its physical address space and the DMA address space.”h]”hX A dma_addr_t can hold any valid DMA address for the platform. It can be given to a device to use as a DMA source or target. A CPU cannot reference a dma_addr_t directly because there may be translation between its physical address space and the DMA address space.”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Khj+hžhubeh}”(h]”Œpart-i-dma-api”ah ]”h"]”Œpart i - dma api”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ*Part Ia - Using large DMA-coherent buffers”h]”hŒ*Part Ia - Using large DMA-coherent buffers”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj`hžhhŸh¶h KubhŒ literal_block”“”)”}”(hŒqvoid * dma_alloc_coherent(struct device *dev, size_t size, dma_addr_t *dma_handle, gfp_t flag)”h]”hŒqvoid * dma_alloc_coherent(struct device *dev, size_t size, dma_addr_t *dma_handle, gfp_t flag)”…””}”hjssbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1jqhŸh¶h K hj`hžhubhØ)”}”(hX+Coherent memory is memory for which a write by either the device or the processor can immediately be read by the processor or device without having to worry about caching effects. (You may however need to make sure to flush the processor's write buffers before telling devices to read that memory.)”h]”hX-Coherent memory is memory for which a write by either the device or the processor can immediately be read by the processor or device without having to worry about caching effects. (You may however need to make sure to flush the processorâ€™s write buffers before telling devices to read that memory.)”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K$hj`hžhubhØ)”}”(hŒCThis routine allocates a region of bytes of coherent memory.”h]”hŒCThis routine allocates a region of bytes of coherent memory.”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K*hj`hžhubhØ)”}”(hŒyIt returns a pointer to the allocated region (in the processor's virtual address space) or NULL if the allocation failed.”h]”hŒ{It returns a pointer to the allocated region (in the processorâ€™s virtual address space) or NULL if the allocation failed.”…””}”(hjŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K,hj`hžhubhØ)”}”(hŒ It also returns a which may be cast to an unsigned integer the same width as the bus and given to the device as the DMA address base of the region.”h]”hŒ It also returns a which may be cast to an unsigned integer the same width as the bus and given to the device as the DMA address base of the region.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K/hj`hžhubhØ)”}”(hXNote: coherent memory can be expensive on some platforms, and the minimum allocation length may be as big as a page, so you should consolidate your requests for coherent memory as much as possible. The simplest way to do that is to use the dma_pool calls (see below).”h]”hXNote: coherent memory can be expensive on some platforms, and the minimum allocation length may be as big as a page, so you should consolidate your requests for coherent memory as much as possible. The simplest way to do that is to use the dma_pool calls (see below).”…””}”(hj»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K3hj`hžhubhØ)”}”(hŒÊThe flag parameter allows the caller to specify the ``GFP_`` flags (see kmalloc()) for the allocation (the implementation may ignore flags that affect the location of the returned memory, like GFP_DMA).”h]”(hŒ4The flag parameter allows the caller to specify the ”…””}”(hjÉhžhhŸNh NubhŒliteral”“”)”}”(hŒ``GFP_``”h]”hŒGFP_”…””}”(hjÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÉubhŒŽ flags (see kmalloc()) for the allocation (the implementation may ignore flags that affect the location of the returned memory, like GFP_DMA).”…””}”(hjÉhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K8hj`hžhubjr)”}”(hŒpvoid dma_free_coherent(struct device *dev, size_t size, void *cpu_addr, dma_addr_t dma_handle)”h]”hŒpvoid dma_free_coherent(struct device *dev, size_t size, void *cpu_addr, dma_addr_t dma_handle)”…””}”hjësbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h K>hj`hžhubhØ)”}”(hŒØFree a previously allocated region of coherent memory. dev, size and dma_handle must all be the same as those passed into dma_alloc_coherent(). cpu_addr must be the virtual address returned by dma_alloc_coherent().”h]”hŒØFree a previously allocated region of coherent memory. dev, size and dma_handle must all be the same as those passed into dma_alloc_coherent(). cpu_addr must be the virtual address returned by dma_alloc_coherent().”…””}”(hjùhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KBhj`hžhubhØ)”}”(hŒ`Note that unlike the sibling allocation call, this routine may only be called with IRQs enabled.”h]”hŒ`Note that unlike the sibling allocation call, this routine may only be called with IRQs enabled.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KFhj`hžhubeh}”(h]”Œ(part-ia-using-large-dma-coherent-buffers”ah ]”h"]”Œ*part ia - using large dma-coherent buffers”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ*Part Ib - Using small DMA-coherent buffers”h]”hŒ*Part Ib - Using small DMA-coherent buffers”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjhžhhŸh¶h KKubhØ)”}”(hŒDTo get this part of the DMA API, you must #include ”h]”hŒDTo get this part of the DMA API, you must #include ”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KMhjhžhubhØ)”}”(hX¸Many drivers need lots of small DMA-coherent memory regions for DMA descriptors or I/O buffers. Rather than allocating in units of a page or more using dma_alloc_coherent(), you can use DMA pools. These work much like a struct kmem_cache, except that they use the DMA-coherent allocator, not __get_free_pages(). Also, they understand common hardware constraints for alignment, like queue heads needing to be aligned on N-byte boundaries.”h]”hX¸Many drivers need lots of small DMA-coherent memory regions for DMA descriptors or I/O buffers. Rather than allocating in units of a page or more using dma_alloc_coherent(), you can use DMA pools. These work much like a struct kmem_cache, except that they use the DMA-coherent allocator, not __get_free_pages(). Also, they understand common hardware constraints for alignment, like queue heads needing to be aligned on N-byte boundaries.”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KOhjhžhubhŒindex”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(Œsingle”Œ!dma_pool_create_node (C function)”Œc.dma_pool_create_node”hNt”auh1jJhjhžhhŸNh NubhŒdesc”“”)”}”(hhh]”(hŒdesc_signature”“”)”}”(hŒƒstruct dma_pool * dma_pool_create_node (const char *name, struct device *dev, size_t size, size_t align, size_t boundary, int node)”h]”hŒdesc_signature_line”“”)”}”(hŒstruct dma_pool *dma_pool_create_node(const char *name, struct device *dev, size_t size, size_t align, size_t boundary, int node)”h]”(hŒdesc_sig_keyword”“”)”}”(hŒstruct”h]”hŒstruct”…””}”(hjnhžhhŸNh Nubah}”(h]”h ]”Œk”ah"]”h$]”h&]”uh1jlhjhhžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KËubhŒdesc_sig_space”“”)”}”(hŒ ”h]”hŒ ”…””}”(hj€hžhhŸNh Nubah}”(h]”h ]”Œw”ah"]”h$]”h&]”uh1j~hjhhžhhŸj}h KËubh)”}”(hhh]”hŒ desc_sig_name”“”)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hj”hžhhŸNh Nubah}”(h]”h ]”Œn”ah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”Œc”Œreftype”Œ identifier”Œ reftarget”j–Œmodname”NŒ classname”NŒc:parent_key”Œsphinx.domains.c”Œ LookupKey”“”)”}”Œdata”]”j±Œ ASTIdentifier”“”)”}”j¬Œdma_pool_create_node”sbŒc.dma_pool_create_node”†”asbuh1hhjhhžhhŸj}h KËubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjhhžhhŸj}h KËubhŒdesc_sig_punctuation”“”)”}”(hŒ*”h]”hŒ*”…””}”(hjÏhžhhŸNh Nubah}”(h]”h ]”Œp”ah"]”h$]”h&]”uh1jÍhjhhžhhŸj}h KËubhŒ desc_name”“”)”}”(hŒdma_pool_create_node”h]”j“)”}”(hj¼h]”hŒdma_pool_create_node”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjàubah}”(h]”h ]”(Œsig-name”Œdescname”eh"]”h$]”h&]”jj‚uh1jÞhjhhžhhŸj}h KËubhŒdesc_parameterlist”“”)”}”(hŒ\(const char *name, struct device *dev, size_t size, size_t align, size_t boundary, int node)”h]”(hŒdesc_parameter”“”)”}”(hŒconst char *name”h]”(jm)”}”(hŒconst”h]”hŒconst”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubhŒdesc_sig_keyword_type”“”)”}”(hŒchar”h]”hŒchar”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”Œkt”ah"]”h$]”h&]”uh1j!hjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj@hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjubj“)”}”(hŒname”h]”hŒname”…””}”(hjMhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒstruct device *dev”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjfhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjbubj)”}”(hŒ ”h]”hŒ ”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbubh)”}”(hhh]”j“)”}”(hŒdevice”h]”hŒdevice”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j†Œmodname”NŒ classname”Nj°j³)”}”j¶]”jºŒc.dma_pool_create_node”†”asbuh1hhjbubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj°hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjbubj“)”}”(hŒdev”h]”hŒdev”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjbubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒsize_t size”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÖubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÛŒmodname”NŒ classname”Nj°j³)”}”j¶]”jºŒc.dma_pool_create_node”†”asbuh1hhjÒubj)”}”(hŒ ”h]”hŒ ”…””}”(hj÷hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒubj“)”}”(hŒsize”h]”hŒsize”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒsize_t align”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j#Œmodname”NŒ classname”Nj°j³)”}”j¶]”jºŒc.dma_pool_create_node”†”asbuh1hhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubj“)”}”(hŒalign”h]”hŒalign”…””}”(hjMhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒsize_t boundary”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjihžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjfubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jkŒmodname”NŒ classname”Nj°j³)”}”j¶]”jºŒc.dma_pool_create_node”†”asbuh1hhjbubj)”}”(hŒ ”h]”hŒ ”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbubj“)”}”(hŒboundary”h]”hŒboundary”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjbubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒint node”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjªubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¼hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjªubj“)”}”(hŒnode”h]”hŒnode”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjªubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjhhžhhŸj}h KËubeh}”(h]”h ]”h"]”h$]”h&]”jj‚Œ add_permalink”ˆuh1jfŒsphinx_line_type”Œ declarator”hjbhžhhŸj}h KËubah}”(h]”jYah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œis_multiline”ˆŒ _toc_parts”)Œ _toc_name”huh1j`hŸj}h KËhj]hžhubhŒdesc_content”“”)”}”(hhh]”hØ)”}”(hŒ-Creates a pool of coherent DMA memory blocks.”h]”hŒ-Creates a pool of coherent DMA memory blocks.”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KËhjûhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj]hžhhŸj}h KËubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”Œdomain”jªŒobjtype”jŒdesctype”jŒnoindex”‰Œnoindexentry”‰Œnocontentsentry”‰uh1j[hžhhjhŸNh NubhŒ container”“”)”}”(hXT**Parameters** ``const char *name`` name of pool, for diagnostics ``struct device *dev`` device that will be doing the DMA ``size_t size`` size of the blocks in this pool. ``size_t align`` alignment requirement for blocks; must be a power of two ``size_t boundary`` returned blocks won't cross this power of two boundary ``int node`` optional NUMA node to allocate structs 'dma_pool' and 'dma_page' on **Context** not in_interrupt() **Description** Given one of these pools, dma_pool_alloc() may be used to allocate memory. Such memory will all have coherent 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. If **boundary** is nonzero, objects returned from dma_pool_alloc() 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. **Return** a dma allocation pool with the requested characteristics, or ``NULL`` if one can't be created.”h]”(hØ)”}”(hŒ**Parameters**”h]”hŒstrong”“”)”}”(hj(h]”hŒ Parameters”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÏhj"ubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ3``const char *name`` name of pool, for diagnostics ”h]”(hŒterm”“”)”}”(hŒ``const char *name``”h]”jÒ)”}”(hjOh]”hŒconst char *name”…””}”(hjQhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÌhjGubhŒ definition”“”)”}”(hhh]”hØ)”}”(hŒname of pool, for diagnostics”h]”hŒname of pool, for diagnostics”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjdh KÌhjgubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjGubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjdh KÌhjBubjF)”}”(hŒ9``struct device *dev`` device that will be doing the DMA ”h]”(jL)”}”(hŒ``struct device *dev``”h]”jÒ)”}”(hjŠh]”hŒstruct device *dev”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjˆubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÍhj„ubjf)”}”(hhh]”hØ)”}”(hŒ!device that will be doing the DMA”h]”hŒ!device that will be doing the DMA”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŸh KÍhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj„ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŸh KÍhjBubjF)”}”(hŒ1``size_t size`` size of the blocks in this pool. ”h]”(jL)”}”(hŒ``size_t size``”h]”jÒ)”}”(hjÃh]”hŒsize_t size”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÎhj½ubjf)”}”(hhh]”hØ)”}”(hŒ size of the blocks in this pool.”h]”hŒ size of the blocks in this pool.”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjØh KÎhjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj½ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjØh KÎhjBubjF)”}”(hŒJ``size_t align`` alignment requirement for blocks; must be a power of two ”h]”(jL)”}”(hŒ``size_t align``”h]”jÒ)”}”(hjüh]”hŒsize_t align”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjúubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÏhjöubjf)”}”(hhh]”hØ)”}”(hŒ8alignment requirement for blocks; must be a power of two”h]”hŒ8alignment requirement for blocks; must be a power of two”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh KÏhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjöubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh KÏhjBubjF)”}”(hŒK``size_t boundary`` returned blocks won't cross this power of two boundary ”h]”(jL)”}”(hŒ``size_t boundary``”h]”jÒ)”}”(hj5h]”hŒsize_t boundary”…””}”(hj7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj3ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÐhj/ubjf)”}”(hhh]”hØ)”}”(hŒ6returned blocks won't cross this power of two boundary”h]”hŒ8returned blocks wonâ€™t cross this power of two boundary”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjJh KÐhjKubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjJh KÐhjBubjF)”}”(hŒQ``int node`` optional NUMA node to allocate structs 'dma_pool' and 'dma_page' on ”h]”(jL)”}”(hŒ``int node``”h]”jÒ)”}”(hjnh]”hŒint node”…””}”(hjphžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjlubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÑhjhubjf)”}”(hhh]”hØ)”}”(hŒCoptional NUMA node to allocate structs 'dma_pool' and 'dma_page' on”h]”hŒKoptional NUMA node to allocate structs â€˜dma_poolâ€™ and â€˜dma_pageâ€™ on”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjƒh KÑhj„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjhubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjƒh KÑhjBubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj"ubhØ)”}”(hŒ**Context**”h]”j+)”}”(hj©h]”hŒContext”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj§ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÓhj"ubhØ)”}”(hŒnot in_interrupt()”h]”hŒnot in_interrupt()”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÒhj"ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÐh]”hŒDescription”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÎubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÔhj"ubhØ)”}”(hX%Given one of these pools, dma_pool_alloc() may be used to allocate memory. Such memory will all have coherent 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.”h]”hX%Given one of these pools, dma_pool_alloc() may be used to allocate memory. Such memory will all have coherent 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.”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÓhj"ubhØ)”}”(hŒêIf **boundary** is nonzero, objects returned from dma_pool_alloc() 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.”h]”(hŒIf ”…””}”(hjõhžhhŸNh Nubj+)”}”(hŒ**boundary**”h]”hŒboundary”…””}”(hjýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjõubhŒÝ is nonzero, objects returned from dma_pool_alloc() 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.”…””}”(hjõhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÙhj"ubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjh]”hŒReturn”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h KÞhj"ubhØ)”}”(hŒ^a dma allocation pool with the requested characteristics, or ``NULL`` if one can't be created.”h]”(hŒ=a dma allocation pool with the requested characteristics, or ”…””}”(hj.hžhhŸNh NubjÒ)”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj.ubhŒ if one canâ€™t be created.”…””}”(hj.hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Kßhj"ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdma_pool_destroy (C function)”Œc.dma_pool_destroy”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ-void dma_pool_destroy (struct dma_pool *pool)”h]”jg)”}”(hŒ,void dma_pool_destroy(struct dma_pool *pool)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjkhžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mdubj)”}”(hŒ ”h]”hŒ ”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjkhžhhŸj}h Mdubjß)”}”(hŒdma_pool_destroy”h]”j“)”}”(hŒdma_pool_destroy”h]”hŒdma_pool_destroy”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŒubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjkhžhhŸj}h Mdubjú)”}”(hŒ(struct dma_pool *pool)”h]”j)”}”(hŒstruct dma_pool *pool”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj¨ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¨ubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÇubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÌŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j’sbŒc.dma_pool_destroy”†”asbuh1hhj¨ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjêhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¨ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjøhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj¨ubj“)”}”(hŒpool”h]”hŒpool”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¨ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¤ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjkhžhhŸj}h Mdubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjghžhhŸj}h Mdubah}”(h]”jbah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj}h Mdhjdhžhubjú)”}”(hhh]”hØ)”}”(hŒ%destroys a pool of dma memory blocks.”h]”hŒ%destroys a pool of dma memory blocks.”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mdhj,hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjdhžhhŸj}h Mdubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjGjjGj‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hŒõ**Parameters** ``struct dma_pool *pool`` dma pool that will be destroyed **Context** !in_interrupt() **Description** Caller guarantees that no more memory from the pool is in use, and that nothing will try to use the pool after this call.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjQh]”hŒ Parameters”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjOubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MhhjKubjA)”}”(hhh]”jF)”}”(hŒ:``struct dma_pool *pool`` dma pool that will be destroyed ”h]”(jL)”}”(hŒ``struct dma_pool *pool``”h]”jÒ)”}”(hjph]”hŒstruct dma_pool *pool”…””}”(hjrhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjnubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mehjjubjf)”}”(hhh]”hØ)”}”(hŒdma pool that will be destroyed”h]”hŒdma pool that will be destroyed”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj…h Mehj†ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj…h Mehjgubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjKubhØ)”}”(hŒ**Context**”h]”j+)”}”(hj«h]”hŒContext”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj©ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MghjKubhØ)”}”(hŒ!in_interrupt()”h]”hŒ!in_interrupt()”…””}”(hjÁhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MfhjKubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÒh]”hŒDescription”…””}”(hjÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÐubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MhhjKubhØ)”}”(hŒyCaller guarantees that no more memory from the pool is in use, and that nothing will try to use the pool after this call.”h]”hŒyCaller guarantees that no more memory from the pool is in use, and that nothing will try to use the pool after this call.”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MghjKubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdma_pool_alloc (C function)”Œc.dma_pool_alloc”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒRvoid * dma_pool_alloc (struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”jg)”}”(hŒPvoid *dma_pool_alloc(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj hžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MŽubj)”}”(hŒ ”h]”hŒ ”…””}”(hj& hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj hžhhŸj% h MŽubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj4 hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj hžhhŸj% h MŽubjß)”}”(hŒdma_pool_alloc”h]”j“)”}”(hŒdma_pool_alloc”h]”hŒdma_pool_alloc”…””}”(hjE hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjA ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj hžhhŸj% h MŽubjú)”}”(hŒ<(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”(j)”}”(hŒstruct dma_pool *pool”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hja hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj] ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjn hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj] ubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj| ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jG sbŒc.dma_pool_alloc”†”asbuh1hhj] ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjŸ hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj] ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj] ubj“)”}”(hŒpool”h]”hŒpool”…””}”(hjº hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj] ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjY ubj)”}”(hŒgfp_t mem_flags”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjÖ hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÓ ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jØ Œmodname”NŒ classname”Nj°j³)”}”j¶]”j› Œc.dma_pool_alloc”†”asbuh1hhjÏ ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjô hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÏ ubj“)”}”(hŒ mem_flags”h]”hŒ mem_flags”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÏ ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjY ubj)”}”(hŒdma_addr_t *handle”h]”(h)”}”(hhh]”j“)”}”(hŒ dma_addr_t”h]”hŒ dma_addr_t”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j Œmodname”NŒ classname”Nj°j³)”}”j¶]”j› Œc.dma_pool_alloc”†”asbuh1hhj ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj< hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjJ hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj ubj“)”}”(hŒhandle”h]”hŒhandle”…””}”(hjW hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjY ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj hžhhŸj% h MŽubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj hžhhŸj% h MŽubah}”(h]”j ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj% h MŽhj hžhubjú)”}”(hhh]”hØ)”}”(hŒget a block of coherent memory”h]”hŒget a block of coherent memory”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MŽhj~ hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj hžhhŸj% h MŽubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj™ jj™ j‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hXe**Parameters** ``struct dma_pool *pool`` dma pool that will produce the block ``gfp_t mem_flags`` GFP_* bitmask ``dma_addr_t *handle`` pointer to dma address of block **Return** the kernel virtual address of a currently unused block, and reports its dma address through the handle. If such a memory block can't be allocated, ``NULL`` is returned.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj£ h]”hŒ Parameters”…””}”(hj¥ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¡ ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M’hj ubjA)”}”(hhh]”(jF)”}”(hŒ?``struct dma_pool *pool`` dma pool that will produce the block ”h]”(jL)”}”(hŒ``struct dma_pool *pool``”h]”jÒ)”}”(hjÂ h]”hŒstruct dma_pool *pool”…””}”(hjÄ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÀ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhj¼ ubjf)”}”(hhh]”hØ)”}”(hŒ$dma pool that will produce the block”h]”hŒ$dma pool that will produce the block”…””}”(hjÛ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj× h MhjØ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj¼ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj× h Mhj¹ ubjF)”}”(hŒ"``gfp_t mem_flags`` GFP_* bitmask ”h]”(jL)”}”(hŒ``gfp_t mem_flags``”h]”jÒ)”}”(hjû h]”hŒgfp_t mem_flags”…””}”(hjý hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjù ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhjõ ubjf)”}”(hhh]”hØ)”}”(hŒ GFP_* bitmask”h]”hŒ GFP_* bitmask”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh Mhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjõ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh Mhj¹ ubjF)”}”(hŒ7``dma_addr_t *handle`` pointer to dma address of block ”h]”(jL)”}”(hŒ``dma_addr_t *handle``”h]”jÒ)”}”(hj4h]”hŒdma_addr_t *handle”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M‘hj.ubjf)”}”(hhh]”hØ)”}”(hŒpointer to dma address of block”h]”hŒpointer to dma address of block”…””}”(hjMhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjIh M‘hjJubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj.ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjIh M‘hj¹ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj ubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjoh]”hŒReturn”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjmubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M“hj ubhØ)”}”(hŒ¨the kernel virtual address of a currently unused block, and reports its dma address through the handle. If such a memory block can't be allocated, ``NULL`` is returned.”h]”(hŒ•the kernel virtual address of a currently unused block, and reports its dma address through the handle. If such a memory block canâ€™t be allocated, ”…””}”(hj…hžhhŸNh NubjÒ)”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj…ubhŒ is returned.”…””}”(hj…hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M“hj ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdma_pool_free (C function)”Œc.dma_pool_free”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒGvoid dma_pool_free (struct dma_pool *pool, void *vaddr, dma_addr_t dma)”h]”jg)”}”(hŒFvoid dma_pool_free(struct dma_pool *pool, void *vaddr, dma_addr_t dma)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjÆhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÂhžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M½ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÂhžhhŸjÔh M½ubjß)”}”(hŒ dma_pool_free”h]”j“)”}”(hŒ dma_pool_free”h]”hŒ dma_pool_free”…””}”(hjçhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjãubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÂhžhhŸjÔh M½ubjú)”}”(hŒ4(struct dma_pool *pool, void *vaddr, dma_addr_t dma)”h]”(j)”}”(hŒstruct dma_pool *pool”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÿubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÿubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j#Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jésbŒc.dma_pool_free”†”asbuh1hhjÿubj)”}”(hŒ ”h]”hŒ ”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÿubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÿubj“)”}”(hŒpool”h]”hŒpool”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÿubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒvoid *vaddr”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjqubj)”}”(hŒ ”h]”hŒ ”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjqubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjqubj“)”}”(hŒvaddr”h]”hŒvaddr”…””}”(hjžhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjqubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubj)”}”(hŒdma_addr_t dma”h]”(h)”}”(hhh]”j“)”}”(hŒ dma_addr_t”h]”hŒ dma_addr_t”…””}”(hjºhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj·ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¼Œmodname”NŒ classname”Nj°j³)”}”j¶]”j=Œc.dma_pool_free”†”asbuh1hhj³ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj³ubj“)”}”(hŒdma”h]”hŒdma”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj³ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjûubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÂhžhhŸjÔh M½ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj¾hžhhŸjÔh M½ubah}”(h]”j¹ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjÔh M½hj»hžhubjú)”}”(hhh]”hØ)”}”(hŒput block back into dma pool”h]”hŒput block back into dma pool”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M½hj hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj»hžhhŸjÔh M½ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj( jj( j‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hX**Parameters** ``struct dma_pool *pool`` the dma pool holding the block ``void *vaddr`` virtual address of block ``dma_addr_t dma`` dma address of block **Description** Caller promises neither device nor driver will again touch this block unless it is first re-allocated.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj2 h]”hŒ Parameters”…””}”(hj4 hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj0 ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MÁhj, ubjA)”}”(hhh]”(jF)”}”(hŒ9``struct dma_pool *pool`` the dma pool holding the block ”h]”(jL)”}”(hŒ``struct dma_pool *pool``”h]”jÒ)”}”(hjQ h]”hŒstruct dma_pool *pool”…””}”(hjS hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjO ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M¾hjK ubjf)”}”(hhh]”hØ)”}”(hŒthe dma pool holding the block”h]”hŒthe dma pool holding the block”…””}”(hjj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjf h M¾hjg ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjK ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjf h M¾hjH ubjF)”}”(hŒ)``void *vaddr`` virtual address of block ”h]”(jL)”}”(hŒ``void *vaddr``”h]”jÒ)”}”(hjŠ h]”hŒvoid *vaddr”…””}”(hjŒ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjˆ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h M¿hj„ ubjf)”}”(hhh]”hØ)”}”(hŒvirtual address of block”h]”hŒvirtual address of block”…””}”(hj£ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŸ h M¿hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj„ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŸ h M¿hjH ubjF)”}”(hŒ(``dma_addr_t dma`` dma address of block ”h]”(jL)”}”(hŒ``dma_addr_t dma``”h]”jÒ)”}”(hjÃ h]”hŒdma_addr_t dma”…””}”(hjÅ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÁ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MÀhj½ ubjf)”}”(hhh]”hØ)”}”(hŒdma address of block”h]”hŒdma address of block”…””}”(hjÜ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjØ h MÀhjÙ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj½ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjØ h MÀhjH ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj, ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjþ h]”hŒDescription”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjü ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MÂhj, ubhØ)”}”(hŒfCaller promises neither device nor driver will again touch this block unless it is first re-allocated.”h]”hŒfCaller promises neither device nor driver will again touch this block unless it is first re-allocated.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MÁhj, ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdmam_pool_create (C function)”Œc.dmam_pool_create”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒwstruct dma_pool * dmam_pool_create (const char *name, struct device *dev, size_t size, size_t align, size_t allocation)”h]”jg)”}”(hŒustruct dma_pool *dmam_pool_create(const char *name, struct device *dev, size_t size, size_t align, size_t allocation)”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjChžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj?hžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mãubj)”}”(hŒ ”h]”hŒ ”…””}”(hjQhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj?hžhhŸjPh Mãubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hjbhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj_ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jdŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œdmam_pool_create”sbŒc.dmam_pool_create”†”asbuh1hhj?hžhhŸjPh Mãubj)”}”(hŒ ”h]”hŒ ”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj?hžhhŸjPh MãubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj?hžhhŸjPh Mãubjß)”}”(hŒdmam_pool_create”h]”j“)”}”(hj€h]”hŒdmam_pool_create”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjžubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj?hžhhŸjPh Mãubjú)”}”(hŒT(const char *name, struct device *dev, size_t size, size_t align, size_t allocation)”h]”(j)”}”(hŒconst char *name”h]”(jm)”}”(hjh]”hŒconst”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj¹ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¹ubj")”}”(hŒchar”h]”hŒchar”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj¹ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¹ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj¹ubj“)”}”(hŒname”h]”hŒname”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¹ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjµubj)”}”(hŒstruct device *dev”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubh)”}”(hhh]”j“)”}”(hŒdevice”h]”hŒdevice”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj5ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j:Œmodname”NŒ classname”Nj°j³)”}”j¶]”j~Œc.dmam_pool_create”†”asbuh1hhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjVhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjubj“)”}”(hŒdev”h]”hŒdev”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjµubj)”}”(hŒsize_t size”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŒmodname”NŒ classname”Nj°j³)”}”j¶]”j~Œc.dmam_pool_create”†”asbuh1hhj†ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj†ubj“)”}”(hŒsize”h]”hŒsize”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj†ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjµubj)”}”(hŒsize_t align”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j×Œmodname”NŒ classname”Nj°j³)”}”j¶]”j~Œc.dmam_pool_create”†”asbuh1hhjÎubj)”}”(hŒ ”h]”hŒ ”…””}”(hjóhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎubj“)”}”(hŒalign”h]”hŒalign”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÎubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjµubj)”}”(hŒsize_t allocation”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŒmodname”NŒ classname”Nj°j³)”}”j¶]”j~Œc.dmam_pool_create”†”asbuh1hhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubj“)”}”(hŒ allocation”h]”hŒ allocation”…””}”(hjIhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjµubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj?hžhhŸjPh Mãubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj;hžhhŸjPh Mãubah}”(h]”j6ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjPh Mãhj8hžhubjú)”}”(hhh]”hØ)”}”(hŒManaged dma_pool_create()”h]”hŒManaged dma_pool_create()”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mãhjphžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj8hžhhŸjPh Mãubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj‹jj‹j‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hXA**Parameters** ``const char *name`` name of pool, for diagnostics ``struct device *dev`` device that will be doing the DMA ``size_t size`` size of the blocks in this pool. ``size_t align`` alignment requirement for blocks; must be a power of two ``size_t allocation`` returned blocks won't cross this boundary (or zero) **Description** Managed dma_pool_create(). DMA pool created with this function is automatically destroyed on driver detach. **Return** a managed dma allocation pool with the requested characteristics, or ``NULL`` if one can't be created.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj•h]”hŒ Parameters”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MçhjubjA)”}”(hhh]”(jF)”}”(hŒ3``const char *name`` name of pool, for diagnostics ”h]”(jL)”}”(hŒ``const char *name``”h]”jÒ)”}”(hj´h]”hŒconst char *name”…””}”(hj¶hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj²ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mähj®ubjf)”}”(hhh]”hØ)”}”(hŒname of pool, for diagnostics”h]”hŒname of pool, for diagnostics”…””}”(hjÍhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÉh MähjÊubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj®ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÉh Mähj«ubjF)”}”(hŒ9``struct device *dev`` device that will be doing the DMA ”h]”(jL)”}”(hŒ``struct device *dev``”h]”jÒ)”}”(hjíh]”hŒstruct device *dev”…””}”(hjïhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjëubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Måhjçubjf)”}”(hhh]”hØ)”}”(hŒ!device that will be doing the DMA”h]”hŒ!device that will be doing the DMA”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh Måhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjçubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh Måhj«ubjF)”}”(hŒ1``size_t size`` size of the blocks in this pool. ”h]”(jL)”}”(hŒ``size_t size``”h]”jÒ)”}”(hj&h]”hŒsize_t size”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj$ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mæhj ubjf)”}”(hhh]”hØ)”}”(hŒ size of the blocks in this pool.”h]”hŒ size of the blocks in this pool.”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj;h Mæhj<ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj;h Mæhj«ubjF)”}”(hŒJ``size_t align`` alignment requirement for blocks; must be a power of two ”h]”(jL)”}”(hŒ``size_t align``”h]”jÒ)”}”(hj_h]”hŒsize_t align”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj]ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MçhjYubjf)”}”(hhh]”hØ)”}”(hŒ8alignment requirement for blocks; must be a power of two”h]”hŒ8alignment requirement for blocks; must be a power of two”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjth Mçhjuubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjYubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjth Mçhj«ubjF)”}”(hŒJ``size_t allocation`` returned blocks won't cross this boundary (or zero) ”h]”(jL)”}”(hŒ``size_t allocation``”h]”jÒ)”}”(hj˜h]”hŒsize_t allocation”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj–ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mèhj’ubjf)”}”(hhh]”hØ)”}”(hŒ3returned blocks won't cross this boundary (or zero)”h]”hŒ5returned blocks wonâ€™t cross this boundary (or zero)”…””}”(hj±hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh Mèhj®ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh Mèhj«ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÓh]”hŒDescription”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÑubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MêhjubhØ)”}”(hŒlManaged dma_pool_create(). DMA pool created with this function is automatically destroyed on driver detach.”h]”hŒlManaged dma_pool_create(). DMA pool created with this function is automatically destroyed on driver detach.”…””}”(hjéhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MéhjubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjúh]”hŒReturn”…””}”(hjühžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjøubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MìhjubhØ)”}”(hŒfa managed dma allocation pool with the requested characteristics, or ``NULL`` if one can't be created.”h]”(hŒEa managed dma allocation pool with the requested characteristics, or ”…””}”(hjhžhhŸNh NubjÒ)”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjubhŒ if one canâ€™t be created.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Míhjubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdmam_pool_destroy (C function)”Œc.dmam_pool_destroy”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ.void dmam_pool_destroy (struct dma_pool *pool)”h]”jg)”}”(hŒ-void dmam_pool_destroy(struct dma_pool *pool)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjQhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjMhžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mubj)”}”(hŒ ”h]”hŒ ”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjMhžhhŸj_h Mubjß)”}”(hŒdmam_pool_destroy”h]”j“)”}”(hŒdmam_pool_destroy”h]”hŒdmam_pool_destroy”…””}”(hjrhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjnubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjMhžhhŸj_h Mubjú)”}”(hŒ(struct dma_pool *pool)”h]”j)”}”(hŒstruct dma_pool *pool”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjŽhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjŠubj)”}”(hŒ ”h]”hŒ ”…””}”(hj›hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŠubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj©ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j®Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jtsbŒc.dmam_pool_destroy”†”asbuh1hhjŠubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŠubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjŠubj“)”}”(hŒpool”h]”hŒpool”…””}”(hjçhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj†ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjMhžhhŸj_h Mubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjIhžhhŸj_h Mubah}”(h]”jDah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj_h MhjFhžhubjú)”}”(hhh]”hØ)”}”(hŒManaged dma_pool_destroy()”h]”hŒManaged dma_pool_destroy()”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhjhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjFhžhhŸj_h Mubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj)jj)j‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hŒy**Parameters** ``struct dma_pool *pool`` dma pool that will be destroyed **Description** Managed dma_pool_destroy().”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj3h]”hŒ Parameters”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj1ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhj-ubjA)”}”(hhh]”jF)”}”(hŒ:``struct dma_pool *pool`` dma pool that will be destroyed ”h]”(jL)”}”(hŒ``struct dma_pool *pool``”h]”jÒ)”}”(hjRh]”hŒstruct dma_pool *pool”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjPubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h MhjLubjf)”}”(hhh]”hØ)”}”(hŒdma pool that will be destroyed”h]”hŒdma pool that will be destroyed”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjgh Mhjhubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjLubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjgh MhjIubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj-ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjh]”hŒDescription”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhj-ubhØ)”}”(hŒManaged dma_pool_destroy().”h]”hŒManaged dma_pool_destroy().”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:86: ./mm/dmapool.c”h Mhj-ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hjhžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒdma_pool_zalloc (C function)”Œc.dma_pool_zalloc”hNt”auh1jJhjhžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒSvoid * dma_pool_zalloc (struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”jg)”}”(hŒQvoid *dma_pool_zalloc(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÎhžhhŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h K@ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjáhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎhžhhŸjàh K@ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjïhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÎhžhhŸjàh K@ubjß)”}”(hŒdma_pool_zalloc”h]”j“)”}”(hŒdma_pool_zalloc”h]”hŒdma_pool_zalloc”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjüubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÎhžhhŸjàh K@ubjú)”}”(hŒ<(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)”h]”(j)”}”(hŒstruct dma_pool *pool”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubh)”}”(hhh]”j“)”}”(hŒdma_pool”h]”hŒdma_pool”…””}”(hj:hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj7ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j<Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jsbŒc.dma_pool_zalloc”†”asbuh1hhjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjhhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjubj“)”}”(hŒpool”h]”hŒpool”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjubj)”}”(hŒgfp_t mem_flags”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŽubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j“Œmodname”NŒ classname”Nj°j³)”}”j¶]”jVŒc.dma_pool_zalloc”†”asbuh1hhjŠubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¯hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŠubj“)”}”(hŒ mem_flags”h]”hŒ mem_flags”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjubj)”}”(hŒdma_addr_t *handle”h]”(h)”}”(hhh]”j“)”}”(hŒ dma_addr_t”h]”hŒ dma_addr_t”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÖubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÛŒmodname”NŒ classname”Nj°j³)”}”j¶]”jVŒc.dma_pool_zalloc”†”asbuh1hhjÒubj)”}”(hŒ ”h]”hŒ ”…””}”(hj÷hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÒubj“)”}”(hŒhandle”h]”hŒhandle”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÎhžhhŸjàh K@ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÊhžhhŸjàh K@ubah}”(h]”jÅah ]”(jñjòeh"]”h$]”h&]”jöˆj÷•›)jøhuh1j`hŸjàh K@hjÇhžhubjú)”}”(hhh]”hØ)”}”(hŒ4Get a zero-initialized block of DMA coherent memory.”h]”hŒ4Get a zero-initialized block of DMA coherent memory.”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h K@hj9hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÇhžhhŸjàh K@ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjTjjTj‰j‰j‰uh1j[hžhhjhŸNh Nubj!)”}”(hŒþ**Parameters** ``struct dma_pool *pool`` dma pool that will produce the block ``gfp_t mem_flags`` GFP_* bitmask ``dma_addr_t *handle`` pointer to dma address of block **Description** Same as dma_pool_alloc(), but the returned memory is zeroed.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj^h]”hŒ Parameters”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj\ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h KDhjXubjA)”}”(hhh]”(jF)”}”(hŒ?``struct dma_pool *pool`` dma pool that will produce the block ”h]”(jL)”}”(hŒ``struct dma_pool *pool``”h]”jÒ)”}”(hj}h]”hŒstruct dma_pool *pool”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h KAhjwubjf)”}”(hhh]”hØ)”}”(hŒ$dma pool that will produce the block”h]”hŒ$dma pool that will produce the block”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj’h KAhj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjwubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj’h KAhjtubjF)”}”(hŒ"``gfp_t mem_flags`` GFP_* bitmask ”h]”(jL)”}”(hŒ``gfp_t mem_flags``”h]”jÒ)”}”(hj¶h]”hŒgfp_t mem_flags”…””}”(hj¸hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj´ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h KBhj°ubjf)”}”(hhh]”hØ)”}”(hŒ GFP_* bitmask”h]”hŒ GFP_* bitmask”…””}”(hjÏhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjËh KBhjÌubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj°ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjËh KBhjtubjF)”}”(hŒ7``dma_addr_t *handle`` pointer to dma address of block ”h]”(jL)”}”(hŒ``dma_addr_t *handle``”h]”jÒ)”}”(hjïh]”hŒdma_addr_t *handle”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjíubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h KChjéubjf)”}”(hhh]”hØ)”}”(hŒpointer to dma address of block”h]”hŒpointer to dma address of block”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh KChjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjéubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh KChjtubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjXubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj*h]”hŒDescription”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj(ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒX/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:89: ./include/linux/dmapool.h”h KEhjXubhØ)”}”(hŒ`. However, these methods are not always available, and even if they are, they may still fail for a number of reasons. In short, a device driver may need to be wary of where buffers are located in physical memory, especially if the DMA mask is less than 32 bits.”h]”(hØ)”}”(hX#In particular, mapping may fail for memory not addressable by the device, e.g. if it is not within the DMA mask of the device and/or a connecting bus bridge. Streaming DMA functions try to overcome such addressing constraints, either by using an IOMMU (a device which maps I/O DMA addresses to physical memory addresses), or by copying the data to/from a bounce buffer if the kernel is configured with a :doc:`SWIOTLB `. However, these methods are not always available, and even if they are, they may still fail for a number of reasons.”h]”(hX•In particular, mapping may fail for memory not addressable by the device, e.g. if it is not within the DMA mask of the device and/or a connecting bus bridge. Streaming DMA functions try to overcome such addressing constraints, either by using an IOMMU (a device which maps I/O DMA addresses to physical memory addresses), or by copying the data to/from a bounce buffer if the kernel is configured with a ”…””}”(hjÞhžhhŸNh Nubh)”}”(hŒ:doc:`SWIOTLB `”h]”hŒinline”“”)”}”(hjèh]”hŒSWIOTLB”…””}”(hjìhžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-doc”eh"]”h$]”h&]”uh1jêhjæubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œcore-api/dma-api”Œ refdomain”j÷Œreftype”Œdoc”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œswiotlb”uh1hhŸh¶h KÁhjÞubhŒv. However, these methods are not always available, and even if they are, they may still fail for a number of reasons.”…””}”(hjÞhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÁhjÚubhØ)”}”(hŒIn short, a device driver may need to be wary of where buffers are located in physical memory, especially if the DMA mask is less than 32 bits.”h]”hŒIn short, a device driver may need to be wary of where buffers are located in physical memory, especially if the DMA mask is less than 32 bits.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KËhjÚubeh}”(h]”h ]”h"]”h$]”h&]”uh1jØhj¹hžhhŸh¶h Nubjr)”}”(hŒ|dma_addr_t dma_map_single(struct device *dev, void *cpu_addr, size_t size, enum dma_data_direction direction)”h]”hŒ|dma_addr_t dma_map_single(struct device *dev, void *cpu_addr, size_t size, enum dma_data_direction direction)”…””}”hj)sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h KÑhj¹hžhubhØ)”}”(hŒwMaps a piece of processor virtual memory so it can be accessed by the device and returns the DMA address of the memory.”h]”hŒwMaps a piece of processor virtual memory so it can be accessed by the device and returns the DMA address of the memory.”…””}”(hj7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÕhj¹hžhubhØ)”}”(hŒ?The DMA API uses a strongly typed enumerator for its direction:”h]”hŒ?The DMA API uses a strongly typed enumerator for its direction:”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KØhj¹hžhubhŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1j]hjZubj^)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”K-uh1j]hjZubhŒtbody”“”)”}”(hhh]”(hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”hØ)”}”(hŒDMA_NONE”h]”hŒDMA_NONE”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÛhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjzubj~)”}”(hhh]”hØ)”}”(hŒ!no direction (used for debugging)”h]”hŒ!no direction (used for debugging)”…””}”(hj™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÛhj–ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjzubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒ DMA_TO_DEVICE”h]”hŒ DMA_TO_DEVICE”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÜhj¶ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj³ubj~)”}”(hhh]”hØ)”}”(hŒ+data is going from the memory to the device”h]”hŒ+data is going from the memory to the device”…””}”(hjÐhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÜhjÍubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj³ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒDMA_FROM_DEVICE”h]”hŒDMA_FROM_DEVICE”…””}”(hjðhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÝhjíubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjêubj~)”}”(hhh]”hØ)”}”(hŒ,data is coming from the device to the memory”h]”hŒ,data is coming from the device to the memory”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÝhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjêubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒDMA_BIDIRECTIONAL”h]”hŒDMA_BIDIRECTIONAL”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÞhj$ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj!ubj~)”}”(hhh]”hØ)”}”(hŒdirection isn't known”h]”hŒdirection isnâ€™t known”…””}”(hj>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h KÞhj;ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj!ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjZubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1jXhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj¹hžhhŸh¶h NubjÙ)”}”(hXmContiguous kernel virtual space may not be contiguous as physical memory. Since this API does not provide any scatter/gather capability, it will fail if the user tries to map a non-physically contiguous piece of memory. For this reason, memory to be mapped by this API should be obtained from sources which guarantee it to be physically contiguous (like kmalloc).”h]”hØ)”}”(hXmContiguous kernel virtual space may not be contiguous as physical memory. Since this API does not provide any scatter/gather capability, it will fail if the user tries to map a non-physically contiguous piece of memory. For this reason, memory to be mapped by this API should be obtained from sources which guarantee it to be physically contiguous (like kmalloc).”h]”hXmContiguous kernel virtual space may not be contiguous as physical memory. Since this API does not provide any scatter/gather capability, it will fail if the user tries to map a non-physically contiguous piece of memory. For this reason, memory to be mapped by this API should be obtained from sources which guarantee it to be physically contiguous (like kmalloc).”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kãhjkubah}”(h]”h ]”h"]”h$]”h&]”uh1jØhj¹hžhhŸh¶h NubhŒwarning”“”)”}”(hX Memory coherency operates at a granularity called the cache line width. In order for memory mapped by this API to operate correctly, the mapped region must begin exactly on a cache line boundary and end exactly on one (to prevent two separately mapped regions from sharing a single cache line). Since the cache line size may not be known at compile time, the API will not enforce this requirement. Therefore, it is recommended that driver writers who don't take special care to determine the cache line size at run time only map virtual regions that begin and end on page boundaries (which are guaranteed also to be cache line boundaries). DMA_TO_DEVICE synchronisation must be done after the last modification of the memory region by the software and before it is handed off to the device. Once this primitive is used, memory covered by this primitive should be treated as read-only by the device. If the device may write to it at any point, it should be DMA_BIDIRECTIONAL (see below). DMA_FROM_DEVICE synchronisation must be done before the driver accesses data that may be changed by the device. This memory should be treated as read-only by the driver. If the driver needs to write to it at any point, it should be DMA_BIDIRECTIONAL (see below). DMA_BIDIRECTIONAL requires special handling: it means that the driver isn't sure if the memory was modified before being handed off to the device and also isn't sure if the device will also modify it. Thus, you must always sync bidirectional memory twice: once before the memory is handed off to the device (to make sure all memory changes are flushed from the processor) and once before the data may be accessed after being used by the device (to make sure any processor cache lines are updated with data that the device may have changed).”h]”(hØ)”}”(hX‚Memory coherency operates at a granularity called the cache line width. In order for memory mapped by this API to operate correctly, the mapped region must begin exactly on a cache line boundary and end exactly on one (to prevent two separately mapped regions from sharing a single cache line). Since the cache line size may not be known at compile time, the API will not enforce this requirement. Therefore, it is recommended that driver writers who don't take special care to determine the cache line size at run time only map virtual regions that begin and end on page boundaries (which are guaranteed also to be cache line boundaries).”h]”hX„Memory coherency operates at a granularity called the cache line width. In order for memory mapped by this API to operate correctly, the mapped region must begin exactly on a cache line boundary and end exactly on one (to prevent two separately mapped regions from sharing a single cache line). Since the cache line size may not be known at compile time, the API will not enforce this requirement. Therefore, it is recommended that driver writers who donâ€™t take special care to determine the cache line size at run time only map virtual regions that begin and end on page boundaries (which are guaranteed also to be cache line boundaries).”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kìhj…ubhØ)”}”(hX\DMA_TO_DEVICE synchronisation must be done after the last modification of the memory region by the software and before it is handed off to the device. Once this primitive is used, memory covered by this primitive should be treated as read-only by the device. If the device may write to it at any point, it should be DMA_BIDIRECTIONAL (see below).”h]”hX\DMA_TO_DEVICE synchronisation must be done after the last modification of the memory region by the software and before it is handed off to the device. Once this primitive is used, memory covered by this primitive should be treated as read-only by the device. If the device may write to it at any point, it should be DMA_BIDIRECTIONAL (see below).”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h K÷hj…ubhØ)”}”(hXDMA_FROM_DEVICE synchronisation must be done before the driver accesses data that may be changed by the device. This memory should be treated as read-only by the driver. If the driver needs to write to it at any point, it should be DMA_BIDIRECTIONAL (see below).”h]”hXDMA_FROM_DEVICE synchronisation must be done before the driver accesses data that may be changed by the device. This memory should be treated as read-only by the driver. If the driver needs to write to it at any point, it should be DMA_BIDIRECTIONAL (see below).”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Kþhj…ubhØ)”}”(hXDMA_BIDIRECTIONAL requires special handling: it means that the driver isn't sure if the memory was modified before being handed off to the device and also isn't sure if the device will also modify it. Thus, you must always sync bidirectional memory twice: once before the memory is handed off to the device (to make sure all memory changes are flushed from the processor) and once before the data may be accessed after being used by the device (to make sure any processor cache lines are updated with data that the device may have changed).”h]”hX!DMA_BIDIRECTIONAL requires special handling: it means that the driver isnâ€™t sure if the memory was modified before being handed off to the device and also isnâ€™t sure if the device will also modify it. Thus, you must always sync bidirectional memory twice: once before the memory is handed off to the device (to make sure all memory changes are flushed from the processor) and once before the data may be accessed after being used by the device (to make sure any processor cache lines are updated with data that the device may have changed).”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj…ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jƒhj¹hžhhŸh¶h Nubjr)”}”(hŒvoid dma_unmap_single(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction direction)”h]”hŒvoid dma_unmap_single(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction direction)”…””}”hjÇsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mhj¹hžhubhØ)”}”(hŒ‹Unmaps the region previously mapped. All the parameters passed in must be identical to those passed to (and returned by) dma_map_single().”h]”hŒ‹Unmaps the region previously mapped. All the parameters passed in must be identical to those passed to (and returned by) dma_map_single().”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj¹hžhubjr)”}”(hXdma_addr_t dma_map_page(struct device *dev, struct page *page, unsigned long offset, size_t size, enum dma_data_direction direction) void dma_unmap_page(struct device *dev, dma_addr_t dma_address, size_t size, enum dma_data_direction direction)”h]”hXdma_addr_t dma_map_page(struct device *dev, struct page *page, unsigned long offset, size_t size, enum dma_data_direction direction) void dma_unmap_page(struct device *dev, dma_addr_t dma_address, size_t size, enum dma_data_direction direction)”…””}”hjãsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mhj¹hžhubhØ)”}”(hX"API for mapping and unmapping for pages. All the notes and warnings for the other mapping APIs apply here. Also, although the and parameters are provided to do partial page mapping, it is recommended that you never use these unless you really know what the cache width is.”h]”hX"API for mapping and unmapping for pages. All the notes and warnings for the other mapping APIs apply here. Also, although the and parameters are provided to do partial page mapping, it is recommended that you never use these unless you really know what the cache width is.”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M hj¹hžhubjr)”}”(hX&dma_addr_t dma_map_resource(struct device *dev, phys_addr_t phys_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_resource(struct device *dev, dma_addr_t addr, size_t size, enum dma_data_direction dir, unsigned long attrs)”h]”hX&dma_addr_t dma_map_resource(struct device *dev, phys_addr_t phys_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_resource(struct device *dev, dma_addr_t addr, size_t size, enum dma_data_direction dir, unsigned long attrs)”…””}”hjÿsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M(hj¹hžhubhØ)”}”(hŒÎAPI for mapping and unmapping for MMIO resources. All the notes and warnings for the other mapping APIs apply here. The API should only be used to map device MMIO resources, mapping of RAM is not permitted.”h]”hŒÎAPI for mapping and unmapping for MMIO resources. All the notes and warnings for the other mapping APIs apply here. The API should only be used to map device MMIO resources, mapping of RAM is not permitted.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M0hj¹hžhubjr)”}”(hŒ>int dma_mapping_error(struct device *dev, dma_addr_t dma_addr)”h]”hŒ>int dma_mapping_error(struct device *dev, dma_addr_t dma_addr)”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M6hj¹hžhubhØ)”}”(hXIn some circumstances dma_map_single(), dma_map_page() and dma_map_resource() will fail to create a mapping. A driver can check for these errors by testing the returned DMA address with dma_mapping_error(). A non-zero return value means the mapping could not be created and the driver should take appropriate action (e.g. reduce current DMA mapping usage or delay and try again later).”h]”hXIn some circumstances dma_map_single(), dma_map_page() and dma_map_resource() will fail to create a mapping. A driver can check for these errors by testing the returned DMA address with dma_mapping_error(). A non-zero return value means the mapping could not be created and the driver should take appropriate action (e.g. reduce current DMA mapping usage or delay and try again later).”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M9hj¹hžhubjr)”}”(hŒsint dma_map_sg(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”h]”hŒsint dma_map_sg(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”…””}”hj7sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MAhj¹hžhubhØ)”}”(hXMaps a scatter/gather list for DMA. Returns the number of DMA address segments mapped, which may be smaller than passed in if several consecutive sglist entries are merged (e.g. with an IOMMU, or if some adjacent segments just happen to be physically contiguous).”h]”hXMaps a scatter/gather list for DMA. Returns the number of DMA address segments mapped, which may be smaller than passed in if several consecutive sglist entries are merged (e.g. with an IOMMU, or if some adjacent segments just happen to be physically contiguous).”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MEhj¹hžhubhØ)”}”(hŒ‹Please note that the sg cannot be mapped again if it has been mapped once. The mapping process is allowed to destroy information in the sg.”h]”hŒ‹Please note that the sg cannot be mapped again if it has been mapped once. The mapping process is allowed to destroy information in the sg.”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MJhj¹hžhubhØ)”}”(hX/As with the other mapping interfaces, dma_map_sg() can fail. When it does, 0 is returned and a driver must take appropriate action. It is critical that the driver do something, in the case of a block driver aborting the request or even oopsing is better than doing nothing and corrupting the filesystem.”h]”hX/As with the other mapping interfaces, dma_map_sg() can fail. When it does, 0 is returned and a driver must take appropriate action. It is critical that the driver do something, in the case of a block driver aborting the request or even oopsing is better than doing nothing and corrupting the filesystem.”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MMhj¹hžhubhØ)”}”(hŒaddress and sg->length as shown above.”h]”hŒÄThen you should loop count times (note: this can be less than nents times) and use sg_dma_address() and sg_dma_len() macros where you previously accessed sg->address and sg->length as shown above.”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mchj¹hžhubjr)”}”(hŒxvoid dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”h]”hŒxvoid dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”…””}”hjµsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mihj¹hžhubhØ)”}”(hŒUnmap the previously mapped scatter/gather list. All the parameters must be the same as those and passed in to the scatter/gather mapping API.”h]”hŒUnmap the previously mapped scatter/gather list. All the parameters must be the same as those and passed in to the scatter/gather mapping API.”…””}”(hjÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mmhj¹hžhubhØ)”}”(hŒaNote: must be the number you passed in, *not* the number of DMA address entries returned.”h]”(hŒ0Note: must be the number you passed in, ”…””}”(hjÑhžhhŸNh NubhŒemphasis”“”)”}”(hŒ*not*”h]”hŒnot”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÙhjÑubhŒ, the number of DMA address entries returned.”…””}”(hjÑhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mqhj¹hžhubjr)”}”(hXšvoid dma_sync_single_for_cpu(struct device *dev, dma_addr_t dma_handle, size_t size, enum dma_data_direction direction) void dma_sync_single_for_device(struct device *dev, dma_addr_t dma_handle, size_t size, enum dma_data_direction direction) void dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction) void dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”h]”hXšvoid dma_sync_single_for_cpu(struct device *dev, dma_addr_t dma_handle, size_t size, enum dma_data_direction direction) void dma_sync_single_for_device(struct device *dev, dma_addr_t dma_handle, size_t size, enum dma_data_direction direction) void dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction) void dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg, int nents, enum dma_data_direction direction)”…””}”hjósbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mvhj¹hžhubhØ)”}”(hXQSynchronise a single contiguous or scatter/gather mapping for the CPU and device. With the sync_sg API, all the parameters must be the same as those passed into the sg mapping API. With the sync_single API, you can use dma_handle and size parameters that aren't identical to those passed into the single mapping API to do a partial sync.”h]”hXSSynchronise a single contiguous or scatter/gather mapping for the CPU and device. With the sync_sg API, all the parameters must be the same as those passed into the sg mapping API. With the sync_single API, you can use dma_handle and size parameters that arenâ€™t identical to those passed into the single mapping API to do a partial sync.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MŠhj¹hžhubjÙ)”}”(hX=You must do this: - Before reading values that have been written by DMA from the device (use the DMA_FROM_DEVICE direction) - After writing values that will be written to the device using DMA (use the DMA_TO_DEVICE) direction - before *and* after handing memory to the device if the memory is DMA_BIDIRECTIONAL”h]”(hØ)”}”(hŒYou must do this:”h]”hŒYou must do this:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M“hjubhŒbullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒgBefore reading values that have been written by DMA from the device (use the DMA_FROM_DEVICE direction)”h]”hØ)”}”(hŒgBefore reading values that have been written by DMA from the device (use the DMA_FROM_DEVICE direction)”h]”hŒgBefore reading values that have been written by DMA from the device (use the DMA_FROM_DEVICE direction)”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M•hj(ubah}”(h]”h ]”h"]”h$]”h&]”uh1j&hj#ubj')”}”(hŒcAfter writing values that will be written to the device using DMA (use the DMA_TO_DEVICE) direction”h]”hØ)”}”(hŒcAfter writing values that will be written to the device using DMA (use the DMA_TO_DEVICE) direction”h]”hŒcAfter writing values that will be written to the device using DMA (use the DMA_TO_DEVICE) direction”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M—hj@ubah}”(h]”h ]”h"]”h$]”h&]”uh1j&hj#ubj')”}”(hŒRbefore *and* after handing memory to the device if the memory is DMA_BIDIRECTIONAL”h]”hØ)”}”(hŒRbefore *and* after handing memory to the device if the memory is DMA_BIDIRECTIONAL”h]”(hŒbefore ”…””}”(hj\hžhhŸNh NubjÚ)”}”(hŒ*and*”h]”hŒand”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÙhj\ubhŒF after handing memory to the device if the memory is DMA_BIDIRECTIONAL”…””}”(hj\hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M™hjXubah}”(h]”h ]”h"]”h$]”h&]”uh1j&hj#ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j!hŸh¶h M•hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jØhj¹hžhhŸNh NubhØ)”}”(hŒSee also dma_map_single().”h]”hŒSee also dma_map_single().”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mœhj¹hžhubjr)”}”(hXªdma_addr_t dma_map_single_attrs(struct device *dev, void *cpu_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_single_attrs(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) int dma_map_sg_attrs(struct device *dev, struct scatterlist *sgl, int nents, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_sg_attrs(struct device *dev, struct scatterlist *sgl, int nents, enum dma_data_direction dir, unsigned long attrs)”h]”hXªdma_addr_t dma_map_single_attrs(struct device *dev, void *cpu_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_single_attrs(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) int dma_map_sg_attrs(struct device *dev, struct scatterlist *sgl, int nents, enum dma_data_direction dir, unsigned long attrs) void dma_unmap_sg_attrs(struct device *dev, struct scatterlist *sgl, int nents, enum dma_data_direction dir, unsigned long attrs)”…””}”hjžsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M hj¹hžhubhØ)”}”(hŒŠThe four functions above are just like the counterpart functions without the _attrs suffixes, except that they pass an optional dma_attrs.”h]”hŒŠThe four functions above are just like the counterpart functions without the _attrs suffixes, except that they pass an optional dma_attrs.”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M´hj¹hžhubhØ)”}”(hŒ”The interpretation of DMA attributes is architecture-specific, and each attribute should be documented in Documentation/core-api/dma-attributes.rst.”h]”hŒ”The interpretation of DMA attributes is architecture-specific, and each attribute should be documented in Documentation/core-api/dma-attributes.rst.”…””}”(hjºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M¸hj¹hžhubhØ)”}”(hŒÛIf dma_attrs are 0, the semantics of each of these functions is identical to those of the corresponding function without the _attrs suffix. As a result dma_map_single_attrs() can generally replace dma_map_single(), etc.”h]”hŒÛIf dma_attrs are 0, the semantics of each of these functions is identical to those of the corresponding function without the _attrs suffix. As a result dma_map_single_attrs() can generally replace dma_map_single(), etc.”…””}”(hjÈhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M¼hj¹hžhubhØ)”}”(hŒˆAs an example of the use of the ``*_attrs`` functions, here's how you could pass an attribute DMA_ATTR_FOO when mapping memory for DMA::”h]”(hŒ As an example of the use of the ”…””}”(hjÖhžhhŸNh NubjÒ)”}”(hŒ``*_attrs``”h]”hŒ*_attrs”…””}”(hjÞhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÖubhŒ^ functions, hereâ€™s how you could pass an attribute DMA_ATTR_FOO when mapping memory for DMA:”…””}”(hjÖhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÁhj¹hžhubjr)”}”(hX4#include /* DMA_ATTR_FOO should be defined in linux/dma-mapping.h and * documented in Documentation/core-api/dma-attributes.rst */ ... unsigned long attr; attr |= DMA_ATTR_FOO; .... n = dma_map_sg_attrs(dev, sg, nents, DMA_TO_DEVICE, attr); ....”h]”hX4#include /* DMA_ATTR_FOO should be defined in linux/dma-mapping.h and * documented in Documentation/core-api/dma-attributes.rst */ ... unsigned long attr; attr |= DMA_ATTR_FOO; .... n = dma_map_sg_attrs(dev, sg, nents, DMA_TO_DEVICE, attr); ....”…””}”hjösbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MÅhj¹hžhubhØ)”}”(hŒArchitectures that care about DMA_ATTR_FOO would check for its presence in their implementations of the mapping and unmapping routines, e.g.:::”h]”hŒŽArchitectures that care about DMA_ATTR_FOO would check for its presence in their implementations of the mapping and unmapping routines, e.g.::”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÐhj¹hžhubjr)”}”(hX+void whizco_dma_map_sg_attrs(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) { .... if (attrs & DMA_ATTR_FOO) /* twizzle the frobnozzle */ .... }”h]”hX+void whizco_dma_map_sg_attrs(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction dir, unsigned long attrs) { .... if (attrs & DMA_ATTR_FOO) /* twizzle the frobnozzle */ .... }”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MÔhj¹hžhubeh}”(h]”Œpart-id-streaming-dma-mappings”ah ]”h"]”Œ part id - streaming dma mappings”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K¹ubh¢)”}”(hhh]”(h§)”}”(hŒ!Part Ie - IOVA-based DMA mappings”h]”hŒ!Part Ie - IOVA-based DMA mappings”…””}”(hj+hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj(hžhhŸh¶h MßubhØ)”}”(hX5These APIs allow a very efficient mapping when using an IOMMU. They are an optional path that requires extra code and are only recommended for drivers where DMA mapping performance, or the space usage for storing the DMA addresses matter. All the considerations from the previous section apply here as well.”h]”hX5These APIs allow a very efficient mapping when using an IOMMU. They are an optional path that requires extra code and are only recommended for drivers where DMA mapping performance, or the space usage for storing the DMA addresses matter. All the considerations from the previous section apply here as well.”…””}”(hj9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Máhj(hžhubjr)”}”(hŒubool dma_iova_try_alloc(struct device *dev, struct dma_iova_state *state, phys_addr_t phys, size_t size);”h]”hŒubool dma_iova_try_alloc(struct device *dev, struct dma_iova_state *state, phys_addr_t phys, size_t size);”…””}”hjGsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mèhj(hžhubhØ)”}”(hXIs used to try to allocate IOVA space for mapping operation. If it returns false this API can't be used for the given device and the normal streaming DMA mapping API should be used. The ``struct dma_iova_state`` is allocated by the driver and must be kept around until unmap time.”h]”(hŒ¾Is used to try to allocate IOVA space for mapping operation. If it returns false this API canâ€™t be used for the given device and the normal streaming DMA mapping API should be used. The ”…””}”(hjUhžhhŸNh NubjÒ)”}”(hŒ``struct dma_iova_state``”h]”hŒstruct dma_iova_state”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjUubhŒE is allocated by the driver and must be kept around until unmap time.”…””}”(hjUhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mëhj(hžhubjr)”}”(hŒ=static inline bool dma_use_iova(struct dma_iova_state *state)”h]”hŒ=static inline bool dma_use_iova(struct dma_iova_state *state)”…””}”hjusbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mòhj(hžhubhØ)”}”(hŒ‹Can be used by the driver to check if the IOVA-based API is used after a call to dma_iova_try_alloc. This can be useful in the unmap path.”h]”hŒ‹Can be used by the driver to check if the IOVA-based API is used after a call to dma_iova_try_alloc. This can be useful in the unmap path.”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Môhj(hžhubjr)”}”(hŒ¼int dma_iova_link(struct device *dev, struct dma_iova_state *state, phys_addr_t phys, size_t offset, size_t size, enum dma_data_direction dir, unsigned long attrs);”h]”hŒ¼int dma_iova_link(struct device *dev, struct dma_iova_state *state, phys_addr_t phys, size_t offset, size_t size, enum dma_data_direction dir, unsigned long attrs);”…””}”hj‘sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mùhj(hžhubhØ)”}”(hX/Is used to link ranges to the IOVA previously allocated. The start of all but the first call to dma_iova_link for a given state must be aligned to the DMA merge boundary returned by ``dma_get_merge_boundary())``, and the size of all but the last range must be aligned to the DMA merge boundary as well.”h]”(hŒ·Is used to link ranges to the IOVA previously allocated. The start of all but the first call to dma_iova_link for a given state must be aligned to the DMA merge boundary returned by ”…””}”(hjŸhžhhŸNh NubjÒ)”}”(hŒ``dma_get_merge_boundary())``”h]”hŒdma_get_merge_boundary())”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjŸubhŒ[, and the size of all but the last range must be aligned to the DMA merge boundary as well.”…””}”(hjŸhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mýhj(hžhubjr)”}”(hŒlint dma_iova_sync(struct device *dev, struct dma_iova_state *state, size_t offset, size_t size);”h]”hŒlint dma_iova_sync(struct device *dev, struct dma_iova_state *state, size_t offset, size_t size);”…””}”hj¿sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mhj(hžhubhØ)”}”(hŒoMust be called to sync the IOMMU page tables for IOVA-range mapped by one or more calls to ``dma_iova_link()``.”h]”(hŒ[Must be called to sync the IOMMU page tables for IOVA-range mapped by one or more calls to ”…””}”(hjÍhžhhŸNh NubjÒ)”}”(hŒ``dma_iova_link()``”h]”hŒdma_iova_link()”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÍubhŒ.”…””}”(hjÍhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj(hžhubhØ)”}”(hŒbFor drivers that use a one-shot mapping, all ranges can be unmapped and the IOVA freed by calling:”h]”hŒbFor drivers that use a one-shot mapping, all ranges can be unmapped and the IOVA freed by calling:”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj(hžhubjr)”}”(hŒ§void dma_iova_destroy(struct device *dev, struct dma_iova_state *state, size_t mapped_len, enum dma_data_direction dir, unsigned long attrs);”h]”hŒ§void dma_iova_destroy(struct device *dev, struct dma_iova_state *state, size_t mapped_len, enum dma_data_direction dir, unsigned long attrs);”…””}”hjûsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mhj(hžhubhØ)”}”(hŒvAlternatively drivers can dynamically manage the IOVA space by unmapping and mapping individual regions. In that case”h]”hŒvAlternatively drivers can dynamically manage the IOVA space by unmapping and mapping individual regions. In that case”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj(hžhubjr)”}”(hŒvoid dma_iova_unlink(struct device *dev, struct dma_iova_state *state, size_t offset, size_t size, enum dma_data_direction dir, unsigned long attrs);”h]”hŒvoid dma_iova_unlink(struct device *dev, struct dma_iova_state *state, size_t offset, size_t size, enum dma_data_direction dir, unsigned long attrs);”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mhj(hžhubhØ)”}”(hŒ/is used to unmap a range previously mapped, and”h]”hŒ/is used to unmap a range previously mapped, and”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj(hžhubjr)”}”(hŒEvoid dma_iova_free(struct device *dev, struct dma_iova_state *state);”h]”hŒEvoid dma_iova_free(struct device *dev, struct dma_iova_state *state);”…””}”hj3sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M!hj(hžhubhØ)”}”(hŒ„is used to free the IOVA space. All regions must have been unmapped using ``dma_iova_unlink()`` before calling ``dma_iova_free()``.”h]”(hŒKis used to free the IOVA space. All regions must have been unmapped using ”…””}”(hjAhžhhŸNh NubjÒ)”}”(hŒ``dma_iova_unlink()``”h]”hŒdma_iova_unlink()”…””}”(hjIhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjAubhŒ before calling ”…””}”(hjAhžhhŸNh NubjÒ)”}”(hŒ``dma_iova_free()``”h]”hŒdma_iova_free()”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjAubhŒ.”…””}”(hjAhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M#hj(hžhubeh}”(h]”Œpart-ie-iova-based-dma-mappings”ah ]”h"]”Œ!part ie - iova-based dma mappings”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Mßubh¢)”}”(hhh]”(h§)”}”(hŒ&Part II - Non-coherent DMA allocations”h]”hŒ&Part II - Non-coherent DMA allocations”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj{hžhhŸh¶h M'ubhØ)”}”(hŒºThese APIs allow to allocate pages that are guaranteed to be DMA addressable by the passed in device, but which need explicit management of memory ownership for the kernel vs the device.”h]”hŒºThese APIs allow to allocate pages that are guaranteed to be DMA addressable by the passed in device, but which need explicit management of memory ownership for the kernel vs the device.”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M)hj{hžhubhØ)”}”(hŒ‹If you don't understand how cache line coherency works between a processor and an I/O device, you should not be using this part of the API.”h]”hŒIf you donâ€™t understand how cache line coherency works between a processor and an I/O device, you should not be using this part of the API.”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M-hj{hžhubjr)”}”(hŒŽstruct page * dma_alloc_pages(struct device *dev, size_t size, dma_addr_t *dma_handle, enum dma_data_direction dir, gfp_t gfp)”h]”hŒŽstruct page * dma_alloc_pages(struct device *dev, size_t size, dma_addr_t *dma_handle, enum dma_data_direction dir, gfp_t gfp)”…””}”hj¨sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M2hj{hžhubhØ)”}”(hŒøThis routine allocates a region of bytes of non-coherent memory. It returns a pointer to first struct page for the region, or NULL if the allocation failed. The resulting struct page can be used for everything a struct page is suitable for.”h]”hŒøThis routine allocates a region of bytes of non-coherent memory. It returns a pointer to first struct page for the region, or NULL if the allocation failed. The resulting struct page can be used for everything a struct page is suitable for.”…””}”(hj¶hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M6hj{hžhubhØ)”}”(hŒ It also returns a which may be cast to an unsigned integer the same width as the bus and given to the device as the DMA address base of the region.”h]”hŒ It also returns a which may be cast to an unsigned integer the same width as the bus and given to the device as the DMA address base of the region.”…””}”(hjÄhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M;hj{hžhubhØ)”}”(hŒkThe dir parameter specified if data is read and/or written by the device, see dma_map_single() for details.”h]”hŒkThe dir parameter specified if data is read and/or written by the device, see dma_map_single() for details.”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M?hj{hžhubhØ)”}”(hŒµThe gfp parameter allows the caller to specify the ``GFP_`` flags (see kmalloc()) for the allocation, but rejects flags used to specify a memory zone such as GFP_DMA or GFP_HIGHMEM.”h]”(hŒ3The gfp parameter allows the caller to specify the ”…””}”(hjàhžhhŸNh NubjÒ)”}”(hŒ``GFP_``”h]”hŒGFP_”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjàubhŒz flags (see kmalloc()) for the allocation, but rejects flags used to specify a memory zone such as GFP_DMA or GFP_HIGHMEM.”…””}”(hjàhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MBhj{hžhubhØ)”}”(hŒÚBefore giving the memory to the device, dma_sync_single_for_device() needs to be called, and before reading memory written by the device, dma_sync_single_for_cpu(), just like for streaming DMA mappings that are reused.”h]”hŒÚBefore giving the memory to the device, dma_sync_single_for_device() needs to be called, and before reading memory written by the device, dma_sync_single_for_cpu(), just like for streaming DMA mappings that are reused.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MFhj{hžhubjr)”}”(hŒ‹void dma_free_pages(struct device *dev, size_t size, struct page *page, dma_addr_t dma_handle, enum dma_data_direction dir)”h]”hŒ‹void dma_free_pages(struct device *dev, size_t size, struct page *page, dma_addr_t dma_handle, enum dma_data_direction dir)”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MMhj{hžhubhØ)”}”(hŒÙFree a region of memory previously allocated using dma_alloc_pages(). dev, size, dma_handle and dir must all be the same as those passed into dma_alloc_pages(). page must be the pointer returned by dma_alloc_pages().”h]”hŒÙFree a region of memory previously allocated using dma_alloc_pages(). dev, size, dma_handle and dir must all be the same as those passed into dma_alloc_pages(). page must be the pointer returned by dma_alloc_pages().”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MQhj{hžhubjr)”}”(hŒqint dma_mmap_pages(struct device *dev, struct vm_area_struct *vma, size_t size, struct page *page)”h]”hŒqint dma_mmap_pages(struct device *dev, struct vm_area_struct *vma, size_t size, struct page *page)”…””}”hj*sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MWhj{hžhubhØ)”}”(hŒÊMap an allocation returned from dma_alloc_pages() into a user address space. dev and size must be the same as those passed into dma_alloc_pages(). page must be the pointer returned by dma_alloc_pages().”h]”hŒÊMap an allocation returned from dma_alloc_pages() into a user address space. dev and size must be the same as those passed into dma_alloc_pages(). page must be the pointer returned by dma_alloc_pages().”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M[hj{hžhubjr)”}”(hŒvoid * dma_alloc_noncoherent(struct device *dev, size_t size, dma_addr_t *dma_handle, enum dma_data_direction dir, gfp_t gfp)”h]”hŒvoid * dma_alloc_noncoherent(struct device *dev, size_t size, dma_addr_t *dma_handle, enum dma_data_direction dir, gfp_t gfp)”…””}”hjFsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mahj{hžhubhØ)”}”(hŒ›This routine is a convenient wrapper around dma_alloc_pages that returns the kernel virtual address for the allocated memory instead of the page structure.”h]”hŒ›This routine is a convenient wrapper around dma_alloc_pages that returns the kernel virtual address for the allocated memory instead of the page structure.”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mfhj{hžhubjr)”}”(hŒŽvoid dma_free_noncoherent(struct device *dev, size_t size, void *cpu_addr, dma_addr_t dma_handle, enum dma_data_direction dir)”h]”hŒŽvoid dma_free_noncoherent(struct device *dev, size_t size, void *cpu_addr, dma_addr_t dma_handle, enum dma_data_direction dir)”…””}”hjbsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mkhj{hžhubhØ)”}”(hŒ÷Free a region of memory previously allocated using dma_alloc_noncoherent(). dev, size, dma_handle and dir must all be the same as those passed into dma_alloc_noncoherent(). cpu_addr must be the virtual address returned by dma_alloc_noncoherent().”h]”hŒ÷Free a region of memory previously allocated using dma_alloc_noncoherent(). dev, size, dma_handle and dir must all be the same as those passed into dma_alloc_noncoherent(). cpu_addr must be the virtual address returned by dma_alloc_noncoherent().”…””}”(hjphžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mohj{hžhubjr)”}”(hŒ¸struct sg_table * dma_alloc_noncontiguous(struct device *dev, size_t size, enum dma_data_direction dir, gfp_t gfp, unsigned long attrs);”h]”hŒ¸struct sg_table * dma_alloc_noncontiguous(struct device *dev, size_t size, enum dma_data_direction dir, gfp_t gfp, unsigned long attrs);”…””}”hj~sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h Mvhj{hžhubhØ)”}”(hX4This routine allocates bytes of non-coherent and possibly non-contiguous memory. It returns a pointer to struct sg_table that describes the allocated and DMA mapped memory, or NULL if the allocation failed. The resulting memory can be used for struct page mapped into a scatterlist are suitable for.”h]”hX4This routine allocates bytes of non-coherent and possibly non-contiguous memory. It returns a pointer to struct sg_table that describes the allocated and DMA mapped memory, or NULL if the allocation failed. The resulting memory can be used for struct page mapped into a scatterlist are suitable for.”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M{hj{hžhubhØ)”}”(hŒ¯The return sg_table is guaranteed to have 1 single DMA mapped segment as indicated by sgt->nents, but it might have multiple CPU side segments as indicated by sgt->orig_nents.”h]”hŒ¯The return sg_table is guaranteed to have 1 single DMA mapped segment as indicated by sgt->nents, but it might have multiple CPU side segments as indicated by sgt->orig_nents.”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M€hj{hžhubhØ)”}”(hŒkThe dir parameter specified if data is read and/or written by the device, see dma_map_single() for details.”h]”hŒkThe dir parameter specified if data is read and/or written by the device, see dma_map_single() for details.”…””}”(hj¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M„hj{hžhubhØ)”}”(hŒµThe gfp parameter allows the caller to specify the ``GFP_`` flags (see kmalloc()) for the allocation, but rejects flags used to specify a memory zone such as GFP_DMA or GFP_HIGHMEM.”h]”(hŒ3The gfp parameter allows the caller to specify the ”…””}”(hj¶hžhhŸNh NubjÒ)”}”(hŒ``GFP_``”h]”hŒGFP_”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj¶ubhŒz flags (see kmalloc()) for the allocation, but rejects flags used to specify a memory zone such as GFP_DMA or GFP_HIGHMEM.”…””}”(hj¶hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M‡hj{hžhubhØ)”}”(hŒCThe attrs argument must be either 0 or DMA_ATTR_ALLOC_SINGLE_PAGES.”h]”hŒCThe attrs argument must be either 0 or DMA_ATTR_ALLOC_SINGLE_PAGES.”…””}”(hjÖhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M‹hj{hžhubhØ)”}”(hŒÜBefore giving the memory to the device, dma_sync_sgtable_for_device() needs to be called, and before reading memory written by the device, dma_sync_sgtable_for_cpu(), just like for streaming DMA mappings that are reused.”h]”hŒÜBefore giving the memory to the device, dma_sync_sgtable_for_device() needs to be called, and before reading memory written by the device, dma_sync_sgtable_for_cpu(), just like for streaming DMA mappings that are reused.”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj{hžhubjr)”}”(hŒvoid dma_free_noncontiguous(struct device *dev, size_t size, struct sg_table *sgt, enum dma_data_direction dir)”h]”hŒvoid dma_free_noncontiguous(struct device *dev, size_t size, struct sg_table *sgt, enum dma_data_direction dir)”…””}”hjòsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M”hj{hžhubhØ)”}”(hŒÙFree memory previously allocated using dma_alloc_noncontiguous(). dev, size, and dir must all be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”h]”hŒÙFree memory previously allocated using dma_alloc_noncontiguous(). dev, size, and dir must all be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M™hj{hžhubjr)”}”(hŒ\void * dma_vmap_noncontiguous(struct device *dev, size_t size, struct sg_table *sgt)”h]”hŒ\void * dma_vmap_noncontiguous(struct device *dev, size_t size, struct sg_table *sgt)”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MŸhj{hžhubhØ)”}”(hŒìReturn a contiguous kernel mapping for an allocation returned from dma_alloc_noncontiguous(). dev and size must be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”h]”hŒìReturn a contiguous kernel mapping for an allocation returned from dma_alloc_noncontiguous(). dev and size must be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M£hj{hžhubhØ)”}”(hŒóOnce a non-contiguous allocation is mapped using this function, the flush_kernel_vmap_range() and invalidate_kernel_vmap_range() APIs must be used to manage the coherency between the kernel mapping, the device and user space mappings (if any).”h]”hŒóOnce a non-contiguous allocation is mapped using this function, the flush_kernel_vmap_range() and invalidate_kernel_vmap_range() APIs must be used to manage the coherency between the kernel mapping, the device and user space mappings (if any).”…””}”(hj*hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M¨hj{hžhubjr)”}”(hŒ>void dma_vunmap_noncontiguous(struct device *dev, void *vaddr)”h]”hŒ>void dma_vunmap_noncontiguous(struct device *dev, void *vaddr)”…””}”hj8sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M¯hj{hžhubhØ)”}”(hŒÂUnmap a kernel mapping returned by dma_vmap_noncontiguous(). dev must be the same the one passed into dma_alloc_noncontiguous(). vaddr must be the pointer returned by dma_vmap_noncontiguous().”•h]”hŒÂUnmap a kernel mapping returned by dma_vmap_noncontiguous(). dev must be the same the one passed into dma_alloc_noncontiguous(). vaddr must be the pointer returned by dma_vmap_noncontiguous().”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M²hj{hžhubjr)”}”(hŒ„int dma_mmap_noncontiguous(struct device *dev, struct vm_area_struct *vma, size_t size, struct sg_table *sgt)”h]”hŒ„int dma_mmap_noncontiguous(struct device *dev, struct vm_area_struct *vma, size_t size, struct sg_table *sgt)”…””}”hjTsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h M¹hj{hžhubhØ)”}”(hŒãMap an allocation returned from dma_alloc_noncontiguous() into a user address space. dev and size must be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”h]”hŒãMap an allocation returned from dma_alloc_noncontiguous() into a user address space. dev and size must be the same as those passed into dma_alloc_noncontiguous(). sgt must be the pointer returned by dma_alloc_noncontiguous().”…””}”(hjbhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M½hj{hžhubjr)”}”(hŒ!int dma_get_cache_alignment(void)”h]”hŒ!int dma_get_cache_alignment(void)”…””}”hjpsbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MÄhj{hžhubhØ)”}”(hŒ¥Returns the processor cache alignment. This is the absolute minimum alignment *and* width that you must observe when either mapping memory or doing partial flushes.”h]”(hŒOReturns the processor cache alignment. This is the absolute minimum alignment ”…””}”(hj~hžhhŸNh NubjÚ)”}”(hŒ*and*”h]”hŒand”…””}”(hj†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÙhj~ubhŒQ width that you must observe when either mapping memory or doing partial flushes.”…””}”(hj~hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÇhj{hžhubjÙ)”}”(hŒáThis API may return a number *larger* than the actual cache line, but it will guarantee that one or more cache lines fit exactly into the width returned by this call. It will also always be a power of two for easy alignment.”h]”hØ)”}”(hŒáThis API may return a number *larger* than the actual cache line, but it will guarantee that one or more cache lines fit exactly into the width returned by this call. It will also always be a power of two for easy alignment.”h]”(hŒThis API may return a number ”…””}”(hj¢hžhhŸNh NubjÚ)”}”(hŒ*larger*”h]”hŒlarger”…””}”(hjªhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÙhj¢ubhŒ¼ than the actual cache line, but it will guarantee that one or more cache lines fit exactly into the width returned by this call. It will also always be a power of two for easy alignment.”…””}”(hj¢hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÍhjžubah}”(h]”h ]”h"]”h$]”h&]”uh1jØhj{hžhhŸh¶h Nubeh}”(h]”Œ$part-ii-non-coherent-dma-allocations”ah ]”h"]”Œ&part ii - non-coherent dma allocations”ah$]”h&]”uh1h¡hh£hžhhŸh¶h M'ubh¢)”}”(hhh]”(h§)”}”(hŒ+Part III - Debug drivers use of the DMA API”h]”hŒ+Part III - Debug drivers use of the DMA API”…””}”(hjÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjÐhžhhŸh¶h MÔubhØ)”}”(hXfThe DMA API as described above has some constraints. DMA addresses must be released with the corresponding function with the same size for example. With the advent of hardware IOMMUs it becomes more and more important that drivers do not violate those constraints. In the worst case such a violation can result in data corruption up to destroyed filesystems.”h]”hXfThe DMA API as described above has some constraints. DMA addresses must be released with the corresponding function with the same size for example. With the advent of hardware IOMMUs it becomes more and more important that drivers do not violate those constraints. In the worst case such a violation can result in data corruption up to destroyed filesystems.”…””}”(hjáhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÖhjÐhžhubhØ)”}”(hXrTo debug drivers and find bugs in the usage of the DMA API checking code can be compiled into the kernel which will tell the developer about those violations. If your architecture supports it you can select the "Enable debugging of DMA API usage" option in your kernel configuration. Enabling this option has a performance impact. Do not enable it in production kernels.”h]”hXvTo debug drivers and find bugs in the usage of the DMA API checking code can be compiled into the kernel which will tell the developer about those violations. If your architecture supports it you can select the â€œEnable debugging of DMA API usageâ€ option in your kernel configuration. Enabling this option has a performance impact. Do not enable it in production kernels.”…””}”(hjïhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MÜhjÐhžhubhØ)”}”(hXIf you boot the resulting kernel will contain code which does some bookkeeping about what DMA memory was allocated for which device. If this code detects an error it prints a warning message with some details into your kernel log. An example warning message may look like this::”h]”hXIf you boot the resulting kernel will contain code which does some bookkeeping about what DMA memory was allocated for which device. If this code detects an error it prints a warning message with some details into your kernel log. An example warning message may look like this:”…””}”(hjýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MâhjÐhžhubjr)”}”(hXWARNING: at /data2/repos/linux-2.6-iommu/lib/dma-debug.c:448 check_unmap+0x203/0x490() Hardware name: forcedeth 0000:00:08.0: DMA-API: device driver frees DMA memory with wrong function [device address=0x00000000640444be] [size=66 bytes] [mapped as single] [unmapped as page] Modules linked in: nfsd exportfs bridge stp llc r8169 Pid: 0, comm: swapper Tainted: G W 2.6.28-dmatest-09289-g8bb99c0 #1 Call Trace: [] warn_slowpath+0xf2/0x130 [] _spin_unlock+0x10/0x30 [] usb_hcd_link_urb_to_ep+0x75/0xc0 [] _spin_unlock_irqrestore+0x12/0x40 [] ohci_urb_enqueue+0x19f/0x7c0 [] queue_work+0x56/0x60 [] enqueue_task_fair+0x20/0x50 [] usb_hcd_submit_urb+0x379/0xbc0 [] cpumask_next_and+0x23/0x40 [] find_busiest_group+0x207/0x8a0 [] _spin_lock_irqsave+0x1f/0x50 [] check_unmap+0x203/0x490 [] debug_dma_unmap_page+0x49/0x50 [] nv_tx_done_optimized+0xc6/0x2c0 [] nv_nic_irq_optimized+0x73/0x2b0 [] handle_IRQ_event+0x34/0x70 [] handle_edge_irq+0xc9/0x150 [] do_IRQ+0xcb/0x1c0 [] ret_from_intr+0x0/0xa <4>---[ end trace f6435a98e2a38c0e ]---”h]”hXWARNING: at /data2/repos/linux-2.6-iommu/lib/dma-debug.c:448 check_unmap+0x203/0x490() Hardware name: forcedeth 0000:00:08.0: DMA-API: device driver frees DMA memory with wrong function [device address=0x00000000640444be] [size=66 bytes] [mapped as single] [unmapped as page] Modules linked in: nfsd exportfs bridge stp llc r8169 Pid: 0, comm: swapper Tainted: G W 2.6.28-dmatest-09289-g8bb99c0 #1 Call Trace: [] warn_slowpath+0xf2/0x130 [] _spin_unlock+0x10/0x30 [] usb_hcd_link_urb_to_ep+0x75/0xc0 [] _spin_unlock_irqrestore+0x12/0x40 [] ohci_urb_enqueue+0x19f/0x7c0 [] queue_work+0x56/0x60 [] enqueue_task_fair+0x20/0x50 [] usb_hcd_submit_urb+0x379/0xbc0 [] cpumask_next_and+0x23/0x40 [] find_busiest_group+0x207/0x8a0 [] _spin_lock_irqsave+0x1f/0x50 [] check_unmap+0x203/0x490 [] debug_dma_unmap_page+0x49/0x50 [] nv_tx_done_optimized+0xc6/0x2c0 [] nv_nic_irq_optimized+0x73/0x2b0 [] handle_IRQ_event+0x34/0x70 [] handle_edge_irq+0xc9/0x150 [] do_IRQ+0xcb/0x1c0 [] ret_from_intr+0x0/0xa <4>---[ end trace f6435a98e2a38c0e ]---”…””}”hj sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MçhjÐhžhubhØ)”}”(hŒ}The driver developer can find the driver and the device including a stacktrace of the DMA API call which caused this warning.”h]”hŒ}The driver developer can find the driver and the device including a stacktrace of the DMA API call which caused this warning.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MhjÐhžhubhØ)”}”(hX:Per default only the first error will result in a warning message. All other errors will only silently counted. This limitation exist to prevent the code from flooding your kernel log. To support debugging a device driver this can be disabled via debugfs. See the debugfs interface documentation below for details.”h]”hX:Per default only the first error will result in a warning message. All other errors will only silently counted. This limitation exist to prevent the code from flooding your kernel log. To support debugging a device driver this can be disabled via debugfs. See the debugfs interface documentation below for details.”…””}”(hj' hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MhjÐhžhubhØ)”}”(hŒ†The debugfs directory for the DMA API debugging code is called dma-api/. In this directory the following files can currently be found:”h]”hŒ†The debugfs directory for the DMA API debugging code is called dma-api/. In this directory the following files can currently be found:”…””}”(hj5 hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MhjÐhžhubjT)”}”(hhh]”jY)”}”(hhh]”(j^)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1j]hjF ubj^)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”K/uh1j]hjF ubjt)”}”(hhh]”(jy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/all_errors”h]”hŒdma-api/all_errors”…””}”(hjf hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhjc ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj` ubj~)”}”(hhh]”hØ)”}”(hŒÛThis file contains a numeric value. If this value is not equal to zero the debugging code will print a warning for every error it finds into the kernel log. Be careful with this option, as it can easily flood your logs.”h]”hŒÛThis file contains a numeric value. If this value is not equal to zero the debugging code will print a warning for every error it finds into the kernel log. Be careful with this option, as it can easily flood your logs.”…””}”(hj} hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhjz ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj` ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/disabled”h]”hŒdma-api/disabled”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhjš ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj— ubj~)”}”(hhh]”hØ)”}”(hŒŸThis read-only file contains the character 'Y' if the debugging code is disabled. This can happen when it runs out of memory or if it was disabled at boot time”h]”hŒ£This read-only file contains the character â€˜Yâ€™ if the debugging code is disabled. This can happen when it runs out of memory or if it was disabled at boot time”…””}”(hj´ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhj± ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj— ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/dump”h]”hŒdma-api/dump”…””}”(hjÔ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MhjÑ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjÎ ubj~)”}”(hhh]”hØ)”}”(hŒ2This read-only file contains current DMA mappings.”h]”hŒ2This read-only file contains current DMA mappings.”…””}”(hjë hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h Mhjè ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjÎ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/error_count”h]”hŒdma-api/error_count”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M hj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj!ubj~)”}”(hhh]”hØ)”}”(hŒCThis file is read-only and shows the total numbers of errors found.”h]”hŒCThis file is read-only and shows the total numbers of errors found.”…””}”(hj"!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M hj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj!ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/num_errors”h]”hŒdma-api/num_errors”…””}”(hjB!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M#hj?!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjThe current number of free dma_debug_entries in the allocator.”h]”hŒ>The current number of free dma_debug_entries in the allocator.”…””}”(hjÇ!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M/hjÄ!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjª!ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/nr_total_entries”h]”hŒdma-api/nr_total_entries”…””}”(hjç!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M2hjä!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjá!ubj~)”}”(hhh]”hØ)”}”(hŒKThe total number of dma_debug_entries in the allocator, both free and used.”h]”hŒKThe total number of dma_debug_entries in the allocator, both free and used.”…””}”(hjþ!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M2hjû!ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hjá!ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubjy)”}”(hhh]”(j~)”}”(hhh]”hØ)”}”(hŒdma-api/driver_filter”h]”hŒdma-api/driver_filter”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M5hj"ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj"ubj~)”}”(hhh]”hØ)”}”(hŒÅYou can write a name of a driver into this file to limit the debug output to requests from that particular driver. Write an empty string to that file to disable the filter and see all errors again.”h]”hŒÅYou can write a name of a driver into this file to limit the debug output to requests from that particular driver. Write an empty string to that file to disable the filter and see all errors again.”…””}”(hj5"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M5hj2"ubah}”(h]”h ]”h"]”h$]”h&]”uh1j}hj"ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jxhj] ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjF ubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1jXhjC ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjÐhžhhŸh¶h NubhØ)”}”(hX,If you have this code compiled into your kernel it will be enabled by default. If you want to boot without the bookkeeping anyway you can provide 'dma_debug=off' as a boot parameter. This will disable DMA API debugging. Notice that you can not enable it again at runtime. You have to reboot to do so.”h]”hX0If you have this code compiled into your kernel it will be enabled by default. If you want to boot without the bookkeeping anyway you can provide â€˜dma_debug=offâ€™ as a boot parameter. This will disable DMA API debugging. Notice that you can not enable it again at runtime. You have to reboot to do so.”…””}”(hjb"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h M parameter. This will enable the driver filter at boot time. The debug code will only print errors for that driver afterwards. This filter can be disabled or changed later using debugfs.”h]”hX.If you want to see debug messages only for a special device driver you can specify the dma_debug_driver= parameter. This will enable the driver filter at boot time. The debug code will only print errors for that driver afterwards. This filter can be disabled or changed later using debugfs.”…””}”(hjp"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MBhjÐhžhubhØ)”}”(hX¹When the code disables itself at runtime this is most likely because it ran out of dma_debug_entries and was unable to allocate more on-demand. 65536 entries are preallocated at boot - if this is too low for you boot with 'dma_debug_entries=' to overwrite the default. Note that the code allocates entries in batches, so the exact number of preallocated entries may be greater than the actual number requested. The code will print to the kernel log each time it has dynamically allocated as many entries as were initially preallocated. This is to indicate that a larger preallocation size may be appropriate, or if it happens continually that a driver may be leaking mappings.”h]”hX½When the code disables itself at runtime this is most likely because it ran out of dma_debug_entries and was unable to allocate more on-demand. 65536 entries are preallocated at boot - if this is too low for you boot with â€˜dma_debug_entries=â€™ to overwrite the default. Note that the code allocates entries in batches, so the exact number of preallocated entries may be greater than the actual number requested. The code will print to the kernel log each time it has dynamically allocated as many entries as were initially preallocated. This is to indicate that a larger preallocation size may be appropriate, or if it happens continually that a driver may be leaking mappings.”…””}”(hj~"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MGhjÐhžhubjr)”}”(hŒFvoid debug_dma_mapping_error(struct device *dev, dma_addr_t dma_addr);”h]”hŒFvoid debug_dma_mapping_error(struct device *dev, dma_addr_t dma_addr);”…””}”hjŒ"sbah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jqhŸh¶h MThjÐhžhubhØ)”}”(hX;dma-debug interface debug_dma_mapping_error() to debug drivers that fail to check DMA mapping errors on addresses returned by dma_map_single() and dma_map_page() interfaces. This interface clears a flag set by debug_dma_map_page() to indicate that dma_mapping_error() has been called by the driver. When driver does unmap, debug_dma_unmap() checks the flag and if this flag is still set, prints warning message that includes call trace that leads up to the unmap. This interface can be called from dma_mapping_error() routines to enable DMA mapping error check debugging.”h]”hX;dma-debug interface debug_dma_mapping_error() to debug drivers that fail to check DMA mapping errors on addresses returned by dma_map_single() and dma_map_page() interfaces. This interface clears a flag set by debug_dma_map_page() to indicate that dma_mapping_error() has been called by the driver. When driver does unmap, debug_dma_unmap() checks the flag and if this flag is still set, prints warning message that includes call trace that leads up to the unmap. This interface can be called from dma_mapping_error() routines to enable DMA mapping error check debugging.”…””}”(hjš"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh¶h MWhjÐhžhubh¢)”}”(hhh]”(h§)”}”(hŒFunctions and structures”h]”hŒFunctions and structures”…””}”(hj«"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¨"hžhhŸh¶h MaubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_next (C function)”Œ c.sg_next”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ5struct scatterlist * sg_next (struct scatterlist *sg)”h]”jg)”}”(hŒ3struct scatterlist *sg_next(struct scatterlist *sg)”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÒ"hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÎ"hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kbubj)”}”(hŒ ”h]”hŒ ”…””}”(hjà"hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎ"hžhhŸjß"h Kbubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjñ"hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjî"ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jó"Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_next”sbŒ c.sg_next”†”asbuh1hhjÎ"hžhhŸjß"h Kbubj)”}”(hŒ ”h]”hŒ ”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎ"hžhhŸjß"h KbubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj #hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÎ"hžhhŸjß"h Kbubjß)”}”(hŒsg_next”h]”j“)”}”(hj#h]”hŒsg_next”…””}”(hj1#hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj-#ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÎ"hžhhŸjß"h Kbubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjL#hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjH#ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjY#hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjH#ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjj#hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjg#ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jl#Œmodname”NŒ classname”Nj°j³)”}”j¶]”j #Œ c.sg_next”†”asbuh1hhjH#ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjˆ#hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjH#ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj–#hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjH#ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj£#hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjH#ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjD#ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÎ"hžhhŸjß"h Kbubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÊ"hžhhŸjß"h Kbubah}”(h]”jÅ"ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjß"h KbhjÇ"hžhubjú)”}”(hhh]”hØ)”}”(hŒ+return the next scatterlist entry in a list”h]”hŒ+return the next scatterlist entry in a list”…””}”(hjÍ#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KbhjÊ#hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÇ"hžhhŸjß"h Kbubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjå#jjå#j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒô**Parameters** ``struct scatterlist *sg`` The current sg entry **Description** Usually the next entry will be **sg** + 1, but if this sg element is part of a chained scatterlist, it could jump to the start of a new scatterlist array.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjï#h]”hŒ Parameters”…””}”(hjñ#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjí#ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kfhjé#ubjA)”}”(hhh]”jF)”}”(hŒ0``struct scatterlist *sg`` The current sg entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj$h]”hŒstruct scatterlist *sg”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj$ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kchj$ubjf)”}”(hhh]”hØ)”}”(hŒThe current sg entry”h]”hŒThe current sg entry”…””}”(hj'$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj#$h Kchj$$ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj$ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj#$h Kchj$ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjé#ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjI$h]”hŒDescription”…””}”(hjK$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjG$ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kehjé#ubhŒblock_quote”“”)”}”(hŒšUsually the next entry will be **sg** + 1, but if this sg element is part of a chained scatterlist, it could jump to the start of a new scatterlist array.”h]”hØ)”}”(hŒšUsually the next entry will be **sg** + 1, but if this sg element is part of a chained scatterlist, it could jump to the start of a new scatterlist array.”h]”(hŒUsually the next entry will be ”…””}”(hje$hžhhŸNh Nubj+)”}”(hŒ**sg**”h]”hŒsg”…””}”(hjm$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hje$ubhŒu + 1, but if this sg element is part of a chained scatterlist, it could jump to the start of a new scatterlist array.”…””}”(hje$hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kehja$ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj…$h Kehjé#ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_assign_page (C function)”Œc.sg_assign_page”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ?void sg_assign_page (struct scatterlist *sg, struct page *page)”h]”jg)”}”(hŒ>void sg_assign_page(struct scatterlist *sg, struct page *page)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj¬$hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj¨$hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kxubj)”}”(hŒ ”h]”hŒ ”…””}”(hj»$hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¨$hžhhŸjº$h Kxubjß)”}”(hŒsg_assign_page”h]”j“)”}”(hŒsg_assign_page”h]”hŒsg_assign_page”…””}”(hjÍ$hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÉ$ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj¨$hžhhŸjº$h Kxubjú)”}”(hŒ+(struct scatterlist *sg, struct page *page)”h]”(j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjé$hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjå$ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjö$hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjå$ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj%ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j %Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÏ$sbŒc.sg_assign_page”†”asbuh1hhjå$ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj'%hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjå$ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj5%hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjå$ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjB%hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjå$ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjá$ubj)”}”(hŒstruct page *page”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj[%hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjW%ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjh%hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjW%ubh)”}”(hhh]”j“)”}”(hŒpage”h]”hŒpage”…””}”(hjy%hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjv%ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j{%Œmodname”NŒ classname”Nj°j³)”}”j¶]”j#%Œc.sg_assign_page”†”asbuh1hhjW%ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj—%hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjW%ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¥%hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjW%ubj“)”}”(hŒpage”h]”hŒpage”…””}”(hj²%hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjW%ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjá$ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj¨$hžhhŸjº$h Kxubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj¤$hžhhŸjº$h Kxubah}”(h]”jŸ$ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjº$h Kxhj¡$hžhubjú)”}”(hhh]”hØ)”}”(hŒ"Assign a given page to an SG entry”h]”hŒ"Assign a given page to an SG entry”…””}”(hjÜ%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KxhjÙ%hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj¡$hžhhŸjº$h Kxubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjô%jjô%j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒ¾**Parameters** ``struct scatterlist *sg`` SG entry ``struct page *page`` The page **Description** Assign page to sg entry. Also see sg_set_page(), the most commonly used variant.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjþ%h]”hŒ Parameters”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjü%ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K|hjø%ubjA)”}”(hhh]”(jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj&h]”hŒstruct scatterlist *sg”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kyhj&ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj6&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj2&h Kyhj3&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj2&h Kyhj&ubjF)”}”(hŒ``struct page *page`` The page ”h]”(jL)”}”(hŒ``struct page *page``”h]”jÒ)”}”(hjV&h]”hŒstruct page *page”…””}”(hjX&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjT&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KzhjP&ubjf)”}”(hhh]”hØ)”}”(hŒThe page”h]”hŒThe page”…””}”(hjo&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjk&h Kzhjl&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjP&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjk&h Kzhj&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjø%ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj‘&h]”hŒDescription”…””}”(hj“&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K|hjø%ubj`$)”}”(hŒPAssign page to sg entry. Also see sg_set_page(), the most commonly used variant.”h]”hØ)”}”(hŒPAssign page to sg entry. Also see sg_set_page(), the most commonly used variant.”h]”hŒPAssign page to sg entry. Also see sg_set_page(), the most commonly used variant.”…””}”(hj«&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K|hj§&ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj¹&h K|hjø%ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_set_page (C function)”Œ c.sg_set_page”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒcvoid sg_set_page (struct scatterlist *sg, struct page *page, unsigned int len, unsigned int offset)”h]”jg)”}”(hŒbvoid sg_set_page(struct scatterlist *sg, struct page *page, unsigned int len, unsigned int offset)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjà&hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÜ&hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K‘ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjï&hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÜ&hžhhŸjî&h K‘ubjß)”}”(hŒsg_set_page”h]”j“)”}”(hŒsg_set_page”h]”hŒsg_set_page”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjý&ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÜ&hžhhŸjî&h K‘ubjú)”}”(hŒR(struct scatterlist *sg, struct page *page, unsigned int len, unsigned int offset)”h]”(j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj*'hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj'ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj;'hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj8'ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j='Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j'sbŒ c.sg_set_page”†”asbuh1hhj'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj['hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj'ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hji'hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj'ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjv'hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj'ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'ubj)”}”(hŒstruct page *page”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj‹'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjœ'hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‹'ubh)”}”(hhh]”j“)”}”(hŒpage”h]”hŒpage”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjª'ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¯'Œmodname”NŒ classname”Nj°j³)”}”j¶]”jW'Œ c.sg_set_page”†”asbuh1hhj‹'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjË'hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‹'ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÙ'hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj‹'ubj“)”}”(hŒpage”h]”hŒpage”…””}”(hjæ'hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‹'ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'ubj)”}”(hŒunsigned int len”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÿ'hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjû'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj (hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjû'ubj")”}”(hŒint”h]”hŒint”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjû'ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj)(hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjû'ubj“)”}”(hŒlen”h]”hŒlen”…””}”(hj7(hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjû'ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'ubj)”}”(hŒunsigned int offset”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjP(hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjL(ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj^(hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjL(ubj")”}”(hŒint”h]”hŒint”…””}”(hjl(hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjL(ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjz(hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjL(ubj“)”}”(hŒoffset”h]”hŒoffset”…””}”(hjˆ(hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjL(ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÜ&hžhhŸjî&h K‘ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjØ&hžhhŸjî&h K‘ubah}”(h]”jÓ&ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjî&h K‘hjÕ&hžhubjú)”}”(hhh]”hØ)”}”(hŒ#Set sg entry to point at given page”h]”hŒ#Set sg entry to point at given page”…””}”(hj²(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K‘hj¯(hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÕ&hžhhŸjî&h K‘ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjÊ(jjÊ(j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX£**Parameters** ``struct scatterlist *sg`` SG entry ``struct page *page`` The page ``unsigned int len`` Length of data ``unsigned int offset`` Offset into page **Description** Use this function to set an sg entry pointing at a page, never assign the page directly. We encode sg table information in the lower bits of the page pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjÔ(h]”hŒ Parameters”…””}”(hjÖ(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÒ(ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K•hjÎ(ubjA)”}”(hhh]”(jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjó(h]”hŒstruct scatterlist *sg”…””}”(hjõ(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjñ(ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K’hjí(ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj)h K’hj )ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjí(ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj)h K’hjê(ubjF)”}”(hŒ``struct page *page`` The page ”h]”(jL)”}”(hŒ``struct page *page``”h]”jÒ)”}”(hj,)h]”hŒstruct page *page”…””}”(hj.)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj*)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K“hj&)ubjf)”}”(hhh]”hØ)”}”(hŒThe page”h]”hŒThe page”…””}”(hjE)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjA)h K“hjB)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj&)ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjA)h K“hjê(ubjF)”}”(hŒ$``unsigned int len`` Length of data ”h]”(jL)”}”(hŒ``unsigned int len``”h]”jÒ)”}”(hje)h]”hŒunsigned int len”…””}”(hjg)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjc)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K”hj_)ubjf)”}”(hhh]”hØ)”}”(hŒLength of data”h]”hŒLength of data”…””}”(hj~)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjz)h K”hj{)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj_)ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjz)h K”hjê(ubjF)”}”(hŒ)``unsigned int offset`` Offset into page ”h]”(jL)”}”(hŒ``unsigned int offset``”h]”jÒ)”}”(hjž)h]”hŒunsigned int offset”…””}”(hj )hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjœ)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K•hj˜)ubjf)”}”(hhh]”hØ)”}”(hŒOffset into page”h]”hŒOffset into page”…””}”(hj·)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj³)h K•hj´)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj˜)ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj³)h K•hjê(ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjÎ(ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÙ)h]”hŒDescription”…””}”(hjÛ)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj×)ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K—hjÎ(ubj`$)”}”(hŒÞUse this function to set an sg entry pointing at a page, never assign the page directly. We encode sg table information in the lower bits of the page pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”hØ)”}”(hŒÞUse this function to set an sg entry pointing at a page, never assign the page directly. We encode sg table information in the lower bits of the page pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”hŒÞUse this function to set an sg entry pointing at a page, never assign the page directly. We encode sg table information in the lower bits of the page pointer. See sg_page() for looking up the page belonging to an sg entry.”…””}”(hjó)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K—hjï)ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj*h K—hjÎ(ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_set_folio (C function)”Œc.sg_set_folio”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒZvoid sg_set_folio (struct scatterlist *sg, struct folio *folio, size_t len, size_t offset)”h]”jg)”}”(hŒYvoid sg_set_folio(struct scatterlist *sg, struct folio *folio, size_t len, size_t offset)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj(*hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj$*hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K§ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj7*hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj$*hžhhŸj6*h K§ubjß)”}”(hŒsg_set_folio”h]”j“)”}”(hŒsg_set_folio”h]”hŒsg_set_folio”…””}”(hjI*hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjE*ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj$*hžhhŸj6*h K§ubjú)”}”(hŒH(struct scatterlist *sg, struct folio *folio, size_t len, size_t offset)”h]”(j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hje*hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhja*ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjr*hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hja*ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjƒ*hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj€*ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j…*Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jK*sbŒc.sg_set_folio”†”asbuh1hhja*ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj£*hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hja*ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj±*hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhja*ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj¾*hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hja*ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj]*ubj)”}”(hŒstruct folio *folio”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj×*hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÓ*ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjä*hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÓ*ubh)”}”(hhh]”j“)”}”(hŒfolio”h]”hŒfolio”…””}”(hjõ*hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjò*ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j÷*Œmodname”NŒ classname”Nj°j³)”}”j¶]”jŸ*Œc.sg_set_folio”†”asbuh1hhjÓ*ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj+hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÓ*ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj!+hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÓ*ubj“)”}”(hŒfolio”h]”hŒfolio”…””}”(hj.+hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÓ*ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj]*ubj)”}”(hŒ size_t len”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjJ+hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjG+ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jL+Œmodname”NŒ classname”Nj°j³)”}”j¶]”jŸ*Œc.sg_set_folio”†”asbuh1hhjC+ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjh+hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjC+ubj“)”}”(hŒlen”h]”hŒlen”…””}”(hjv+hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjC+ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj]*ubj)”}”(hŒ size_t offset”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj’+hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj+ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j”+Œmodname”NŒ classname”Nj°j³)”}”j¶]”jŸ*Œc.sg_set_folio”†”asbuh1hhj‹+ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj°+hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‹+ubj“)”}”(hŒoffset”h]”hŒoffset”…””}”(hj¾+hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‹+ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj]*ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj$*hžhhŸj6*h K§ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj *hžhhŸj6*h K§ubah}”(h]”j*ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj6*h K§hj*hžhubjú)”}”(hhh]”hØ)”}”(hŒ$Set sg entry to point at given folio”h]”hŒ$Set sg entry to point at given folio”…””}”(hjè+hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K§hjå+hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj*hžhhŸj6*h K§ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj,jj,j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXž**Parameters** ``struct scatterlist *sg`` SG entry ``struct folio *folio`` The folio ``size_t len`` Length of data ``size_t offset`` Offset into folio **Description** Use this function to set an sg entry pointing at a folio, never assign the folio directly. We encode sg table information in the lower bits of the folio pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj ,h]”hŒ Parameters”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj,ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K«hj,ubjA)”}”(hhh]”(jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj),h]”hŒstruct scatterlist *sg”…””}”(hj+,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj',ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K¨hj#,ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjB,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj>,h K¨hj?,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj#,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj>,h K¨hj ,ubjF)”}”(hŒ"``struct folio *folio`` The folio ”h]”(jL)”}”(hŒ``struct folio *folio``”h]”jÒ)”}”(hjb,h]”hŒstruct folio *folio”…””}”(hjd,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj`,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K©hj\,ubjf)”}”(hhh]”hØ)”}”(hŒ The folio”h]”hŒ The folio”…””}”(hj{,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjw,h K©hjx,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj\,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjw,h K©hj ,ubjF)”}”(hŒ``size_t len`` Length of data ”h]”(jL)”}”(hŒ``size_t len``”h]”jÒ)”}”(hj›,h]”hŒ size_t len”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj™,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kªhj•,ubjf)”}”(hhh]”hØ)”}”(hŒLength of data”h]”hŒLength of data”…””}”(hj´,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj°,h Kªhj±,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj•,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj°,h Kªhj ,ubjF)”}”(hŒ$``size_t offset`` Offset into folio ”h]”(jL)”}”(hŒ``size_t offset``”h]”jÒ)”}”(hjÔ,h]”hŒ size_t offset”…””}”(hjÖ,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÒ,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h K«hjÎ,ubjf)”}”(hhh]”hØ)”}”(hŒOffset into folio”h]”hŒOffset into folio”…””}”(hjí,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjé,h K«hjê,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÎ,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjé,h K«hj ,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj,ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj-h]”hŒDescription”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj -ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Khj,ubj`$)”}”(hŒáUse this function to set an sg entry pointing at a folio, never assign the folio directly. We encode sg table information in the lower bits of the folio pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”hØ)”}”(hŒáUse this function to set an sg entry pointing at a folio, never assign the folio directly. We encode sg table information in the lower bits of the folio pointer. See sg_page() for looking up the page belonging to an sg entry.”h]”hŒáUse this function to set an sg entry pointing at a folio, never assign the folio directly. We encode sg table information in the lower bits of the folio pointer. See sg_page() for looking up the page belonging to an sg entry.”…””}”(hj)-hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Khj%-ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj7-h Khj,ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_set_buf (C function)”Œc.sg_set_buf”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒNvoid sg_set_buf (struct scatterlist *sg, const void *buf, unsigned int buflen)”h]”jg)”}”(hŒMvoid sg_set_buf(struct scatterlist *sg, const void *buf, unsigned int buflen)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj^-hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjZ-hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KÇubj)”}”(hŒ ”h]”hŒ ”…””}”(hjm-hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjZ-hžhhŸjl-h KÇubjß)”}”(hŒ sg_set_buf”h]”j“)”}”(hŒ sg_set_buf”h]”hŒ sg_set_buf”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj{-ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjZ-hžhhŸjl-h KÇubjú)”}”(hŒ>(struct scatterlist *sg, const void *buf, unsigned int buflen)”h]”(j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj›-hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj—-ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¨-hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj—-ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj¹-hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¶-ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j»-Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j-sbŒc.sg_set_buf”†”asbuh1hhj—-ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÙ-hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj—-ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjç-hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj—-ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjô-hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj—-ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj“-ubj)”}”(hŒconst void *buf”h]”(jm)”}”(hjh]”hŒconst”…””}”(hj .hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj .ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj .ubj")”}”(hŒvoid”h]”hŒvoid”…””}”(hj(.hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj .ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj6.hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj .ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjD.hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj .ubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hjQ.hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj .ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj“-ubj)”}”(hŒunsigned int buflen”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjj.hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjf.ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjx.hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjf.ubj")”}”(hŒint”h]”hŒint”…””}”(hj†.hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjf.ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj”.hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjf.ubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hj¢.hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjf.ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj“-ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjZ-hžhhŸjl-h KÇubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjV-hžhhŸjl-h KÇubah}”(h]”jQ-ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjl-h KÇhjS-hžhubjú)”}”(hhh]”hØ)”}”(hŒ#Set sg entry to point at given data”h]”hŒ#Set sg entry to point at given data”…””}”(hjÌ.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KÇhjÉ.hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjS-hžhhŸjl-h KÇubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjä.jjä.j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒx**Parameters** ``struct scatterlist *sg`` SG entry ``const void *buf`` Data ``unsigned int buflen`` Data length”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjî.h]”hŒ Parameters”…””}”(hjð.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjì.ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KËhjè.ubjA)”}”(hhh]”(jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj /h]”hŒstruct scatterlist *sg”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KÈhj/ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj&/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj"/h KÈhj#/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj"/h KÈhj/ubjF)”}”(hŒ``const void *buf`` Data ”h]”(jL)”}”(hŒ``const void *buf``”h]”jÒ)”}”(hjF/h]”hŒconst void *buf”…””}”(hjH/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjD/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KÉhj@/ubjf)”}”(hhh]”hØ)”}”(hŒData”h]”hŒData”…””}”(hj_/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj[/h KÉhj\/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj@/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj[/h KÉhj/ubjF)”}”(hŒ#``unsigned int buflen`` Data length”h]”(jL)”}”(hŒ``unsigned int buflen``”h]”jÒ)”}”(hj/h]”hŒunsigned int buflen”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj}/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KËhjy/ubjf)”}”(hhh]”hØ)”}”(hŒData length”h]”hŒData length”…””}”(hj˜/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KÊhj•/ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjy/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj”/h KËhj/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjè.ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_chain (C function)”Œ c.sg_chain”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒXvoid sg_chain (struct scatterlist *prv, unsigned int prv_nents, struct scatterlist *sgl)”h]”jg)”}”(hŒWvoid sg_chain(struct scatterlist *prv, unsigned int prv_nents, struct scatterlist *sgl)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjÙ/hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÕ/hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kûubj)”}”(hŒ ”h]”hŒ ”…””}”(hjè/hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÕ/hžhhŸjç/h Kûubjß)”}”(hŒsg_chain”h]”j“)”}”(hŒsg_chain”h]”hŒsg_chain”…””}”(hjú/hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjö/ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÕ/hžhhŸjç/h Kûubjú)”}”(hŒJ(struct scatterlist *prv, unsigned int prv_nents, struct scatterlist *sgl)”h]”(j)”}”(hŒstruct scatterlist *prv”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj#0hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj40hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj10ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j60Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jü/sbŒ c.sg_chain”†”asbuh1hhj0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjT0hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjb0hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj0ubj“)”}”(hŒprv”h]”hŒprv”…””}”(hjo0hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj0ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj0ubj)”}”(hŒunsigned int prv_nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjˆ0hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj„0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj–0hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj„0ubj")”}”(hŒint”h]”hŒint”…””}”(hj¤0hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj„0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj²0hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj„0ubj“)”}”(hŒ prv_nents”h]”hŒ prv_nents”…””}”(hjÀ0hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj„0ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj0ubj)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÙ0hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÕ0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjæ0hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÕ0ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj÷0hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjô0ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jù0Œmodname”NŒ classname”Nj°j³)”}”j¶]”jP0Œ c.sg_chain”†”asbuh1hhjÕ0ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÕ0ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj#1hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÕ0ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj01hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÕ0ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj0ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÕ/hžhhŸjç/h Kûubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÑ/hžhhŸjç/h Kûubah}”(h]”jÌ/ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjç/h KûhjÎ/hžhubjú)”}”(hhh]”hØ)”}”(hŒChain two sglists together”h]”hŒChain two sglists together”…””}”(hjZ1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KûhjW1hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÎ/hžhhŸjç/h Kûubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjr1jjr1j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒþ**Parameters** ``struct scatterlist *prv`` First scatterlist ``unsigned int prv_nents`` Number of entries in prv ``struct scatterlist *sgl`` Second scatterlist **Description** Links **prv** and **sgl** together, to form a longer scatterlist.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj|1h]”hŒ Parameters”…””}”(hj~1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjz1ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kÿhjv1ubjA)”}”(hhh]”(jF)”}”(hŒ.``struct scatterlist *prv`` First scatterlist ”h]”(jL)”}”(hŒ``struct scatterlist *prv``”h]”jÒ)”}”(hj›1h]”hŒstruct scatterlist *prv”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj™1ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kühj•1ubjf)”}”(hhh]”hØ)”}”(hŒFirst scatterlist”h]”hŒFirst scatterlist”…””}”(hj´1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj°1h Kühj±1ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj•1ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj°1h Kühj’1ubjF)”}”(hŒ4``unsigned int prv_nents`` Number of entries in prv ”h]”(jL)”}”(hŒ``unsigned int prv_nents``”h]”jÒ)”}”(hjÔ1h]”hŒunsigned int prv_nents”…””}”(hjÖ1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÒ1ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h KýhjÎ1ubjf)”}”(hhh]”hØ)”}”(hŒNumber of entries in prv”h]”hŒNumber of entries in prv”…””}”(hjí1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjé1h Kýhjê1ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÎ1ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjé1h Kýhj’1ubjF)”}”(hŒ/``struct scatterlist *sgl`` Second scatterlist ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hj 2h]”hŒstruct scatterlist *sgl”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Kþhj2ubjf)”}”(hhh]”hØ)”}”(hŒSecond scatterlist”h]”hŒSecond scatterlist”…””}”(hj&2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj"2h Kþhj#2ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj2ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj"2h Kþhj’1ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjv1ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjH2h]”hŒDescription”…””}”(hjJ2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjF2ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhjv1ubj`$)”}”(hŒALinks **prv** and **sgl** together, to form a longer scatterlist.”h]”hØ)”}”(hj`2h]”(hŒLinks ”…””}”(hjb2hžhhŸNh Nubj+)”}”(hŒ**prv**”h]”hŒprv”…””}”(hji2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjb2ubhŒ and ”…””}”(hjb2hžhhŸNh Nubj+)”}”(hŒ**sgl**”h]”hŒsgl”…””}”(hj{2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjb2ubhŒ( together, to form a longer scatterlist.”…””}”(hjb2hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj^2ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj“2h Mhjv1ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"•8hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_mark_end (C function)”Œ c.sg_mark_end”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ)void sg_mark_end (struct scatterlist *sg)”h]”jg)”}”(hŒ(void sg_mark_end(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjº2hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj¶2hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÉ2hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¶2hžhhŸjÈ2h Mubjß)”}”(hŒsg_mark_end”h]”j“)”}”(hŒsg_mark_end”h]”hŒsg_mark_end”…””}”(hjÛ2hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj×2ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj¶2hžhhŸjÈ2h Mubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj÷2hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjó2ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjó2ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj3ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j3Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÝ2sbŒ c.sg_mark_end”†”asbuh1hhjó2ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj53hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjó2ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjC3hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjó2ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjP3hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjó2ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjï2ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj¶2hžhhŸjÈ2h Mubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj²2hžhhŸjÈ2h Mubah}”(h]”j2ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjÈ2h Mhj¯2hžhubjú)”}”(hhh]”hØ)”}”(hŒMark the end of the scatterlist”h]”hŒMark the end of the scatterlist”…””}”(hjz3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhjw3hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj¯2hžhhŸjÈ2h Mubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj’3jj’3j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒÒ**Parameters** ``struct scatterlist *sg`` SG entryScatterlist **Description** Marks the passed in sg entry as the termination point for the sg table. A call to sg_next() on this entry will return NULL.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjœ3h]”hŒ Parameters”…””}”(hjž3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjš3ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj–3ubjA)”}”(hhh]”jF)”}”(hŒ/``struct scatterlist *sg`` SG entryScatterlist ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj»3h]”hŒstruct scatterlist *sg”…””}”(hj½3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj¹3ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhjµ3ubjf)”}”(hhh]”hØ)”}”(hŒSG entryScatterlist”h]”hŒSG entryScatterlist”…””}”(hjÔ3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÐ3h MhjÑ3ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjµ3ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÐ3h Mhj²3ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj–3ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjö3h]”hŒDescription”…””}”(hjø3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjô3ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj–3ubj`$)”}”(hŒ{Marks the passed in sg entry as the termination point for the sg table. A call to sg_next() on this entry will return NULL.”h]”hØ)”}”(hŒ{Marks the passed in sg entry as the termination point for the sg table. A call to sg_next() on this entry will return NULL.”h]”hŒ{Marks the passed in sg entry as the termination point for the sg table. A call to sg_next() on this entry will return NULL.”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj4h Mhj–3ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_unmark_end (C function)”Œc.sg_unmark_end”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ+void sg_unmark_end (struct scatterlist *sg)”h]”jg)”}”(hŒ*void sg_unmark_end(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjE4hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjA4hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mubj)”}”(hŒ ”h]”hŒ ”…””}”(hjT4hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjA4hžhhŸjS4h Mubjß)”}”(hŒ sg_unmark_end”h]”j“)”}”(hŒ sg_unmark_end”h]”hŒ sg_unmark_end”…””}”(hjf4hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjb4ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjA4hžhhŸjS4h Mubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj‚4hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj~4ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj~4ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj 4hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj4ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¢4Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jh4sbŒc.sg_unmark_end”†”asbuh1hhj~4ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÀ4hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj~4ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÎ4hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj~4ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjÛ4hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj~4ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjz4ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjA4hžhhŸjS4h Mubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj=4hžhhŸjS4h Mubah}”(h]”j84ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjS4h Mhj:4hžhubjú)”}”(hhh]”hØ)”}”(hŒ'Undo setting the end of the scatterlist”h]”hŒ'Undo setting the end of the scatterlist”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj5hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj:4hžhhŸjS4h Mubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj5jj5j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒœ**Parameters** ``struct scatterlist *sg`` SG entryScatterlist **Description** Removes the termination marker from the given entry of the scatterlist.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj'5h]”hŒ Parameters”…””}”(hj)5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj%5ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M!hj!5ubjA)”}”(hhh]”jF)”}”(hŒ/``struct scatterlist *sg`` SG entryScatterlist ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjF5h]”hŒstruct scatterlist *sg”…””}”(hjH5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjD5ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mhj@5ubjf)”}”(hhh]”hØ)”}”(hŒSG entryScatterlist”h]”hŒSG entryScatterlist”…””}”(hj_5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj[5h Mhj\5ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj@5ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj[5h Mhj=5ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj!5ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj5h]”hŒDescription”…””}”(hjƒ5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj5ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M hj!5ubj`$)”}”(hŒGRemoves the termination marker from the given entry of the scatterlist.”h]”hØ)”}”(hj™5h]”hŒGRemoves the termination marker from the given entry of the scatterlist.”…””}”(hj›5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M hj—5ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj¨5h M hj!5ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ"sg_dma_is_bus_address (C function)”Œc.sg_dma_is_bus_address”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ3bool sg_dma_is_bus_address (struct scatterlist *sg)”h]”jg)”}”(hŒ2bool sg_dma_is_bus_address(struct scatterlist *sg)”h]”(j")”}”(hŒbool”h]”hŒbool”…””}”(hjÏ5hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjË5hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M5ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÞ5hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjË5hžhhŸjÝ5h M5ubjß)”}”(hŒsg_dma_is_bus_address”h]”j“)”}”(hŒsg_dma_is_bus_address”h]”hŒsg_dma_is_bus_address”…””}”(hjð5hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjì5ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjË5hžhhŸjÝ5h M5ubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj6ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj6ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj*6hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj'6ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j,6Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jò5sbŒc.sg_dma_is_bus_address”†”asbuh1hhj6ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjJ6hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj6ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjX6hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj6ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hje6hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj6ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj6ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjË5hžhhŸjÝ5h M5ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÇ5hžhhŸjÝ5h M5ubah}”(h]”jÂ5ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjÝ5h M5hjÄ5hžhubjú)”}”(hhh]”hØ)”}”(hŒ:Return whether a given segment was marked as a bus address”h]”hŒ:Return whether a given segment was marked as a bus address”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M5hjŒ6hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÄ5hžhhŸjÝ5h M5ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj§6jj§6j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒ–**Parameters** ``struct scatterlist *sg`` SG entry **Description** Returns true if sg_dma_mark_bus_address() has been called on this segment.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj±6h]”hŒ Parameters”…””}”(hj³6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¯6ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M9hj«6ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjÐ6h]”hŒstruct scatterlist *sg”…””}”(hjÒ6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÎ6ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M7hjÊ6ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjé6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjå6h M7hjæ6ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÊ6ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjå6h M7hjÇ6ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj«6ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj7h]”hŒDescription”…””}”(hj 7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj 7ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M9hj«6ubj`$)”}”(hŒJReturns true if sg_dma_mark_bus_address() has been called on this segment.”h]”hØ)”}”(hŒJReturns true if sg_dma_mark_bus_address() has been called on this segment.”h]”hŒJReturns true if sg_dma_mark_bus_address() has been called on this segment.”…””}”(hj%7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M9hj!7ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj37h M9hj«6ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ$sg_dma_mark_bus_address (C function)”Œc.sg_dma_mark_bus_address”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ5void sg_dma_mark_bus_address (struct scatterlist *sg)”h]”jg)”}”(hŒ4void sg_dma_mark_bus_address(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjZ7hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjV7hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MCubj)”}”(hŒ ”h]”hŒ ”…””}”(hji7hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjV7hžhhŸjh7h MCubjß)”}”(hŒsg_dma_mark_bus_address”h]”j“)”}”(hŒsg_dma_mark_bus_address”h]”hŒsg_dma_mark_bus_address”…””}”(hj{7hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjw7ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjV7hžhhŸjh7h MCubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj—7hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj“7ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¤7hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj“7ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjµ7hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj²7ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j·7Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j}7sbŒc.sg_dma_mark_bus_address”†”asbuh1hhj“7ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÕ7hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj“7ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjã7hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj“7ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjð7hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj“7ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj7ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjV7hžhhŸjh7h MCubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjR7hžhhŸjh7h MCubah}”(h]”jM7ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjh7h MChjO7hžhubjú)”}”(hhh]”hØ)”}”(hŒ+Mark the scatterlist entry as a bus address”h]”hŒ+Mark the scatterlist entry as a bus address”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MChj8hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjO7hžhhŸjh7h MCubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj28jj28j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXD**Parameters** ``struct scatterlist *sg`` SG entry **Description** Marks the passed in sg entry to indicate that the dma_address is a bus address and doesn't need to be unmapped. This should only be used by dma_map_sg() implementations to mark bus addresses so they can be properly cleaned up in dma_unmap_sg().”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj<8h]”hŒ Parameters”…””}”(hj>8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:8ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MGhj68ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj[8h]”hŒstruct scatterlist *sg”…””}”(hj]8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjY8ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MDhjU8ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjt8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjp8h MDhjq8ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjU8ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjp8h MDhjR8ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj68ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj–8h]”hŒDescription”…””}”(hj˜8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj”8ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MFhj68ubj`$)”}”(hŒôMarks the passed in sg entry to indicate that the dma_address is a bus address and doesn't need to be unmapped. This should only be used by dma_map_sg() implementations to mark bus addresses so they can be properly cleaned up in dma_unmap_sg().”h]”hØ)”}”(hŒôMarks the passed in sg entry to indicate that the dma_address is a bus address and doesn't need to be unmapped. This should only be used by dma_map_sg() implementations to mark bus addresses so they can be properly cleaned up in dma_unmap_sg().”h]”hŒöMarks the passed in sg entry to indicate that the dma_address is a bus address and doesnâ€™t need to be unmapped. This should only be used by dma_map_sg() implementations to mark bus addresses so they can be properly cleaned up in dma_unmap_sg().”…””}”(hj°8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MFhj¬8ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj¾8h MFhj68ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ&sg_dma_unmark_bus_address (C function)”Œc.sg_dma_unmark_bus_address”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ7void sg_dma_unmark_bus_address (struct scatterlist *sg)”h]”jg)”}”(hŒ6void sg_dma_unmark_bus_address(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjå8hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjá8hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MRubj)”}”(hŒ ”h]”hŒ ”…””}”(hjô8hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjá8hžhhŸjó8h MRubjß)”}”(hŒsg_dma_unmark_bus_address”h]”j“)”}”(hŒsg_dma_unmark_bus_address”h]”hŒsg_dma_unmark_bus_address”…””}”(hj9hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj9ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjá8hžhhŸjó8h MRubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj"9hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj9ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj/9hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj9ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj@9hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj=9ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jB9Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j9sbŒc.sg_dma_unmark_bus_address”†”asbuh1hhj9ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj`9hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj9ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjn9hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj9ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj{9hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj9ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj9ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjá8hžhhŸjó8h MRubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÝ8hžhhŸjó8h MRubah}”(h]”jØ8ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjó8h MRhjÚ8hžhubjú)”}”(hhh]”hØ)”}”(hŒ-Unmark the scatterlist entry as a bus address”h]”hŒ-Unmark the scatterlist entry as a bus address”…””}”(hj¥9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MRhj¢9hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÚ8hžhhŸjó8h MRubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj½9jj½9j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒf**Parameters** ``struct scatterlist *sg`` SG entry **Description** Clears the bus address mark.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjÇ9h]”hŒ Parameters”…””}”(hjÉ9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÅ9ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MVhjÁ9ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjæ9h]”hŒstruct scatterlist *sg”…””}”(hjè9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjä9ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MShjà9ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjÿ9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjû9h MShjü9ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjà9ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjû9h MShjÝ9ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjÁ9ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj!:h]”hŒDescription”…””}”(hj#:hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MUhjÁ9ubj`$)”}”(hŒClears the bus address mark.”h]”hØ)”}”(hj9:h]”hŒClears the bus address mark.”…””}”(hj;:hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MUhj7:ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjH:h MUhjÁ9ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_dma_is_swiotlb (C function)”Œc.sg_dma_is_swiotlb”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ/bool sg_dma_is_swiotlb (struct scatterlist *sg)”h]”jg)”}”(hŒ.bool sg_dma_is_swiotlb(struct scatterlist *sg)”h]”(j")”}”(hjÑ5h]”hŒbool”…””}”(hjo:hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjk:hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M^ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj}:hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjk:hžhhŸj|:h M^ubjß)”}”(hŒsg_dma_is_swiotlb”h]”j“)”}”(hŒsg_dma_is_swiotlb”h]”hŒsg_dma_is_swiotlb”…””}”(hj:hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‹:ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjk:hžhhŸj|:h M^ubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj«:hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj§:ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¸:hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj§:ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjÉ:hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÆ:ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jË:Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j‘:sbŒc.sg_dma_is_swiotlb”†”asbuh1hhj§:ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjé:hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj§:ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj÷:hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj§:ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj§:ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj£:ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjk:hžhhŸj|:h M^ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjg:hžhhŸj|:h M^ubah}”(h]”jb:ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj|:h M^hjd:hžhubjú)”}”(hhh]”hØ)”}”(hŒ>Return whether the scatterlist was marked for SWIOTLB bouncing”h]”hŒ>Return whether the scatterlist was marked for SWIOTLB bouncing”…””}”(hj.;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M^hj+;hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjd:hžhhŸj|:h M^ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjF;jjF;j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX**Parameters** ``struct scatterlist *sg`` SG entry **Description** Returns true if the scatterlist was marked for SWIOTLB bouncing. Not all elements may have been bounced, so the caller would have to check individual SG entries with swiotlb_find_pool().”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjP;h]”hŒ Parameters”…””}”(hjR;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjN;ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MbhjJ;ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjo;h]”hŒstruct scatterlist *sg”…””}”(hjq;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjm;ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M`hji;ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjˆ;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj„;h M`hj…;ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehji;ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj„;h M`hjf;ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjJ;ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjª;h]”hŒDescription”…””}”(hj¬;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¨;ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MbhjJ;ubj`$)”}”(hŒºReturns true if the scatterlist was marked for SWIOTLB bouncing. Not all elements may have been bounced, so the caller would have to check individual SG entries with swiotlb_find_pool().”h]”hØ)”}”(hŒºReturns true if the scatterlist was marked for SWIOTLB bouncing. Not all elements may have been bounced, so the caller would have to check individual SG entries with swiotlb_find_pool().”h]”hŒºReturns true if the scatterlist was marked for SWIOTLB bouncing. Not all elements may have been bounced, so the caller would have to check individual SG entries with swiotlb_find_pool().”…””}”(hjÄ;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MbhjÀ;ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjÒ;h MbhjJ;ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ sg_dma_mark_swiotlb (C function)”Œc.sg_dma_mark_swiotlb”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ1void sg_dma_mark_swiotlb (struct scatterlist *sg)”h]”jg)”}”(hŒ0void sg_dma_mark_swiotlb(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjù;hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjõ;hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mmubj)”}”(hŒ ”h]”hŒ ”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjõ;hžhhŸj<h Mmubjß)”}”(hŒsg_dma_mark_swiotlb”h]”j“)”}”(hŒsg_dma_mark_swiotlb”h]”hŒsg_dma_mark_swiotlb”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj<ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjõ;hžhhŸj<h Mmubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj6<hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj2<ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjC<hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj2<ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjT<hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjQ<ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jV<Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j<sbŒc.sg_dma_mark_swiotlb”†”asbuh1hhj2<ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjt<hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj2<ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj‚<hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj2<ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj2<ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj.<ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjõ;hžhhŸj<h Mmubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjñ;hžhhŸj<h Mmubah}”(h]”jì;ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj<h Mmhjî;hžhubjú)”}”(hhh]”hØ)”}”(hŒ)Mark the scatterlist for SWIOTLB bouncing”h]”hŒ)Mark the scatterlist for SWIOTLB bouncing”…””}”(hj¹<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mmhj¶<hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjî;hžhhŸj<h Mmubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjÑ<jjÑ<j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒ˜**Parameters** ``struct scatterlist *sg`` SG entry **Description** Marks a a scatterlist for SWIOTLB bounce. Not all SG entries may be bounced.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjÛ<h]”hŒ Parameters”…””}”(hjÝ<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÙ<ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MqhjÕ<ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjú<h]”hŒstruct scatterlist *sg”…””}”(hjü<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjø<ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mnhjô<ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj=hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj=h Mnhj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjô<ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj=h Mnhjñ<ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjÕ<ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj5=h]”hŒDescription”…””}”(hj7=hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj3=ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MphjÕ<ubj`$)”}”(hŒLMarks a a scatterlist for SWIOTLB bounce. Not all SG entries may be bounced.”h]”hØ)”}”(hŒLMarks a a scatterlist for SWIOTLB bounce. Not all SG entries may be bounced.”h]”hŒLMarks a a scatterlist for SWIOTLB bounce. Not all SG entries may be bounced.”…””}”(hjO=hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MphjK=ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj]=h MphjÕ<ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_phys (C function)”Œ c.sg_phys”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ+dma_addr_t sg_phys (struct scatterlist *sg)”h]”jg)”}”(hŒ*dma_addr_t sg_phys(struct scatterlist *sg)”h]”(h)”}”(hhh]”j“)”}”(hŒ dma_addr_t”h]”hŒ dma_addr_t”…””}”(hj‡=hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj„=ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j‰=Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_phys”sbŒ c.sg_phys”†”asbuh1hhj€=hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mubj)”}”(hŒ ”h]”hŒ ”…””}”(hj©=hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj€=hžhhŸj¨=h Mubjß)”}”(hŒsg_phys”h]”j“)”}”(hj¥=h]”hŒsg_phys”…””}”(hj»=hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj·=ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj€=hžhhŸj¨=h Mubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÖ=hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÒ=ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjã=hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒ=ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjô=hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjñ=ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jö=Œmodname”NŒ classname”Nj°j³)”}”j¶]”j£=Œ c.sg_phys”†”asbuh1hhjÒ=ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj>hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒ=ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj >hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÒ=ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hj->hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒ=ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÎ=ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj€=hžhhŸj¨=h Mubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj|=hžhhŸj¨=h Mubah}”(h]”jw=ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj¨=h Mhjy=hžhubjú)”}”(hhh]”hØ)”}”(hŒ&Return physical address of an sg entry”h]”hŒ&Return physical address of an sg entry”…””}”(hjW>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MhjT>hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjy=hžhhŸj¨=h Mubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjo>jjo>j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒê**Parameters** ``struct scatterlist *sg`` SG entry **Description** This calls page_to_phys() on the page in this sg entry, and adds the sg offset. The caller must know that it is legal to call page_to_phys() on the sg page.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjy>h]”hŒ Parameters”…””}”(hj{>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjw>ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M”hjs>ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj˜>h]”hŒstruct scatterlist *sg”…””}”(hjš>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj–>ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M‘hj’>ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj±>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj>h M‘hj®>ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj’>ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj>h M‘hj>ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjs>ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÓ>h]”hŒDescription”…””}”(hjÕ>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÑ>ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M“hjs>ubj`$)”}”(hŒœThis calls page_to_phys() on the page in this sg entry, and adds the sg offset. The caller must know that it is legal to call page_to_phys() on the sg page.”h]”hØ)”}”(hŒœThis calls page_to_phys() on the page in this sg entry, and adds the sg offset. The caller must know that it is legal to call page_to_phys() on the sg page.”h]”hŒœThis calls page_to_phys() on the page in this sg entry, and adds the sg offset. The caller must know that it is legal to call page_to_phys() on the sg page.”…””}”(hjí>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M“hjé>ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjû>h M“hjs>ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_virt (C function)”Œ c.sg_virt”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ'void * sg_virt (struct scatterlist *sg)”h]”jg)”}”(hŒ%void *sg_virt(struct scatterlist *sg)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj"?hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj?hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MŸubj)”}”(hŒ ”h]”hŒ ”…””}”(hj1?hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj?hžhhŸj0?h MŸubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj??hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj?hžhhŸj0?h MŸubjß)”}”(hŒsg_virt”h]”j“)”}”(hŒsg_virt”h]”hŒsg_virt”…””}”(hjP?hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjL?ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj?hžhhŸj0?h MŸubjú)”}”(hŒ(struct scatterlist *sg)”h]”j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjl?hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjh?ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjy?hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjh?ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjŠ?hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‡?ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŒ?Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jR?sbŒ c.sg_virt”†”asbuh1hhjh?ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjª?hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjh?ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¸?hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjh?ubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjÅ?hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjh?ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjd?ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj?hžhhŸj0?h MŸubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj?hžhhŸj0?h MŸubah}”(h]”j?ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj0?h MŸhj?hžhubjú)”}”(hhh]”hØ)”}”(hŒ%Return virtual address of an sg entry”h]”hŒ%Return virtual address of an sg entry”…””}”(hjï?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MŸhjì?hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj?hžhhŸj0?h MŸubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj@jj@j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒà**Parameters** ``struct scatterlist *sg`` SG entry **Description** This calls page_address() on the page in this sg entry, and adds the sg offset. The caller must know that the sg page has a valid virtual mapping.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj@h]”hŒ Parameters”…””}”(hj@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj@ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M£hj@ubjA)”}”(hhh]”jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hj0@h]”hŒstruct scatterlist *sg”…””}”(hj2@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj.@ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M hj*@ubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hjI@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjE@h M hjF@ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj*@ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjE@h M hj'@ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj@ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjk@h]”hŒDescription”…””}”(hjm@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hji@ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M¢hj@ubj`$)”}”(hŒ’This calls page_address() on the page in this sg entry, and adds the sg offset. The caller must know that the sg page has a valid virtual mapping.”h]”hØ)”}”(hŒ’This calls page_address() on the page in this sg entry, and adds the sg offset. The caller must know that the sg page has a valid virtual mapping.”h]”hŒ’This calls page_address() on the page in this sg entry, and adds the sg offset. The caller must know that the sg page has a valid virtual mapping.”…””}”(hj…@hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M¢hj@ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj“@h M¢hj@ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_init_marker (C function)”Œc.sg_init_marker”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒAvoid sg_init_marker (struct scatterlist *sgl, unsigned int nents)”h]”jg)”}”(hŒ@void sg_init_marker(struct scatterlist *sgl, unsigned int nents)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjº@hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj¶@hžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M®ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÉ@hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¶@hžhhŸjÈ@h M®ubjß)”}”(hŒsg_init_marker”h]”j“)”}”(hŒsg_init_marker”h]”hŒsg_init_marker”…””}”(hjÛ@hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj×@ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj¶@hžhhŸjÈ@h M®ubjú)”}”(hŒ-(struct scatterlist *sgl, unsigned int nents)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj÷@hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjó@ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjó@ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjAubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jAŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÝ@sbŒc.sg_init_marker”†”asbuh1hhjó@ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj5AhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjó@ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjCAhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjó@ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hjPAhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjó@ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjï@ubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjiAhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjeAubj)”}”(hŒ ”h]”hŒ ”…””}”(hjwAhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjeAubj")”}”(hŒint”h]”hŒint”…””}”(hj…AhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjeAubj)”}”(hŒ ”h]”hŒ ”…””}”(hj“AhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjeAubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj¡AhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjeAubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjï@ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj¶@hžhhŸjÈ@h M®ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj²@hžhhŸjÈ@h M®ubah}”(h]”j@ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjÈ@h M®hj¯@hžhubjú)”}”(hhh]”hØ)”}”(hŒInitialize markers in sg table”h]”hŒInitialize markers in sg table”…””}”(hjËAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M®hjÈAhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj¯@hžhhŸjÈ@h M®ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjãAjjãAj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒo**Parameters** ``struct scatterlist *sgl`` The SG table ``unsigned int nents`` Number of entries in table”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjíAh]”hŒ Parameters”…””}”(hjïAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjëAubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M²hjçAubjA)”}”(hhh]”(jF)”}”(hŒ)``struct scatterlist *sgl`` The SG table ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjBh]”hŒstruct scatterlist *sgl”…””}”(hjBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj Bubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M¯hjBubjf)”}”(hhh]”hØ)”}”(hŒThe SG table”h]”hŒThe SG table”…””}”(hj%BhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj!Bh M¯hj"Bubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjBubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj!Bh M¯hjBubjF)”}”(hŒ1``unsigned int nents`` Number of entries in table”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hjEBh]”hŒunsigned int nents”…””}”(hjGBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjCBubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M±hj?Bubjf)”}”(hhh]”hØ)”}”(hŒNumber of entries in table”h]”hŒNumber of entries in table”…””}”(hj^BhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h M°hj[Bubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj?Bubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjZBh M±hjBubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjçAubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ&sg_alloc_table_from_pages (C function)”Œc.sg_alloc_table_from_pages”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ˜int sg_alloc_table_from_pages (struct sg_table *sgt, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, gfp_t gfp_mask)”h]”jg)”}”(hŒ—int sg_alloc_table_from_pages(struct sg_table *sgt, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, gfp_t gfp_mask)”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hjŸBhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj›BhžhhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÙubj)”}”(hŒ ”h]”hŒ ”…””}”(hj®BhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj›BhžhhŸjBh MÙubjß)”}”(hŒsg_alloc_table_from_pages”h]”j“)”}”(hŒsg_alloc_table_from_pages”h]”hŒsg_alloc_table_from_pages”…””}”(hjÀBhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¼Bubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj›BhžhhŸjBh MÙubjú)”}”(hŒz(struct sg_table *sgt, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, gfp_t gfp_mask)”h]”(j)”}”(hŒstruct sg_table *sgt”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÜBhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjØBubj)”}”(hŒ ”h]”hŒ ”…””}”(hjéBhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjØBubh)”}”(hhh]”j“)”}”(hŒsg_table”h]”hŒsg_table”…””}”(hjúBhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj÷Bubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jüBŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÂBsbŒc.sg_alloc_table_from_pages”†”asbuh1hhjØBubj)”}”(hŒ ”h]”hŒ ”…””}”(hjChžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjØBubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj(ChžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjØBubj“)”}”(hŒsgt”h]”hŒsgt”…””}”(hj5ChžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjØBubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubj)”}”(hŒstruct page **pages”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjNChžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjJCubj)”}”(hŒ ”h]”hŒ ”…””}”(hj[ChžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjJCubh)”}”(hhh]”j“)”}”(hŒpage”h]”hŒpage”…””}”(hjlChžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjiCubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jnCŒmodname”NŒ classname”Nj°j³)”}”j¶]”jCŒc.sg_alloc_table_from_pages”†”asbuh1hhjJCubj)”}”(hŒ ”h]”hŒ ”…””}”(hjŠChžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjJCubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj˜ChžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjJCubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¥ChžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjJCubj“)”}”(hŒpages”h]”hŒpages”…””}”(hj²ChžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjJCubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubj)”}”(hŒunsigned int n_pages”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjËChžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÇCubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÙChžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÇCubj")”}”(hŒint”h]”hŒint”…””}”(hjçChžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÇCubj)”}”(hŒ ”h]”hŒ ”…””}”(hjõChžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÇCubj“)”}”(hŒn_pages”h]”hŒn_pages”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÇCubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubj)”}”(hŒunsigned int offset”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjDubj)”}”(hŒ ”h]”hŒ ”…””}”(hj*DhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjDubj")”}”(hŒint”h]”hŒint”…””}”(hj8DhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjDubj)”}”(hŒ ”h]”hŒ ”…””}”(hjFDhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjDubj“)”}”(hŒoffset”h]”hŒoffset”…””}”(hjTDhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjDubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubj)”}”(hŒunsigned long size”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjmDhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjiDubj)”}”(hŒ ”h]”hŒ ”…””}”(hj{DhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjiDubj")”}”(hŒlong”h]”hŒlong”…””}”(hj‰DhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjiDubj)”}”(hŒ ”h]”hŒ ”…””}”(hj—DhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjiDubj“)”}”(hŒsize”h]”hŒsize”…””}”(hj¥DhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjiDubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubj)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjÁDhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¾Dubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÃDŒmodname”NŒ classname”Nj°j³)”}”j¶]”jCŒc.sg_alloc_table_from_pages”†”asbuh1hhjºDubj)”}”(hŒ ”h]”hŒ ”…””}”(hjßDhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjºDubj“)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hjíDhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjºDubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÔBubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj›BhžhhŸjBh MÙubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj—BhžhhŸjBh MÙubah}”(h]”j’Bah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjBh MÙhj”Bhžhubjú)”}”(hhh]”hØ)”}”(hŒ:Allocate and initialize an sg table from an array of pages”h]”hŒ:Allocate and initialize an sg table from an array of pages”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÙhjEhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj”BhžhhŸjBh MÙubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj/Ejj/Ej‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX **Parameters** ``struct sg_table *sgt`` The sg table header to use ``struct page **pages`` Pointer to an array of page pointers ``unsigned int n_pages`` Number of pages in the pages array ``unsigned int offset`` Offset from start of the first page to the start of a buffer ``unsigned long size`` Number of valid bytes in the buffer (after offset) ``gfp_t gfp_mask`` GFP allocation mask **Description** Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_table. **Return** 0 on success, negative error on failure”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj9Eh]”hŒ Parameters”…””}”(hj;EhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj7Eubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÝhj3EubjA)”}”(hhh]”(jF)”}”(hŒ4``struct sg_table *sgt`` The sg table header to use ”h]”(jL)”}”(hŒ``struct sg_table *sgt``”h]”jÒ)”}”(hjXEh]”hŒstruct sg_table *sgt”…””}”(hjZEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjVEubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÛhjREubjf)”}”(hhh]”hØ)”}”(hŒThe sg table header to use”h]”hŒThe sg table header to use”…””}”(hjqEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjmEh MÛhjnEubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjREubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjmEh MÛhjOEubjF)”}”(hŒ=``struct page **pages`` Pointer to an array of page pointers ”h]”(jL)”}”(hŒ``struct page **pages``”h]”jÒ)”}”(hj‘Eh]”hŒstruct page **pages”…””}”(hj“EhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjEubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÜhj‹Eubjf)”}”(hhh]”hØ)”}”(hŒ$Pointer to an array of page pointers”h]”hŒ$Pointer to an array of page pointers”…””}”(hjªEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¦Eh MÜhj§Eubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj‹Eubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¦Eh MÜhjOEubjF)”}”(hŒ<``unsigned int n_pages`` Number of pages in the pages array ”h]”(jL)”}”(hŒ``unsigned int n_pages``”h]”jÒ)”}”(hjÊEh]”hŒunsigned int n_pages”…””}”(hjÌEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÈEubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÝhjÄEubjf)”}”(hhh]”hØ)”}”(hŒ"Number of pages in the pages array”h]”hŒ"Number of pages in the pages array”…””}”(hjãEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjßEh MÝhjàEubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÄEubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjßEh MÝhjOEubjF)”}”(hŒU``unsigned int offset`` Offset from start of the first page to the start of a buffer ”h]”(jL)”}”(hŒ``unsigned int offset``”h]”jÒ)”}”(hjFh]”hŒunsigned int offset”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjFubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MÞhjýEubjf)”}”(hhh]”hØ)”}”(hŒFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj:Fubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mßhj6Fubjf)”}”(hhh]”hØ)”}”(hŒ2Number of valid bytes in the buffer (after offset)”h]”hŒ2Number of valid bytes in the buffer (after offset)”…””}”(hjUFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjQFh MßhjRFubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj6Fubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjQFh MßhjOEubjF)”}”(hŒ'``gfp_t gfp_mask`` GFP allocation mask ”h]”(jL)”}”(hŒ``gfp_t gfp_mask``”h]”jÒ)”}”(hjuFh]”hŒgfp_t gfp_mask”…””}”(hjwFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjsFubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MàhjoFubjf)”}”(hhh]”hØ)”}”(hŒGFP allocation mask”h]”hŒGFP allocation mask”…””}”(hjŽFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŠFh Màhj‹Fubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjoFubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŠFh MàhjOEubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj3EubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj°Fh]”hŒDescription”…””}”(hj²FhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj®Fubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mâhj3Eubj`$)”}”(hX$Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_table. ”h]”hØ)”}”(hX#Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_table.”h]”hX#Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_table.”…””}”(hjÊFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MâhjÆFubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjØFh Mâhj3EubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjáFh]”hŒReturn”…””}”(hjãFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjßFubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mèhj3EubhØ)”}”(hŒ'0 on success, negative error on failure”h]”hŒ'0 on success, negative error on failure”…””}”(hj÷FhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Méhj3Eubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_page_iter_page (C function)”Œc.sg_page_iter_page”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ``piter`` page iterator to hold current page, sg, sg_pgoffset ”h]”(jL)”}”(hŒ ``piter``”h]”jÒ)”}”(hjíJh]”hŒpiter”…””}”(hjïJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjëJubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h MmhjçJubjf)”}”(hhh]”hØ)”}”(hŒ3page iterator to hold current page, sg, sg_pgoffset”h]”hŒ3page iterator to hold current page, sg, sg_pgoffset”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjKh MmhjKubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjçJubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjKh Mmhj«JubjF)”}”(hŒ7``nents`` maximum number of sg entries to iterate over ”h]”(jL)”}”(hŒ ``nents``”h]”jÒ)”}”(hj&Kh]”hŒnents”…””}”(hj(KhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj$Kubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒ]/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:867: ./include/linux/scatterlist.h”h Mnhj Kubjf)”}”(hhh]”hØ)”}”(hŒ,maximum number of sg entries to iterate over”h]”hŒ,maximum number of sg entries to iterate over”…””}”(hj?KhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj;Kh Mnhj(struct scatterlist *sg, const void *buf, unsigned int buflen)”h]”(j)”}”(hŒstruct scatterlist *sg”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjYubj)”}”(hŒ ”h]”hŒ ”…””}”(hj+YhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjYubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjYŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jYsbŒ c.sg_init_one”†”asbuh1hhjYubj)”}”(hŒ ”h]”hŒ ”…””}”(hj\YhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjYubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjjYhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjYubj“)”}”(hŒsg”h]”hŒsg”…””}”(hjwYhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjYubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjYubj)”}”(hŒconst void *buf”h]”(jm)”}”(hjh]”hŒconst”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjŒYubj)”}”(hŒ ”h]”hŒ ”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŒYubj")”}”(hŒvoid”h]”hŒvoid”…””}”(hj«YhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjŒYubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¹YhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŒYubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÇYhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjŒYubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hjÔYhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŒYubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjYubj)”}”(hŒunsigned int buflen”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjíYhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjéYubj)”}”(hŒ ”h]”hŒ ”…””}”(hjûYhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjéYubj")”}”(hŒint”h]”hŒint”…””}”(hj ZhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjéYubj)”}”(hŒ ”h]”hŒ ”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjéYubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hj%ZhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjéYubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjYubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÝXhžhhŸjïXh Kpubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÙXhžhhŸjïXh Kpubah}”(h]”jÔXah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjïXh KphjÖXhžhubjú)”}”(hhh]”hØ)”}”(hŒ!Initialize a single entry sg list”h]”hŒ!Initialize a single entry sg list”…””}”(hjOZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KphjLZhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÖXhžhhŸjïXh Kpubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjgZjjgZj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒˆ**Parameters** ``struct scatterlist *sg`` SG entry ``const void *buf`` Virtual address for IO ``unsigned int buflen`` IO length”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjqZh]”hŒ Parameters”…””}”(hjsZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjoZubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KthjkZubjA)”}”(hhh]”(jF)”}”(hŒ$``struct scatterlist *sg`` SG entry ”h]”(jL)”}”(hŒ``struct scatterlist *sg``”h]”jÒ)”}”(hjZh]”hŒstruct scatterlist *sg”…””}”(hj’ZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjŽZubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KqhjŠZubjf)”}”(hhh]”hØ)”}”(hŒSG entry”h]”hŒSG entry”…””}”(hj©ZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¥Zh Kqhj¦Zubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjŠZubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¥Zh Kqhj‡ZubjF)”}”(hŒ+``const void *buf`` Virtual address for IO ”h]”(jL)”}”(hŒ``const void *buf``”h]”jÒ)”}”(hjÉZh]”hŒconst void *buf”…””}”(hjËZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÇZubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KrhjÃZubjf)”}”(hhh]”hØ)”}”(hŒVirtual address for IO”h]”hŒVirtual address for IO”…””}”(hjâZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÞZh KrhjßZubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÃZubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÞZh Krhj‡ZubjF)”}”(hŒ!``unsigned int buflen`` IO length”h]”(jL)”}”(hŒ``unsigned int buflen``”h]”jÒ)”}”(hj[h]”hŒunsigned int buflen”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KthjüZubjf)”}”(hhh]”hØ)”}”(hŒ IO length”h]”hŒ IO length”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kshj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjüZubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj[h Kthj‡Zubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjkZubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ__sg_free_table (C function)”Œc.__sg_free_table”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒvoid __sg_free_table (struct sg_table *table, unsigned int max_ents, unsigned int nents_first_chunk, sg_free_fn *free_fn, unsigned int num_ents)”h]”jg)”}”(hŒvoid __sg_free_table(struct sg_table *table, unsigned int max_ents, unsigned int nents_first_chunk, sg_free_fn *free_fn, unsigned int num_ents)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj\[hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjX[hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KŸubj)”}”(hŒ ”h]”hŒ ”…””}”(hjk[hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjX[hžhhŸjj[h KŸubjß)”}”(hŒ__sg_free_table”h]”j“)”}”(hŒ__sg_free_table”h]”hŒ__sg_free_table”…””}”(hj}[hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjy[ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjX[hžhhŸjj[h KŸubjú)”}”(hŒ{(struct sg_table *table, unsigned int max_ents, unsigned int nents_first_chunk, sg_free_fn *free_fn, unsigned int num_ents)”h]”(j)”}”(hŒstruct sg_table *table”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj™[hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj•[ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¦[hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj•[ubh)”}”(hhh]”j“)”}”(hŒsg_table”h]”hŒsg_table”…””}”(hj·[hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj´[ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¹[Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j[sbŒc.__sg_free_table”†”asbuh1hhj•[ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj×[hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj•[ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjå[hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj•[ubj“)”}”(hŒtable”h]”hŒtable”…””}”(hjò[hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj•[ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‘[ubj)”}”(hŒunsigned int max_ents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj\ubj")”}”(hŒint”h]”hŒint”…””}”(hj'\hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj5\hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj\ubj“)”}”(hŒmax_ents”h]”hŒmax_ents”…””}”(hjC\hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj\ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‘[ubj)”}”(hŒunsigned int nents_first_chunk”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj\\hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjX\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjj\hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjX\ubj")”}”(hŒint”h]”hŒint”…””}”(hjx\hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjX\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj†\hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjX\ubj“)”}”(hŒnents_first_chunk”h]”hŒnents_first_chunk”…””}”(hj”\hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjX\ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‘[ubj)”}”(hŒsg_free_fn *free_fn”h]”(h)”}”(hhh]”j“)”}”(hŒ sg_free_fn”h]”hŒ sg_free_fn”…””}”(hj°\hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj\ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j²\Œmodname”NŒ classname”Nj°j³)”}”j¶]”jÓ[Œc.__sg_free_table”†”asbuh1hhj©\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÎ\hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj©\ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÜ\hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj©\ubj“)”}”(hŒfree_fn”h]”hŒfree_fn”…””}”(hjé\hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj©\ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‘[ubj)”}”(hŒunsigned int num_ents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjþ\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjþ\ubj")”}”(hŒint”h]”hŒint”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjþ\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj,]hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjþ\ubj“)”}”(hŒnum_ents”h]”hŒnum_ents”…””}”(hj:]hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjþ\ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‘[ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjX[hžhhŸjj[h KŸubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjT[hžhhŸjj[h KŸubah}”(h]”jO[ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjj[h KŸhjQ[hžhubjú)”}”(hhh]”hØ)”}”(hŒ!Free a previously mapped sg table”h]”hŒ!Free a previously mapped sg table”…””}”(hjd]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KŸhja]hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjQ[hžhhŸjj[h KŸubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj|]jj|]j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXP**Parameters** ``struct sg_table *table`` The sg table header to use ``unsigned int max_ents`` The maximum number of entries per single scatterlist ``unsigned int nents_first_chunk`` Number of entries int the (preallocated) first scatterlist chunk, 0 means no such preallocated first chunk ``sg_free_fn *free_fn`` Free function ``unsigned int num_ents`` Number of entries in the table **Description** Free an sg table previously allocated and setup with __sg_alloc_table(). The **max_ents** value must be identical to that previously used with __sg_alloc_table().”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj†]h]”hŒ Parameters”…””}”(hjˆ]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj„]ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K£hj€]ubjA)”}”(hhh]”(jF)”}”(hŒ6``struct sg_table *table`` The sg table header to use ”h]”(jL)”}”(hŒ``struct sg_table *table``”h]”jÒ)”}”(hj¥]h]”hŒstruct sg_table *table”…””}”(hj§]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj£]ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K hjŸ]ubjf)”}”(hhh]”hØ)”}”(hŒThe sg table header to use”h]”hŒThe sg table header to use”…””}”(hj¾]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjº]h K hj»]ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjŸ]ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjº]h K hjœ]ubjF)”}”(hŒO``unsigned int max_ents`` The maximum number of entries per single scatterlist ”h]”(jL)”}”(hŒ``unsigned int max_ents``”•@h]”jÒ)”}”(hjÞ]h]”hŒunsigned int max_ents”…””}”(hjà]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÜ]ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K¡hjØ]ubjf)”}”(hhh]”hØ)”}”(hŒ4The maximum number of entries per single scatterlist”h]”hŒ4The maximum number of entries per single scatterlist”…””}”(hj÷]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjó]h K¡hjô]ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjØ]ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjó]h K¡hjœ]ubjF)”}”(hŒŽ``unsigned int nents_first_chunk`` Number of entries int the (preallocated) first scatterlist chunk, 0 means no such preallocated first chunk ”h]”(jL)”}”(hŒ"``unsigned int nents_first_chunk``”h]”jÒ)”}”(hj^h]”hŒunsigned int nents_first_chunk”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K£hj^ubjf)”}”(hhh]”hØ)”}”(hŒjNumber of entries int the (preallocated) first scatterlist chunk, 0 means no such preallocated first chunk”h]”hŒjNumber of entries int the (preallocated) first scatterlist chunk, 0 means no such preallocated first chunk”…””}”(hj0^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K¢hj-^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj,^h K£hjœ]ubjF)”}”(hŒ&``sg_free_fn *free_fn`` Free function ”h]”(jL)”}”(hŒ``sg_free_fn *free_fn``”h]”jÒ)”}”(hjQ^h]”hŒsg_free_fn *free_fn”…””}”(hjS^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjO^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K¤hjK^ubjf)”}”(hhh]”hØ)”}”(hŒ Free function”h]”hŒ Free function”…””}”(hjj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjf^h K¤hjg^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjK^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjf^h K¤hjœ]ubjF)”}”(hŒ9``unsigned int num_ents`` Number of entries in the table ”h]”(jL)”}”(hŒ``unsigned int num_ents``”h]”jÒ)”}”(hjŠ^h]”hŒunsigned int num_ents”…””}”(hjŒ^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjˆ^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K¥hj„^ubjf)”}”(hhh]”hØ)”}”(hŒNumber of entries in the table”h]”hŒNumber of entries in the table”…””}”(hj£^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŸ^h K¥hj ^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj„^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŸ^h K¥hjœ]ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj€]ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÅ^h]”hŒDescription”…””}”(hjÇ^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÃ^ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K§hj€]ubj`$)”}”(hŒ£Free an sg table previously allocated and setup with __sg_alloc_table(). The **max_ents** value must be identical to that previously used with __sg_alloc_table().”h]”hØ)”}”(hŒ£Free an sg table previously allocated and setup with __sg_alloc_table(). The **max_ents** value must be identical to that previously used with __sg_alloc_table().”h]”(hŒNFree an sg table previously allocated and setup with __sg_alloc_table(). The ”…””}”(hjß^hžhhŸNh Nubj+)”}”(hŒ**max_ents**”h]”hŒmax_ents”…””}”(hjç^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjß^ubhŒI value must be identical to that previously used with __sg_alloc_table().”…””}”(hjß^hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h K§hjÛ^ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjÿ^h K§hj€]ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ!sg_free_append_table (C function)”Œc.sg_free_append_table”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ9void sg_free_append_table (struct sg_append_table *table)”h]”jg)”}”(hŒ8void sg_free_append_table(struct sg_append_table *table)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj&_hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj"_hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KÙubj)”}”(hŒ ”h]”hŒ ”…””}”(hj5_hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj"_hžhhŸj4_h KÙubjß)”}”(hŒsg_free_append_table”h]”j“)”}”(hŒsg_free_append_table”h]”hŒsg_free_append_table”…””}”(hjG_hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjC_ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj"_hžhhŸj4_h KÙubjú)”}”(hŒ(struct sg_append_table *table)”h]”j)”}”(hŒstruct sg_append_table *table”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjc_hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj__ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjp_hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj__ubh)”}”(hhh]”j“)”}”(hŒsg_append_table”h]”hŒsg_append_table”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj~_ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jƒ_Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jI_sbŒc.sg_free_append_table”†”asbuh1hhj__ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¡_hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj__ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¯_hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj__ubj“)”}”(hŒtable”h]”hŒtable”…””}”(hj¼_hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj__ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj[_ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj"_hžhhŸj4_h KÙubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj_hžhhŸj4_h KÙubah}”(h]”j_ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj4_h KÙhj_hžhubjú)”}”(hhh]”hØ)”}”(hŒ,Free a previously allocated append sg table.”h]”hŒ,Free a previously allocated append sg table.”…””}”(hjæ_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KÙhjã_hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj_hžhhŸj4_h KÙubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjþ_jjþ_j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒU**Parameters** ``struct sg_append_table *table`` The mapped sg append table header”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj`h]”hŒ Parameters”…””}”(hj `hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj`ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KÝhj`ubjA)”}”(hhh]”jF)”}”(hŒC``struct sg_append_table *table`` The mapped sg append table header”h]”(jL)”}”(hŒ!``struct sg_append_table *table``”h]”jÒ)”}”(hj'`h]”hŒstruct sg_append_table *table”…””}”(hj)`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj%`ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kßhj!`ubjf)”}”(hhh]”hØ)”}”(hŒ!The mapped sg append table header”h]”hŒ!The mapped sg append table header”…””}”(hj@`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KÚhj=`ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj!`ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj<`h Kßhj`ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj`ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_free_table (C function)”Œc.sg_free_table”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ+void sg_free_table (struct sg_table *table)”h]”jg)”}”(hŒ*void sg_free_table(struct sg_table *table)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj}`hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kæubj)”}”(hŒ ”h]”hŒ ”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj}`hžhhŸj`h Kæubjß)”}”(hŒ sg_free_table”h]”j“)”}”(hŒ sg_free_table”h]”hŒ sg_free_table”…””}”(hj¢`hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjž`ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj}`hžhhŸj`h Kæubjú)”}”(hŒ(struct sg_table *table)”h]”j)”}”(hŒstruct sg_table *table”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj¾`hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjº`ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjË`hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjº`ubh)”}”(hhh]”j“)”}”(hŒsg_table”h]”hŒsg_table”…””}”(hjÜ`hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÙ`ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÞ`Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j¤`sbŒc.sg_free_table”†”asbuh1hhjº`ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjü`hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjº`ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj ahžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjº`ubj“)”}”(hŒtable”h]”hŒtable”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjº`ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¶`ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj}`hžhhŸj`h Kæubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjy`hžhhŸj`h Kæubah}”(h]”jt`ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj`h Kæhjv`hžhubjú)”}”(hhh]”hØ)”}”(hŒ$Free a previously allocated sg table”h]”hŒ$Free a previously allocated sg table”…””}”(hjAahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kæhj>ahžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjv`hžhhŸj`h Kæubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjYajjYaj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒG**Parameters** ``struct sg_table *table`` The mapped sg table header”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjcah]”hŒ Parameters”…””}”(hjeahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjaaubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kêhj]aubjA)”}”(hhh]”jF)”}”(hŒ5``struct sg_table *table`` The mapped sg table header”h]”(jL)”}”(hŒ``struct sg_table *table``”h]”jÒ)”}”(hj‚ah]”hŒstruct sg_table *table”…””}”(hj„ahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj€aubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kìhj|aubjf)”}”(hhh]”hØ)”}”(hŒThe mapped sg table header”h]”hŒThe mapped sg table header”…””}”(hj›ahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kçhj˜aubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj|aubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj—ah Kìhjyaubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj]aubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ__sg_alloc_table (C function)”Œc.__sg_alloc_table”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒÀint __sg_alloc_table (struct sg_table *table, unsigned int nents, unsigned int max_ents, struct scatterlist *first_chunk, unsigned int nents_first_chunk, gfp_t gfp_mask, sg_alloc_fn *alloc_fn)”h]”jg)”}”(hŒ¿int __sg_alloc_table(struct sg_table *table, unsigned int nents, unsigned int max_ents, struct scatterlist *first_chunk, unsigned int nents_first_chunk, gfp_t gfp_mask, sg_alloc_fn *alloc_fn)”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hjÜahžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjØahžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kòubj)”}”(hŒ ”h]”hŒ ”…””}”(hjëahžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjØahžhhŸjêah Kòubjß)”}”(hŒ__sg_alloc_table”h]”j“)”}”(hŒ__sg_alloc_table”h]”hŒ__sg_alloc_table”…””}”(hjýahžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjùaubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjØahžhhŸjêah Kòubjú)”}”(hŒ«(struct sg_table *table, unsigned int nents, unsigned int max_ents, struct scatterlist *first_chunk, unsigned int nents_first_chunk, gfp_t gfp_mask, sg_alloc_fn *alloc_fn)”h]”(j)”}”(hŒstruct sg_table *table”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjbhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjbubj)”}”(hŒ ”h]”hŒ ”…””}”(hj&bhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbubh)”}”(hhh]”j“)”}”(hŒsg_table”h]”hŒsg_table”…””}”(hj7bhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj4bubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j9bŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÿasbŒc.__sg_alloc_table”†”asbuh1hhjbubj)”}”(hŒ ”h]”hŒ ”…””}”(hjWbhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjebhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjbubj“)”}”(hŒtable”h]”hŒtable”…””}”(hjrbhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjbubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj‹bhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj‡bubj)”}”(hŒ ”h]”hŒ ”…””}”(hj™bhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‡bubj")”}”(hŒint”h]”hŒint”…””}”(hj§bhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj‡bubj)”}”(hŒ ”h]”hŒ ”…””}”(hjµbhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‡bubj“)”}”(hŒnents”h]”hŒnents”…””}”(hjÃbhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‡bubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒunsigned int max_ents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÜbhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjØbubj)”}”(hŒ ”h]”hŒ ”…””}”(hjêbhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjØbubj")”}”(hŒint”h]”hŒint”…””}”(hjøbhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjØbubj)”}”(hŒ ”h]”hŒ ”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjØbubj“)”}”(hŒmax_ents”h]”hŒmax_ents”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjØbubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒstruct scatterlist *first_chunk”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj-chžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj)cubj)”}”(hŒ ”h]”hŒ ”…””}”(hj:chžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj)cubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjKchžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjHcubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jMcŒmodname”NŒ classname”Nj°j³)”}”j¶]”jSbŒc.__sg_alloc_table”†”asbuh1hhj)cubj)”}”(hŒ ”h]”hŒ ”…””}”(hjichžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj)cubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjwchžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj)cubj“)”}”(hŒfirst_chunk”h]”hŒfirst_chunk”…””}”(hj„chžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj)cubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒunsigned int nents_first_chunk”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj™cubj)”}”(hŒ ”h]”hŒ ”…””}”(hj«chžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj™cubj")”}”(hŒint”h]”hŒint”…””}”(hj¹chžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj™cubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÇchžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj™cubj“)”}”(hŒnents_first_chunk”h]”hŒnents_first_chunk”…””}”(hjÕchžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj™cubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjñchžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjîcubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jócŒmodname”NŒ classname”Nj°j³)”}”j¶]”jSbŒc.__sg_alloc_table”†”asbuh1hhjêcubj)”}”(hŒ ”h]”hŒ ”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjêcubj“)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjêcubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubj)”}”(hŒsg_alloc_fn *alloc_fn”h]”(h)”}”(hhh]”j“)”}”(hŒsg_alloc_fn”h]”hŒsg_alloc_fn”…””}”(hj9dhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj6dubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j;dŒmodname”NŒ classname”Nj°j³)”}”j¶]”jSbŒc.__sg_alloc_table”†”asbuh1hhj2dubj)”}”(hŒ ”h]”hŒ ”…””}”(hjWdhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj2dubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjedhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj2dubj“)”}”(hŒalloc_fn”h]”hŒalloc_fn”…””}”(hjrdhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj2dubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjbubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjØahžhhŸjêah Kòubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÔahžhhŸjêah Kòubah}”(h]”jÏaah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjêah KòhjÑahžhubjú)”}”(hhh]”hØ)”}”(hŒ8Allocate and initialize an sg table with given allocator”h]”hŒ8Allocate and initialize an sg table with given allocator”…””}”(hjœdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kòhj™dhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÑahžhhŸjêah Kòubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj´djj´dj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX³**Parameters** ``struct sg_table *table`` The sg table header to use ``unsigned int nents`` Number of entries in sg list ``unsigned int max_ents`` The maximum number of entries the allocator returns per call ``struct scatterlist *first_chunk`` first SGL if preallocated (may be ``NULL``) ``unsigned int nents_first_chunk`` Number of entries in the (preallocated) first scatterlist chunk, 0 means no such preallocated chunk provided by user ``gfp_t gfp_mask`` GFP allocation mask ``sg_alloc_fn *alloc_fn`` Allocator to use **Description** This function returns a **table** **nents** long. The allocator is defined to return scatterlist chunks of maximum size **max_ents**. Thus if **nents** is bigger than **max_ents**, the scatterlists will be chained in units of **max_ents**. **Notes** If this function returns non-0 (eg failure), the caller must call __sg_free_table() to cleanup any leftover allocations.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj¾dh]”hŒ Parameters”…””}”(hjÀdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¼dubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Köhj¸dubjA)”}”(hhh]”(jF)”}”(hŒ6``struct sg_table *table`` The sg table header to use ”h]”(jL)”}”(hŒ``struct sg_table *table``”h]”jÒ)”}”(hjÝdh]”hŒstruct sg_table *table”…””}”(hjßdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÛdubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kóhj×dubjf)”}”(hhh]”hØ)”}”(hŒThe sg table header to use”h]”hŒThe sg table header to use”…””}”(hjödhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjòdh Kóhjódubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj×dubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjòdh KóhjÔdubjF)”}”(hŒ4``unsigned int nents`` Number of entries in sg list ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hjeh]”hŒunsigned int nents”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjeubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Kôhjeubjf)”}”(hhh]”hØ)”}”(hŒNumber of entries in sg list”h]”hŒNumber of entries in sg list”…””}”(hj/ehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj+eh Kôhj,eubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjeubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj+eh KôhjÔdubjF)”}”(hŒW``unsigned int max_ents`` The maximum number of entries the allocator returns per call ”h]”(jL)”}”(hŒ``unsigned int max_ents``”h]”jÒ)”}”(hjOeh]”hŒunsigned int max_ents”…””}”(hjQehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjMeubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h KõhjIeubjf)”}”(hhh]”hØ)”}”(hŒiubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MXhj:iubjf)”}”(hhh]”hØ)”}”(hŒNumber of entries in sg list”h]”hŒNumber of entries in sg list”…””}”(hjYihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjUih MXhjViubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj:iubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjUih MXhjþhubjF)”}”(hŒ'``gfp_t gfp_mask`` GFP allocation mask ”h]”(jL)”}”(hŒ``gfp_t gfp_mask``”h]”jÒ)”}”(hjyih]”hŒgfp_t gfp_mask”…””}”(hj{ihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjwiubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MYhjsiubjf)”}”(hhh]”hØ)”}”(hŒGFP allocation mask”h]”hŒGFP allocation mask”…””}”(hj’ihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŽih MYhjiubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjsiubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŽih MYhjþhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjâhubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj´ih]”hŒDescription”…””}”(hj¶ihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj²iubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M[hjâhubj`$)”}”(hŒvAllocate and initialize an sg table. If **nents** is larger than SG_MAX_SINGLE_ALLOC a chained sg table will be setup.”h]”hØ)”}”(hŒvAllocate and initialize an sg table. If **nents** is larger than SG_MAX_SINGLE_ALLOC a chained sg table will be setup.”h]”(hŒ(Allocate and initialize an sg table. If ”…””}”(hjÎihžhhŸNh Nubj+)”}”(hŒ **nents**”h]”hŒnents”…””}”(hjÖihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÎiubhŒE is larger than SG_MAX_SINGLE_ALLOC a chained sg table will be setup.”…””}”(hjÎihžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M[hjÊiubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjîih M[hjâhubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ-sg_alloc_append_table_from_pages (C function)”Œ"c.sg_alloc_append_table_from_pages”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒàint sg_alloc_append_table_from_pages (struct sg_append_table *sgt_append, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, unsigned int max_segment, unsigned int left_pages, gfp_t gfp_mask)”h]”jg)”}”(hŒßint sg_alloc_append_table_from_pages(struct sg_append_table *sgt_append, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, unsigned int max_segment, unsigned int left_pages, gfp_t gfp_mask)”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjjhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M”ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj$jhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjjhžhhŸj#jh M”ubjß)”}”(hŒ sg_alloc_append_table_from_pages”h]”j“)”}”(hŒ sg_alloc_append_table_from_pages”h]”hŒ sg_alloc_append_table_from_pages”…””}”(hj6jhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj2jubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjjhžhhŸj#jh M”ubjú)”}”(hŒ»(struct sg_append_table *sgt_append, struct page **pages, unsigned int n_pages, unsigned int offset, unsigned long size, unsigned int max_segment, unsigned int left_pages, gfp_t gfp_mask)”h]”(j)”}”(hŒ"struct sg_append_table *sgt_append”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjRjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjNjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj_jhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjNjubh)”}”(hhh]”j“)”}”(hŒsg_append_table”h]”hŒsg_append_table”…””}”(hjpjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjmjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jrjŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j8jsbŒ"c.sg_alloc_append_table_from_pages”†”asbuh1hhjNjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjNjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjžjhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjNjubj“)”}”(hŒ sgt_append”h]”hŒ sgt_append”…””}”(hj«jhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjNjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒstruct page **pages”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÄjhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÀjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÑjhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÀjubh)”}”(hhh]”j“)”}”(hŒpage”h]”hŒpage”…””}”(hjâjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjßjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jäjŒmodname”NŒ classname”Nj°j³)”}”j¶]”jŒjŒ"c.sg_alloc_append_table_from_pages”†”asbuh1hhjÀjubj)”}”(hŒ ”h]”hŒ ”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÀjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÀjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÀjubj“)”}”(hŒpages”h]”hŒpages”…””}”(hj(khžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÀjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒunsigned int n_pages”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjAkhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj=kubj)”}”(hŒ ”h]”hŒ ”…””}”(hjOkhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj=kubj")”}”(hŒint”h]”hŒint”…””}”(hj]khžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj=kubj)”}”(hŒ ”h]”hŒ ”…””}”(hjkkhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj=kubj“)”}”(hŒn_pages”h]”hŒn_pages”…””}”(hjykhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj=kubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒunsigned int offset”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj’khžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjŽkubj)”}”(hŒ ”h]”hŒ ”…””}”(hj khžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŽkubj")”}”(hŒint”h]”hŒint”…””}”(hj®khžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjŽkubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¼khžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŽkubj“)”}”(hŒoffset”h]”hŒoffset”…””}”(hjÊkhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŽkubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒunsigned long size”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjãkhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjßkubj)”}”(hŒ ”h]”hŒ ”…””}”(hjñkhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjßkubj")”}”(hŒlong”h]”hŒlong”…””}”(hjÿkhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjßkubj)”}”(hŒ ”h]”hŒ ”…””}”(hj lhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjßkubj“)”}”(hŒsize”h]”hŒsize”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjßkubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒunsigned int max_segment”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj4lhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj0lubj)”}”(hŒ ”h]”hŒ ”…””}”(hjBlhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0lubj")”}”(hŒint”h]”hŒint”…””}”(hjPlhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj0lubj)”}”(hŒ ”h]”hŒ ”…””}”(hj^lhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0lubj“)”}”(hŒmax_segment”h]”hŒmax_segment”…””}”(hjllhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj0lubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒunsigned int left_pages”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj…lhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjlubj)”}”(hŒ ”h]”hŒ ”…””}”(hj“lhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjlubj")”}”(hŒint”h]”hŒint”…””}”(hj¡lhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjlubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¯lhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjlubj“)”}”(hŒ left_pages”h]”hŒ left_pages”…””}”(hj½lhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjlubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubj)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjÙlhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÖlubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÛlŒmodname”NŒ classname”Nj°j³)”}”j¶]”jŒjŒ"c.sg_alloc_append_table_from_pages”†”asbuh1hhjÒlubj)”}”(hŒ ”h]”hŒ ”…””}”(hj÷lhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒlubj“)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒlubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjJjubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjjhžhhŸj#jh M”ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj jhžhhŸj#jh M”ubah}”(h]”jjah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj#jh M”hj jhžhubjú)”}”(hhh]”hØ)”}”(hŒAAllocate and initialize an append sg table from an array of pages”h]”hŒAAllocate and initialize an append sg table from an array of pages”…””}”(hj/mhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M”hj,mhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj jhžhhŸj#jh M”ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjGmjjGmj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXú**Parameters** ``struct sg_append_table *sgt_append`` The sg append table to use ``struct page **pages`` Pointer to an array of page pointers ``unsigned int n_pages`` Number of pages in the pages array ``unsigned int offset`` Offset from start of the first page to the start of a buffer ``unsigned long size`` Number of valid bytes in the buffer (after offset) ``unsigned int max_segment`` Maximum size of a scatterlist element in bytes ``unsigned int left_pages`` Left pages caller have to set after this call ``gfp_t gfp_mask`` GFP allocation mask **Description** In the first call it allocate and initialize an sg table from a list of pages, else reuse the scatterlist from sgt_append. Contiguous ranges of the pages are squashed into a single scatterlist entry up to the maximum size specified in **max_segment**. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_append_table **Return** 0 on success, negative error on failure **Notes** If this function returns non-0 (eg failure), the caller must call sg_free_append_table() to cleanup any leftover allocations. In the fist call, sgt_append must by initialized.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjQmh]”hŒ Parameters”…””}”(hjSmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjOmubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M˜hjKmubjA)”}”(hhh]”(jF)”}”(hŒB``struct sg_append_table *sgt_append`` The sg append table to use ”h]”(jL)”}”(hŒ&``struct sg_append_table *sgt_append``”h]”jÒ)”}”(hjpmh]”hŒ"struct sg_append_table *sgt_append”…””}”(hjrmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjnmubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M–hjjmubjf)”}”(hhh]”hØ)”}”(hŒThe sg append table to use”h]”hŒThe sg append table to use”…””}”(hj‰mhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj…mh M–hj†mubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjjmubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj…mh M–hjgmubjF)”}”(hŒ=``struct page **pages`` Pointer to an array of page pointers ”h]”(jL)”}”(hŒ``struct page **pages``”h]”jÒ)”}”(hj©mh]”hŒstruct page **pages”…””}”(hj«mhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj§mubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M—hj£mubjf)”}”(hhh]”hØ)”}”(hŒ$Pointer to an array of page pointers”h]”hŒ$Pointer to an array of page pointers”…””}”(hjÂmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¾mh M—hj¿mubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj£mubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¾mh M—hjgmubjF)”}”(hŒ<``unsigned int n_pages`` Number of pages in the pages array ”h]”(jL)”}”(hŒ``unsigned int n_pages``”h]”jÒ)”}”(hjâmh]”hŒunsigned int n_pages”…””}”(hjämhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjàmubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M˜hjÜmubjf)”}”(hhh]”hØ)”}”(hŒ"Number of pages in the pages array”h]”hŒ"Number of pages in the pages array”…””}”(hjûmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj÷mh M˜hjømubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÜmubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj÷mh M˜hjgmubjF)”}”(hŒU``unsigned int offset`` Offset from start of the first page to the start of a buffer ”h]”(jL)”}”(hŒ``unsigned int offset``”h]”jÒ)”}”(hjnh]”hŒunsigned int offset”…””}”(hjnhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjnubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M™hjnubjf)”}”(hhh]”hØ)”}”(hŒth Mhj?tubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj#tubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj>th MhjsubjF)”}”(hŒ'``gfp_t gfp_mask`` GFP allocation mask ”h]”(jL)”}”(hŒ``gfp_t gfp_mask``”h]”jÒ)”}”(hjbth]”hŒgfp_t gfp_mask”…””}”(hjdthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj`tubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj\tubjf)”}”(hhh]”hØ)”}”(hŒGFP allocation mask”h]”hŒGFP allocation mask”…””}”(hj{thžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjwth Mhjxtubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj\tubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjwth Mhjsubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjçrubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjth]”hŒDescription”…””}”(hjŸthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj›tubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M!hjçrubj`$)”}”(hXYAllocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node up to the maximum size specified in **max_segment**. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array. The returned sg table is released by sg_free_table. ”h]”(hØ)”}”(hX#Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node up to the maximum size specified in **max_segment**. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array.”h]”(hŒ©Allocate and initialize an sg table from a list of pages. Contiguous ranges of the pages are squashed into a single scatterlist node up to the maximum size specified in ”…””}”(hj·thžhhŸNh Nubj+)”}”(hŒ**max_segment**”h]”hŒmax_segment”…””}”(hj¿thžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj·tubhŒk. A user may provide an offset at a start and a size of valid data in a buffer specified by the page array.”…””}”(hj·thžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M!hj³tubhØ)”}”(hŒ3The returned sg table is released by sg_free_table.”h]”hŒ3The returned sg table is released by sg_free_table.”…””}”(hjØthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M&hj³tubeh}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj×th M!hjçrubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjïth]”hŒReturn”…””}”(hjñthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjítubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M(hjçrubhØ)”}”(hŒ'0 on success, negative error on failure”h]”hŒ'0 on success, negative error on failure”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M)hjçrubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsgl_alloc_order (C function)”Œc.sgl_alloc_order”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ…struct scatterlist * sgl_alloc_order (unsigned long long length, unsigned int order, bool chainable, gfp_t gfp, unsigned int *nent_p)”h]”jg)”}”(hŒƒstruct scatterlist *sgl_alloc_order(unsigned long long length, unsigned int order, bool chainable, gfp_t gfp, unsigned int *nent_p)”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj4uhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj0uhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MCubj)”}”(hŒ ”h]”hŒ ”…””}”(hjBuhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0uhžhhŸjAuh MCubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjSuhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjPuubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jUuŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsgl_alloc_order”sbŒc.sgl_alloc_order”†”asbuh1hhj0uhžhhŸjAuh MCubj)”}”(hŒ ”h]”hŒ ”…””}”(hjtuhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj0uhžhhŸjAuh MCubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj‚uhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj0uhžhhŸjAuh MCubjß)”}”(hŒsgl_alloc_order”h]”j“)”}”(hjquh]”hŒsgl_alloc_order”…””}”(hj“uhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjuubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj0uhžhhŸjAuh MCubjú)”}”(hŒ`(unsigned long long length, unsigned int order, bool chainable, gfp_t gfp, unsigned int *nent_p)”h]”(j)”}”(hŒunsigned long long length”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj®uhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjªuubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¼uhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjªuubj")”}”(hŒlong”h]”hŒlong”…””}”(hjÊuhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjªuubj)”}”(hŒ ”h]”hŒ ”…””}”(hjØuhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjªuubj")”}”(hŒlong”h]”hŒlong”…””}”(hjæuhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjªuubj)”}”(hŒ ”h]”hŒ ”…””}”(hjôuhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjªuubj“)”}”(hŒlength”h]”hŒlength”…””}”(hjvhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjªuubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¦uubj)”}”(hŒunsigned int order”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjvhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjvubj)”}”(hŒ ”h]”hŒ ”…””}”(hj)vhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjvubj")”}”(hŒint”h]”hŒint”…””}”(hj7vhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjvubj)”}”(hŒ ”h]”hŒ ”…””}”(hjEvhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjvubj“)”}”(hŒorder”h]”hŒorder”…””}”(hjSvhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjvubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¦uubj)”}”(hŒbool chainable”h]”(j")”}”(hjÑ5h]”hŒbool”…””}”(hjlvhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjhvubj)”}”(hŒ ”h]”hŒ ”…””}”(hjyvhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjhvubj“)”}”(hŒ chainable”h]”hŒ chainable”…””}”(hj‡vhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjhvubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¦uubj)”}”(hŒ gfp_t gfp”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hj£vhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj vubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¥vŒmodname”NŒ classname”Nj°j³)”}”j¶]”jouŒc.sgl_alloc_order”†”asbuh1hhjœvubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÁvhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjœvubj“)”}”(hŒgfp”h]”hŒgfp”…””}”(hjÏvhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjœvubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¦uubj)”}”(hŒunsigned int *nent_p”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjèvhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjävubj)”}”(hŒ ”h]”hŒ ”…””}”(hjövhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjävubj")”}”(hŒint”h]”hŒint”…””}”(hjwhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjävubj)”}”(hŒ ”h]”hŒ ”…””}”(hjwhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjävubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj whžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjävubj“)”}”(hŒnent_p”h]”hŒnent_p”…””}”(hj-whžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjävubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¦uubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj0uhžhhŸjAuh MCubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj,uhžhhŸjAuh MCubah}”(h]”j'uah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjAuh MChj)uhžhubjú)”}”(hhh]”hØ)”}”(hŒ$allocate a scatterlist and its pages”h]”hŒ$allocate a scatterlist and its pages”…””}”(hjWwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MChjTwhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj)uhžhhŸjAuh MCubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjowjjowj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXì**Parameters** ``unsigned long long length`` Length in bytes of the scatterlist. Must be at least one ``unsigned int order`` Second argument for alloc_pages() ``bool chainable`` Whether or not to allocate an extra element in the scatterlist for scatterlist chaining purposes ``gfp_t gfp`` Memory allocation flags ``unsigned int *nent_p`` [out] Number of entries in the scatterlist that have pages **Return** A pointer to an initialized scatterlist or ``NULL`` upon failure.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjywh]”hŒ Parameters”…””}”(hj{whžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjwwubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MGhjswubjA)”}”(hhh]”(jF)”}”(hŒW``unsigned long long length`` Length in bytes of the scatterlist. Must be at least one ”h]”(jL)”}”(hŒ``unsigned long long length``”h]”jÒ)”}”(hj˜wh]”hŒunsigned long long length”…””}”(hjšwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj–wubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MDhj’wubjf)”}”(hhh]”hØ)”}”(hŒ8Length in bytes of the scatterlist. Must be at least one”h]”hŒ8Length in bytes of the scatterlist. Must be at least one”…””}”(hj±whžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjwh MDhj®wubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj’wubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjwh MDhjwubjF)”}”(hŒ9``unsigned int order`` Second argument for alloc_pages() ”h]”(jL)”}”(hŒ``unsigned int order``”h]”jÒ)”}”(hjÑwh]”hŒunsigned int order”…””}”(hjÓwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÏwubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MEhjËwubjf)”}”(hhh]”hØ)”}”(hŒ!Second argument for alloc_pages()”h]”hŒ!Second argument for alloc_pages()”…””}”(hjêwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjæwh MEhjçwubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjËwubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjæwh MEhjwubjF)”}”(hŒt``bool chainable`` Whether or not to allocate an extra element in the scatterlist for scatterlist chaining purposes ”h]”(jL)”}”(hŒ``bool chainable``”h]”jÒ)”}”(hj xh]”hŒbool chainable”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjxubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MGhjxubjf)”}”(hhh]”hØ)”}”(hŒ`Whether or not to allocate an extra element in the scatterlist for scatterlist chaining purposes”h]”hŒ`Whether or not to allocate an extra element in the scatterlist for scatterlist chaining purposes”…””}”(hj#xhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MFhj xubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjxubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjxh MGhjwubjF)”}”(hŒ&``gfp_t gfp`` Memory allocation flags ”h]”(jL)”}”(hŒ ``gfp_t gfp``”h]”jÒ)”}”(hjDxh]”hŒ gfp_t gfp”…””}”(hjFxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjBxubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MHhj>xubjf)”}”(hhh]”hØ)”}”(hŒMemory allocation flags”h]”hŒMemory allocation flags”…””}”(hj]xhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjYxh MHhjZxubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj>xubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjYxh MHhjwubjF)”}”(hŒT``unsigned int *nent_p`` [out] Number of entries in the scatterlist that have pages ”h]”(jL)”}”(hŒ``unsigned int *nent_p``”h]”jÒ)”}”(hj}xh]”hŒunsigned int *nent_p”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj{xubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MIhjwxubjf)”}”(hhh]”hØ)”}”(hŒ:[out] Number of entries in the scatterlist that have pages”h]”hŒ:[out] Number of entries in the scatterlist that have pages”…””}”(hj–xhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj’xh MIhj“xubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjwxubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj’xh MIhjwubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjswubhØ)”}”(hŒ **Return**”h]”j+)”}”(hj¸xh]”hŒReturn”…””}”(hjºxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¶xubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MKhjswubhØ)”}”(hŒAA pointer to an initialized scatterlist or ``NULL`` upon failure.”h]”(hŒ+A pointer to an initialized scatterlist or ”…””}”(hjÎxhžhhŸNh NubjÒ)”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hjÖxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÎxubhŒ upon failure.”…””}”(hjÎxhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MKhjswubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsgl_alloc (C function)”Œc.sgl_alloc”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ[struct scatterlist * sgl_alloc (unsigned long long length, gfp_t gfp, unsigned int *nent_p)”h]”jg)”}”(hŒYstruct scatterlist *sgl_alloc(unsigned long long length, gfp_t gfp, unsigned int *nent_p)”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjyhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjyhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjyhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjyhžhhŸjyh M|ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj.yhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj+yubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j0yŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œ sgl_alloc”sbŒc.sgl_alloc”†”asbuh1hhjyhžhhŸjyh M|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjOyhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjyhžhhŸjyh M|ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj]yhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjyhžhhŸjyh M|ubjß)”}”(hŒ sgl_alloc”h]”j“)”}”(hjLyh]”hŒ sgl_alloc”…””}”(hjnyhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjjyubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjyhžhhŸjyh M|ubjú)”}”(hŒ<(unsigned long long length, gfp_t gfp, unsigned int *nent_p)”h]”(j)”}”(hŒunsigned long long length”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj‰yhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj…yubj)”}”(hŒ ”h]”hŒ ”…””}”(hj—yhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj…yubj")”}”(hŒlong”h]”hŒlong”…””}”(hj¥yhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj…yubj)”}”(hŒ ”h]”hŒ ”…””}”(hj³yhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj…yubj")”}”(hŒlong”h]”hŒlong”…””}”(hjÁyhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj…yubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÏyhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj…yubj“)”}”(hŒlength”h]”hŒlength”…””}”(hjÝyhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj…yubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjyubj)”}”(hŒ gfp_t gfp”h]”(h)”}”(hhh]”j“)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjùyhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjöyubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jûyŒmodname”NŒ classname”Nj°j³)”}”j¶]”jJyŒc.sgl_alloc”†”asbuh1hhjòyubj)”}”(hŒ ”h]”hŒ ”…””}”(hjzhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjòyubj“)”}”(hŒgfp”h]”hŒgfp”…””}”(hj%zhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjòyubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjyubj)”}”(hŒunsigned int *nent_p”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj>zhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj:zubj)”}”(hŒ ”h]”hŒ ”…””}”(hjLzhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj:zubj")”}”(hŒint”h]”hŒint”…””}”(hjZzhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj:zubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhzhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj:zubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjvzhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj:zubj“)”}”(hŒnent_p”h]”hŒnent_p”…””}”(hjƒzhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj:zubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjyubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjyhžhhŸjyh M|ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjyhžhhŸjyh M|ubah}”(h]”jyah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjyh M|hjyhžhubjú)”}”(hhh]”hØ)”}”(hŒ$allocate a scatterlist and its pages”h]”hŒ$allocate a scatterlist and its pages”…””}”(hjzhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M|hjªzhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjyhžhhŸjyh M|ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjÅzjjÅzj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX**Parameters** ``unsigned long long length`` Length in bytes of the scatterlist ``gfp_t gfp`` Memory allocation flags ``unsigned int *nent_p`` [out] Number of entries in the scatterlist **Return** A pointer to an initialized scatterlist or ``NULL`` upon failure.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjÏzh]”hŒ Parameters”…””}”(hjÑzhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÍzubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M€hjÉzubjA)”}”(hhh]”(jF)”}”(hŒA``unsigned long long length`` Length in bytes of the scatterlist ”h]”(jL)”}”(hŒ``unsigned long long length``”h]”jÒ)”}”(hjîzh]”hŒunsigned long long length”…””}”(hjðzhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjìzubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M}hjèzubjf)”}”(hhh]”hØ)”}”(hŒ"Length in bytes of the scatterlist”h]”hŒ"Length in bytes of the scatterlist”…””}”(hj{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj{h M}hj{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjèzubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj{h M}hjåzubjF)”}”(hŒ&``gfp_t gfp`` Memory allocation flags ”h]”(jL)”}”(hŒ ``gfp_t gfp``”h]”jÒ)”}”(hj'{h]”hŒ gfp_t gfp”…””}”(hj){hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj%{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M~hj!{ubjf)”}”(hhh]”hØ)”}”(hŒMemory allocation flags”h]”hŒMemory allocation flags”…””}”(hj@{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj<{h M~hj={ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj!{ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj<{h M~hjåzubjF)”}”(hŒD``unsigned int *nent_p`` [out] Number of entries in the scatterlist ”h]”(jL)”}”(hŒ``unsigned int *nent_p``”h]”jÒ)”}”(hj`{h]”hŒunsigned int *nent_p”…””}”(hjb{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj^{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjZ{ubjf)”}”(hhh]”hØ)”}”(hŒ*[out] Number of entries in the scatterlist”h]”hŒ*[out] Number of entries in the scatterlist”…””}”(hjy{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸju{h Mhjv{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjZ{ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸju{h Mhjåzubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjÉzubhØ)”}”(hŒ **Return**”h]”j+)”}”(hj›{h]”hŒReturn”…””}”(hj{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj™{ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjÉzubhØ)”}”(hŒAA pointer to an initialized scatterlist or ``NULL`` upon failure.”h]”(hŒ+A pointer to an initialized scatterlist or ”…””}”(hj±{hžhhŸNh NubjÒ)”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hj¹{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj±{ubhŒ upon failure.”…””}”(hj±{hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjÉzubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsgl_free_n_order (C function)”Œc.sgl_free_n_order”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒEvoid sgl_free_n_order (struct scatterlist *sgl, int nents, int order)”h]”jg)”}”(hŒDvoid sgl_free_n_order(struct scatterlist *sgl, int nents, int order)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjò{hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjî{hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M‹ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjî{hžhhŸj|h M‹ubjß)”}”(hŒsgl_free_n_order”h]”j“)”}”(hŒsgl_free_n_order”h]”hŒsgl_free_n_order”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj|ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjî{hžhhŸj|h M‹ubjú)”}”(hŒ/(struct scatterlist *sgl, int nents, int order)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj/|hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj+|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj<|hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj+|ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjM|hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjJ|ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jO|Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j|sbŒc.sgl_free_n_order”†”asbuh1hhj+|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjm|hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj+|ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj{|hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj+|ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hjˆ|hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj+|ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'|ubj)”}”(hŒ int nents”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hj¡|hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¯|hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj|ubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj½|hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj|ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'|ubj)”}”(hŒ int order”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hjÖ|hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÒ|ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjä|hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÒ|ubj“)”}”(hŒorder”h]”hŒorder”…””}”(hjò|hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÒ|ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj'|ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjî{hžhhŸj|h M‹ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjê{hžhhŸj|h M‹ubah}”(h]”jå{ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj|h M‹hjç{hžhubjú)”}”(hhh]”hØ)”}”(hŒ free a scatterlist and its pages”h]”hŒ free a scatterlist and its pages”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M‹hj}hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjç{hžhhŸj|h M‹ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj4}jj4}j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXÜ**Parameters** ``struct scatterlist *sgl`` Scatterlist with one or more elements ``int nents`` Maximum number of elements to free ``int order`` Second argument for __free_pages() **Notes** - If several scatterlists have been chained and each chain element is freed separately then it's essential to set nents correctly to avoid that a page would get freed twice. - All pages in a chained scatterlist can be freed at once by setting **nents** to a high number.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj>}h]”hŒ Parameters”…””}”(hj@}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj<}ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj8}ubjA)”}”(hhh]”(jF)”}”(hŒB``struct scatterlist *sgl`` Scatterlist with one or more elements ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hj]}h]”hŒstruct scatterlist *sgl”…””}”(hj_}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj[}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MŒhjW}ubjf)”}”(hhh]”hØ)”}”(hŒ%Scatterlist with one or more elements”h]”hŒ%Scatterlist with one or more elements”…””}”(hjv}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjr}h MŒhjs}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjW}ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjr}h MŒhjT}ubjF)”}”(hŒ1``int nents`` Maximum number of elements to free ”h]”(jL)”}”(hŒ ``int nents``”h]”jÒ)”}”(hj–}h]”hŒ int nents”…””}”(hj˜}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj”}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj}ubjf)”}”(hhh]”hØ)”}”(hŒ"Maximum number of elements to free”h]”hŒ"Maximum number of elements to free”…””}”(hj¯}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj«}h Mhj¬}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj}ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj«}h MhjT}ubjF)”}”(hŒ1``int order`` Second argument for __free_pages() ”h]”(jL)”}”(hŒ ``int order``”h]”jÒ)”}”(hjÏ}h]”hŒ int order”…””}”(hjÑ}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÍ}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MŽhjÉ}ubjf)”}”(hhh]”hØ)”}”(hŒ"Second argument for __free_pages()”h]”hŒ"Second argument for __free_pages()”…””}”(hjè}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjä}h MŽhjå}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÉ}ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjä}h MŽhjT}ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj8}ubhØ)”}”(hŒ **Notes**”h]”j+)”}”(hj ~h]”hŒNotes”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj8}ubj")”}”(hhh]”(j')”}”(hŒ«If several scatterlists have been chained and each chain element is freed separately then it's essential to set nents correctly to avoid that a page would get freed twice.”h]”hØ)”}”(hŒ«If several scatterlists have been chained and each chain element is freed separately then it's essential to set nents correctly to avoid that a page would get freed twice.”h]”hŒIf several scatterlists have been chained and each chain element is freed separately then itâ€™s essential to set nents correctly to avoid that a page would get freed twice.”…””}”(hj'~hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj#~ubah}”(h]”h ]”h"]”h$]”h&]”uh1j&hj ~ubj')”}”(hŒ^All pages in a chained scatterlist can be freed at once by setting **nents** to a high number.”h]”hØ)”}”(hŒ^All pages in a chained scatterlist can be freed at once by setting **nents** to a high number.”h]”(hŒCAll pages in a chained scatterlist can be freed at once by setting ”…””}”(hj@~hžhhŸNh Nubj+)”}”(hŒ **nents**”h]”hŒnents”…””}”(hjH~hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj@~ubhŒ to a high number.”…””}”(hj@~hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M“hj<~ubah}”(h]”h ]”h"]”h$]”h&]”uh1j&hj ~ubeh}”(h]”h ]”h"]”h$]”h&]”jˆj‰uh1j!hŸj5~h Mhj8}ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsgl_free_order (C function)”Œc.sgl_free_order”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ8void sgl_free_order (struct scatterlist *sgl, int order)”h]”jg)”}”(hŒ7void sgl_free_order(struct scatterlist *sgl, int order)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj‰~hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M©ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjœ~hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‰~hžhhŸj›~h M©ubjß)”}”(hŒsgl_free_order”h]”j“)”}”(hŒsgl_free_order”h]”hŒsgl_free_order”…””}”(hj®~hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjª~ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj‰~hžhhŸj›~h M©ubjú)”}”(hŒ$(struct scatterlist *sgl, int order)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÊ~hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÆ~ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj×~hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÆ~ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjè~hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjå~ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jê~Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬j°~sbŒc.sgl_free_order”†”asbuh1hhjÆ~ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÆ~ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÆ~ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÆ~ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÂ~ubj)”}”(hŒ int order”h]”(j")”}”(hŒint”h]”hŒint”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj8ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj8ubj“)”}”(hŒorder”h]”hŒorder”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj8ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjÂ~ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj‰~hžhhŸj›~h M©ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj…~hžhhŸj›~h M©ubah}”(h]”j€~ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj›~h M©hj‚~hžhubjú)”}”(hhh]”hØ)”}”(hŒ free a scatterlist and its pages”h]”hŒ free a scatterlist and its pages”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M©hjhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj‚~hžhhŸj›~h M©ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjšjjšj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒ‡**Parameters** ``struct scatterlist *sgl`` Scatterlist with one or more elements ``int order`` Second argument for __free_pages()”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj¤h]”hŒ Parameters”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¢ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjžubjA)”}”(hhh]”(jF)”}”(hŒB``struct scatterlist *sgl`` Scatterlist with one or more elements ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjÃh]”hŒstruct scatterlist *sgl”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mªhj½ubjf)”}”(hhh]”hØ)”}”(hŒ%Scatterlist with one or more elements”h]”hŒ%Scatterlist with one or more elements”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjØh MªhjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj½ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjØh MªhjºubjF)”}”(hŒ0``int order`` Second argument for __free_pages()”h]”(jL)”}”(hŒ ``int order``”h]”jÒ)”}”(hjüh]”hŒ int order”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjúubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¬hjöubjf)”}”(hhh]”hØ)”}”(hŒ"Second argument for __free_pages()”h]”hŒ"Second argument for __free_pages()”…””}”(hj€hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M«hj€ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjöubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj€h M¬hjºubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjžubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsgl_free (C function)”Œ c.sgl_free”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ'void sgl_free (struct scatterlist *sgl)”h]”jg)”}”(hŒ&void sgl_free(struct scatterlist *sgl)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjV€hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjR€hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M´ubj)”}”(hŒ ”h]”hŒ ”…””}”(hje€hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjR€hžhhŸjd€h M´ubjß)”}”(hŒsgl_free”h]”j“)”}”(hŒsgl_free”h]”hŒsgl_free”…””}”(hjw€hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjs€ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjR€hžhhŸjd€h M´ubjú)”}”(hŒ(struct scatterlist *sgl)”h]”j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj“€hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj€ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj €hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj€ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj±€hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj®€ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j³€Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jy€sbŒ c.sgl_free”†”asbuh1hhj€ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÑ€hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj€ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjß€hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj€ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hjì€hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj€ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‹€ubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjR€hžhhŸjd€h M´ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjN€hžhhŸjd€h M´ubah}”(h]”jI€ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjd€h M´hjK€hžhubjú)”}”(hhh]”hØ)”}”(hŒ free a scatterlist and its pages”h]”hŒ free a scatterlist and its pages”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M´hjhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjK€hžhhŸjd€h M´ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj.jj.j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒS**Parameters** ``struct scatterlist *sgl`` Scatterlist with one or more elements”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj8h]”hŒ Parameters”…””}”(hj:hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj6ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¸hj2ubjA)”}”(hhh]”jF)”}”(hŒA``struct scatterlist *sgl`` Scatterlist with one or more elements”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjWh]”hŒstruct scatterlist *sgl”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MºhjQubjf)”}”(hhh]”hØ)”}”(hŒ%Scatterlist with one or more elements”h]”hŒ%Scatterlist with one or more elements”…””}”(hjphžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mµhjmubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjQubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjlh MºhjNubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj2ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_miter_start (C function)”Œc.sg_miter_start”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒtvoid sg_miter_start (struct sg_mapping_iter *miter, struct scatterlist *sgl, unsigned int nents, unsigned int flags)”h]”jg)”}”(hŒsvoid sg_miter_start(struct sg_mapping_iter *miter, struct scatterlist *sgl, unsigned int nents, unsigned int flags)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj±hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mþubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÀhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjhžhhŸj¿h Mþubjß)”}”(hŒsg_miter_start”h]”j“)”}”(hŒsg_miter_start”h]”hŒsg_miter_start”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÎubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjhžhhŸj¿h Mþubjú)”}”(hŒ`(struct sg_mapping_iter *miter, struct scatterlist *sgl, unsigned int nents, unsigned int flags)”h]”(j)”}”(hŒstruct sg_mapping_iter *miter”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjîhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjêubj)”}”(hŒ ”h]”hŒ ”…””}”(hjûhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjêubh)”}”(hhh]”j“)”}”(hŒsg_mapping_iter”h]”hŒsg_mapping_iter”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj ‚ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j‚Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jÔsbŒc.sg_miter_start”†”asbuh1hhjêubj)”}”(hŒ ”h]”hŒ ”…””}”(hj,‚hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjêubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj:‚hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjêubj“)”}”(hŒmiter”h]”hŒmiter”…””}”(hjG‚hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjêubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjæubj)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj`‚hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj\‚ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjm‚hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj\‚ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj~‚hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj{‚ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j€‚Œmodname”NŒ classname”Nj°j³)”}”j¶]”j(‚Œc.sg_miter_start”†”asbuh1hhj\‚ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjœ‚hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj\‚ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjª‚hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj\‚ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj·‚hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj\‚ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjæubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÐ‚hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÌ‚ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÞ‚hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÌ‚ubj")”}”(hŒint”h]”hŒint”…””}”(hjì‚hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÌ‚ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjú‚hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÌ‚ubj“)”}”(hŒnents”h]”hŒnents”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÌ‚ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjæubj)”}”(hŒunsigned int flags”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj!ƒhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjƒubj)”}”(hŒ ”h]”hŒ ”…””}”(hj/ƒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjƒubj")”}”(hŒint”h]”hŒint”…””}”(hj=ƒhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjƒubj)”}”(hŒ ”h]”hŒ ”…””}”(hjKƒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjƒubj“)”}”(hŒflags”h]”hŒflags”…””}”(hjYƒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjƒubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjæubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjhžhhŸj¿h Mþubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj©hžhhŸj¿h Mþubah}”(h]”j¤ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj¿h Mþhj¦hžhubjú)”}”(hhh]”hØ)”}”(hŒ&start mapping iteration over a sg list”h]”hŒ&start mapping iteration over a sg list”…””}”(hjƒƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mþhj€ƒhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj¦hžhhŸj¿h Mþubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj›ƒjj›ƒj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX4**Parameters** ``struct sg_mapping_iter *miter`` sg mapping iter to be started ``struct scatterlist *sgl`` sg list to iterate over ``unsigned int nents`` number of sg entries ``unsigned int flags`` sg iterator flags **Description** Starts mapping iterator **miter**. **Context** Don't care.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj¥ƒh]”hŒ Parameters”…””}”(hj§ƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj£ƒubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjŸƒubjA)”}”(hhh]”(jF)”}”(hŒ@``struct sg_mapping_iter *miter`` sg mapping iter to be started ”h]”(jL)”}”(hŒ!``struct sg_mapping_iter *miter``”h]”jÒ)”}”(hjÄƒh]”hŒstruct sg_mapping_iter *miter”…””}”(hjÆƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÂƒubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mÿhj¾ƒubjf)”}”(hhh]”hØ)”}”(hŒsg mapping iter to be started”h]”hŒsg mapping iter to be started”…””}”(hjÝƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÙƒh MÿhjÚƒubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj¾ƒubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÙƒh Mÿhj»ƒubjF)”}”(hŒ4``struct scatterlist *sgl`` sg list to iterate over ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjýƒh]”hŒstruct scatterlist *sgl”…””}”(hjÿƒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjûƒubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj÷ƒubjf)”}”(hhh]”hØ)”}”(hŒsg list to iterate over”h]”hŒsg list to iterate over”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj„h Mhj„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj÷ƒubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj„h Mhj»ƒubjF)”}”(hŒ,``unsigned int nents`` number of sg entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hj6„h]”hŒunsigned int nents”…””}”(hj8„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj4„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj0„ubjf)”}”(hhh]”hØ)”}”(hŒnumber of sg entries”h]”hŒnumber of sg entries”…””}”(hjO„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjK„h MhjL„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj0„ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjK„h Mhj»ƒubjF)”}”(hŒ)``unsigned int flags`` sg iterator flags ”h]”(jL)”}”(hŒ``unsigned int flags``”h]”jÒ)”}”(hjo„h]”hŒunsigned int flags”…””}”(hjq„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjm„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhji„ubjf)”}”(hhh]”hØ)”}”(hŒsg iterator flags”h]”hŒsg iterator flags”…””}”(hjˆ„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj„„h Mhj…„ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehji„ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj„„h Mhj»ƒubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjŸƒubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjª„h]”hŒDescription”…””}”(hj¬„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¨„ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjŸƒubj`$)”}”(hŒ#Starts mapping iterator **miter**. ”h]”hØ)”}”(hŒ"Starts mapping iterator **miter**.”h]”(hŒStarts mapping iterator ”…””}”(hjÄ„hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hjÌ„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÄ„ubhŒ.”…””}”(hjÄ„hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjÀ„ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸjä„h MhjŸƒubhØ)”}”(hŒ**Context**”h]”j+)”}”(hjí„h]”hŒContext”…””}”(hjï„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjë„ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjŸƒubhØ)”}”(hŒDon't care.”h]”hŒ Donâ€™t care.”…””}”(hj…hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjŸƒubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_miter_skip (C function)”Œc.sg_miter_skip”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ@bool sg_miter_skip (struct sg_mapping_iter *miter, off_t offset)”h]”jg)”}”(hŒ?bool sg_miter_skip(struct sg_mapping_iter *miter, off_t offset)”h]”(j")”}”(hjÑ5h]”hŒbool”…””}”(hj2…hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj.…hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M-ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj@…hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj.…hžhhŸj?…h M-ubjß)”}”(hŒ sg_miter_skip”h]”j“)”}”(hŒ sg_miter_skip”h]”hŒ sg_miter_skip”…””}”(hjR…hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjN…ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj.…hžhhŸj?…h M-ubjú)”}”(hŒ-(struct sg_mapping_iter *miter, off_t offset)”h]”(j)”}”(hŒstruct sg_mapping_iter *miter”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjn…hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjj…ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj{…hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjj…ubh)”}”(hhh]”j“)”}”(hŒsg_mapping_iter”h]”hŒsg_mapping_iter”…””}”(hjŒ…hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‰…ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŽ…Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jT…sbŒc.sg_miter_skip”†”asbuh1hhjj…ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¬…hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjj…ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjº…hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjj…ubj“)”}”(hŒmiter”h]”hŒmiter”…””}”(hjÇ…hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjj…ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjf…ubj)”}”(hŒoff_t offset”h]”(h)”}”(hhh]”j“)”}”(hŒoff_t”h]”hŒoff_t”…””}”(hjã…hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjà…ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jå…Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¨…Œc.sg_miter_skip”†”asbuh1hhjÜ…ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj†hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÜ…ubj“)”}”(hŒoffset”h]”hŒoffset”…””}”(hj†hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÜ…ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjf…ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj.…hžhhŸj?…h M-ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj*…hžhhŸj?…h M-ubah}”(h]”j%…ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj?…h M-hj'…hžhubjú)”}”(hhh]”hØ)”}”(hŒreposition mapping iterator”h]”hŒreposition mapping iterator”…””}”(hj9†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M-hj6†hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj'…hžhhŸj?…h M-ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjQ†jjQ†j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXË**Parameters** ``struct sg_mapping_iter *miter`` sg mapping iter to be skipped ``off_t offset`` number of bytes to plus the current location **Description** Sets the offset of **miter** to its current location plus **offset** bytes. If mapping iterator **miter** has been proceeded by sg_miter_next(), this stops **miter**. **Context** Don't care. **Return** true if **miter** contains the valid mapping. false if end of sg list is reached.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj[†h]”hŒ Parameters”…””}”(hj]†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjY†ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M1hjU†ubjA)”}”(hhh]”(jF)”}”(hŒ@``struct sg_mapping_iter *miter`` sg mapping iter to be skipped ”h]”(jL)”}”(hŒ!``struct sg_mapping_iter *miter``”h]”jÒ)”}”(hjz†h]”hŒstruct sg_mapping_iter *miter”…””}”(hj|†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjx†ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M.hjt†ubjf)”}”(hhh]”hØ)”}”(hŒsg mapping iter to be skipped”h]”hŒsg mapping iter to be skipped”…””}”(hj“†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj†h M.hj†ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjt†ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj†h M.hjq†ubjF)”}”(hŒ>``off_t offset`` number of bytes to plus the current location ”h]”(jL)”}”(hŒ``off_t offset``”h]”jÒ)”}”(hj³†h]”hŒoff_t offset”…””}”(hjµ†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj±†ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M/hj†ubjf)”}”(hhh]”hØ)”}”(hŒ,number of bytes to plus the current location”h]”hŒ,number of bytes to plus the current location”…””}”(hjÌ†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÈ†h M/hjÉ†ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj†ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÈ†h M/hjq†ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjU†ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjî†h]”hŒDescription”…””}”(hjð†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjì†ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M1hjU†ubj`$)”}”(hŒ§Sets the offset of **miter** to its current location plus **offset** bytes. If mapping iterator **miter** has been proceeded by sg_miter_next(), this stops **miter**. ”h]”hØ)”}”(hŒ¦Sets the offset of **miter** to its current location plus **offset** bytes. If mapping iterator **miter** has been proceeded by sg_miter_next(), this stops **miter**.”h]”(hŒSets the offset of ”…””}”(hj‡hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‡ubhŒ to its current location plus ”…””}”(hj‡hžhhŸNh Nubj+)”}”(hŒ **offset**”h]”hŒoffset”…””}”(hj"‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‡ubhŒ bytes. If mapping iterator ”…””}”(hj‡hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hj4‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‡ubhŒ3 has been proceeded by sg_miter_next(), this stops ”…””}”(hj‡hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hjF‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‡ubhŒ.”…””}”(hj‡hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M1hj‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj^‡h M1hjU†ubhØ)”}”(hŒ**Context**”h]”j+)”}”(hjg‡h]”hŒContext”…””}”(hji‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hje‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M5hjU†ubhØ)”}”(hŒDon't care.”h]”hŒ Donâ€™t care.”…””}”(hj}‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M6hjU†ubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjŽ‡h]”hŒReturn”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjŒ‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M8hjU†ubhØ)”}”(hŒRtrue if **miter** contains the valid mapping. false if end of sg list is reached.”h]”(hŒtrue if ”…””}”(hj¤‡hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hj¬‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¤‡ubhŒA contains the valid mapping. false if end of sg list is reached.”…””}”(hj¤‡hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M9hjU†ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_miter_next (C function)”Œc.sg_miter_next”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ2bool sg_miter_next (struct sg_mapping_iter *miter)”h]”jg)”}”(hŒ1bool sg_miter_next(struct sg_mapping_iter *miter)”h]”(j")”}”(hjÑ5h]”hŒbool”…””}”(hjå‡hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjá‡hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MRubj)”}”(hŒ ”h]”hŒ ”…””}”(hjó‡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjá‡hžhhŸjò‡h MRubjß)”}”(hŒ sg_miter_next”h]”j“)”}”(hŒ sg_miter_next”h]”hŒ sg_miter_next”…””}”(hjˆhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjˆubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjá‡hžhhŸjò‡h MRubjú)”}”(hŒ(struct sg_mapping_iter *miter)”h]”j)”}”(hŒstruct sg_mapping_iter *miter”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj!ˆhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjˆubj)”}”(hŒ ”h]”hŒ ”…””}”(hj.ˆhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjˆubh)”}”(hhh]”j“)”}”(hŒsg_mapping_iter”h]”hŒsg_mapping_iter”…””}”(hj?ˆhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj<ˆubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jAˆŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jˆsbŒc.sg_miter_next”†”asbuh1hhjˆubj)”}”(hŒ ”h]”hŒ ”…””}”(hj_ˆhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjˆubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjmˆhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjˆubj“)”}”(hŒmiter”h]”hŒmiter”…””}”(hjzˆhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjˆubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjˆubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjá‡hžhhŸjò‡h MRubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÝ‡hžhhŸjò‡h MRubah}”(h]”jØ‡ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjò‡h MRhjÚ‡hžhubjú)”}”(hhh]”hØ)”}”(hŒ,proceed mapping iterator to the next mapping”h]”hŒ,proceed mapping iterator to the next mapping”…””}”(hj¤ˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MRhj¡ˆhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjÚ‡hžhhŸjò‡h MRubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj¼ˆjj¼ˆj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hXÕ**Parameters** ``struct sg_mapping_iter *miter`` sg mapping iter to proceed **Description** Proceeds **miter** to the next mapping. **miter** should have been started using sg_miter_start(). On successful return, **miter->page**, **miter->addr** and **miter->length** point to the current mapping. **Context** May sleep if !SG_MITER_ATOMIC && !SG_MITER_LOCAL. **Return** true if **miter** contains the next mapping. false if end of sg list is reached.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjÆˆh]”hŒ Parameters”…””}”(hjÈˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÄˆubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MVhjÀˆubjA)”}”(hhh]”jF)”}”(hŒ=``struct sg_mapping_iter *miter`` sg mapping iter to proceed ”h]”(jL)”}”(hŒ!``struct sg_mapping_iter *miter``”h]”jÒ)”}”(hjåˆh]”hŒstruct sg_mapping_iter *miter”…””}”(hjçˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjãˆubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MShjßˆubjf)”}”(hhh]”hØ)”}”(hŒsg mapping iter to proceed”h]”hŒsg mapping iter to proceed”…””}”(hjþˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjúˆh MShjûˆubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjßˆubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjúˆh MShjÜˆubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hjÀˆubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj ‰h]”hŒDescription”…””}”(hj"‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‰ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MUhjÀˆubj`$)”}”(hŒÐProceeds **miter** to the next mapping. **miter** should have been started using sg_miter_start(). On successful return, **miter->page**, **miter->addr** and **miter->length** point to the current mapping. ”h]”hØ)”}”(hŒÏProceeds **miter** to the next mapping. **miter** should have been started using sg_miter_start(). On successful return, **miter->page**, **miter->addr** and **miter->length** point to the current mapping.”h]”(hŒ Proceeds ”…””}”(hj:‰hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hjB‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:‰ubhŒ to the next mapping. ”…””}”(hj:‰hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hjT‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:‰ubhŒI should have been started using sg_miter_start(). On successful return, ”…””}”(hj:‰hžhhŸNh Nubj+)”}”(hŒ**miter->page**”h]”hŒmiter->page”…””}”(hjf‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:‰ubhŒ, ”…””}”(hj:‰hžhhŸNh Nubj+)”}”(hŒ**miter->addr**”h]”hŒmiter->addr”…””}”(hjx‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:‰ubhŒ and ”…””}”(hj:‰hžhhŸNh Nubj+)”}”(hŒ**miter->length**”h]”hŒ miter->length”…””}”(hjŠ‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj:‰ubhŒ point to the current mapping.”…””}”(hj:‰hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MUhj6‰ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj¢‰h MUhjÀˆubhØ)”}”(hŒ**Context**”h]”j+)”}”(hj«‰h]”hŒContext”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj©‰ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MYhjÀˆubhØ)”}”(hŒ1May sleep if !SG_MITER_ATOMIC && !SG_MITER_LOCAL.”h]”hŒ1May sleep if !SG_MITER_ATOMIC && !SG_MITER_LOCAL.”…””}”(hjÁ‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MZhjÀˆubhØ)”}”(hŒ **Return**”h]”j+)”}”(hjÒ‰h]”hŒReturn”…””}”(hjÔ‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÐ‰ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M\hjÀˆubhØ)”}”(hŒQtrue if **miter** contains the next mapping. false if end of sg list is reached.”h]”(hŒtrue if ”…””}”(hjè‰hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hjð‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjè‰ubhŒ@ contains the next mapping. false if end of sg list is reached.”…””}”(hjè‰hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”•h M]hjÀˆubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_miter_stop (C function)”Œc.sg_miter_stop”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ2void sg_miter_stop (struct sg_mapping_iter *miter)”h]”jg)”}”(hŒ1void sg_miter_stop(struct sg_mapping_iter *miter)”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj)ŠhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj%ŠhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M{ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj8ŠhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj%ŠhžhhŸj7Šh M{ubjß)”}”(hŒ sg_miter_stop”h]”j“)”}”(hŒ sg_miter_stop”h]”hŒ sg_miter_stop”…””}”(hjJŠhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjFŠubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj%ŠhžhhŸj7Šh M{ubjú)”}”(hŒ(struct sg_mapping_iter *miter)”h]”j)”}”(hŒstruct sg_mapping_iter *miter”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjfŠhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjbŠubj)”}”(hŒ ”h]”hŒ ”…””}”(hjsŠhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbŠubh)”}”(hhh]”j“)”}”(hŒsg_mapping_iter”h]”hŒsg_mapping_iter”…””}”(hj„ŠhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j†ŠŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬jLŠsbŒc.sg_miter_stop”†”asbuh1hhjbŠubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¤ŠhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjbŠubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj²ŠhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjbŠubj“)”}”(hŒmiter”h]”hŒmiter”…””}”(hj¿ŠhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjbŠubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj^Šubah}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj%ŠhžhhŸj7Šh M{ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj!ŠhžhhŸj7Šh M{ubah}”(h]”jŠah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj7Šh M{hjŠhžhubjú)”}”(hhh]”hØ)”}”(hŒstop mapping iteration”h]”hŒstop mapping iteration”…””}”(hjéŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M{hjæŠhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjŠhžhhŸj7Šh M{ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj‹jj‹j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX**Parameters** ``struct sg_mapping_iter *miter`` sg mapping iter to be stopped **Description** Stops mapping iterator **miter**. **miter** should have been started using sg_miter_start(). A stopped iteration can be resumed by calling sg_miter_next() on it. This is useful when resources (kmap) need to be released during iteration. **Context** Don't care otherwise.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj‹h]”hŒ Parameters”…””}”(hj ‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj ‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj‹ubjA)”}”(hhh]”jF)”}”(hŒ@``struct sg_mapping_iter *miter`` sg mapping iter to be stopped ”h]”(jL)”}”(hŒ!``struct sg_mapping_iter *miter``”h]”jÒ)”}”(hj*‹h]”hŒstruct sg_mapping_iter *miter”…””}”(hj,‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj(‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M|hj$‹ubjf)”}”(hhh]”hØ)”}”(hŒsg mapping iter to be stopped”h]”hŒsg mapping iter to be stopped”…””}”(hjC‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj?‹h M|hj@‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj$‹ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj?‹h M|hj!‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1j@hj‹ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hje‹h]”hŒDescription”…””}”(hjg‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjc‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M~hj‹ubj`$)”}”(hŒðStops mapping iterator **miter**. **miter** should have been started using sg_miter_start(). A stopped iteration can be resumed by calling sg_miter_next() on it. This is useful when resources (kmap) need to be released during iteration. ”h]”hØ)”}”(hŒïStops mapping iterator **miter**. **miter** should have been started using sg_miter_start(). A stopped iteration can be resumed by calling sg_miter_next() on it. This is useful when resources (kmap) need to be released during iteration.”h]”(hŒStops mapping iterator ”…””}”(hj‹hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hj‡‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‹ubhŒ. ”…””}”(hj‹hžhhŸNh Nubj+)”}”(hŒ **miter**”h]”hŒmiter”…””}”(hj™‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj‹ubhŒÃ should have been started using sg_miter_start(). A stopped iteration can be resumed by calling sg_miter_next() on it. This is useful when resources (kmap) need to be released during iteration.”…””}”(hj‹hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M~hj{‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_$hŸj±‹h M~hj‹ubhØ)”}”(hŒ**Context**”h]”j+)”}”(hjº‹h]”hŒContext”…””}”(hj¼‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj¸‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mƒhj‹ubhØ)”}”(hŒDon't care otherwise.”h]”hŒDonâ€™t care otherwise.”…””}”(hjÐ‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M„hj‹ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_copy_buffer (C function)”Œc.sg_copy_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒysize_t sg_copy_buffer (struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip, bool to_buffer)”h]”jg)”}”(hŒxsize_t sg_copy_buffer(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip, bool to_buffer)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÿ‹ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŒŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_copy_buffer”sbŒc.sg_copy_buffer”†”asbuh1hhjû‹hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¤ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj$ŒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjû‹hžhhŸj#Œh M¤ubjß)”}”(hŒsg_copy_buffer”h]”j“)”}”(hj Œh]”hŒsg_copy_buffer”…””}”(hj6ŒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj2Œubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjû‹hžhhŸj#Œh M¤ubjú)”}”(hŒc(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip, bool to_buffer)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjQŒhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjMŒubj)”}”(hŒ ”h]”hŒ ”…””}”(hj^ŒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjMŒubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjoŒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjlŒubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jqŒŒmodname”NŒ classname”Nj°j³)”}”j¶]”jŒŒc.sg_copy_buffer”†”asbuh1hhjMŒubj)”}”(hŒ ”h]”hŒ ”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjMŒubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj›ŒhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjMŒubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj¨ŒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjMŒubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÁŒhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj½Œubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÏŒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj½Œubj")”}”(hŒint”h]”hŒint”…””}”(hjÝŒhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj½Œubj)”}”(hŒ ”h]”hŒ ”…””}”(hjëŒhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj½Œubj“)”}”(hŒnents”h]”hŒnents”…””}”(hjùŒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj½Œubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubj)”}”(hŒ void *buf”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjWhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjTubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jYŒmodname”NŒ classname”Nj°j³)”}”j¶]”jŒŒc.sg_copy_buffer”†”asbuh1hhjPubj)”}”(hŒ ”h]”hŒ ”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjPubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hjƒhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjPubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubj)”}”(hŒ off_t skip”h]”(h)”}”(hhh]”j“)”}”(hŒoff_t”h]”hŒoff_t”…””}”(hjŸhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjœubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¡Œmodname”NŒ classname”Nj°j³)”}”j¶]”jŒŒc.sg_copy_buffer”†”asbuh1hhj˜ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj˜ubj“)”}”(hŒskip”h]”hŒskip”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj˜ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubj)”}”(hŒbool to_buffer”h]”(j")”}”(hjÑ5h]”hŒbool”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjàubj)”}”(hŒ ”h]”hŒ ”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjàubj“)”}”(hŒ to_buffer”h]”hŒ to_buffer”…””}”(hjÿhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjàubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjIŒubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjû‹hžhhŸj#Œh M¤ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj÷‹hžhhŸj#Œh M¤ubah}”(h]”jò‹ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj#Œh M¤hjô‹hžhubjú)”}”(hhh]”hØ)”}”(hŒ0Copy data between a linear buffer and an SG list”h]”hŒ0Copy data between a linear buffer and an SG list”…””}”(hj)ŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¤hj&Žhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjô‹hžhhŸj#Œh M¤ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjAŽjjAŽj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX£**Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``void *buf`` Where to copy from ``size_t buflen`` The number of bytes to copy ``off_t skip`` Number of bytes to skip before copying ``bool to_buffer`` transfer direction (true == from an sg list to a buffer, false == from a buffer to an sg list) **Description** Returns the number of copied bytes.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjKŽh]”hŒ Parameters”…””}”(hjMŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjIŽubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¨hjEŽubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjjŽh]”hŒstruct scatterlist *sgl”…””}”(hjlŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjhŽubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¥hjdŽubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hjƒŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjŽh M¥hj€Žubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjdŽubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjŽh M¥hjaŽubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hj£Žh]”hŒunsigned int nents”…””}”(hj¥ŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj¡Žubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¦hjŽubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hj¼ŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¸Žh M¦hj¹Žubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjŽubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¸Žh M¦hjaŽubjF)”}”(hŒ!``void *buf`` Where to copy from ”h]”(jL)”}”(hŒ ``void *buf``”h]”jÒ)”}”(hjÜŽh]”hŒ void *buf”…””}”(hjÞŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÚŽubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M§hjÖŽubjf)”}”(hhh]”hØ)”}”(hŒWhere to copy from”h]”hŒWhere to copy from”…””}”(hjõŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjñŽh M§hjòŽubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÖŽubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjñŽh M§hjaŽubjF)”}”(hŒ.``size_t buflen`` The number of bytes to copy ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hjh]”hŒ size_t buflen”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¨hjubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to copy”h]”hŒThe number of bytes to copy”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj*h M¨hj+ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj*h M¨hjaŽubjF)”}”(hŒ6``off_t skip`` Number of bytes to skip before copying ”h]”(jL)”}”(hŒ``off_t skip``”h]”jÒ)”}”(hjNh]”hŒ off_t skip”…””}”(hjPhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjLubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M©hjHubjf)”}”(hhh]”hØ)”}”(hŒ&Number of bytes to skip before copying”h]”hŒ&Number of bytes to skip before copying”…””}”(hjghžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjch M©hjdubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjHubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjch M©hjaŽubjF)”}”(hŒr``bool to_buffer`` transfer direction (true == from an sg list to a buffer, false == from a buffer to an sg list) ”h]”(jL)”}”(hŒ``bool to_buffer``”h]”jÒ)”}”(hj‡h]”hŒbool to_buffer”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj…ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M«hjubjf)”}”(hhh]”hØ)”}”(hŒ^transfer direction (true == from an sg list to a buffer, false == from a buffer to an sg list)”h]”hŒ^transfer direction (true == from an sg list to a buffer, false == from a buffer to an sg list)”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mªhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjœh M«hjaŽubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjEŽubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÃh]”hŒDescription”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjEŽubhØ)”}”(hŒ#Returns the number of copied bytes.”h]”hŒ#Returns the number of copied bytes.”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M¬hjEŽubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ sg_copy_from_buffer (C function)”Œc.sg_copy_from_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒhsize_t sg_copy_from_buffer (struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen)”h]”jg)”}”(hŒgsize_t sg_copy_from_buffer(struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_copy_from_buffer”sbŒc.sg_copy_from_buffer”†”asbuh1hhjhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÕubj)”}”(hŒ ”h]”hŒ ”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjhžhhŸj,h MÕubjß)”}”(hŒsg_copy_from_buffer”h]”j“)”}”(hj)h]”hŒsg_copy_from_buffer”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj;ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjhžhhŸj,h MÕubjú)”}”(hŒM(struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjVubj)”}”(hŒ ”h]”hŒ ”…””}”(hjghžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjVubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjuubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jzŒmodname”NŒ classname”Nj°j³)”}”j¶]”j'Œc.sg_copy_from_buffer”†”asbuh1hhjVubj)”}”(hŒ ”h]”hŒ ”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjVubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjVubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj±hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjVubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjRubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÆubj)”}”(hŒ ”h]”hŒ ”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÆubj")”}”(hŒint”h]”hŒint”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjÆubj)”}”(hŒ ”h]”hŒ ”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÆubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÆubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjRubj)”}”(hŒconst void *buf”h]”(jm)”}”(hjh]”hŒconst”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj‘ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj(‘hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‘ubj")”}”(hŒvoid”h]”hŒvoid”…””}”(hj6‘hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj‘ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjD‘hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‘ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjR‘hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj‘ubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hj_‘hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‘ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjRubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj{‘hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjx‘ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j}‘Œmodname”NŒ classname”Nj°j³)”}”j¶]”j'Œc.sg_copy_from_buffer”†”asbuh1hhjt‘ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj™‘hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjt‘ubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hj§‘hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjt‘ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjRubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjhžhhŸj,h MÕubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjhžhhŸj,h MÕubah}”(h]”jûah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj,h MÕhjýhžhubjú)”}”(hhh]”hØ)”}”(hŒ'Copy from a linear buffer to an SG list”h]”hŒ'Copy from a linear buffer to an SG list”…””}”(hjÑ‘hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÕhjÎ‘hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjýhžhhŸj,h MÕubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjé‘jjé‘j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒù**Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``const void *buf`` Where to copy from ``size_t buflen`` The number of bytes to copy **Description** Returns the number of copied bytes.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjó‘h]”hŒ Parameters”…””}”(hjõ‘hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjñ‘ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÙhjí‘ubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hj’h]”hŒstruct scatterlist *sgl”…””}”(hj’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÖhj’ubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hj+’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj'’h MÖhj(’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj'’h MÖhj ’ubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hjK’h]”hŒunsigned int nents”…””}”(hjM’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjI’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M×hjE’ubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hjd’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj`’h M×hja’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjE’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj`’h M×hj ’ubjF)”}”(hŒ'``const void *buf`` Where to copy from ”h]”(jL)”}”(hŒ``const void *buf``”h]”jÒ)”}”(hj„’h]”hŒconst void *buf”…””}”(hj†’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj‚’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MØhj~’ubjf)”}”(hhh]”hØ)”}”(hŒWhere to copy from”h]”hŒWhere to copy from”…””}”(hj’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj™’h MØhjš’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj~’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj™’h MØhj ’ubjF)”}”(hŒ.``size_t buflen`` The number of bytes to copy ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hj½’h]”hŒ size_t buflen”…””}”(hj¿’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj»’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÙhj·’ubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to copy”h]”hŒThe number of bytes to copy”…””}”(hjÖ’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjÒ’h MÙhjÓ’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj·’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjÒ’h MÙhj ’ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjí‘ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjø’h]”hŒDescription”…””}”(hjú’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjö’ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÛhjí‘ubhØ)”}”(hŒ#Returns the number of copied bytes.”h]”hŒ#Returns the number of copied bytes.”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MÚhjí‘ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_copy_to_buffer (C function)”Œc.sg_copy_to_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ`size_t sg_copy_to_buffer (struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen)”h]”jg)”}”(hŒ_size_t sg_copy_to_buffer(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj@“hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj=“ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jB“Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_copy_to_buffer”sbŒc.sg_copy_to_buffer”†”asbuh1hhj9“hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mæubj)”}”(hŒ ”h]”hŒ ”…””}”(hjb“hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj9“hžhhŸja“h Mæubjß)”}”(hŒsg_copy_to_buffer”h]”j“)”}”(hj^“h]”hŒsg_copy_to_buffer”…””}”(hjt“hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjp“ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj9“hžhhŸja“h Mæubjú)”}”(hŒG(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj‹“ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjœ“hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‹“ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjª“ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¯“Œmodname”NŒ classname”Nj°j³)”}”j¶]”j\“Œc.sg_copy_to_buffer”†”asbuh1hhj‹“ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjË“hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj‹“ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjÙ“hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj‹“ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hjæ“hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj‹“ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‡“ubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÿ“hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjû“ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj ”hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjû“ubj")”}”(hŒint”h]”hŒint”…””}”(hj”hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjû“ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj)”hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjû“ubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj7”hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjû“ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‡“ubj)”}”(hŒ void *buf”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hjP”hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjL”ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj^”hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjL”ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjl”hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjL”ubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hjy”hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjL”ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‡“ubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj•”hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj’”ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j—”Œmodname”NŒ classname”Nj°j³)”}”j¶]”j\“Œc.sg_copy_to_buffer”†”asbuh1hhjŽ”ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj³”hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjŽ”ubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hjÁ”hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŽ”ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj‡“ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj9“hžhhŸja“h Mæubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj5“hžhhŸja“h Mæubah}”(h]”j0“ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸja“h Mæhj2“hžhubjú)”}”(hhh]”hØ)”}”(hŒ'Copy from an SG list to a linear buffer”h]”hŒ'Copy from an SG list to a linear buffer”…””}”(hjë”hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mæhjè”hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj2“hžhhŸja“h Mæubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj•jj•j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hŒñ**Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``void *buf`` Where to copy to ``size_t buflen`` The number of bytes to copy **Description** Returns the number of copied bytes.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj •h]”hŒ Parameters”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj•ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mêhj•ubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hj,•h]”hŒstruct scatterlist *sgl”…””}”(hj.•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj*•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mçhj&•ubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hjE•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjA•h MçhjB•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj&•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjA•h Mçhj#•ubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hje•h]”hŒunsigned int nents”…””}”(hjg•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjc•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mèhj_•ubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hj~•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjz•h Mèhj{•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj_•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjz•h Mèhj#•ubjF)”}”(hŒ``void *buf`` Where to copy to ”h]”(jL)”}”(hŒ ``void *buf``”h]”jÒ)”}”(hjž•h]”hŒ void *buf”…””}”(hj •hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjœ•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Méhj˜•ubjf)”}”(hhh]”hØ)”}”(hŒWhere to copy to”h]”hŒWhere to copy to”…””}”(hj·•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj³•h Méhj´•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj˜•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj³•h Méhj#•ubjF)”}”(hŒ.``size_t buflen`` The number of bytes to copy ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hj×•h]”hŒ size_t buflen”…””}”(hjÙ•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÕ•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MêhjÑ•ubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to copy”h]”hŒThe number of bytes to copy”…””}”(hjð•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjì•h Mêhjí•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÑ•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjì•h Mêhj#•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj•ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hj–h]”hŒDescription”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj–ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mìhj•ubhØ)”}”(hŒ#Returns the number of copied bytes.”h]”hŒ#Returns the number of copied bytes.”…””}”(hj(–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mëhj•ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒ!sg_pcopy_from_buffer (C function)”Œc.sg_pcopy_from_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒusize_t sg_pcopy_from_buffer (struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen, off_t skip)”h]”jg)”}”(hŒtsize_t sg_pcopy_from_buffer(struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen, off_t skip)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjZ–hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjW–ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j\–Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_pcopy_from_buffer”sbŒc.sg_pcopy_from_buffer”†”asbuh1hhjS–hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M÷ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj|–hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjS–hžhhŸj{–h M÷ubjß)”}”(hŒsg_pcopy_from_buffer”h]”j“)”}”(hjx–h]”hŒsg_pcopy_from_buffer”…””}”(hjŽ–hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠ–ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjS–hžhhŸj{–h M÷ubjú)”}”(hŒY(struct scatterlist *sgl, unsigned int nents, const void *buf, size_t buflen, off_t skip)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj©–hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj¥–ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¶–hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¥–ubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjÇ–hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÄ–ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÉ–Œmodname”NŒ classname”Nj°j³)”}”j¶]”jv–Œc.sg_pcopy_from_buffer”†”asbuh1hhj¥–ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjå–hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¥–ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjó–hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj¥–ubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¥–ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡–ubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj—ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj'—hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj—ubj")”}”(hŒint”h]”hŒint”…””}”(hj5—hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj—ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjC—hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj—ubj“)”}”(hŒnents”h]”hŒnents”…””}”(hjQ—hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj—ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡–ubj)”}”(hŒconst void *buf”h]”(jm)”}”(hjh]”hŒconst”…””}”(hjj—hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjf—ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjw—hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjf—ubj")”}”(hŒvoid”h]”hŒvoid”…””}”(hj…—hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjf—ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj“—hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjf—ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¡—hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjf—ubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hj®—hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjf—ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡–ubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjÊ—hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÇ—ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÌ—Œmodname”NŒ classname”Nj°j³)”}”j¶]”jv–Œc.sg_pcopy_from_buffer”†”asbuh1hhjÃ—ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjè—hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÃ—ubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hjö—hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÃ—ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡–ubj)”}”(hŒ off_t skip”h]”(h)”}”(hhh]”j“)”}”(hŒoff_t”h]”hŒoff_t”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj˜ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j˜Œmodname”NŒ classname”Nj°j³)”}”j¶]”jv–Œc.sg_pcopy_from_buffer”†”asbuh1hhj˜ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj0˜hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj˜ubj“)”}”(hŒskip”h]”hŒskip”…””}”(hj>˜hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj˜ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡–ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjS–hžhhŸj{–h M÷ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjO–hžhhŸj{–h M÷ubah}”(h]”jJ–ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj{–h M÷hjL–hžhubjú)”}”(hhh]”hØ)”}”(hŒ'Copy from a linear buffer to an SG list”h]”hŒ'Copy from a linear buffer to an SG list”…””}”(hjh˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M÷hje˜hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjL–hžhhŸj{–h M÷ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj€˜jj€˜j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX2**Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``const void *buf`` Where to copy from ``size_t buflen`` The number of bytes to copy ``off_t skip`` Number of bytes to skip before copying **Description** Returns the number of copied bytes.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hjŠ˜h]”hŒ Parameters”…””}”(hjŒ˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjˆ˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mûhj„˜ubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hj©˜h]”hŒstruct scatterlist *sgl”…””}”(hj«˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj§˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Møhj£˜ubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hjÂ˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¾˜h Møhj¿˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj£˜ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¾˜h Møhj ˜ubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hjâ˜h]”hŒunsigned int nents”…””}”(hjä˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjà˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MùhjÜ˜ubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hjû˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj÷˜h Mùhjø˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÜ˜ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj÷˜h Mùhj ˜ubjF)”}”(hŒ'``const void *buf`` Where to copy from ”h]”(jL)”}”(hŒ``const void *buf``”h]”jÒ)”}”(hj™h]”hŒconst void *buf”…””}”(hj™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Múhj™ubjf)”}”(hhh]”hØ)”}”(hŒWhere to copy from”h]”hŒWhere to copy from”…””}”(hj4™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj0™h Múhj1™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj™ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj0™h Múhj ˜ubjF)”}”(hŒ.``size_t buflen`` The number of bytes to copy ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hjT™h]”hŒ size_t buflen”…””}”(hjV™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjR™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MûhjN™ubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to copy”h]”hŒThe number of bytes to copy”…””}”(hjm™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸji™h Mûhjj™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjN™ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸji™h Mûhj ˜ubjF)”}”(hŒ6``off_t skip`` Number of bytes to skip before copying ”h]”(jL)”}”(hŒ``off_t skip``”h]”jÒ)”}”(hj™h]”hŒ off_t skip”…””}”(hj™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj‹™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mühj‡™ubjf)”}”(hhh]”hØ)”}”(hŒ&Number of bytes to skip before copying”h]”hŒ&Number of bytes to skip before copying”…””}”(hj¦™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj¢™h Mühj£™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj‡™ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj¢™h Mühj ˜ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hj„˜ubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjÈ™h]”hŒDescription”…””}”(hjÊ™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÆ™ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mþhj„˜ubhØ)”}”(hŒ#Returns the number of copied bytes.”h]”hŒ#Returns the number of copied bytes.”…””}”(hjÞ™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mýhj„˜ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_pcopy_to_buffer (C function)”Œc.sg_pcopy_to_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒmsize_t sg_pcopy_to_buffer (struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip)”h]”jg)”}”(hŒlsize_t sg_pcopy_to_buffer(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj šubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jšŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_pcopy_to_buffer”sbŒc.sg_pcopy_to_buffer”†”asbuh1hhj šhžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj2šhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj šhžhhŸj1šh M ubjß)”}”(hŒsg_pcopy_to_buffer”h]”j“)”}”(hj.šh]”hŒsg_pcopy_to_buffer”…””}”(hjDšhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj@šubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj šhžhhŸj1šh M ubjú)”}”(hŒS(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj_šhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj[šubj)”}”(hŒ ”h]”hŒ ”…””}”(hjlšhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj[šubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj}šhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjzšubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jšŒmodname”NŒ classname”Nj°j³)”}”j¶]”j,šŒc.sg_pcopy_to_buffer”†”asbuh1hhj[šubj)”}”(hŒ ”h]”hŒ ”…””}”(hj›šhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj[šubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj©šhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj[šubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hj¶šhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj[šubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjWšubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjÏšhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjËšubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÝšhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjËšubj")”}”(hŒint”h]”hŒint”…””}”(hjëšhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjËšubj)”}”(hŒ ”h]”hŒ ”…””}”(hjùšhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjËšubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjËšubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjWšubj)”}”(hŒ void *buf”h]”(j")”}”(hŒvoid”h]”hŒvoid”…””}”(hj ›hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj›ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj.›hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj›ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj<›hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj›ubj“)”}”(hŒbuf”h]”hŒbuf”…””}”(hjI›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj›ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjWšubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hje›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjb›ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jg›Œmodname”NŒ classname”Nj°j³)”}”j¶]”j,šŒc.sg_pcopy_to_buffer”†”asbuh1hhj^›ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjƒ›hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj^›ubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hj‘›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj^›ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjWšubj)”}”(hŒ off_t skip”h]”(h)”}”(hhh]”j“)”}”(hŒoff_t”h]”hŒoff_t”…””}”(hj›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjª›ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¯›Œmodname”NŒ classname”Nj°j³)”}”j¶]”j,šŒc.sg_pcopy_to_buffer”†”asbuh1hhj¦›ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjË›hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¦›ubj“)”}”(hŒskip”h]”hŒskip”…””}”(hjÙ›hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¦›ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjWšubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj šhžhhŸj1šh M ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjšhžhhŸj1šh M ubah}”(h]”jšah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸj1šh M hjšhžhubjú)”}”(hhh]”hØ)”}”(hŒ'Copy from an SG list to a linear buffer”h]”hŒ'Copy from an SG list to a linear buffer”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M hjœhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjšhžhhŸj1šh M ubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjœjjœj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX***Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``void *buf`` Where to copy to ``size_t buflen`` The number of bytes to copy ``off_t skip`` Number of bytes to skip before copying **Description** Returns the number of copied bytes.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj%œh]”hŒ Parameters”…””}”(hj'œhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj#œubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M hjœubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjDœh]”hŒstruct scatterlist *sgl”…””}”(hjFœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjBœubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M hj>œubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hj]œhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjYœh M hjZœubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj>œubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjYœh M hj;œubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hj}œh]”hŒunsigned int nents”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj{œubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhjwœubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hj–œhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj’œh Mhj“œubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjwœubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj’œh Mhj;œubjF)”}”(hŒ``void *buf`` Where to copy to ”h]”(jL)”}”(hŒ ``void *buf``”h]”jÒ)”}”(hj¶œh]”hŒ void *buf”…””}”(hj¸œhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj´œubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj°œubjf)”}”(hhh]”hØ)”}”(hŒWhere to copy to”h]”hŒWhere to copy to”…””}”(hjÏœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjËœh MhjÌœubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj°œubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjËœh Mhj;œubjF)”}”(hŒ.``size_t buflen`` The number of bytes to copy ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hjïœh]”hŒ size_t buflen”…””}”(hjñœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjíœubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M hjéœubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to copy”h]”hŒThe number of bytes to copy”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjh M hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjéœubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjh M hj;œubjF)”}”(hŒ6``off_t skip`` Number of bytes to skip before copying ”h]”(jL)”}”(hŒ``off_t skip``”h]”jÒ)”}”(hj(h]”hŒ off_t skip”…””}”(hj*hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj"ubjf)”}”(hhh]”hØ)”}”(hŒ&Number of bytes to skip before copying”h]”hŒ&Number of bytes to skip before copying”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj=h Mhj>ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj"ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj=h Mhj;œubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjœubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjch]”hŒDescription”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjaubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjœubhØ)”}”(hŒ#Returns the number of copied bytes.”h]”hŒ#Returns the number of copied bytes.”…””}”(hjyhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhjœubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒsg_zero_buffer (C function)”Œc.sg_zero_buffer”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ^size_t sg_zero_buffer (struct scatterlist *sgl, unsigned int nents, size_t buflen, off_t skip)”h]”jg)”}”(hŒ]size_t sg_zero_buffer(struct scatterlist *sgl, unsigned int nents, size_t buflen, off_t skip)”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¨ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŒmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œsg_zero_buffer”sbŒc.sg_zero_buffer”†”asbuh1hhj¤hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÍhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¤hžhhŸjÌh Mubjß)”}”(hŒsg_zero_buffer”h]”j“)”}”(hjÉh]”hŒsg_zero_buffer”…””}”(hjßhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÛubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhj¤hžhhŸjÌh Mubjú)”}”(hŒH(struct scatterlist *sgl, unsigned int nents, size_t buflen, off_t skip)”h]”(j)”}”(hŒstruct scatterlist *sgl”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjúhžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjöubj)”}”(hŒ ”h]”hŒ ”…””}”(hjžhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjöubh)”}”(hhh]”j“)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjžhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjžubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jžŒmodname”NŒ classname”Nj°j³)”}”j¶]”jÇŒc.sg_zero_buffer”†”asbuh1hhjöubj)”}”(hŒ ”h]”hŒ ”…””}”(hj6žhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjöubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjDžhžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjöubj“)”}”(hŒsgl”h]”hŒsgl”…””}”(hjQžhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjöubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjòubj)”}”(hŒunsigned int nents”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjjžhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjfžubj)”}”(hŒ ”h]”hŒ ”…””}”(hjxžhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjfžubj")”}”(hŒint”h]”hŒint”…””}”(hj†žhžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hjfžubj)”}”(hŒ ”h]”hŒ ”…””}”(hj”žhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjfžubj“)”}”(hŒnents”h]”hŒnents”…””}”(hj¢žhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjfžubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjòubj)”}”(hŒ size_t buflen”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj¾žhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj»žubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÀžŒmodname”NŒ classname”Nj°j³)”}”j¶]”jÇŒc.sg_zero_buffer”†”asbuh1hhj·žubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÜžhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj·žubj“)”}”(hŒbuflen”h]”hŒbuflen”…””}”(hjêžhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj·žubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjòubj)”}”(hŒ off_t skip”h]”(h)”}”(hhh]”j“)”}”(hŒoff_t”h]”hŒoff_t”…””}”(hjŸhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŸubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jŸŒmodname”NŒ classname”Nj°j³)”}”j¶]”jÇŒc.sg_zero_buffer”†”asbuh1hhjÿžubj)”}”(hŒ ”h]”hŒ ”…””}”(hj$ŸhžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÿžubj“)”}”(hŒskip”h]”hŒskip”…””}”(hj2ŸhžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÿžubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhjòubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhj¤hžhhŸjÌh Mubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhj hžhhŸjÌh Mubah}”(h]”j›ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjÌh Mhjhžhubjú)”}”(hhh]”hØ)”}”(hŒZero-out a part of a SG list”h]”hŒZero-out a part of a SG list”…””}”(hj\ŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjYŸhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhjhžhhŸjÌh Mubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjjtŸjjtŸj‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX**Parameters** ``struct scatterlist *sgl`` The SG list ``unsigned int nents`` Number of SG entries ``size_t buflen`` The number of bytes to zero out ``off_t skip`` Number of bytes to skip before zeroing **Description** Returns the number of bytes zeroed.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj~Ÿh]”hŒ Parameters”…””}”(hj€ŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj|Ÿubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjxŸubjA)”}”(hhh]”(jF)”}”(hŒ(``struct scatterlist *sgl`` The SG list ”h]”(jL)”}”(hŒ``struct scatterlist *sgl``”h]”jÒ)”}”(hjŸh]”hŒstruct scatterlist *sgl”…””}”(hjŸŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj›Ÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj—Ÿubjf)”}”(hhh]”hØ)”}”(hŒThe SG list”h]”hŒThe SG list”…””}”(hj¶ŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj²Ÿh Mhj³Ÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj—Ÿubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj²Ÿh Mhj”ŸubjF)”}”(hŒ,``unsigned int nents`` Number of SG entries ”h]”(jL)”}”(hŒ``unsigned int nents``”h]”jÒ)”}”(hjÖŸh]”hŒunsigned int nents”…””}”(hjØŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÔŸubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjÐŸubjf)”}”(hhh]”hØ)”}”(hŒNumber of SG entries”h]”hŒNumber of SG entries”…””}”(hjïŸhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjëŸh MhjìŸubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjÐŸubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjëŸh Mhj”ŸubjF)”}”(hŒ2``size_t buflen`` The number of bytes to zero out ”h]”(jL)”}”(hŒ``size_t buflen``”h]”jÒ)”}”(hj h]”hŒ size_t buflen”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mhj ubjf)”}”(hhh]”hØ)”}”(hŒThe number of bytes to zero out”h]”hŒThe number of bytes to zero out”…””}”(hj( hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj$ h Mhj% ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj$ h Mhj”ŸubjF)”}”(hŒ6``off_t skip`` Number of bytes to skip before zeroing ”h]”(jL)”}”(hŒ``off_t skip``”h]”jÒ)”}”(hjH h]”hŒ off_t skip”…””}”(hjJ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjF ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MhjB ubjf)”}”(hhh]”hØ)”}”(hŒ&Number of bytes to skip before zeroing”h]”hŒ&Number of bytes to skip before zeroing”…””}”(hja hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj] h Mhj^ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehjB ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj] h Mhj”Ÿubeh}”(h]”h ]”h"]”h$]”h&]”uh1j@hjxŸubhØ)”}”(hŒ**Description**”h]”j+)”}”(hjƒ h]”hŒDescription”…””}”(hj… hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M!hjxŸubhØ)”}”(hŒ#Returns the number of bytes zeroed.”h]”hŒ#Returns the number of bytes zeroed.”…””}”(hj™ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M hjxŸubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh NubjK)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jWŒextract_iter_to_sg (C function)”Œc.extract_iter_to_sg”hNt”auh1jJhj¨"hžhhŸNh Nubj\)”}”(hhh]”(ja)”}”(hŒ™ssize_t extract_iter_to_sg (struct iov_iter *iter, size_t maxsize, struct sg_table *sgtable, unsigned int sg_max, iov_iter_extraction_t extraction_flags)”h]”jg)”}”(hŒ˜ssize_t extract_iter_to_sg(struct iov_iter *iter, size_t maxsize, struct sg_table *sgtable, unsigned int sg_max, iov_iter_extraction_t extraction_flags)”h]”(h)”}”(hhh]”j“)”}”(hŒssize_t”h]”hŒssize_t”…””}”(hjË hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÈ ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jÍ Œmodname”NŒ classname”Nj°j³)”}”j¶]”j¹)”}”j¬Œextract_iter_to_sg”sbŒc.extract_iter_to_sg”†”asbuh1hhjÄ hžhhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MMubj)”}”(hŒ ”h]”hŒ ”…””}”(hjí hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÄ hžhhŸjì h MMubjß)”}”(hŒextract_iter_to_sg”h]”j“)”}”(hjé h]”hŒextract_iter_to_sg”…””}”(hjÿ hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjû ubah}”(h]”h ]”(jôjõeh"]”h$]”h&]”jj‚uh1jÞhjÄ hžhhŸjì h MMubjú)”}”(hŒ~(struct iov_iter *iter, size_t maxsize, struct sg_table *sgtable, unsigned int sg_max, iov_iter_extraction_t extraction_flags)”h]”(j)”}”(hŒstruct iov_iter *iter”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhj¡ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj'¡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¡ubh)”}”(hhh]”j“)”}”(hŒiov_iter”h]”hŒiov_iter”…””}”(hj8¡hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj5¡ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j:¡Œmodname”NŒ classname”Nj°j³)”}”j¶]”jç Œc.extract_iter_to_sg”†”asbuh1hhj¡ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjV¡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¡ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hjd¡hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhj¡ubj“)”}”(hŒiter”h]”hŒiter”…””}”(hjq¡hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¡ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡ubj)”}”(hŒsize_t maxsize”h]”(h)”}”(hhh]”j“)”}”(hŒsize_t”h]”hŒsize_t”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjŠ¡ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j¡Œmodname”NŒ classname”Nj°j³)”}”j¶]”jç Œc.extract_iter_to_sg”†”asbuh1hhj†¡ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj«¡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj†¡ubj“)”}”(hŒmaxsize”h]”hŒmaxsize”…””}”(hj¹¡hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj†¡ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡ubj)”}”(hŒstruct sg_table *sgtable”h]”(jm)”}”(hjph]”hŒstruct”…””}”(hjÒ¡hžhhŸNh Nubah}”(h]”h ]”jyah"]”h$]”h&]”uh1jlhjÎ¡ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjß¡hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎ¡ubh)”}”(hhh]”j“)”}”(hŒsg_table”h]”hŒsg_table”…””}”(hjð¡hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjí¡ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”jò¡Œmodname”NŒ classname”Nj°j³)”}”j¶]”jç Œc.extract_iter_to_sg”†”asbuh1hhjÎ¡ubj)”}”(hŒ ”h•£7]”hŒ ”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hjÎ¡ubjÎ)”}”(hjÑh]”hŒ*”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”jÚah"]”h$]”h&]”uh1jÍhjÎ¡ubj“)”}”(hŒsgtable”h]”hŒsgtable”…””}”(hj)¢hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hjÎ¡ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡ubj)”}”(hŒunsigned int sg_max”h]”(j")”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjB¢hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj>¢ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjP¢hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj>¢ubj")”}”(hŒint”h]”hŒint”…””}”(hj^¢hžhhŸNh Nubah}”(h]”h ]”j.ah"]”h$]”h&]”uh1j!hj>¢ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjl¢hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj>¢ubj“)”}”(hŒsg_max”h]”hŒsg_max”…””}”(hjz¢hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj>¢ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡ubj)”}”(hŒ&iov_iter_extraction_t extraction_flags”h]”(h)”}”(hhh]”j“)”}”(hŒiov_iter_extraction_t”h]”hŒiov_iter_extraction_t”…””}”(hj–¢hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj“¢ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”jªŒreftype”j¬Œ reftarget”j˜¢Œmodname”NŒ classname”Nj°j³)”}”j¶]”jç Œc.extract_iter_to_sg”†”asbuh1hhj¢ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj´¢hžhhŸNh Nubah}”(h]”h ]”j‹ah"]”h$]”h&]”uh1j~hj¢ubj“)”}”(hŒextraction_flags”h]”hŒextraction_flags”…””}”(hjÂ¢hžhhŸNh Nubah}”(h]”h ]”jŸah"]”h$]”h&]”uh1j’hj¢ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆjj‚uh1jÿhj¡ubeh}”(h]”h ]”h"]”h$]”h&]”jj‚uh1jùhjÄ hžhhŸjì h MMubeh}”(h]”h ]”h"]”h$]”h&]”jj‚jëˆuh1jfjìjíhjÀ hžhhŸjì h MMubah}”(h]”j» ah ]”(jñjòeh"]”h$]”h&]”jöˆj÷)jøhuh1j`hŸjì h MMhj½ hžhubjú)”}”(hhh]”hØ)”}”(hŒ3Extract pages from an iterator and add to an sglist”h]”hŒ3Extract pages from an iterator and add to an sglist”…””}”(hjì¢hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MMhjé¢hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jùhj½ hžhhŸjì h MMubeh}”(h]”h ]”(jªŒfunction”eh"]”h$]”h&]”jjªjj£jj£j‰j‰j‰uh1j[hžhhj¨"hŸNh Nubj!)”}”(hX¨**Parameters** ``struct iov_iter *iter`` The iterator to extract from ``size_t maxsize`` The amount of iterator to copy ``struct sg_table *sgtable`` The scatterlist table to fill in ``unsigned int sg_max`` Maximum number of elements in **sgtable** that may be filled ``iov_iter_extraction_t extraction_flags`` Flags to qualify the request **Description** Extract the page fragments from the given amount of the source iterator and add them to a scatterlist that refers to all of those bits, to a maximum addition of **sg_max** elements. The pages referred to by UBUF- and IOVEC-type iterators are extracted and pinned; BVEC-, KVEC-, FOLIOQ- and XARRAY-type are extracted but aren't pinned; DISCARD-type is not supported. No end mark is placed on the scatterlist; that's left to the caller. **extraction_flags** can have ITER_ALLOW_P2PDMA set to request peer-to-peer DMA be allowed on the pages extracted. If successful, **sgtable->nents** is updated to include the number of elements added and the number of bytes added is returned. **sgtable->orig_nents** is left unaltered. The iov_iter_extract_mode() function should be used to query how cleanup should be performed.”h]”(hØ)”}”(hŒ**Parameters**”h]”j+)”}”(hj£h]”hŒ Parameters”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hj£ubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MQhj£ubjA)”}”(hhh]”(jF)”}”(hŒ7``struct iov_iter *iter`` The iterator to extract from ”h]”(jL)”}”(hŒ``struct iov_iter *iter``”h]”jÒ)”}”(hj-£h]”hŒstruct iov_iter *iter”…””}”(hj/£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj+£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MNhj'£ubjf)”}”(hhh]”hØ)”}”(hŒThe iterator to extract from”h]”hŒThe iterator to extract from”…””}”(hjF£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸjB£h MNhjC£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj'£ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸjB£h MNhj$£ubjF)”}”(hŒ2``size_t maxsize`` The amount of iterator to copy ”h]”(jL)”}”(hŒ``size_t maxsize``”h]”jÒ)”}”(hjf£h]”hŒsize_t maxsize”…””}”(hjh£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjd£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MOhj`£ubjf)”}”(hhh]”hØ)”}”(hŒThe amount of iterator to copy”h]”hŒThe amount of iterator to copy”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj{£h MOhj|£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj`£ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj{£h MOhj$£ubjF)”}”(hŒ>``struct sg_table *sgtable`` The scatterlist table to fill in ”h]”(jL)”}”(hŒ``struct sg_table *sgtable``”h]”jÒ)”}”(hjŸ£h]”hŒstruct sg_table *sgtable”…””}”(hj¡£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MPhj™£ubjf)”}”(hhh]”hØ)”}”(hŒ The scatterlist table to fill in”h]”hŒ The scatterlist table to fill in”…””}”(hj¸£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸj´£h MPhjµ£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jehj™£ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jEhŸj´£h MPhj$£ubjF)”}”(hŒU``unsigned int sg_max`` Maximum number of elements in **sgtable** that may be filled ”h]”(jL)”}”(hŒ``unsigned int sg_max``”h]”jÒ)”}”(hjØ£h]”hŒunsigned int sg_max”…””}”(hjÚ£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÖ£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h MQhjÒ£ubjf)”}”(hhh]”hØ)”}”(hŒnents** is updated to include the number of elements added and the number of bytes added is returned. **sgtable->orig_nents** is left unaltered.”h]”(hŒIf successful, ”…””}”(hjÐ¤hžhhŸNh Nubj+)”}”(hŒ**sgtable->nents**”h]”hŒsgtable->nents”…””}”(hjØ¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÐ¤ubhŒ` is updated to include the number of elements added and the number of bytes added is returned. ”…””}”(hjÐ¤hžhhŸNh Nubj+)”}”(hŒ**sgtable->orig_nents**”h]”hŒsgtable->orig_nents”…””}”(hjê¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j*hjÐ¤ubhŒ is left unaltered.”…””}”(hjÐ¤hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h M`hj£ubhØ)”}”(hŒ]The iov_iter_extract_mode() function should be used to query how cleanup should be performed.”h]”hŒ]The iov_iter_extract_mode() function should be used to query how cleanup should be performed.”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸŒS/var/lib/git/docbuild/linux/Documentation/core-api/dma-api:868: ./lib/scatterlist.c”h Mdhj£ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j hj¨"hžhhŸNh Nubeh}”(h]”Œfunctions-and-structures”ah ]”h"]”Œfunctions and structures”ah$]”h&]”uh1h¡hjÐhžhhŸh¶h Maubeh}”(h]”Œ)part-iii-debug-drivers-use-of-the-dma-api”ah ]”h"]”Œ+part iii - debug drivers use of the dma api”ah$]”h&]”uh1h¡hh£hžhhŸh¶h MÔubeh}”(h]”Œ,dynamic-dma-mapping-using-the-generic-device”ah ]”h"]”Œ,dynamic dma mapping using the generic device”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”j}Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jS¥Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j.¥j+¥j]jZjjj[jXj¶j³j%j"jxjujÍjÊj&¥j#¥j¥j¥uŒ nametypes”}”(j.¥‰j]‰j‰j[‰j¶‰j%‰jx‰jÍ‰j&¥‰j¥‰uh}”(j+¥h£jZj+jj`jXjjYjbjbjgj j j¹j¾j6j;jDjIjÅjÊj³j^j"j¹juj(jÊj{j#¥jÐj¥j¨"jÅ"jÊ"jŸ$j¤$jÓ&jØ&j*j *jQ-jV-jÌ/jÑ/j2j²2j84j=4jÂ5jÇ5jM7jR7jØ8jÝ8jb:jg:jì;jñ;jw=j|=j?j?j@j²@j’Bj—BjGjGj¯Hj´HjJj"JjÒKj×KjˆMjMjOj Oj€Pj…PjRjRj*Tj/Tj¿VjÄVjÔXjÙXjO[jT[j_j_jt`jy`jÏajÔaj`gjegjjj jjõojúoj'uj,ujyjyjå{jê{j€~j…~jI€jN€j¤j©j%…j*…jØ‡jÝ‡jŠj!Šjò‹j÷‹jûjj0“j5“jJ–jO–jšjšj›j j» jÀ uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ decoration”Nhžhub.