include/linux/dma-iommu.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2014-2015 ARM Ltd.
   4  */
   5 #ifndef __DMA_IOMMU_H
   6 #define __DMA_IOMMU_H
   7
   8 #include <linux/errno.h>
   9 #include <linux/types.h>
  10
  11 #ifdef CONFIG_IOMMU_DMA
  12 #include <linux/dma-mapping.h>
  13 #include <linux/iommu.h>
  14 #include <linux/msi.h>
  15
  16 /* Domain management interface for IOMMU drivers */
  17 int iommu_get_dma_cookie(struct iommu_domain *domain);
  18 int iommu_get_msi_cookie(struct iommu_domain *domain, dma_addr_t base);
  19 void iommu_put_dma_cookie(struct iommu_domain *domain);
  20
  21 /* Setup call for arch DMA mapping code */
  22 void iommu_setup_dma_ops(struct device *dev, u64 dma_base, u64 dma_limit);
  23 int iommu_dma_init_fq(struct iommu_domain *domain);
  24
  25 /* The DMA API isn't _quite_ the whole story, though... */
  26 /*
  27  * iommu_dma_prepare_msi() - Map the MSI page in the IOMMU device
  28  *
  29  * The MSI page will be stored in @desc.
  30  *
  31  * Return: 0 on success otherwise an error describing the failure.
  32  */
  33 int iommu_dma_prepare_msi(struct msi_desc *desc, phys_addr_t msi_addr);
  34
  35 /* Update the MSI message if required. */
  36 void iommu_dma_compose_msi_msg(struct msi_desc *desc,
  37                                struct msi_msg *msg);
  38
  39 void iommu_dma_get_resv_regions(struct device *dev, struct list_head *list);
  40
  41 void iommu_dma_free_cpu_cached_iovas(unsigned int cpu,
  42                 struct iommu_domain *domain);
  43
  44 extern bool iommu_dma_forcedac;
  45
  46 #else /* CONFIG_IOMMU_DMA */
  47
  48 struct iommu_domain;
  49 struct msi_desc;
  50 struct msi_msg;
  51 struct device;
  52
  53 static inline void iommu_setup_dma_ops(struct device *dev, u64 dma_base,
  54                                        u64 dma_limit)
  55 {
  56 }
  57
  58 static inline int iommu_dma_init_fq(struct iommu_domain *domain)
  59 {
  60         return -EINVAL;
  61 }
  62
  63 static inline int iommu_get_dma_cookie(struct iommu_domain *domain)
  64 {
  65         return -ENODEV;
  66 }
  67
  68 static inline int iommu_get_msi_cookie(struct iommu_domain *domain, dma_addr_t base)
  69 {
  70         return -ENODEV;
  71 }
  72
  73 static inline void iommu_put_dma_cookie(struct iommu_domain *domain)
  74 {
  75 }
  76
  77 static inline int iommu_dma_prepare_msi(struct msi_desc *desc,
  78                                         phys_addr_t msi_addr)
  79 {
  80         return 0;
  81 }
  82
  83 static inline void iommu_dma_compose_msi_msg(struct msi_desc *desc,
  84                                              struct msi_msg *msg)
  85 {
  86 }
  87
  88 static inline void iommu_dma_get_resv_regions(struct device *dev, struct list_head *list)
  89 {
  90 }
  91
  92 #endif  /* CONFIG_IOMMU_DMA */
  93 #endif  /* __DMA_IOMMU_H */