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