Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2007-2008 Advanced Micro Devices, Inc. |
| 3 | * Author: Joerg Roedel <joerg.roedel@amd.com> |
| 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 | |
Laura Abbott | 74315cc | 2011-06-08 17:29:11 -0400 | [diff] [blame] | 22 | #include <linux/errno.h> |
Wang YanQing | 9a08d37 | 2013-04-19 09:38:04 +0800 | [diff] [blame] | 23 | #include <linux/err.h> |
Will Deacon | d0f60a4 | 2014-08-27 16:15:59 +0100 | [diff] [blame] | 24 | #include <linux/of.h> |
Thierry Reding | 76582d0 | 2012-07-25 16:24:49 +0200 | [diff] [blame] | 25 | #include <linux/types.h> |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 26 | #include <linux/scatterlist.h> |
Shuah Khan | 56fa484 | 2013-09-24 15:21:20 -0600 | [diff] [blame] | 27 | #include <trace/events/iommu.h> |
Laura Abbott | 74315cc | 2011-06-08 17:29:11 -0400 | [diff] [blame] | 28 | |
Will Deacon | ca13bb3 | 2013-11-05 15:59:53 +0000 | [diff] [blame] | 29 | #define IOMMU_READ (1 << 0) |
| 30 | #define IOMMU_WRITE (1 << 1) |
| 31 | #define IOMMU_CACHE (1 << 2) /* DMA cache coherency */ |
Antonios Motakis | a720b41 | 2014-10-13 14:06:16 +0100 | [diff] [blame] | 32 | #define IOMMU_NOEXEC (1 << 3) |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 33 | |
Joerg Roedel | 905d66c | 2011-09-06 16:03:26 +0200 | [diff] [blame] | 34 | struct iommu_ops; |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 35 | struct iommu_group; |
Joerg Roedel | ff21776 | 2011-08-26 16:48:26 +0200 | [diff] [blame] | 36 | struct bus_type; |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 37 | struct device; |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 38 | struct iommu_domain; |
Joerg Roedel | ba1eabfa | 2012-08-03 15:55:41 +0200 | [diff] [blame] | 39 | struct notifier_block; |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 40 | |
| 41 | /* iommu fault flags */ |
| 42 | #define IOMMU_FAULT_READ 0x0 |
| 43 | #define IOMMU_FAULT_WRITE 0x1 |
| 44 | |
| 45 | typedef int (*iommu_fault_handler_t)(struct iommu_domain *, |
Ohad Ben-Cohen | 77ca233 | 2012-05-21 20:20:05 +0300 | [diff] [blame] | 46 | struct device *, unsigned long, int, void *); |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 47 | |
Joerg Roedel | 0ff64f8 | 2012-01-26 19:40:53 +0100 | [diff] [blame] | 48 | struct iommu_domain_geometry { |
| 49 | dma_addr_t aperture_start; /* First address that can be mapped */ |
| 50 | dma_addr_t aperture_end; /* Last address that can be mapped */ |
| 51 | bool force_aperture; /* DMA only allowed in mappable range? */ |
| 52 | }; |
| 53 | |
Joerg Roedel | 8539c7c | 2015-03-26 13:43:05 +0100 | [diff] [blame] | 54 | /* Domain feature flags */ |
| 55 | #define __IOMMU_DOMAIN_PAGING (1U << 0) /* Support for iommu_map/unmap */ |
| 56 | #define __IOMMU_DOMAIN_DMA_API (1U << 1) /* Domain for use in DMA-API |
| 57 | implementation */ |
| 58 | #define __IOMMU_DOMAIN_PT (1U << 2) /* Domain is identity mapped */ |
| 59 | |
| 60 | /* |
| 61 | * This are the possible domain-types |
| 62 | * |
| 63 | * IOMMU_DOMAIN_BLOCKED - All DMA is blocked, can be used to isolate |
| 64 | * devices |
| 65 | * IOMMU_DOMAIN_IDENTITY - DMA addresses are system physical addresses |
| 66 | * IOMMU_DOMAIN_UNMANAGED - DMA mappings managed by IOMMU-API user, used |
| 67 | * for VMs |
| 68 | * IOMMU_DOMAIN_DMA - Internally used for DMA-API implementations. |
| 69 | * This flag allows IOMMU drivers to implement |
| 70 | * certain optimizations for these domains |
| 71 | */ |
| 72 | #define IOMMU_DOMAIN_BLOCKED (0U) |
| 73 | #define IOMMU_DOMAIN_IDENTITY (__IOMMU_DOMAIN_PT) |
| 74 | #define IOMMU_DOMAIN_UNMANAGED (__IOMMU_DOMAIN_PAGING) |
| 75 | #define IOMMU_DOMAIN_DMA (__IOMMU_DOMAIN_PAGING | \ |
| 76 | __IOMMU_DOMAIN_DMA_API) |
| 77 | |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 78 | struct iommu_domain { |
Joerg Roedel | 8539c7c | 2015-03-26 13:43:05 +0100 | [diff] [blame] | 79 | unsigned type; |
Thierry Reding | b22f643 | 2014-06-27 09:03:12 +0200 | [diff] [blame] | 80 | const struct iommu_ops *ops; |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 81 | iommu_fault_handler_t handler; |
Ohad Ben-Cohen | 77ca233 | 2012-05-21 20:20:05 +0300 | [diff] [blame] | 82 | void *handler_token; |
Joerg Roedel | 0ff64f8 | 2012-01-26 19:40:53 +0100 | [diff] [blame] | 83 | struct iommu_domain_geometry geometry; |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 84 | }; |
| 85 | |
Joerg Roedel | 1aed074 | 2014-09-03 18:34:04 +0200 | [diff] [blame] | 86 | enum iommu_cap { |
| 87 | IOMMU_CAP_CACHE_COHERENCY, /* IOMMU can enforce cache coherent DMA |
| 88 | transactions */ |
| 89 | IOMMU_CAP_INTR_REMAP, /* IOMMU supports interrupt isolation */ |
Antonios Motakis | c498664 | 2014-10-13 14:06:17 +0100 | [diff] [blame] | 90 | IOMMU_CAP_NOEXEC, /* IOMMU_NOEXEC flag */ |
Joerg Roedel | 1aed074 | 2014-09-03 18:34:04 +0200 | [diff] [blame] | 91 | }; |
Sheng Yang | dbb9fd8 | 2009-03-18 15:33:06 +0800 | [diff] [blame] | 92 | |
Varun Sethi | 7cabf49 | 2013-07-15 10:20:56 +0530 | [diff] [blame] | 93 | /* |
| 94 | * Following constraints are specifc to FSL_PAMUV1: |
| 95 | * -aperture must be power of 2, and naturally aligned |
| 96 | * -number of windows must be power of 2, and address space size |
| 97 | * of each window is determined by aperture size / # of windows |
| 98 | * -the actual size of the mapped region of a window must be power |
| 99 | * of 2 starting with 4KB and physical address must be naturally |
| 100 | * aligned. |
| 101 | * DOMAIN_ATTR_FSL_PAMUV1 corresponds to the above mentioned contraints. |
| 102 | * The caller can invoke iommu_domain_get_attr to check if the underlying |
| 103 | * iommu implementation supports these constraints. |
| 104 | */ |
| 105 | |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 106 | enum iommu_attr { |
Joerg Roedel | 0ff64f8 | 2012-01-26 19:40:53 +0100 | [diff] [blame] | 107 | DOMAIN_ATTR_GEOMETRY, |
Joerg Roedel | d2e1216 | 2013-01-29 13:49:04 +0100 | [diff] [blame] | 108 | DOMAIN_ATTR_PAGING, |
Joerg Roedel | 6935671 | 2013-02-04 14:00:01 +0100 | [diff] [blame] | 109 | DOMAIN_ATTR_WINDOWS, |
Varun Sethi | 7cabf49 | 2013-07-15 10:20:56 +0530 | [diff] [blame] | 110 | DOMAIN_ATTR_FSL_PAMU_STASH, |
| 111 | DOMAIN_ATTR_FSL_PAMU_ENABLE, |
| 112 | DOMAIN_ATTR_FSL_PAMUV1, |
Will Deacon | c02607a | 2014-09-29 10:05:06 -0600 | [diff] [blame] | 113 | DOMAIN_ATTR_NESTING, /* two stages of translation */ |
Joerg Roedel | a8b8a88a | 2013-01-29 14:36:31 +0100 | [diff] [blame] | 114 | DOMAIN_ATTR_MAX, |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 115 | }; |
| 116 | |
Joerg Roedel | a1015c2 | 2015-05-28 18:41:33 +0200 | [diff] [blame^] | 117 | /** |
| 118 | * struct iommu_dm_region - descriptor for a direct mapped memory region |
| 119 | * @list: Linked list pointers |
| 120 | * @start: System physical start address of the region |
| 121 | * @length: Length of the region in bytes |
| 122 | * @prot: IOMMU Protection flags (READ/WRITE/...) |
| 123 | */ |
| 124 | struct iommu_dm_region { |
| 125 | struct list_head list; |
| 126 | phys_addr_t start; |
| 127 | size_t length; |
| 128 | int prot; |
| 129 | }; |
| 130 | |
Joerg Roedel | 39d4ebb | 2011-09-06 16:48:40 +0200 | [diff] [blame] | 131 | #ifdef CONFIG_IOMMU_API |
| 132 | |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 133 | /** |
| 134 | * struct iommu_ops - iommu ops and capabilities |
| 135 | * @domain_init: init iommu domain |
| 136 | * @domain_destroy: destroy iommu domain |
| 137 | * @attach_dev: attach device to an iommu domain |
| 138 | * @detach_dev: detach device from an iommu domain |
| 139 | * @map: map a physically contiguous memory region to an iommu domain |
| 140 | * @unmap: unmap a physically contiguous memory region from an iommu domain |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 141 | * @map_sg: map a scatter-gather list of physically contiguous memory chunks |
| 142 | * to an iommu domain |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 143 | * @iova_to_phys: translate iova to physical address |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 144 | * @add_device: add device to iommu grouping |
| 145 | * @remove_device: remove device from iommu grouping |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 146 | * @domain_get_attr: Query domain attributes |
| 147 | * @domain_set_attr: Change domain attributes |
Will Deacon | d0f60a4 | 2014-08-27 16:15:59 +0100 | [diff] [blame] | 148 | * @of_xlate: add OF master IDs to iommu grouping |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 149 | * @pgsize_bitmap: bitmap of supported page sizes |
Will Deacon | 1cd076b | 2014-08-27 14:40:58 +0100 | [diff] [blame] | 150 | * @priv: per-instance data private to the iommu driver |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 151 | */ |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 152 | struct iommu_ops { |
Joerg Roedel | 3c0e0ca | 2014-09-03 18:47:25 +0200 | [diff] [blame] | 153 | bool (*capable)(enum iommu_cap); |
Joerg Roedel | 938c470 | 2015-03-26 13:43:04 +0100 | [diff] [blame] | 154 | |
| 155 | /* Domain allocation and freeing by the iommu driver */ |
Joerg Roedel | 8539c7c | 2015-03-26 13:43:05 +0100 | [diff] [blame] | 156 | struct iommu_domain *(*domain_alloc)(unsigned iommu_domain_type); |
Joerg Roedel | 938c470 | 2015-03-26 13:43:04 +0100 | [diff] [blame] | 157 | void (*domain_free)(struct iommu_domain *); |
| 158 | |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 159 | int (*attach_dev)(struct iommu_domain *domain, struct device *dev); |
| 160 | void (*detach_dev)(struct iommu_domain *domain, struct device *dev); |
Joerg Roedel | 6765178 | 2010-01-21 16:32:27 +0100 | [diff] [blame] | 161 | int (*map)(struct iommu_domain *domain, unsigned long iova, |
Ohad Ben-Cohen | 5009065 | 2011-11-10 11:32:25 +0200 | [diff] [blame] | 162 | phys_addr_t paddr, size_t size, int prot); |
| 163 | size_t (*unmap)(struct iommu_domain *domain, unsigned long iova, |
| 164 | size_t size); |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 165 | size_t (*map_sg)(struct iommu_domain *domain, unsigned long iova, |
| 166 | struct scatterlist *sg, unsigned int nents, int prot); |
Varun Sethi | bb5547ac | 2013-03-29 01:23:58 +0530 | [diff] [blame] | 167 | phys_addr_t (*iova_to_phys)(struct iommu_domain *domain, dma_addr_t iova); |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 168 | int (*add_device)(struct device *dev); |
| 169 | void (*remove_device)(struct device *dev); |
Alex Williamson | 1460432 | 2011-10-21 15:56:05 -0400 | [diff] [blame] | 170 | int (*device_group)(struct device *dev, unsigned int *groupid); |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 171 | int (*domain_get_attr)(struct iommu_domain *domain, |
| 172 | enum iommu_attr attr, void *data); |
| 173 | int (*domain_set_attr)(struct iommu_domain *domain, |
| 174 | enum iommu_attr attr, void *data); |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 175 | |
Joerg Roedel | a1015c2 | 2015-05-28 18:41:33 +0200 | [diff] [blame^] | 176 | /* Request/Free a list of direct mapping requirements for a device */ |
| 177 | void (*get_dm_regions)(struct device *dev, struct list_head *list); |
| 178 | void (*put_dm_regions)(struct device *dev, struct list_head *list); |
| 179 | |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 180 | /* Window handling functions */ |
| 181 | int (*domain_window_enable)(struct iommu_domain *domain, u32 wnd_nr, |
Varun Sethi | 80f97f0 | 2013-03-29 01:24:00 +0530 | [diff] [blame] | 182 | phys_addr_t paddr, u64 size, int prot); |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 183 | void (*domain_window_disable)(struct iommu_domain *domain, u32 wnd_nr); |
Joerg Roedel | 6935671 | 2013-02-04 14:00:01 +0100 | [diff] [blame] | 184 | /* Set the numer of window per domain */ |
| 185 | int (*domain_set_windows)(struct iommu_domain *domain, u32 w_count); |
| 186 | /* Get the numer of window per domain */ |
| 187 | u32 (*domain_get_windows)(struct iommu_domain *domain); |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 188 | |
Will Deacon | d0f60a4 | 2014-08-27 16:15:59 +0100 | [diff] [blame] | 189 | #ifdef CONFIG_OF_IOMMU |
| 190 | int (*of_xlate)(struct device *dev, struct of_phandle_args *args); |
| 191 | #endif |
| 192 | |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 193 | unsigned long pgsize_bitmap; |
Will Deacon | 1cd076b | 2014-08-27 14:40:58 +0100 | [diff] [blame] | 194 | void *priv; |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 195 | }; |
| 196 | |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 197 | #define IOMMU_GROUP_NOTIFY_ADD_DEVICE 1 /* Device added */ |
| 198 | #define IOMMU_GROUP_NOTIFY_DEL_DEVICE 2 /* Pre Device removed */ |
| 199 | #define IOMMU_GROUP_NOTIFY_BIND_DRIVER 3 /* Pre Driver bind */ |
| 200 | #define IOMMU_GROUP_NOTIFY_BOUND_DRIVER 4 /* Post Driver bind */ |
| 201 | #define IOMMU_GROUP_NOTIFY_UNBIND_DRIVER 5 /* Pre Driver unbind */ |
| 202 | #define IOMMU_GROUP_NOTIFY_UNBOUND_DRIVER 6 /* Post Driver unbind */ |
| 203 | |
Thierry Reding | b22f643 | 2014-06-27 09:03:12 +0200 | [diff] [blame] | 204 | extern int bus_set_iommu(struct bus_type *bus, const struct iommu_ops *ops); |
Joerg Roedel | a1b60c1 | 2011-09-06 18:46:34 +0200 | [diff] [blame] | 205 | extern bool iommu_present(struct bus_type *bus); |
Joerg Roedel | 3c0e0ca | 2014-09-03 18:47:25 +0200 | [diff] [blame] | 206 | extern bool iommu_capable(struct bus_type *bus, enum iommu_cap cap); |
Joerg Roedel | 905d66c | 2011-09-06 16:03:26 +0200 | [diff] [blame] | 207 | extern struct iommu_domain *iommu_domain_alloc(struct bus_type *bus); |
Alexey Kardashevskiy | aa16bea | 2013-03-25 10:23:49 +1100 | [diff] [blame] | 208 | extern struct iommu_group *iommu_group_get_by_id(int id); |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 209 | extern void iommu_domain_free(struct iommu_domain *domain); |
| 210 | extern int iommu_attach_device(struct iommu_domain *domain, |
| 211 | struct device *dev); |
| 212 | extern void iommu_detach_device(struct iommu_domain *domain, |
| 213 | struct device *dev); |
Joerg Roedel | 2c1296d | 2015-05-28 18:41:32 +0200 | [diff] [blame] | 214 | extern struct iommu_domain *iommu_get_domain_for_dev(struct device *dev); |
Joerg Roedel | cefc53c | 2010-01-08 13:35:09 +0100 | [diff] [blame] | 215 | extern int iommu_map(struct iommu_domain *domain, unsigned long iova, |
Ohad Ben-Cohen | 7d3002c | 2011-11-10 11:32:26 +0200 | [diff] [blame] | 216 | phys_addr_t paddr, size_t size, int prot); |
| 217 | extern size_t iommu_unmap(struct iommu_domain *domain, unsigned long iova, |
| 218 | size_t size); |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 219 | extern size_t default_iommu_map_sg(struct iommu_domain *domain, unsigned long iova, |
| 220 | struct scatterlist *sg,unsigned int nents, |
| 221 | int prot); |
Varun Sethi | bb5547ac | 2013-03-29 01:23:58 +0530 | [diff] [blame] | 222 | extern phys_addr_t iommu_iova_to_phys(struct iommu_domain *domain, dma_addr_t iova); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 223 | extern void iommu_set_fault_handler(struct iommu_domain *domain, |
Ohad Ben-Cohen | 77ca233 | 2012-05-21 20:20:05 +0300 | [diff] [blame] | 224 | iommu_fault_handler_t handler, void *token); |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 225 | |
Joerg Roedel | a1015c2 | 2015-05-28 18:41:33 +0200 | [diff] [blame^] | 226 | extern void iommu_get_dm_regions(struct device *dev, struct list_head *list); |
| 227 | extern void iommu_put_dm_regions(struct device *dev, struct list_head *list); |
| 228 | |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 229 | extern int iommu_attach_group(struct iommu_domain *domain, |
| 230 | struct iommu_group *group); |
| 231 | extern void iommu_detach_group(struct iommu_domain *domain, |
| 232 | struct iommu_group *group); |
| 233 | extern struct iommu_group *iommu_group_alloc(void); |
| 234 | extern void *iommu_group_get_iommudata(struct iommu_group *group); |
| 235 | extern void iommu_group_set_iommudata(struct iommu_group *group, |
| 236 | void *iommu_data, |
| 237 | void (*release)(void *iommu_data)); |
| 238 | extern int iommu_group_set_name(struct iommu_group *group, const char *name); |
| 239 | extern int iommu_group_add_device(struct iommu_group *group, |
| 240 | struct device *dev); |
| 241 | extern void iommu_group_remove_device(struct device *dev); |
| 242 | extern int iommu_group_for_each_dev(struct iommu_group *group, void *data, |
| 243 | int (*fn)(struct device *, void *)); |
| 244 | extern struct iommu_group *iommu_group_get(struct device *dev); |
| 245 | extern void iommu_group_put(struct iommu_group *group); |
| 246 | extern int iommu_group_register_notifier(struct iommu_group *group, |
| 247 | struct notifier_block *nb); |
| 248 | extern int iommu_group_unregister_notifier(struct iommu_group *group, |
| 249 | struct notifier_block *nb); |
| 250 | extern int iommu_group_id(struct iommu_group *group); |
Alex Williamson | 104a1c1 | 2014-07-03 09:51:18 -0600 | [diff] [blame] | 251 | extern struct iommu_group *iommu_group_get_for_dev(struct device *dev); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 252 | |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 253 | extern int iommu_domain_get_attr(struct iommu_domain *domain, enum iommu_attr, |
| 254 | void *data); |
| 255 | extern int iommu_domain_set_attr(struct iommu_domain *domain, enum iommu_attr, |
| 256 | void *data); |
Alex Williamson | c61959e | 2014-06-12 16:12:24 -0600 | [diff] [blame] | 257 | struct device *iommu_device_create(struct device *parent, void *drvdata, |
| 258 | const struct attribute_group **groups, |
| 259 | const char *fmt, ...); |
| 260 | void iommu_device_destroy(struct device *dev); |
| 261 | int iommu_device_link(struct device *dev, struct device *link); |
| 262 | void iommu_device_unlink(struct device *dev, struct device *link); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 263 | |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 264 | /* Window handling function prototypes */ |
| 265 | extern int iommu_domain_window_enable(struct iommu_domain *domain, u32 wnd_nr, |
Varun Sethi | 80f97f0 | 2013-03-29 01:24:00 +0530 | [diff] [blame] | 266 | phys_addr_t offset, u64 size, |
| 267 | int prot); |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 268 | extern void iommu_domain_window_disable(struct iommu_domain *domain, u32 wnd_nr); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 269 | /** |
| 270 | * report_iommu_fault() - report about an IOMMU fault to the IOMMU framework |
| 271 | * @domain: the iommu domain where the fault has happened |
| 272 | * @dev: the device where the fault has happened |
| 273 | * @iova: the faulting address |
| 274 | * @flags: mmu fault flags (e.g. IOMMU_FAULT_READ/IOMMU_FAULT_WRITE/...) |
| 275 | * |
| 276 | * This function should be called by the low-level IOMMU implementations |
| 277 | * whenever IOMMU faults happen, to allow high-level users, that are |
| 278 | * interested in such events, to know about them. |
| 279 | * |
| 280 | * This event may be useful for several possible use cases: |
| 281 | * - mere logging of the event |
| 282 | * - dynamic TLB/PTE loading |
| 283 | * - if restarting of the faulting device is required |
| 284 | * |
| 285 | * Returns 0 on success and an appropriate error code otherwise (if dynamic |
| 286 | * PTE/TLB loading will one day be supported, implementations will be able |
| 287 | * to tell whether it succeeded or not according to this return value). |
Ohad Ben-Cohen | 0ed6d2d | 2011-09-27 07:36:40 -0400 | [diff] [blame] | 288 | * |
| 289 | * Specifically, -ENOSYS is returned if a fault handler isn't installed |
| 290 | * (though fault handlers can also return -ENOSYS, in case they want to |
| 291 | * elicit the default behavior of the IOMMU drivers). |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 292 | */ |
| 293 | static inline int report_iommu_fault(struct iommu_domain *domain, |
| 294 | struct device *dev, unsigned long iova, int flags) |
| 295 | { |
Ohad Ben-Cohen | 0ed6d2d | 2011-09-27 07:36:40 -0400 | [diff] [blame] | 296 | int ret = -ENOSYS; |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 297 | |
| 298 | /* |
| 299 | * if upper layers showed interest and installed a fault handler, |
| 300 | * invoke it. |
| 301 | */ |
| 302 | if (domain->handler) |
Ohad Ben-Cohen | 77ca233 | 2012-05-21 20:20:05 +0300 | [diff] [blame] | 303 | ret = domain->handler(domain, dev, iova, flags, |
| 304 | domain->handler_token); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 305 | |
Shuah Khan | 56fa484 | 2013-09-24 15:21:20 -0600 | [diff] [blame] | 306 | trace_io_page_fault(dev, iova, flags); |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 307 | return ret; |
| 308 | } |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 309 | |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 310 | static inline size_t iommu_map_sg(struct iommu_domain *domain, |
| 311 | unsigned long iova, struct scatterlist *sg, |
| 312 | unsigned int nents, int prot) |
| 313 | { |
| 314 | return domain->ops->map_sg(domain, iova, sg, nents, prot); |
| 315 | } |
| 316 | |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 317 | #else /* CONFIG_IOMMU_API */ |
| 318 | |
Joerg Roedel | 39d4ebb | 2011-09-06 16:48:40 +0200 | [diff] [blame] | 319 | struct iommu_ops {}; |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 320 | struct iommu_group {}; |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 321 | |
Joerg Roedel | a1b60c1 | 2011-09-06 18:46:34 +0200 | [diff] [blame] | 322 | static inline bool iommu_present(struct bus_type *bus) |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 323 | { |
| 324 | return false; |
| 325 | } |
| 326 | |
Joerg Roedel | 3c0e0ca | 2014-09-03 18:47:25 +0200 | [diff] [blame] | 327 | static inline bool iommu_capable(struct bus_type *bus, enum iommu_cap cap) |
| 328 | { |
| 329 | return false; |
| 330 | } |
| 331 | |
Joerg Roedel | 905d66c | 2011-09-06 16:03:26 +0200 | [diff] [blame] | 332 | static inline struct iommu_domain *iommu_domain_alloc(struct bus_type *bus) |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 333 | { |
| 334 | return NULL; |
| 335 | } |
| 336 | |
Alexey Kardashevskiy | b62dfd2 | 2013-11-21 17:41:14 +1100 | [diff] [blame] | 337 | static inline struct iommu_group *iommu_group_get_by_id(int id) |
| 338 | { |
| 339 | return NULL; |
| 340 | } |
| 341 | |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 342 | static inline void iommu_domain_free(struct iommu_domain *domain) |
| 343 | { |
| 344 | } |
| 345 | |
| 346 | static inline int iommu_attach_device(struct iommu_domain *domain, |
| 347 | struct device *dev) |
| 348 | { |
| 349 | return -ENODEV; |
| 350 | } |
| 351 | |
| 352 | static inline void iommu_detach_device(struct iommu_domain *domain, |
| 353 | struct device *dev) |
| 354 | { |
| 355 | } |
| 356 | |
Joerg Roedel | 2c1296d | 2015-05-28 18:41:32 +0200 | [diff] [blame] | 357 | static inline struct iommu_domain *iommu_get_domain_for_dev(struct device *dev) |
| 358 | { |
| 359 | return NULL; |
| 360 | } |
| 361 | |
Joerg Roedel | cefc53c | 2010-01-08 13:35:09 +0100 | [diff] [blame] | 362 | static inline int iommu_map(struct iommu_domain *domain, unsigned long iova, |
| 363 | phys_addr_t paddr, int gfp_order, int prot) |
| 364 | { |
| 365 | return -ENODEV; |
| 366 | } |
| 367 | |
| 368 | static inline int iommu_unmap(struct iommu_domain *domain, unsigned long iova, |
| 369 | int gfp_order) |
| 370 | { |
| 371 | return -ENODEV; |
| 372 | } |
| 373 | |
Olav Haugan | 315786e | 2014-10-25 09:55:16 -0700 | [diff] [blame] | 374 | static inline size_t iommu_map_sg(struct iommu_domain *domain, |
| 375 | unsigned long iova, struct scatterlist *sg, |
| 376 | unsigned int nents, int prot) |
| 377 | { |
| 378 | return -ENODEV; |
| 379 | } |
| 380 | |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 381 | static inline int iommu_domain_window_enable(struct iommu_domain *domain, |
| 382 | u32 wnd_nr, phys_addr_t paddr, |
Varun Sethi | 80f97f0 | 2013-03-29 01:24:00 +0530 | [diff] [blame] | 383 | u64 size, int prot) |
Joerg Roedel | d7787d5 | 2013-01-29 14:26:20 +0100 | [diff] [blame] | 384 | { |
| 385 | return -ENODEV; |
| 386 | } |
| 387 | |
| 388 | static inline void iommu_domain_window_disable(struct iommu_domain *domain, |
| 389 | u32 wnd_nr) |
| 390 | { |
| 391 | } |
| 392 | |
Varun Sethi | bb5547ac | 2013-03-29 01:23:58 +0530 | [diff] [blame] | 393 | static inline phys_addr_t iommu_iova_to_phys(struct iommu_domain *domain, dma_addr_t iova) |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 394 | { |
| 395 | return 0; |
| 396 | } |
| 397 | |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 398 | static inline void iommu_set_fault_handler(struct iommu_domain *domain, |
Ohad Ben-Cohen | 77ca233 | 2012-05-21 20:20:05 +0300 | [diff] [blame] | 399 | iommu_fault_handler_t handler, void *token) |
Ohad Ben-Cohen | 4f3f8d9 | 2011-09-13 15:25:23 -0400 | [diff] [blame] | 400 | { |
| 401 | } |
| 402 | |
Joerg Roedel | a1015c2 | 2015-05-28 18:41:33 +0200 | [diff] [blame^] | 403 | static inline void iommu_get_dm_regions(struct device *dev, |
| 404 | struct list_head *list) |
| 405 | { |
| 406 | } |
| 407 | |
| 408 | static inline void iommu_put_dm_regions(struct device *dev, |
| 409 | struct list_head *list) |
| 410 | { |
| 411 | } |
| 412 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 413 | static inline int iommu_attach_group(struct iommu_domain *domain, |
| 414 | struct iommu_group *group) |
Alex Williamson | 1460432 | 2011-10-21 15:56:05 -0400 | [diff] [blame] | 415 | { |
| 416 | return -ENODEV; |
| 417 | } |
| 418 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 419 | static inline void iommu_detach_group(struct iommu_domain *domain, |
| 420 | struct iommu_group *group) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 421 | { |
| 422 | } |
| 423 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 424 | static inline struct iommu_group *iommu_group_alloc(void) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 425 | { |
| 426 | return ERR_PTR(-ENODEV); |
| 427 | } |
| 428 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 429 | static inline void *iommu_group_get_iommudata(struct iommu_group *group) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 430 | { |
| 431 | return NULL; |
| 432 | } |
| 433 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 434 | static inline void iommu_group_set_iommudata(struct iommu_group *group, |
| 435 | void *iommu_data, |
| 436 | void (*release)(void *iommu_data)) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 437 | { |
| 438 | } |
| 439 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 440 | static inline int iommu_group_set_name(struct iommu_group *group, |
| 441 | const char *name) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 442 | { |
| 443 | return -ENODEV; |
| 444 | } |
| 445 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 446 | static inline int iommu_group_add_device(struct iommu_group *group, |
| 447 | struct device *dev) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 448 | { |
| 449 | return -ENODEV; |
| 450 | } |
| 451 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 452 | static inline void iommu_group_remove_device(struct device *dev) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 453 | { |
| 454 | } |
| 455 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 456 | static inline int iommu_group_for_each_dev(struct iommu_group *group, |
| 457 | void *data, |
| 458 | int (*fn)(struct device *, void *)) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 459 | { |
| 460 | return -ENODEV; |
| 461 | } |
| 462 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 463 | static inline struct iommu_group *iommu_group_get(struct device *dev) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 464 | { |
| 465 | return NULL; |
| 466 | } |
| 467 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 468 | static inline void iommu_group_put(struct iommu_group *group) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 469 | { |
| 470 | } |
| 471 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 472 | static inline int iommu_group_register_notifier(struct iommu_group *group, |
| 473 | struct notifier_block *nb) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 474 | { |
| 475 | return -ENODEV; |
| 476 | } |
| 477 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 478 | static inline int iommu_group_unregister_notifier(struct iommu_group *group, |
| 479 | struct notifier_block *nb) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 480 | { |
| 481 | return 0; |
| 482 | } |
| 483 | |
Alex Williamson | bef83de | 2012-09-24 21:23:25 -0600 | [diff] [blame] | 484 | static inline int iommu_group_id(struct iommu_group *group) |
Alex Williamson | d72e31c | 2012-05-30 14:18:53 -0600 | [diff] [blame] | 485 | { |
| 486 | return -ENODEV; |
| 487 | } |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 488 | |
Joerg Roedel | 0cd76dd | 2012-01-26 19:40:52 +0100 | [diff] [blame] | 489 | static inline int iommu_domain_get_attr(struct iommu_domain *domain, |
| 490 | enum iommu_attr attr, void *data) |
| 491 | { |
| 492 | return -EINVAL; |
| 493 | } |
| 494 | |
| 495 | static inline int iommu_domain_set_attr(struct iommu_domain *domain, |
| 496 | enum iommu_attr attr, void *data) |
| 497 | { |
| 498 | return -EINVAL; |
| 499 | } |
| 500 | |
Alex Williamson | e09f8ea5 | 2014-07-07 14:31:36 -0600 | [diff] [blame] | 501 | static inline struct device *iommu_device_create(struct device *parent, |
| 502 | void *drvdata, |
| 503 | const struct attribute_group **groups, |
| 504 | const char *fmt, ...) |
Alex Williamson | c61959e | 2014-06-12 16:12:24 -0600 | [diff] [blame] | 505 | { |
| 506 | return ERR_PTR(-ENODEV); |
| 507 | } |
| 508 | |
Alex Williamson | e09f8ea5 | 2014-07-07 14:31:36 -0600 | [diff] [blame] | 509 | static inline void iommu_device_destroy(struct device *dev) |
Alex Williamson | c61959e | 2014-06-12 16:12:24 -0600 | [diff] [blame] | 510 | { |
| 511 | } |
| 512 | |
Alex Williamson | e09f8ea5 | 2014-07-07 14:31:36 -0600 | [diff] [blame] | 513 | static inline int iommu_device_link(struct device *dev, struct device *link) |
Alex Williamson | c61959e | 2014-06-12 16:12:24 -0600 | [diff] [blame] | 514 | { |
| 515 | return -EINVAL; |
| 516 | } |
| 517 | |
Alex Williamson | e09f8ea5 | 2014-07-07 14:31:36 -0600 | [diff] [blame] | 518 | static inline void iommu_device_unlink(struct device *dev, struct device *link) |
Alex Williamson | c61959e | 2014-06-12 16:12:24 -0600 | [diff] [blame] | 519 | { |
| 520 | } |
| 521 | |
Joerg Roedel | 4a77a6c | 2008-11-26 17:02:33 +0100 | [diff] [blame] | 522 | #endif /* CONFIG_IOMMU_API */ |
| 523 | |
| 524 | #endif /* __LINUX_IOMMU_H */ |