xref: /linux-6.15/include/linux/iommu.h (revision 9b133f8d)
1 /*
2  * Copyright (C) 2007-2008 Advanced Micro Devices, Inc.
3  * Author: Joerg Roedel <[email protected]>
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 as published
7  * by the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
17  */
18 
19 #ifndef __LINUX_IOMMU_H
20 #define __LINUX_IOMMU_H
21 
22 #include <linux/errno.h>
23 
24 #define IOMMU_READ	(1)
25 #define IOMMU_WRITE	(2)
26 #define IOMMU_CACHE	(4) /* DMA cache coherency */
27 
28 struct device;
29 
30 struct iommu_domain {
31 	void *priv;
32 };
33 
34 #define IOMMU_CAP_CACHE_COHERENCY	0x1
35 #define IOMMU_CAP_INTR_REMAP		0x2	/* isolates device intrs */
36 
37 struct iommu_ops {
38 	int (*domain_init)(struct iommu_domain *domain);
39 	void (*domain_destroy)(struct iommu_domain *domain);
40 	int (*attach_dev)(struct iommu_domain *domain, struct device *dev);
41 	void (*detach_dev)(struct iommu_domain *domain, struct device *dev);
42 	int (*map)(struct iommu_domain *domain, unsigned long iova,
43 		   phys_addr_t paddr, int gfp_order, int prot);
44 	int (*unmap)(struct iommu_domain *domain, unsigned long iova,
45 		     int gfp_order);
46 	phys_addr_t (*iova_to_phys)(struct iommu_domain *domain,
47 				    unsigned long iova);
48 	int (*domain_has_cap)(struct iommu_domain *domain,
49 			      unsigned long cap);
50 };
51 
52 #ifdef CONFIG_IOMMU_API
53 
54 extern void register_iommu(struct iommu_ops *ops);
55 extern bool iommu_found(void);
56 extern struct iommu_domain *iommu_domain_alloc(void);
57 extern void iommu_domain_free(struct iommu_domain *domain);
58 extern int iommu_attach_device(struct iommu_domain *domain,
59 			       struct device *dev);
60 extern void iommu_detach_device(struct iommu_domain *domain,
61 				struct device *dev);
62 extern int iommu_map(struct iommu_domain *domain, unsigned long iova,
63 		     phys_addr_t paddr, int gfp_order, int prot);
64 extern int iommu_unmap(struct iommu_domain *domain, unsigned long iova,
65 		       int gfp_order);
66 extern phys_addr_t iommu_iova_to_phys(struct iommu_domain *domain,
67 				      unsigned long iova);
68 extern int iommu_domain_has_cap(struct iommu_domain *domain,
69 				unsigned long cap);
70 
71 #else /* CONFIG_IOMMU_API */
72 
73 static inline void register_iommu(struct iommu_ops *ops)
74 {
75 }
76 
77 static inline bool iommu_found(void)
78 {
79 	return false;
80 }
81 
82 static inline struct iommu_domain *iommu_domain_alloc(void)
83 {
84 	return NULL;
85 }
86 
87 static inline void iommu_domain_free(struct iommu_domain *domain)
88 {
89 }
90 
91 static inline int iommu_attach_device(struct iommu_domain *domain,
92 				      struct device *dev)
93 {
94 	return -ENODEV;
95 }
96 
97 static inline void iommu_detach_device(struct iommu_domain *domain,
98 				       struct device *dev)
99 {
100 }
101 
102 static inline int iommu_map(struct iommu_domain *domain, unsigned long iova,
103 			    phys_addr_t paddr, int gfp_order, int prot)
104 {
105 	return -ENODEV;
106 }
107 
108 static inline int iommu_unmap(struct iommu_domain *domain, unsigned long iova,
109 			      int gfp_order)
110 {
111 	return -ENODEV;
112 }
113 
114 static inline phys_addr_t iommu_iova_to_phys(struct iommu_domain *domain,
115 					     unsigned long iova)
116 {
117 	return 0;
118 }
119 
120 static inline int domain_has_cap(struct iommu_domain *domain,
121 				 unsigned long cap)
122 {
123 	return 0;
124 }
125 
126 #endif /* CONFIG_IOMMU_API */
127 
128 #endif /* __LINUX_IOMMU_H */
129