Re: [PATCH v2 7/8] docs: dma-api: update streaming DMA physical address constraints

From: Randy Dunlap
Date: Sat Jun 28 2025 - 14:59:48 EST




On 6/27/25 3:10 AM, Petr Tesarik wrote:
> Add an introductory paragraph to Part Id - Streaming DMA mappings and move
> the explanation of address constraints there, because it applies to all map
> functions.
>
> Clarify that streaming DMA can be used with memory which does not meet the
> addressing constraints of a device, but it may fail in that case.
>
> Make a note about SWIOTLB and link to the detailed description of it.
>
> Do not mention platform-dependent allocation flags. The note may mislead
> device driver authors into thinking that they should poke into and try to
> second-guess the DMA API implementation. They definitely shouldn't.
>
> Remove the claim that platforms with an IOMMU may not require physically
> contiguous buffers. The current implementation explicitly rejects vmalloc
> addresses, regardless of IOMMU.
>
> Signed-off-by: Petr Tesarik <ptesarik@xxxxxxxx>

Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

Thanks.

> ---
> Documentation/core-api/dma-api.rst | 36 +++++++++++++++++-------------
> 1 file changed, 21 insertions(+), 15 deletions(-)

--
~Randy