Changes in dma-api.rst

5483cc3d - docs: dma-api: Fix description of the sync_sg API

Fri, 03 Nov 2023 16:21:20 +0000

docs: dma-api: Fix description of the sync_sg APIFix the description of the parameters to dma_sync_sg*. They should be thesame as the parameters to dma_map_sg(), not dma_map_single().Signed-off-by: Brian Johannesmeyer Signed-off-by: Jonathan Corbet Message-ID: <20231103162120.3474026-1-bjohannesmeyer@gmail.com> List of files: /linux-6.15/Documentation/core-api/dma-api.rst

353c7dd6 - docs/mm: Physical Memory: remove useless markup

Wed, 01 Feb 2023 09:41:54 +0000

docs/mm: Physical Memory: remove useless markupJon says: > +See also :ref:`Page Reclaim `. Can also just be "See also Documentation/mm/page_reclaim.rst". The right things will happen in the HTML output, readers of the plain-text will know immediately where to go, and we don't have to add the label clutter.Remove reference markup and unnecessary labes and use plain file names.Fixes: 5d8c5e430a63 ("docs/mm: Physical Memory: add structure, introduction and nodes description")Suggested-by: Jonathan Corbet Acked-by: Bagas Sanjaya Signed-off-by: Mike Rapoport (IBM) Link: https://lore.kernel.org/r/20230201094156.991542-2-rppt@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/core-api/dma-api.rst

5d8c5e43 - docs/mm: Physical Memory: add structure, introduction and nodes description

Wed, 25 Jan 2023 19:28:41 +0000

docs/mm: Physical Memory: add structure, introduction and nodes descriptionAdd structure, introduction and Nodes section to Physical Memorychapter.As the new documentation references core-api/dma-api and mm/page_reclaim,add page labels to those documents.Reviewed-by: Bagas Sanjaya Reviewed-by: Lorenzo Stoakes Acked-by: Michal Hocko Acked-by: Vlastimil Babka Signed-off-by: Mike Rapoport (IBM) Link: https://lore.kernel.org/r/20230125192841.25342-2-rppt@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/core-api/dma-api.rst

a229cc14 - dma-mapping: add dma_opt_mapping_size()

Thu, 14 Jul 2022 11:15:24 +0000

dma-mapping: add dma_opt_mapping_size()Streaming DMA mapping involving an IOMMU may be much slower for largertotal mapping size. This is because every IOMMU DMA mapping requires anIOVA to be allocated and freed. IOVA sizes above a certain limit are notcached, which can have a big impact on DMA mapping performance.Provide an API for device drivers to know this "optimal" limit, such thatthey may try to produce mapping which don't exceed it.Signed-off-by: John Garry Reviewed-by: Damien Le Moal Acked-by: Martin K. Petersen Signed-off-by: Christoph Hellwig List of files: /linux-6.15/Documentation/core-api/dma-api.rst

a822b2ee - docs: core-api: avoid using ReST :doc:`foo` markup

Wed, 16 Jun 2021 06:27:23 +0000

docs: core-api: avoid using ReST :doc:`foo` markupThe :doc:`foo` tag is auto-generated via automarkup.py.So, use the filename at the sources, instead of :doc:`foo`.Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/d967d490b6655735b7df292f88859b5a1b07d0d7.1623824363.git.mchehab+huawei@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/core-api/dma-api.rst

7d5b5738 - dma-mapping: add a dma_alloc_noncontiguous API

Thu, 28 Jan 2021 13:54:18 +0000

dma-mapping: add a dma_alloc_noncontiguous APIAdd a new API that returns a potentiall virtually non-contigous sg_tableand a DMA address. This API is only properly implemented for dma-iommuand will simply return a contigious chunk as a fallback.The intent is that drivers can use this API if either: - no kernel mapping or only temporary kernel mappings are required. That is as a better replacement for DMA_ATTR_NO_KERNEL_MAPPING - a kernel mapping is required for cached and DMA mapped pages, but the driver also needs the pages to e.g. map them to userspace. In that sense it is a replacement for some aspects of the recently removed and never fully implemented DMA_ATTR_NON_CONSISTENTSigned-off-by: Christoph Hellwig Reviewed-by: Tomasz Figa Tested-by: Ricardo Ribalda List of files: /linux-6.15/Documentation/core-api/dma-api.rst

eedb0b12 - dma-mapping: add a dma_mmap_pages helper

Thu, 28 Jan 2021 13:53:22 +0000

dma-mapping: add a dma_mmap_pages helperAdd a helper to map memory allocated using dma_alloc_pages intoa user address space, similar to the dma_alloc_attrs function forcoherent allocations.Signed-off-by: Christoph Hellwig Reviewed-by: Tomasz Figa Tested-by: Ricardo Ribalda List of files: /linux-6.15/Documentation/core-api/dma-api.rst

81d88ce5 - dma-mapping: remove the {alloc,free}_noncoherent methods

Tue, 24 Nov 2020 15:38:40 +0000

dma-mapping: remove the {alloc,free}_noncoherent methodsIt turns out allowing non-contigous allocations here was a rather badidea, as we'll now need to define ways to get the pages for mmapingor dma_buf sharing. Revert this change and stick to the originalconcept. A different API for the use case of non-contigous allocationswill be added back later.Signed-off-by: Christoph Hellwig Reviewed-by: Tomasz Figa Tested-by: Ricardo Ribalda :wq List of files: /linux-6.15/Documentation/core-api/dma-api.rst

6857a5eb - dma-mapping: document dma_{alloc,free}_pages

Sat, 26 Sep 2020 14:11:03 +0000

dma-mapping: document dma_{alloc,free}_pagesDocument the new dma_alloc_pages and dma_free_pages APIs, and fixup the documentation for dma_alloc_noncoherent and dma_free_noncoherent.Reported-by: Robin Murphy Signed-off-by: Christoph Hellwig Reviewed-by: Robin Murphy List of files: /linux-6.15/Documentation/core-api/dma-api.rst

0d71675f - dma-mapping: add a new dma_alloc_noncoherent API

Tue, 01 Sep 2020 11:31:30 +0000

dma-mapping: add a new dma_alloc_noncoherent APIAdd a new API to allocate and free memory that is guaranteed to beaddressable by a device, but which potentially is not cache coherentfor DMA.To transfer ownership to and from the device, the existing streamingDMA API calls dma_sync_single_for_device and dma_sync_single_for_cpumust be used.For now the new calls are implemented on top of dma_alloc_attrs justlike the old-noncoherent API, but once all drivers are switched tothe new API it will be replaced with a better working implementationthat is available on all architectures.Signed-off-by: Christoph Hellwig List of files: /linux-6.15/Documentation/core-api/dma-api.rst

a92df4f6 - dma-mapping: move the dma_declare_coherent_memory documentation

Tue, 18 Aug 2020 17:32:42 +0000

dma-mapping: move the dma_declare_coherent_memory documentationdma_declare_coherent_memory should not be in a DMA API guide aimedat driver writers (that is consumers of the API). Move it to a commentnear the function instead.Signed-off-by: Christoph Hellwig Reviewed-by: Robin Murphy List of files: /linux-6.15/Documentation/core-api/dma-api.rst

3aa91625 - dma-mapping: Add a new dma_need_sync API

Mon, 29 Jun 2020 13:03:56 +0000

dma-mapping: Add a new dma_need_sync APIAdd a new API to check if calls to dma_sync_single_for_{device,cpu} arerequired for a given DMA streaming mapping.Signed-off-by: Christoph Hellwig Signed-off-by: Daniel Borkmann Link: https://lore.kernel.org/bpf/20200629130359.2690853-2-hch@lst.de List of files: /linux-6.15/Documentation/core-api/dma-api.rst

985098a0 - docs: fix references for DMA*.txt files

Tue, 23 Jun 2020 07:09:10 +0000

docs: fix references for DMA*.txt filesAs we moved those files to core-api, fix references to pointto their newer locations.Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/37b2fd159fbc7655dbf33b3eb1215396a25f6344.1592895969.git.mchehab+huawei@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/core-api/dma-api.rst

728c1471 - docs: move DMA kAPI to Documentation/core-api

Fri, 01 May 2020 15:37:45 +0000

docs: move DMA kAPI to Documentation/core-apiMove those files to the core-api, where they belong, renamingthem to ReST and adding to the core API index file.Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/a1517185418cb9d987f566ef85a5dd5c7c99f34e.1588345503.git.mchehab+huawei@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/core-api/dma-api.rst