dma-mapping: add a dma_need_unmap helper

JIRA: https://issues.redhat.com/browse/RHEL-113839
Upstream-Status: git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git

commit 5f3b133
Author: Christoph Hellwig <hch@lst.de>
Date:   Mon May 5 10:01:45 2025 +0300

    dma-mapping: add a dma_need_unmap helper

    Add a helper to check if a given dma_addr_t value actually needs to be
    unmapped, either because it was mapped or because it is a special value
    like DMA_MAPPING_ERROR.

    Reviewed-by: Leon Romanovsky <leonro@nvidia.com>
    Tested-by: Jens Axboe <axboe@kernel.dk>
    Reviewed-by: Luis Chamberlain <mcgrof@kernel.org>
    Signed-off-by: Christoph Hellwig <hch@lst.de>
    Signed-off-by: Leon Romanovsky <leonro@nvidia.com>
    Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>

(cherry picked from commit 5f3b133)
Co-developed-by: Claude claude-sonnet-4
Signed-off-by: Jerry Snitselaar <jsnitsel@redhat.com>

Author: snits

include/linux/dma-mapping.h

@@ -406,6 +406,7 @@ static inline bool dma_need_sync(struct device *dev, dma_addr_t dma_addr)
 {
 	return dma_dev_need_sync(dev) ? __dma_need_sync(dev, dma_addr) : false;
 }
+bool dma_need_unmap(struct device *dev);
 #else /* !CONFIG_HAS_DMA || !CONFIG_DMA_NEED_SYNC */
 static inline bool dma_dev_need_sync(const struct device *dev)
 {
@@ -431,6 +432,10 @@ static inline bool dma_need_sync(struct device *dev, dma_addr_t dma_addr)
 {
 	return false;
 }
+static inline bool dma_need_unmap(struct device *dev)
+{
+	return false;
+}
 #endif /* !CONFIG_HAS_DMA || !CONFIG_DMA_NEED_SYNC */
 
 struct page *dma_alloc_pages(struct device *dev, size_t size,

kernel/dma/mapping.c

@@ -443,6 +443,24 @@ bool __dma_need_sync(struct device *dev, dma_addr_t dma_addr)
 }
 EXPORT_SYMBOL_GPL(__dma_need_sync);
 
+/**
+ * dma_need_unmap - does this device need dma_unmap_* operations
+ * @dev: device to check
+ *
+ * If this function returns %false, drivers can skip calling dma_unmap_* after
+ * finishing an I/O.  This function must be called after all mappings that might
+ * need to be unmapped have been performed.
+ */
+bool dma_need_unmap(struct device *dev)
+{
+	if (!dma_map_direct(dev, get_dma_ops(dev)))
+		return true;
+	if (!dev->dma_skip_sync)
+		return true;
+	return IS_ENABLED(CONFIG_DMA_API_DEBUG);
+}
+EXPORT_SYMBOL_GPL(dma_need_unmap);
+
 static void dma_setup_need_sync(struct device *dev)
 {
 	const struct dma_map_ops *ops = get_dma_ops(dev);