]> git.proxmox.com Git - mirror_ubuntu-hirsute-kernel.git/blame - drivers/iommu/iommu.c
iommu/amd: Rename a few flush functions
[mirror_ubuntu-hirsute-kernel.git] / drivers / iommu / iommu.c
CommitLineData
fc2100eb
JR
1/*
2 * Copyright (C) 2007-2008 Advanced Micro Devices, Inc.
63ce3ae8 3 * Author: Joerg Roedel <jroedel@suse.de>
fc2100eb
JR
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
92e7066f 19#define pr_fmt(fmt) "iommu: " fmt
7d3002cc 20
905d66c1 21#include <linux/device.h>
40998188 22#include <linux/kernel.h>
fc2100eb
JR
23#include <linux/bug.h>
24#include <linux/types.h>
60db4027
AM
25#include <linux/module.h>
26#include <linux/slab.h>
fc2100eb
JR
27#include <linux/errno.h>
28#include <linux/iommu.h>
d72e31c9
AW
29#include <linux/idr.h>
30#include <linux/notifier.h>
31#include <linux/err.h>
104a1c13 32#include <linux/pci.h>
f096c061 33#include <linux/bitops.h>
57f98d2f 34#include <linux/property.h>
7f6db171 35#include <trace/events/iommu.h>
d72e31c9
AW
36
37static struct kset *iommu_group_kset;
e38d1f13 38static DEFINE_IDA(iommu_group_ida);
fccb4e3b 39static unsigned int iommu_def_domain_type = IOMMU_DOMAIN_DMA;
d72e31c9 40
b22f6434
TR
41struct iommu_callback_data {
42 const struct iommu_ops *ops;
43};
44
d72e31c9
AW
45struct iommu_group {
46 struct kobject kobj;
47 struct kobject *devices_kobj;
48 struct list_head devices;
49 struct mutex mutex;
50 struct blocking_notifier_head notifier;
51 void *iommu_data;
52 void (*iommu_data_release)(void *iommu_data);
53 char *name;
54 int id;
53723dc5 55 struct iommu_domain *default_domain;
e39cb8a3 56 struct iommu_domain *domain;
d72e31c9
AW
57};
58
c09e22d5 59struct group_device {
d72e31c9
AW
60 struct list_head list;
61 struct device *dev;
62 char *name;
63};
64
65struct iommu_group_attribute {
66 struct attribute attr;
67 ssize_t (*show)(struct iommu_group *group, char *buf);
68 ssize_t (*store)(struct iommu_group *group,
69 const char *buf, size_t count);
70};
71
bc7d12b9
EA
72static const char * const iommu_group_resv_type_string[] = {
73 [IOMMU_RESV_DIRECT] = "direct",
74 [IOMMU_RESV_RESERVED] = "reserved",
75 [IOMMU_RESV_MSI] = "msi",
9d3a4de4 76 [IOMMU_RESV_SW_MSI] = "msi",
bc7d12b9
EA
77};
78
d72e31c9
AW
79#define IOMMU_GROUP_ATTR(_name, _mode, _show, _store) \
80struct iommu_group_attribute iommu_group_attr_##_name = \
81 __ATTR(_name, _mode, _show, _store)
fc2100eb 82
d72e31c9
AW
83#define to_iommu_group_attr(_attr) \
84 container_of(_attr, struct iommu_group_attribute, attr)
85#define to_iommu_group(_kobj) \
86 container_of(_kobj, struct iommu_group, kobj)
fc2100eb 87
b0119e87
JR
88static LIST_HEAD(iommu_device_list);
89static DEFINE_SPINLOCK(iommu_device_lock);
90
91int iommu_device_register(struct iommu_device *iommu)
92{
93 spin_lock(&iommu_device_lock);
94 list_add_tail(&iommu->list, &iommu_device_list);
95 spin_unlock(&iommu_device_lock);
96
97 return 0;
98}
99
100void iommu_device_unregister(struct iommu_device *iommu)
101{
102 spin_lock(&iommu_device_lock);
103 list_del(&iommu->list);
104 spin_unlock(&iommu_device_lock);
105}
106
53723dc5
JR
107static struct iommu_domain *__iommu_domain_alloc(struct bus_type *bus,
108 unsigned type);
e39cb8a3
JR
109static int __iommu_attach_device(struct iommu_domain *domain,
110 struct device *dev);
111static int __iommu_attach_group(struct iommu_domain *domain,
112 struct iommu_group *group);
113static void __iommu_detach_group(struct iommu_domain *domain,
114 struct iommu_group *group);
53723dc5 115
fccb4e3b
WD
116static int __init iommu_set_def_domain_type(char *str)
117{
118 bool pt;
119
120 if (!str || strtobool(str, &pt))
121 return -EINVAL;
122
123 iommu_def_domain_type = pt ? IOMMU_DOMAIN_IDENTITY : IOMMU_DOMAIN_DMA;
124 return 0;
125}
126early_param("iommu.passthrough", iommu_set_def_domain_type);
127
d72e31c9
AW
128static ssize_t iommu_group_attr_show(struct kobject *kobj,
129 struct attribute *__attr, char *buf)
1460432c 130{
d72e31c9
AW
131 struct iommu_group_attribute *attr = to_iommu_group_attr(__attr);
132 struct iommu_group *group = to_iommu_group(kobj);
133 ssize_t ret = -EIO;
1460432c 134
d72e31c9
AW
135 if (attr->show)
136 ret = attr->show(group, buf);
137 return ret;
138}
139
140static ssize_t iommu_group_attr_store(struct kobject *kobj,
141 struct attribute *__attr,
142 const char *buf, size_t count)
143{
144 struct iommu_group_attribute *attr = to_iommu_group_attr(__attr);
145 struct iommu_group *group = to_iommu_group(kobj);
146 ssize_t ret = -EIO;
1460432c 147
d72e31c9
AW
148 if (attr->store)
149 ret = attr->store(group, buf, count);
150 return ret;
1460432c 151}
1460432c 152
d72e31c9
AW
153static const struct sysfs_ops iommu_group_sysfs_ops = {
154 .show = iommu_group_attr_show,
155 .store = iommu_group_attr_store,
156};
1460432c 157
d72e31c9
AW
158static int iommu_group_create_file(struct iommu_group *group,
159 struct iommu_group_attribute *attr)
160{
161 return sysfs_create_file(&group->kobj, &attr->attr);
1460432c 162}
1460432c 163
d72e31c9
AW
164static void iommu_group_remove_file(struct iommu_group *group,
165 struct iommu_group_attribute *attr)
166{
167 sysfs_remove_file(&group->kobj, &attr->attr);
168}
169
170static ssize_t iommu_group_show_name(struct iommu_group *group, char *buf)
171{
172 return sprintf(buf, "%s\n", group->name);
173}
174
6c65fb31
EA
175/**
176 * iommu_insert_resv_region - Insert a new region in the
177 * list of reserved regions.
178 * @new: new region to insert
179 * @regions: list of regions
180 *
181 * The new element is sorted by address with respect to the other
182 * regions of the same type. In case it overlaps with another
183 * region of the same type, regions are merged. In case it
184 * overlaps with another region of different type, regions are
185 * not merged.
186 */
187static int iommu_insert_resv_region(struct iommu_resv_region *new,
188 struct list_head *regions)
189{
190 struct iommu_resv_region *region;
191 phys_addr_t start = new->start;
192 phys_addr_t end = new->start + new->length - 1;
193 struct list_head *pos = regions->next;
194
195 while (pos != regions) {
196 struct iommu_resv_region *entry =
197 list_entry(pos, struct iommu_resv_region, list);
198 phys_addr_t a = entry->start;
199 phys_addr_t b = entry->start + entry->length - 1;
200 int type = entry->type;
201
202 if (end < a) {
203 goto insert;
204 } else if (start > b) {
205 pos = pos->next;
206 } else if ((start >= a) && (end <= b)) {
207 if (new->type == type)
208 goto done;
209 else
210 pos = pos->next;
211 } else {
212 if (new->type == type) {
213 phys_addr_t new_start = min(a, start);
214 phys_addr_t new_end = max(b, end);
215
216 list_del(&entry->list);
217 entry->start = new_start;
218 entry->length = new_end - new_start + 1;
219 iommu_insert_resv_region(entry, regions);
220 } else {
221 pos = pos->next;
222 }
223 }
224 }
225insert:
226 region = iommu_alloc_resv_region(new->start, new->length,
227 new->prot, new->type);
228 if (!region)
229 return -ENOMEM;
230
231 list_add_tail(&region->list, pos);
232done:
233 return 0;
234}
235
236static int
237iommu_insert_device_resv_regions(struct list_head *dev_resv_regions,
238 struct list_head *group_resv_regions)
239{
240 struct iommu_resv_region *entry;
a514a6e2 241 int ret = 0;
6c65fb31
EA
242
243 list_for_each_entry(entry, dev_resv_regions, list) {
244 ret = iommu_insert_resv_region(entry, group_resv_regions);
245 if (ret)
246 break;
247 }
248 return ret;
249}
250
251int iommu_get_group_resv_regions(struct iommu_group *group,
252 struct list_head *head)
253{
8d2932dd 254 struct group_device *device;
6c65fb31
EA
255 int ret = 0;
256
257 mutex_lock(&group->mutex);
258 list_for_each_entry(device, &group->devices, list) {
259 struct list_head dev_resv_regions;
260
261 INIT_LIST_HEAD(&dev_resv_regions);
262 iommu_get_resv_regions(device->dev, &dev_resv_regions);
263 ret = iommu_insert_device_resv_regions(&dev_resv_regions, head);
264 iommu_put_resv_regions(device->dev, &dev_resv_regions);
265 if (ret)
266 break;
267 }
268 mutex_unlock(&group->mutex);
269 return ret;
270}
271EXPORT_SYMBOL_GPL(iommu_get_group_resv_regions);
272
bc7d12b9
EA
273static ssize_t iommu_group_show_resv_regions(struct iommu_group *group,
274 char *buf)
275{
276 struct iommu_resv_region *region, *next;
277 struct list_head group_resv_regions;
278 char *str = buf;
279
280 INIT_LIST_HEAD(&group_resv_regions);
281 iommu_get_group_resv_regions(group, &group_resv_regions);
282
283 list_for_each_entry_safe(region, next, &group_resv_regions, list) {
284 str += sprintf(str, "0x%016llx 0x%016llx %s\n",
285 (long long int)region->start,
286 (long long int)(region->start +
287 region->length - 1),
288 iommu_group_resv_type_string[region->type]);
289 kfree(region);
290 }
291
292 return (str - buf);
293}
294
d72e31c9
AW
295static IOMMU_GROUP_ATTR(name, S_IRUGO, iommu_group_show_name, NULL);
296
bc7d12b9
EA
297static IOMMU_GROUP_ATTR(reserved_regions, 0444,
298 iommu_group_show_resv_regions, NULL);
299
d72e31c9
AW
300static void iommu_group_release(struct kobject *kobj)
301{
302 struct iommu_group *group = to_iommu_group(kobj);
303
269aa808
JR
304 pr_debug("Releasing group %d\n", group->id);
305
d72e31c9
AW
306 if (group->iommu_data_release)
307 group->iommu_data_release(group->iommu_data);
308
feccf398 309 ida_simple_remove(&iommu_group_ida, group->id);
d72e31c9 310
53723dc5
JR
311 if (group->default_domain)
312 iommu_domain_free(group->default_domain);
313
d72e31c9
AW
314 kfree(group->name);
315 kfree(group);
316}
317
318static struct kobj_type iommu_group_ktype = {
319 .sysfs_ops = &iommu_group_sysfs_ops,
320 .release = iommu_group_release,
321};
322
323/**
324 * iommu_group_alloc - Allocate a new group
325 * @name: Optional name to associate with group, visible in sysfs
326 *
327 * This function is called by an iommu driver to allocate a new iommu
328 * group. The iommu group represents the minimum granularity of the iommu.
329 * Upon successful return, the caller holds a reference to the supplied
330 * group in order to hold the group until devices are added. Use
331 * iommu_group_put() to release this extra reference count, allowing the
332 * group to be automatically reclaimed once it has no devices or external
333 * references.
334 */
335struct iommu_group *iommu_group_alloc(void)
1460432c 336{
d72e31c9
AW
337 struct iommu_group *group;
338 int ret;
339
340 group = kzalloc(sizeof(*group), GFP_KERNEL);
341 if (!group)
342 return ERR_PTR(-ENOMEM);
343
344 group->kobj.kset = iommu_group_kset;
345 mutex_init(&group->mutex);
346 INIT_LIST_HEAD(&group->devices);
347 BLOCKING_INIT_NOTIFIER_HEAD(&group->notifier);
348
feccf398
HK
349 ret = ida_simple_get(&iommu_group_ida, 0, 0, GFP_KERNEL);
350 if (ret < 0) {
d72e31c9 351 kfree(group);
feccf398 352 return ERR_PTR(ret);
d72e31c9 353 }
feccf398 354 group->id = ret;
1460432c 355
d72e31c9
AW
356 ret = kobject_init_and_add(&group->kobj, &iommu_group_ktype,
357 NULL, "%d", group->id);
358 if (ret) {
feccf398 359 ida_simple_remove(&iommu_group_ida, group->id);
d72e31c9
AW
360 kfree(group);
361 return ERR_PTR(ret);
362 }
363
364 group->devices_kobj = kobject_create_and_add("devices", &group->kobj);
365 if (!group->devices_kobj) {
366 kobject_put(&group->kobj); /* triggers .release & free */
367 return ERR_PTR(-ENOMEM);
368 }
369
370 /*
371 * The devices_kobj holds a reference on the group kobject, so
372 * as long as that exists so will the group. We can therefore
373 * use the devices_kobj for reference counting.
374 */
375 kobject_put(&group->kobj);
376
bc7d12b9
EA
377 ret = iommu_group_create_file(group,
378 &iommu_group_attr_reserved_regions);
379 if (ret)
380 return ERR_PTR(ret);
381
269aa808
JR
382 pr_debug("Allocated group %d\n", group->id);
383
d72e31c9
AW
384 return group;
385}
386EXPORT_SYMBOL_GPL(iommu_group_alloc);
387
aa16bea9
AK
388struct iommu_group *iommu_group_get_by_id(int id)
389{
390 struct kobject *group_kobj;
391 struct iommu_group *group;
392 const char *name;
393
394 if (!iommu_group_kset)
395 return NULL;
396
397 name = kasprintf(GFP_KERNEL, "%d", id);
398 if (!name)
399 return NULL;
400
401 group_kobj = kset_find_obj(iommu_group_kset, name);
402 kfree(name);
403
404 if (!group_kobj)
405 return NULL;
406
407 group = container_of(group_kobj, struct iommu_group, kobj);
408 BUG_ON(group->id != id);
409
410 kobject_get(group->devices_kobj);
411 kobject_put(&group->kobj);
412
413 return group;
414}
415EXPORT_SYMBOL_GPL(iommu_group_get_by_id);
416
d72e31c9
AW
417/**
418 * iommu_group_get_iommudata - retrieve iommu_data registered for a group
419 * @group: the group
420 *
421 * iommu drivers can store data in the group for use when doing iommu
422 * operations. This function provides a way to retrieve it. Caller
423 * should hold a group reference.
424 */
425void *iommu_group_get_iommudata(struct iommu_group *group)
426{
427 return group->iommu_data;
428}
429EXPORT_SYMBOL_GPL(iommu_group_get_iommudata);
430
431/**
432 * iommu_group_set_iommudata - set iommu_data for a group
433 * @group: the group
434 * @iommu_data: new data
435 * @release: release function for iommu_data
436 *
437 * iommu drivers can store data in the group for use when doing iommu
438 * operations. This function provides a way to set the data after
439 * the group has been allocated. Caller should hold a group reference.
440 */
441void iommu_group_set_iommudata(struct iommu_group *group, void *iommu_data,
442 void (*release)(void *iommu_data))
1460432c 443{
d72e31c9
AW
444 group->iommu_data = iommu_data;
445 group->iommu_data_release = release;
446}
447EXPORT_SYMBOL_GPL(iommu_group_set_iommudata);
1460432c 448
d72e31c9
AW
449/**
450 * iommu_group_set_name - set name for a group
451 * @group: the group
452 * @name: name
453 *
454 * Allow iommu driver to set a name for a group. When set it will
455 * appear in a name attribute file under the group in sysfs.
456 */
457int iommu_group_set_name(struct iommu_group *group, const char *name)
458{
459 int ret;
460
461 if (group->name) {
462 iommu_group_remove_file(group, &iommu_group_attr_name);
463 kfree(group->name);
464 group->name = NULL;
465 if (!name)
466 return 0;
467 }
468
469 group->name = kstrdup(name, GFP_KERNEL);
470 if (!group->name)
471 return -ENOMEM;
472
473 ret = iommu_group_create_file(group, &iommu_group_attr_name);
474 if (ret) {
475 kfree(group->name);
476 group->name = NULL;
477 return ret;
478 }
1460432c
AW
479
480 return 0;
481}
d72e31c9 482EXPORT_SYMBOL_GPL(iommu_group_set_name);
1460432c 483
beed2821
JR
484static int iommu_group_create_direct_mappings(struct iommu_group *group,
485 struct device *dev)
486{
487 struct iommu_domain *domain = group->default_domain;
e5b5234a 488 struct iommu_resv_region *entry;
beed2821
JR
489 struct list_head mappings;
490 unsigned long pg_size;
491 int ret = 0;
492
493 if (!domain || domain->type != IOMMU_DOMAIN_DMA)
494 return 0;
495
d16e0faa 496 BUG_ON(!domain->pgsize_bitmap);
beed2821 497
d16e0faa 498 pg_size = 1UL << __ffs(domain->pgsize_bitmap);
beed2821
JR
499 INIT_LIST_HEAD(&mappings);
500
e5b5234a 501 iommu_get_resv_regions(dev, &mappings);
beed2821
JR
502
503 /* We need to consider overlapping regions for different devices */
504 list_for_each_entry(entry, &mappings, list) {
505 dma_addr_t start, end, addr;
506
e5b5234a
EA
507 if (domain->ops->apply_resv_region)
508 domain->ops->apply_resv_region(dev, domain, entry);
33b21a6b 509
beed2821
JR
510 start = ALIGN(entry->start, pg_size);
511 end = ALIGN(entry->start + entry->length, pg_size);
512
544a25d9
EA
513 if (entry->type != IOMMU_RESV_DIRECT)
514 continue;
515
beed2821
JR
516 for (addr = start; addr < end; addr += pg_size) {
517 phys_addr_t phys_addr;
518
519 phys_addr = iommu_iova_to_phys(domain, addr);
520 if (phys_addr)
521 continue;
522
523 ret = iommu_map(domain, addr, addr, pg_size, entry->prot);
524 if (ret)
525 goto out;
526 }
527
528 }
529
530out:
e5b5234a 531 iommu_put_resv_regions(dev, &mappings);
beed2821
JR
532
533 return ret;
534}
535
d72e31c9
AW
536/**
537 * iommu_group_add_device - add a device to an iommu group
538 * @group: the group into which to add the device (reference should be held)
539 * @dev: the device
540 *
541 * This function is called by an iommu driver to add a device into a
542 * group. Adding a device increments the group reference count.
543 */
544int iommu_group_add_device(struct iommu_group *group, struct device *dev)
1460432c 545{
d72e31c9 546 int ret, i = 0;
c09e22d5 547 struct group_device *device;
d72e31c9
AW
548
549 device = kzalloc(sizeof(*device), GFP_KERNEL);
550 if (!device)
551 return -ENOMEM;
552
553 device->dev = dev;
1460432c 554
d72e31c9 555 ret = sysfs_create_link(&dev->kobj, &group->kobj, "iommu_group");
797a8b4d
RM
556 if (ret)
557 goto err_free_device;
d72e31c9
AW
558
559 device->name = kasprintf(GFP_KERNEL, "%s", kobject_name(&dev->kobj));
560rename:
561 if (!device->name) {
797a8b4d
RM
562 ret = -ENOMEM;
563 goto err_remove_link;
d72e31c9 564 }
1460432c 565
d72e31c9
AW
566 ret = sysfs_create_link_nowarn(group->devices_kobj,
567 &dev->kobj, device->name);
568 if (ret) {
d72e31c9
AW
569 if (ret == -EEXIST && i >= 0) {
570 /*
571 * Account for the slim chance of collision
572 * and append an instance to the name.
573 */
797a8b4d 574 kfree(device->name);
d72e31c9
AW
575 device->name = kasprintf(GFP_KERNEL, "%s.%d",
576 kobject_name(&dev->kobj), i++);
577 goto rename;
578 }
797a8b4d 579 goto err_free_name;
d72e31c9
AW
580 }
581
582 kobject_get(group->devices_kobj);
583
584 dev->iommu_group = group;
585
beed2821
JR
586 iommu_group_create_direct_mappings(group, dev);
587
d72e31c9
AW
588 mutex_lock(&group->mutex);
589 list_add_tail(&device->list, &group->devices);
e39cb8a3 590 if (group->domain)
797a8b4d 591 ret = __iommu_attach_device(group->domain, dev);
d72e31c9 592 mutex_unlock(&group->mutex);
797a8b4d
RM
593 if (ret)
594 goto err_put_group;
d72e31c9
AW
595
596 /* Notify any listeners about change to group. */
597 blocking_notifier_call_chain(&group->notifier,
598 IOMMU_GROUP_NOTIFY_ADD_DEVICE, dev);
d1cf7e82
SK
599
600 trace_add_device_to_group(group->id, dev);
269aa808
JR
601
602 pr_info("Adding device %s to group %d\n", dev_name(dev), group->id);
603
1460432c 604 return 0;
797a8b4d
RM
605
606err_put_group:
607 mutex_lock(&group->mutex);
608 list_del(&device->list);
609 mutex_unlock(&group->mutex);
610 dev->iommu_group = NULL;
611 kobject_put(group->devices_kobj);
612err_free_name:
613 kfree(device->name);
614err_remove_link:
615 sysfs_remove_link(&dev->kobj, "iommu_group");
616err_free_device:
617 kfree(device);
618 pr_err("Failed to add device %s to group %d: %d\n", dev_name(dev), group->id, ret);
619 return ret;
1460432c 620}
d72e31c9 621EXPORT_SYMBOL_GPL(iommu_group_add_device);
1460432c 622
d72e31c9
AW
623/**
624 * iommu_group_remove_device - remove a device from it's current group
625 * @dev: device to be removed
626 *
627 * This function is called by an iommu driver to remove the device from
628 * it's current group. This decrements the iommu group reference count.
629 */
630void iommu_group_remove_device(struct device *dev)
631{
632 struct iommu_group *group = dev->iommu_group;
c09e22d5 633 struct group_device *tmp_device, *device = NULL;
d72e31c9 634
269aa808
JR
635 pr_info("Removing device %s from group %d\n", dev_name(dev), group->id);
636
d72e31c9
AW
637 /* Pre-notify listeners that a device is being removed. */
638 blocking_notifier_call_chain(&group->notifier,
639 IOMMU_GROUP_NOTIFY_DEL_DEVICE, dev);
640
641 mutex_lock(&group->mutex);
642 list_for_each_entry(tmp_device, &group->devices, list) {
643 if (tmp_device->dev == dev) {
644 device = tmp_device;
645 list_del(&device->list);
646 break;
647 }
648 }
649 mutex_unlock(&group->mutex);
650
651 if (!device)
652 return;
653
654 sysfs_remove_link(group->devices_kobj, device->name);
655 sysfs_remove_link(&dev->kobj, "iommu_group");
656
2e757086
SK
657 trace_remove_device_from_group(group->id, dev);
658
d72e31c9
AW
659 kfree(device->name);
660 kfree(device);
661 dev->iommu_group = NULL;
662 kobject_put(group->devices_kobj);
663}
664EXPORT_SYMBOL_GPL(iommu_group_remove_device);
665
426a2738
JR
666static int iommu_group_device_count(struct iommu_group *group)
667{
c09e22d5 668 struct group_device *entry;
426a2738
JR
669 int ret = 0;
670
671 list_for_each_entry(entry, &group->devices, list)
672 ret++;
673
674 return ret;
675}
676
d72e31c9
AW
677/**
678 * iommu_group_for_each_dev - iterate over each device in the group
679 * @group: the group
680 * @data: caller opaque data to be passed to callback function
681 * @fn: caller supplied callback function
682 *
683 * This function is called by group users to iterate over group devices.
684 * Callers should hold a reference count to the group during callback.
685 * The group->mutex is held across callbacks, which will block calls to
686 * iommu_group_add/remove_device.
687 */
e39cb8a3
JR
688static int __iommu_group_for_each_dev(struct iommu_group *group, void *data,
689 int (*fn)(struct device *, void *))
d72e31c9 690{
c09e22d5 691 struct group_device *device;
d72e31c9
AW
692 int ret = 0;
693
d72e31c9
AW
694 list_for_each_entry(device, &group->devices, list) {
695 ret = fn(device->dev, data);
696 if (ret)
697 break;
698 }
e39cb8a3
JR
699 return ret;
700}
701
702
703int iommu_group_for_each_dev(struct iommu_group *group, void *data,
704 int (*fn)(struct device *, void *))
705{
706 int ret;
707
708 mutex_lock(&group->mutex);
709 ret = __iommu_group_for_each_dev(group, data, fn);
d72e31c9 710 mutex_unlock(&group->mutex);
e39cb8a3 711
d72e31c9
AW
712 return ret;
713}
714EXPORT_SYMBOL_GPL(iommu_group_for_each_dev);
715
716/**
717 * iommu_group_get - Return the group for a device and increment reference
718 * @dev: get the group that this device belongs to
719 *
720 * This function is called by iommu drivers and users to get the group
721 * for the specified device. If found, the group is returned and the group
722 * reference in incremented, else NULL.
723 */
724struct iommu_group *iommu_group_get(struct device *dev)
725{
726 struct iommu_group *group = dev->iommu_group;
727
728 if (group)
729 kobject_get(group->devices_kobj);
730
731 return group;
732}
733EXPORT_SYMBOL_GPL(iommu_group_get);
734
13f59a78
RM
735/**
736 * iommu_group_ref_get - Increment reference on a group
737 * @group: the group to use, must not be NULL
738 *
739 * This function is called by iommu drivers to take additional references on an
740 * existing group. Returns the given group for convenience.
741 */
742struct iommu_group *iommu_group_ref_get(struct iommu_group *group)
743{
744 kobject_get(group->devices_kobj);
745 return group;
746}
747
d72e31c9
AW
748/**
749 * iommu_group_put - Decrement group reference
750 * @group: the group to use
751 *
752 * This function is called by iommu drivers and users to release the
753 * iommu group. Once the reference count is zero, the group is released.
754 */
755void iommu_group_put(struct iommu_group *group)
756{
757 if (group)
758 kobject_put(group->devices_kobj);
759}
760EXPORT_SYMBOL_GPL(iommu_group_put);
761
762/**
763 * iommu_group_register_notifier - Register a notifier for group changes
764 * @group: the group to watch
765 * @nb: notifier block to signal
766 *
767 * This function allows iommu group users to track changes in a group.
768 * See include/linux/iommu.h for actions sent via this notifier. Caller
769 * should hold a reference to the group throughout notifier registration.
770 */
771int iommu_group_register_notifier(struct iommu_group *group,
772 struct notifier_block *nb)
773{
774 return blocking_notifier_chain_register(&group->notifier, nb);
775}
776EXPORT_SYMBOL_GPL(iommu_group_register_notifier);
777
778/**
779 * iommu_group_unregister_notifier - Unregister a notifier
780 * @group: the group to watch
781 * @nb: notifier block to signal
782 *
783 * Unregister a previously registered group notifier block.
784 */
785int iommu_group_unregister_notifier(struct iommu_group *group,
786 struct notifier_block *nb)
787{
788 return blocking_notifier_chain_unregister(&group->notifier, nb);
789}
790EXPORT_SYMBOL_GPL(iommu_group_unregister_notifier);
791
792/**
793 * iommu_group_id - Return ID for a group
794 * @group: the group to ID
795 *
796 * Return the unique ID for the group matching the sysfs group number.
797 */
798int iommu_group_id(struct iommu_group *group)
799{
800 return group->id;
801}
802EXPORT_SYMBOL_GPL(iommu_group_id);
1460432c 803
f096c061
AW
804static struct iommu_group *get_pci_alias_group(struct pci_dev *pdev,
805 unsigned long *devfns);
806
104a1c13
AW
807/*
808 * To consider a PCI device isolated, we require ACS to support Source
809 * Validation, Request Redirection, Completer Redirection, and Upstream
810 * Forwarding. This effectively means that devices cannot spoof their
811 * requester ID, requests and completions cannot be redirected, and all
812 * transactions are forwarded upstream, even as it passes through a
813 * bridge where the target device is downstream.
814 */
815#define REQ_ACS_FLAGS (PCI_ACS_SV | PCI_ACS_RR | PCI_ACS_CR | PCI_ACS_UF)
816
f096c061
AW
817/*
818 * For multifunction devices which are not isolated from each other, find
819 * all the other non-isolated functions and look for existing groups. For
820 * each function, we also need to look for aliases to or from other devices
821 * that may already have a group.
822 */
823static struct iommu_group *get_pci_function_alias_group(struct pci_dev *pdev,
824 unsigned long *devfns)
825{
826 struct pci_dev *tmp = NULL;
827 struct iommu_group *group;
828
829 if (!pdev->multifunction || pci_acs_enabled(pdev, REQ_ACS_FLAGS))
830 return NULL;
831
832 for_each_pci_dev(tmp) {
833 if (tmp == pdev || tmp->bus != pdev->bus ||
834 PCI_SLOT(tmp->devfn) != PCI_SLOT(pdev->devfn) ||
835 pci_acs_enabled(tmp, REQ_ACS_FLAGS))
836 continue;
837
838 group = get_pci_alias_group(tmp, devfns);
839 if (group) {
840 pci_dev_put(tmp);
841 return group;
842 }
843 }
844
845 return NULL;
846}
847
848/*
338c3149
JL
849 * Look for aliases to or from the given device for existing groups. DMA
850 * aliases are only supported on the same bus, therefore the search
f096c061
AW
851 * space is quite small (especially since we're really only looking at pcie
852 * device, and therefore only expect multiple slots on the root complex or
853 * downstream switch ports). It's conceivable though that a pair of
854 * multifunction devices could have aliases between them that would cause a
855 * loop. To prevent this, we use a bitmap to track where we've been.
856 */
857static struct iommu_group *get_pci_alias_group(struct pci_dev *pdev,
858 unsigned long *devfns)
859{
860 struct pci_dev *tmp = NULL;
861 struct iommu_group *group;
862
863 if (test_and_set_bit(pdev->devfn & 0xff, devfns))
864 return NULL;
865
866 group = iommu_group_get(&pdev->dev);
867 if (group)
868 return group;
869
870 for_each_pci_dev(tmp) {
871 if (tmp == pdev || tmp->bus != pdev->bus)
872 continue;
873
874 /* We alias them or they alias us */
338c3149 875 if (pci_devs_are_dma_aliases(pdev, tmp)) {
f096c061
AW
876 group = get_pci_alias_group(tmp, devfns);
877 if (group) {
878 pci_dev_put(tmp);
879 return group;
880 }
881
882 group = get_pci_function_alias_group(tmp, devfns);
883 if (group) {
884 pci_dev_put(tmp);
885 return group;
886 }
887 }
888 }
889
890 return NULL;
891}
892
104a1c13
AW
893struct group_for_pci_data {
894 struct pci_dev *pdev;
895 struct iommu_group *group;
896};
897
898/*
899 * DMA alias iterator callback, return the last seen device. Stop and return
900 * the IOMMU group if we find one along the way.
901 */
902static int get_pci_alias_or_group(struct pci_dev *pdev, u16 alias, void *opaque)
903{
904 struct group_for_pci_data *data = opaque;
905
906 data->pdev = pdev;
907 data->group = iommu_group_get(&pdev->dev);
908
909 return data->group != NULL;
910}
911
6eab556a
JR
912/*
913 * Generic device_group call-back function. It just allocates one
914 * iommu-group per device.
915 */
916struct iommu_group *generic_device_group(struct device *dev)
917{
7f7a2304 918 return iommu_group_alloc();
6eab556a
JR
919}
920
104a1c13
AW
921/*
922 * Use standard PCI bus topology, isolation features, and DMA alias quirks
923 * to find or create an IOMMU group for a device.
924 */
5e62292b 925struct iommu_group *pci_device_group(struct device *dev)
104a1c13 926{
5e62292b 927 struct pci_dev *pdev = to_pci_dev(dev);
104a1c13
AW
928 struct group_for_pci_data data;
929 struct pci_bus *bus;
930 struct iommu_group *group = NULL;
f096c061 931 u64 devfns[4] = { 0 };
104a1c13 932
5e62292b
JR
933 if (WARN_ON(!dev_is_pci(dev)))
934 return ERR_PTR(-EINVAL);
935
104a1c13
AW
936 /*
937 * Find the upstream DMA alias for the device. A device must not
938 * be aliased due to topology in order to have its own IOMMU group.
939 * If we find an alias along the way that already belongs to a
940 * group, use it.
941 */
942 if (pci_for_each_dma_alias(pdev, get_pci_alias_or_group, &data))
943 return data.group;
944
945 pdev = data.pdev;
946
947 /*
948 * Continue upstream from the point of minimum IOMMU granularity
949 * due to aliases to the point where devices are protected from
950 * peer-to-peer DMA by PCI ACS. Again, if we find an existing
951 * group, use it.
952 */
953 for (bus = pdev->bus; !pci_is_root_bus(bus); bus = bus->parent) {
954 if (!bus->self)
955 continue;
956
957 if (pci_acs_path_enabled(bus->self, NULL, REQ_ACS_FLAGS))
958 break;
959
960 pdev = bus->self;
961
962 group = iommu_group_get(&pdev->dev);
963 if (group)
964 return group;
965 }
966
967 /*
f096c061
AW
968 * Look for existing groups on device aliases. If we alias another
969 * device or another device aliases us, use the same group.
104a1c13 970 */
f096c061
AW
971 group = get_pci_alias_group(pdev, (unsigned long *)devfns);
972 if (group)
973 return group;
104a1c13
AW
974
975 /*
f096c061
AW
976 * Look for existing groups on non-isolated functions on the same
977 * slot and aliases of those funcions, if any. No need to clear
978 * the search bitmap, the tested devfns are still valid.
104a1c13 979 */
f096c061
AW
980 group = get_pci_function_alias_group(pdev, (unsigned long *)devfns);
981 if (group)
982 return group;
104a1c13
AW
983
984 /* No shared group found, allocate new */
7f7a2304 985 return iommu_group_alloc();
104a1c13
AW
986}
987
988/**
989 * iommu_group_get_for_dev - Find or create the IOMMU group for a device
990 * @dev: target device
991 *
992 * This function is intended to be called by IOMMU drivers and extended to
993 * support common, bus-defined algorithms when determining or creating the
994 * IOMMU group for a device. On success, the caller will hold a reference
995 * to the returned IOMMU group, which will already include the provided
996 * device. The reference should be released with iommu_group_put().
997 */
998struct iommu_group *iommu_group_get_for_dev(struct device *dev)
999{
46c6b2bc 1000 const struct iommu_ops *ops = dev->bus->iommu_ops;
c4a783b8 1001 struct iommu_group *group;
104a1c13
AW
1002 int ret;
1003
1004 group = iommu_group_get(dev);
1005 if (group)
1006 return group;
1007
05f80300
RM
1008 if (!ops)
1009 return ERR_PTR(-EINVAL);
104a1c13 1010
05f80300 1011 group = ops->device_group(dev);
72dcac63
JR
1012 if (WARN_ON_ONCE(group == NULL))
1013 return ERR_PTR(-EINVAL);
1014
104a1c13
AW
1015 if (IS_ERR(group))
1016 return group;
1017
1228236d
JR
1018 /*
1019 * Try to allocate a default domain - needs support from the
1020 * IOMMU driver.
1021 */
1022 if (!group->default_domain) {
fccb4e3b
WD
1023 struct iommu_domain *dom;
1024
1025 dom = __iommu_domain_alloc(dev->bus, iommu_def_domain_type);
1026 if (!dom && iommu_def_domain_type != IOMMU_DOMAIN_DMA) {
1027 dev_warn(dev,
1028 "failed to allocate default IOMMU domain of type %u; falling back to IOMMU_DOMAIN_DMA",
1029 iommu_def_domain_type);
1030 dom = __iommu_domain_alloc(dev->bus, IOMMU_DOMAIN_DMA);
1031 }
1032
1033 group->default_domain = dom;
eebb8034 1034 if (!group->domain)
fccb4e3b 1035 group->domain = dom;
1228236d
JR
1036 }
1037
104a1c13
AW
1038 ret = iommu_group_add_device(group, dev);
1039 if (ret) {
1040 iommu_group_put(group);
1041 return ERR_PTR(ret);
1042 }
1043
1044 return group;
1045}
1046
6827ca83
JR
1047struct iommu_domain *iommu_group_default_domain(struct iommu_group *group)
1048{
1049 return group->default_domain;
1050}
1051
d72e31c9 1052static int add_iommu_group(struct device *dev, void *data)
1460432c 1053{
b22f6434
TR
1054 struct iommu_callback_data *cb = data;
1055 const struct iommu_ops *ops = cb->ops;
38667f18 1056 int ret;
d72e31c9
AW
1057
1058 if (!ops->add_device)
461bfb3f 1059 return 0;
1460432c 1060
d72e31c9
AW
1061 WARN_ON(dev->iommu_group);
1062
38667f18
JR
1063 ret = ops->add_device(dev);
1064
1065 /*
1066 * We ignore -ENODEV errors for now, as they just mean that the
1067 * device is not translated by an IOMMU. We still care about
1068 * other errors and fail to initialize when they happen.
1069 */
1070 if (ret == -ENODEV)
1071 ret = 0;
1072
1073 return ret;
1460432c
AW
1074}
1075
8da30142
JR
1076static int remove_iommu_group(struct device *dev, void *data)
1077{
1078 struct iommu_callback_data *cb = data;
1079 const struct iommu_ops *ops = cb->ops;
1080
1081 if (ops->remove_device && dev->iommu_group)
1082 ops->remove_device(dev);
1460432c
AW
1083
1084 return 0;
1085}
1086
d72e31c9
AW
1087static int iommu_bus_notifier(struct notifier_block *nb,
1088 unsigned long action, void *data)
1460432c
AW
1089{
1090 struct device *dev = data;
b22f6434 1091 const struct iommu_ops *ops = dev->bus->iommu_ops;
d72e31c9
AW
1092 struct iommu_group *group;
1093 unsigned long group_action = 0;
1094
1095 /*
1096 * ADD/DEL call into iommu driver ops if provided, which may
1097 * result in ADD/DEL notifiers to group->notifier
1098 */
1099 if (action == BUS_NOTIFY_ADD_DEVICE) {
3ba8775f 1100 if (ops->add_device) {
1101 int ret;
1102
1103 ret = ops->add_device(dev);
1104 return (ret) ? NOTIFY_DONE : NOTIFY_OK;
1105 }
843cb6dc 1106 } else if (action == BUS_NOTIFY_REMOVED_DEVICE) {
d72e31c9
AW
1107 if (ops->remove_device && dev->iommu_group) {
1108 ops->remove_device(dev);
1109 return 0;
1110 }
1111 }
1460432c 1112
d72e31c9
AW
1113 /*
1114 * Remaining BUS_NOTIFYs get filtered and republished to the
1115 * group, if anyone is listening
1116 */
1117 group = iommu_group_get(dev);
1118 if (!group)
1119 return 0;
1460432c 1120
d72e31c9
AW
1121 switch (action) {
1122 case BUS_NOTIFY_BIND_DRIVER:
1123 group_action = IOMMU_GROUP_NOTIFY_BIND_DRIVER;
1124 break;
1125 case BUS_NOTIFY_BOUND_DRIVER:
1126 group_action = IOMMU_GROUP_NOTIFY_BOUND_DRIVER;
1127 break;
1128 case BUS_NOTIFY_UNBIND_DRIVER:
1129 group_action = IOMMU_GROUP_NOTIFY_UNBIND_DRIVER;
1130 break;
1131 case BUS_NOTIFY_UNBOUND_DRIVER:
1132 group_action = IOMMU_GROUP_NOTIFY_UNBOUND_DRIVER;
1133 break;
1134 }
1460432c 1135
d72e31c9
AW
1136 if (group_action)
1137 blocking_notifier_call_chain(&group->notifier,
1138 group_action, dev);
1460432c 1139
d72e31c9 1140 iommu_group_put(group);
1460432c
AW
1141 return 0;
1142}
1143
fb3e3065 1144static int iommu_bus_init(struct bus_type *bus, const struct iommu_ops *ops)
ff21776d 1145{
fb3e3065
MS
1146 int err;
1147 struct notifier_block *nb;
b22f6434
TR
1148 struct iommu_callback_data cb = {
1149 .ops = ops,
1150 };
1151
fb3e3065
MS
1152 nb = kzalloc(sizeof(struct notifier_block), GFP_KERNEL);
1153 if (!nb)
1154 return -ENOMEM;
1155
1156 nb->notifier_call = iommu_bus_notifier;
1157
1158 err = bus_register_notifier(bus, nb);
8da30142
JR
1159 if (err)
1160 goto out_free;
d7da6bdc
HS
1161
1162 err = bus_for_each_dev(bus, NULL, &cb, add_iommu_group);
8da30142
JR
1163 if (err)
1164 goto out_err;
1165
d7da6bdc
HS
1166
1167 return 0;
8da30142
JR
1168
1169out_err:
1170 /* Clean up */
1171 bus_for_each_dev(bus, NULL, &cb, remove_iommu_group);
1172 bus_unregister_notifier(bus, nb);
1173
1174out_free:
1175 kfree(nb);
1176
1177 return err;
ff21776d 1178}
fc2100eb 1179
ff21776d
JR
1180/**
1181 * bus_set_iommu - set iommu-callbacks for the bus
1182 * @bus: bus.
1183 * @ops: the callbacks provided by the iommu-driver
1184 *
1185 * This function is called by an iommu driver to set the iommu methods
1186 * used for a particular bus. Drivers for devices on that bus can use
1187 * the iommu-api after these ops are registered.
1188 * This special function is needed because IOMMUs are usually devices on
1189 * the bus itself, so the iommu drivers are not initialized when the bus
1190 * is set up. With this function the iommu-driver can set the iommu-ops
1191 * afterwards.
1192 */
b22f6434 1193int bus_set_iommu(struct bus_type *bus, const struct iommu_ops *ops)
fc2100eb 1194{
d7da6bdc
HS
1195 int err;
1196
ff21776d
JR
1197 if (bus->iommu_ops != NULL)
1198 return -EBUSY;
fc2100eb 1199
ff21776d
JR
1200 bus->iommu_ops = ops;
1201
1202 /* Do IOMMU specific setup for this bus-type */
d7da6bdc
HS
1203 err = iommu_bus_init(bus, ops);
1204 if (err)
1205 bus->iommu_ops = NULL;
1206
1207 return err;
fc2100eb 1208}
ff21776d 1209EXPORT_SYMBOL_GPL(bus_set_iommu);
fc2100eb 1210
a1b60c1c 1211bool iommu_present(struct bus_type *bus)
fc2100eb 1212{
94441c3b 1213 return bus->iommu_ops != NULL;
fc2100eb 1214}
a1b60c1c 1215EXPORT_SYMBOL_GPL(iommu_present);
fc2100eb 1216
3c0e0ca0
JR
1217bool iommu_capable(struct bus_type *bus, enum iommu_cap cap)
1218{
1219 if (!bus->iommu_ops || !bus->iommu_ops->capable)
1220 return false;
1221
1222 return bus->iommu_ops->capable(cap);
1223}
1224EXPORT_SYMBOL_GPL(iommu_capable);
1225
4f3f8d9d
OBC
1226/**
1227 * iommu_set_fault_handler() - set a fault handler for an iommu domain
1228 * @domain: iommu domain
1229 * @handler: fault handler
77ca2332 1230 * @token: user data, will be passed back to the fault handler
0ed6d2d2
OBC
1231 *
1232 * This function should be used by IOMMU users which want to be notified
1233 * whenever an IOMMU fault happens.
1234 *
1235 * The fault handler itself should return 0 on success, and an appropriate
1236 * error code otherwise.
4f3f8d9d
OBC
1237 */
1238void iommu_set_fault_handler(struct iommu_domain *domain,
77ca2332
OBC
1239 iommu_fault_handler_t handler,
1240 void *token)
4f3f8d9d
OBC
1241{
1242 BUG_ON(!domain);
1243
1244 domain->handler = handler;
77ca2332 1245 domain->handler_token = token;
4f3f8d9d 1246}
30bd918c 1247EXPORT_SYMBOL_GPL(iommu_set_fault_handler);
4f3f8d9d 1248
53723dc5
JR
1249static struct iommu_domain *__iommu_domain_alloc(struct bus_type *bus,
1250 unsigned type)
fc2100eb
JR
1251{
1252 struct iommu_domain *domain;
fc2100eb 1253
94441c3b 1254 if (bus == NULL || bus->iommu_ops == NULL)
905d66c1
JR
1255 return NULL;
1256
53723dc5 1257 domain = bus->iommu_ops->domain_alloc(type);
fc2100eb
JR
1258 if (!domain)
1259 return NULL;
1260
8539c7c1 1261 domain->ops = bus->iommu_ops;
53723dc5 1262 domain->type = type;
d16e0faa
RM
1263 /* Assume all sizes by default; the driver may override this later */
1264 domain->pgsize_bitmap = bus->iommu_ops->pgsize_bitmap;
905d66c1 1265
fc2100eb 1266 return domain;
fc2100eb 1267}
fc2100eb 1268
53723dc5
JR
1269struct iommu_domain *iommu_domain_alloc(struct bus_type *bus)
1270{
1271 return __iommu_domain_alloc(bus, IOMMU_DOMAIN_UNMANAGED);
fc2100eb
JR
1272}
1273EXPORT_SYMBOL_GPL(iommu_domain_alloc);
1274
1275void iommu_domain_free(struct iommu_domain *domain)
1276{
89be34a1 1277 domain->ops->domain_free(domain);
fc2100eb
JR
1278}
1279EXPORT_SYMBOL_GPL(iommu_domain_free);
1280
426a2738
JR
1281static int __iommu_attach_device(struct iommu_domain *domain,
1282 struct device *dev)
fc2100eb 1283{
b54db778 1284 int ret;
e5aa7f00
JR
1285 if (unlikely(domain->ops->attach_dev == NULL))
1286 return -ENODEV;
1287
b54db778
SK
1288 ret = domain->ops->attach_dev(domain, dev);
1289 if (!ret)
1290 trace_attach_device_to_domain(dev);
1291 return ret;
fc2100eb 1292}
426a2738
JR
1293
1294int iommu_attach_device(struct iommu_domain *domain, struct device *dev)
1295{
1296 struct iommu_group *group;
1297 int ret;
1298
1299 group = iommu_group_get(dev);
426a2738 1300 /*
05f80300 1301 * Lock the group to make sure the device-count doesn't
426a2738
JR
1302 * change while we are attaching
1303 */
1304 mutex_lock(&group->mutex);
1305 ret = -EINVAL;
1306 if (iommu_group_device_count(group) != 1)
1307 goto out_unlock;
1308
e39cb8a3 1309 ret = __iommu_attach_group(domain, group);
426a2738
JR
1310
1311out_unlock:
1312 mutex_unlock(&group->mutex);
1313 iommu_group_put(group);
1314
1315 return ret;
1316}
fc2100eb
JR
1317EXPORT_SYMBOL_GPL(iommu_attach_device);
1318
426a2738
JR
1319static void __iommu_detach_device(struct iommu_domain *domain,
1320 struct device *dev)
fc2100eb 1321{
e5aa7f00
JR
1322 if (unlikely(domain->ops->detach_dev == NULL))
1323 return;
1324
1325 domain->ops->detach_dev(domain, dev);
69980630 1326 trace_detach_device_from_domain(dev);
fc2100eb 1327}
426a2738
JR
1328
1329void iommu_detach_device(struct iommu_domain *domain, struct device *dev)
1330{
1331 struct iommu_group *group;
1332
1333 group = iommu_group_get(dev);
426a2738
JR
1334
1335 mutex_lock(&group->mutex);
1336 if (iommu_group_device_count(group) != 1) {
1337 WARN_ON(1);
1338 goto out_unlock;
1339 }
1340
e39cb8a3 1341 __iommu_detach_group(domain, group);
426a2738
JR
1342
1343out_unlock:
1344 mutex_unlock(&group->mutex);
1345 iommu_group_put(group);
1346}
fc2100eb
JR
1347EXPORT_SYMBOL_GPL(iommu_detach_device);
1348
2c1296d9
JR
1349struct iommu_domain *iommu_get_domain_for_dev(struct device *dev)
1350{
1351 struct iommu_domain *domain;
1352 struct iommu_group *group;
1353
1354 group = iommu_group_get(dev);
1464d0b1
RM
1355 if (!group)
1356 return NULL;
2c1296d9
JR
1357
1358 domain = group->domain;
1359
1360 iommu_group_put(group);
1361
1362 return domain;
1363}
1364EXPORT_SYMBOL_GPL(iommu_get_domain_for_dev);
fc2100eb 1365
d72e31c9
AW
1366/*
1367 * IOMMU groups are really the natrual working unit of the IOMMU, but
1368 * the IOMMU API works on domains and devices. Bridge that gap by
1369 * iterating over the devices in a group. Ideally we'd have a single
1370 * device which represents the requestor ID of the group, but we also
1371 * allow IOMMU drivers to create policy defined minimum sets, where
1372 * the physical hardware may be able to distiguish members, but we
1373 * wish to group them at a higher level (ex. untrusted multi-function
1374 * PCI devices). Thus we attach each device.
1375 */
1376static int iommu_group_do_attach_device(struct device *dev, void *data)
1377{
1378 struct iommu_domain *domain = data;
1379
426a2738 1380 return __iommu_attach_device(domain, dev);
d72e31c9
AW
1381}
1382
e39cb8a3
JR
1383static int __iommu_attach_group(struct iommu_domain *domain,
1384 struct iommu_group *group)
1385{
1386 int ret;
1387
1388 if (group->default_domain && group->domain != group->default_domain)
1389 return -EBUSY;
1390
1391 ret = __iommu_group_for_each_dev(group, domain,
1392 iommu_group_do_attach_device);
1393 if (ret == 0)
1394 group->domain = domain;
1395
1396 return ret;
d72e31c9
AW
1397}
1398
1399int iommu_attach_group(struct iommu_domain *domain, struct iommu_group *group)
1400{
e39cb8a3
JR
1401 int ret;
1402
1403 mutex_lock(&group->mutex);
1404 ret = __iommu_attach_group(domain, group);
1405 mutex_unlock(&group->mutex);
1406
1407 return ret;
d72e31c9
AW
1408}
1409EXPORT_SYMBOL_GPL(iommu_attach_group);
1410
1411static int iommu_group_do_detach_device(struct device *dev, void *data)
1412{
1413 struct iommu_domain *domain = data;
1414
426a2738 1415 __iommu_detach_device(domain, dev);
d72e31c9
AW
1416
1417 return 0;
1418}
1419
e39cb8a3
JR
1420static void __iommu_detach_group(struct iommu_domain *domain,
1421 struct iommu_group *group)
1422{
1423 int ret;
1424
1425 if (!group->default_domain) {
1426 __iommu_group_for_each_dev(group, domain,
1427 iommu_group_do_detach_device);
1428 group->domain = NULL;
1429 return;
1430 }
1431
1432 if (group->domain == group->default_domain)
1433 return;
1434
1435 /* Detach by re-attaching to the default domain */
1436 ret = __iommu_group_for_each_dev(group, group->default_domain,
1437 iommu_group_do_attach_device);
1438 if (ret != 0)
1439 WARN_ON(1);
1440 else
1441 group->domain = group->default_domain;
1442}
1443
d72e31c9
AW
1444void iommu_detach_group(struct iommu_domain *domain, struct iommu_group *group)
1445{
e39cb8a3
JR
1446 mutex_lock(&group->mutex);
1447 __iommu_detach_group(domain, group);
1448 mutex_unlock(&group->mutex);
d72e31c9
AW
1449}
1450EXPORT_SYMBOL_GPL(iommu_detach_group);
1451
bb5547ac 1452phys_addr_t iommu_iova_to_phys(struct iommu_domain *domain, dma_addr_t iova)
fc2100eb 1453{
e5aa7f00
JR
1454 if (unlikely(domain->ops->iova_to_phys == NULL))
1455 return 0;
1456
1457 return domain->ops->iova_to_phys(domain, iova);
fc2100eb
JR
1458}
1459EXPORT_SYMBOL_GPL(iommu_iova_to_phys);
dbb9fd86 1460
bd13969b
AW
1461static size_t iommu_pgsize(struct iommu_domain *domain,
1462 unsigned long addr_merge, size_t size)
1463{
1464 unsigned int pgsize_idx;
1465 size_t pgsize;
1466
1467 /* Max page size that still fits into 'size' */
1468 pgsize_idx = __fls(size);
1469
1470 /* need to consider alignment requirements ? */
1471 if (likely(addr_merge)) {
1472 /* Max page size allowed by address */
1473 unsigned int align_pgsize_idx = __ffs(addr_merge);
1474 pgsize_idx = min(pgsize_idx, align_pgsize_idx);
1475 }
1476
1477 /* build a mask of acceptable page sizes */
1478 pgsize = (1UL << (pgsize_idx + 1)) - 1;
1479
1480 /* throw away page sizes not supported by the hardware */
d16e0faa 1481 pgsize &= domain->pgsize_bitmap;
bd13969b
AW
1482
1483 /* make sure we're still sane */
1484 BUG_ON(!pgsize);
1485
1486 /* pick the biggest page */
1487 pgsize_idx = __fls(pgsize);
1488 pgsize = 1UL << pgsize_idx;
1489
1490 return pgsize;
1491}
1492
cefc53c7 1493int iommu_map(struct iommu_domain *domain, unsigned long iova,
7d3002cc 1494 phys_addr_t paddr, size_t size, int prot)
cefc53c7 1495{
7d3002cc
OBC
1496 unsigned long orig_iova = iova;
1497 unsigned int min_pagesz;
1498 size_t orig_size = size;
06bfcaa9 1499 phys_addr_t orig_paddr = paddr;
7d3002cc 1500 int ret = 0;
cefc53c7 1501
9db4ad91 1502 if (unlikely(domain->ops->map == NULL ||
d16e0faa 1503 domain->pgsize_bitmap == 0UL))
e5aa7f00 1504 return -ENODEV;
cefc53c7 1505
a10315e5
JR
1506 if (unlikely(!(domain->type & __IOMMU_DOMAIN_PAGING)))
1507 return -EINVAL;
1508
7d3002cc 1509 /* find out the minimum page size supported */
d16e0faa 1510 min_pagesz = 1 << __ffs(domain->pgsize_bitmap);
7d3002cc
OBC
1511
1512 /*
1513 * both the virtual address and the physical one, as well as
1514 * the size of the mapping, must be aligned (at least) to the
1515 * size of the smallest page supported by the hardware
1516 */
1517 if (!IS_ALIGNED(iova | paddr | size, min_pagesz)) {
abedb049 1518 pr_err("unaligned: iova 0x%lx pa %pa size 0x%zx min_pagesz 0x%x\n",
6197ca82 1519 iova, &paddr, size, min_pagesz);
7d3002cc
OBC
1520 return -EINVAL;
1521 }
1522
abedb049 1523 pr_debug("map: iova 0x%lx pa %pa size 0x%zx\n", iova, &paddr, size);
7d3002cc
OBC
1524
1525 while (size) {
bd13969b 1526 size_t pgsize = iommu_pgsize(domain, iova | paddr, size);
7d3002cc 1527
abedb049 1528 pr_debug("mapping: iova 0x%lx pa %pa pgsize 0x%zx\n",
6197ca82 1529 iova, &paddr, pgsize);
7d3002cc
OBC
1530
1531 ret = domain->ops->map(domain, iova, paddr, pgsize, prot);
1532 if (ret)
1533 break;
1534
1535 iova += pgsize;
1536 paddr += pgsize;
1537 size -= pgsize;
1538 }
1539
1540 /* unroll mapping in case something went wrong */
1541 if (ret)
1542 iommu_unmap(domain, orig_iova, orig_size - size);
e0be7c86 1543 else
06bfcaa9 1544 trace_map(orig_iova, orig_paddr, orig_size);
7d3002cc
OBC
1545
1546 return ret;
cefc53c7
JR
1547}
1548EXPORT_SYMBOL_GPL(iommu_map);
1549
7d3002cc 1550size_t iommu_unmap(struct iommu_domain *domain, unsigned long iova, size_t size)
cefc53c7 1551{
7d3002cc
OBC
1552 size_t unmapped_page, unmapped = 0;
1553 unsigned int min_pagesz;
6fd492fd 1554 unsigned long orig_iova = iova;
cefc53c7 1555
57886518 1556 if (unlikely(domain->ops->unmap == NULL ||
d16e0faa 1557 domain->pgsize_bitmap == 0UL))
e5aa7f00
JR
1558 return -ENODEV;
1559
a10315e5
JR
1560 if (unlikely(!(domain->type & __IOMMU_DOMAIN_PAGING)))
1561 return -EINVAL;
1562
7d3002cc 1563 /* find out the minimum page size supported */
d16e0faa 1564 min_pagesz = 1 << __ffs(domain->pgsize_bitmap);
7d3002cc
OBC
1565
1566 /*
1567 * The virtual address, as well as the size of the mapping, must be
1568 * aligned (at least) to the size of the smallest page supported
1569 * by the hardware
1570 */
1571 if (!IS_ALIGNED(iova | size, min_pagesz)) {
6197ca82
JP
1572 pr_err("unaligned: iova 0x%lx size 0x%zx min_pagesz 0x%x\n",
1573 iova, size, min_pagesz);
7d3002cc
OBC
1574 return -EINVAL;
1575 }
1576
6197ca82 1577 pr_debug("unmap this: iova 0x%lx size 0x%zx\n", iova, size);
7d3002cc
OBC
1578
1579 /*
1580 * Keep iterating until we either unmap 'size' bytes (or more)
1581 * or we hit an area that isn't mapped.
1582 */
1583 while (unmapped < size) {
bd13969b 1584 size_t pgsize = iommu_pgsize(domain, iova, size - unmapped);
7d3002cc 1585
bd13969b 1586 unmapped_page = domain->ops->unmap(domain, iova, pgsize);
7d3002cc
OBC
1587 if (!unmapped_page)
1588 break;
1589
6197ca82
JP
1590 pr_debug("unmapped: iova 0x%lx size 0x%zx\n",
1591 iova, unmapped_page);
7d3002cc
OBC
1592
1593 iova += unmapped_page;
1594 unmapped += unmapped_page;
1595 }
1596
db8614d3 1597 trace_unmap(orig_iova, size, unmapped);
7d3002cc 1598 return unmapped;
cefc53c7
JR
1599}
1600EXPORT_SYMBOL_GPL(iommu_unmap);
1460432c 1601
315786eb
OH
1602size_t default_iommu_map_sg(struct iommu_domain *domain, unsigned long iova,
1603 struct scatterlist *sg, unsigned int nents, int prot)
1604{
38ec010d 1605 struct scatterlist *s;
315786eb 1606 size_t mapped = 0;
18f23409 1607 unsigned int i, min_pagesz;
38ec010d 1608 int ret;
315786eb 1609
d16e0faa 1610 if (unlikely(domain->pgsize_bitmap == 0UL))
18f23409 1611 return 0;
315786eb 1612
d16e0faa 1613 min_pagesz = 1 << __ffs(domain->pgsize_bitmap);
18f23409
RM
1614
1615 for_each_sg(sg, s, nents, i) {
3e6110fd 1616 phys_addr_t phys = page_to_phys(sg_page(s)) + s->offset;
18f23409
RM
1617
1618 /*
1619 * We are mapping on IOMMU page boundaries, so offset within
1620 * the page must be 0. However, the IOMMU may support pages
1621 * smaller than PAGE_SIZE, so s->offset may still represent
1622 * an offset of that boundary within the CPU page.
1623 */
1624 if (!IS_ALIGNED(s->offset, min_pagesz))
38ec010d
JR
1625 goto out_err;
1626
1627 ret = iommu_map(domain, iova + mapped, phys, s->length, prot);
1628 if (ret)
1629 goto out_err;
1630
1631 mapped += s->length;
315786eb
OH
1632 }
1633
1634 return mapped;
38ec010d
JR
1635
1636out_err:
1637 /* undo mappings already done */
1638 iommu_unmap(domain, iova, mapped);
1639
1640 return 0;
1641
315786eb
OH
1642}
1643EXPORT_SYMBOL_GPL(default_iommu_map_sg);
d7787d57
JR
1644
1645int iommu_domain_window_enable(struct iommu_domain *domain, u32 wnd_nr,
80f97f0f 1646 phys_addr_t paddr, u64 size, int prot)
d7787d57
JR
1647{
1648 if (unlikely(domain->ops->domain_window_enable == NULL))
1649 return -ENODEV;
1650
80f97f0f
VS
1651 return domain->ops->domain_window_enable(domain, wnd_nr, paddr, size,
1652 prot);
d7787d57
JR
1653}
1654EXPORT_SYMBOL_GPL(iommu_domain_window_enable);
1655
1656void iommu_domain_window_disable(struct iommu_domain *domain, u32 wnd_nr)
1657{
1658 if (unlikely(domain->ops->domain_window_disable == NULL))
1659 return;
1660
1661 return domain->ops->domain_window_disable(domain, wnd_nr);
1662}
1663EXPORT_SYMBOL_GPL(iommu_domain_window_disable);
1664
207c6e36
JR
1665/**
1666 * report_iommu_fault() - report about an IOMMU fault to the IOMMU framework
1667 * @domain: the iommu domain where the fault has happened
1668 * @dev: the device where the fault has happened
1669 * @iova: the faulting address
1670 * @flags: mmu fault flags (e.g. IOMMU_FAULT_READ/IOMMU_FAULT_WRITE/...)
1671 *
1672 * This function should be called by the low-level IOMMU implementations
1673 * whenever IOMMU faults happen, to allow high-level users, that are
1674 * interested in such events, to know about them.
1675 *
1676 * This event may be useful for several possible use cases:
1677 * - mere logging of the event
1678 * - dynamic TLB/PTE loading
1679 * - if restarting of the faulting device is required
1680 *
1681 * Returns 0 on success and an appropriate error code otherwise (if dynamic
1682 * PTE/TLB loading will one day be supported, implementations will be able
1683 * to tell whether it succeeded or not according to this return value).
1684 *
1685 * Specifically, -ENOSYS is returned if a fault handler isn't installed
1686 * (though fault handlers can also return -ENOSYS, in case they want to
1687 * elicit the default behavior of the IOMMU drivers).
1688 */
1689int report_iommu_fault(struct iommu_domain *domain, struct device *dev,
1690 unsigned long iova, int flags)
1691{
1692 int ret = -ENOSYS;
1693
1694 /*
1695 * if upper layers showed interest and installed a fault handler,
1696 * invoke it.
1697 */
1698 if (domain->handler)
1699 ret = domain->handler(domain, dev, iova, flags,
1700 domain->handler_token);
1701
1702 trace_io_page_fault(dev, iova, flags);
1703 return ret;
1704}
1705EXPORT_SYMBOL_GPL(report_iommu_fault);
1706
d72e31c9 1707static int __init iommu_init(void)
1460432c 1708{
d72e31c9
AW
1709 iommu_group_kset = kset_create_and_add("iommu_groups",
1710 NULL, kernel_kobj);
d72e31c9
AW
1711 BUG_ON(!iommu_group_kset);
1712
1713 return 0;
1460432c 1714}
d7ef9995 1715core_initcall(iommu_init);
0cd76dd1
JR
1716
1717int iommu_domain_get_attr(struct iommu_domain *domain,
1718 enum iommu_attr attr, void *data)
1719{
0ff64f80 1720 struct iommu_domain_geometry *geometry;
d2e12160 1721 bool *paging;
0ff64f80 1722 int ret = 0;
69356712 1723 u32 *count;
0ff64f80
JR
1724
1725 switch (attr) {
1726 case DOMAIN_ATTR_GEOMETRY:
1727 geometry = data;
1728 *geometry = domain->geometry;
1729
d2e12160
JR
1730 break;
1731 case DOMAIN_ATTR_PAGING:
1732 paging = data;
d16e0faa 1733 *paging = (domain->pgsize_bitmap != 0UL);
69356712
JR
1734 break;
1735 case DOMAIN_ATTR_WINDOWS:
1736 count = data;
1737
1738 if (domain->ops->domain_get_windows != NULL)
1739 *count = domain->ops->domain_get_windows(domain);
1740 else
1741 ret = -ENODEV;
1742
0ff64f80
JR
1743 break;
1744 default:
1745 if (!domain->ops->domain_get_attr)
1746 return -EINVAL;
0cd76dd1 1747
0ff64f80
JR
1748 ret = domain->ops->domain_get_attr(domain, attr, data);
1749 }
1750
1751 return ret;
0cd76dd1
JR
1752}
1753EXPORT_SYMBOL_GPL(iommu_domain_get_attr);
1754
1755int iommu_domain_set_attr(struct iommu_domain *domain,
1756 enum iommu_attr attr, void *data)
1757{
69356712
JR
1758 int ret = 0;
1759 u32 *count;
1760
1761 switch (attr) {
1762 case DOMAIN_ATTR_WINDOWS:
1763 count = data;
1764
1765 if (domain->ops->domain_set_windows != NULL)
1766 ret = domain->ops->domain_set_windows(domain, *count);
1767 else
1768 ret = -ENODEV;
1460432c 1769
69356712
JR
1770 break;
1771 default:
1772 if (domain->ops->domain_set_attr == NULL)
1773 return -EINVAL;
1774
1775 ret = domain->ops->domain_set_attr(domain, attr, data);
1776 }
1777
1778 return ret;
1460432c 1779}
0cd76dd1 1780EXPORT_SYMBOL_GPL(iommu_domain_set_attr);
a1015c2b 1781
e5b5234a 1782void iommu_get_resv_regions(struct device *dev, struct list_head *list)
a1015c2b
JR
1783{
1784 const struct iommu_ops *ops = dev->bus->iommu_ops;
1785
e5b5234a
EA
1786 if (ops && ops->get_resv_regions)
1787 ops->get_resv_regions(dev, list);
a1015c2b
JR
1788}
1789
e5b5234a 1790void iommu_put_resv_regions(struct device *dev, struct list_head *list)
a1015c2b
JR
1791{
1792 const struct iommu_ops *ops = dev->bus->iommu_ops;
1793
e5b5234a
EA
1794 if (ops && ops->put_resv_regions)
1795 ops->put_resv_regions(dev, list);
a1015c2b 1796}
d290f1e7 1797
2b20cbba 1798struct iommu_resv_region *iommu_alloc_resv_region(phys_addr_t start,
9d3a4de4
RM
1799 size_t length, int prot,
1800 enum iommu_resv_type type)
2b20cbba
EA
1801{
1802 struct iommu_resv_region *region;
1803
1804 region = kzalloc(sizeof(*region), GFP_KERNEL);
1805 if (!region)
1806 return NULL;
1807
1808 INIT_LIST_HEAD(&region->list);
1809 region->start = start;
1810 region->length = length;
1811 region->prot = prot;
1812 region->type = type;
1813 return region;
a1015c2b 1814}
d290f1e7
JR
1815
1816/* Request that a device is direct mapped by the IOMMU */
1817int iommu_request_dm_for_dev(struct device *dev)
1818{
1819 struct iommu_domain *dm_domain;
1820 struct iommu_group *group;
1821 int ret;
1822
1823 /* Device must already be in a group before calling this function */
1824 group = iommu_group_get_for_dev(dev);
409e553d
DC
1825 if (IS_ERR(group))
1826 return PTR_ERR(group);
d290f1e7
JR
1827
1828 mutex_lock(&group->mutex);
1829
1830 /* Check if the default domain is already direct mapped */
1831 ret = 0;
1832 if (group->default_domain &&
1833 group->default_domain->type == IOMMU_DOMAIN_IDENTITY)
1834 goto out;
1835
1836 /* Don't change mappings of existing devices */
1837 ret = -EBUSY;
1838 if (iommu_group_device_count(group) != 1)
1839 goto out;
1840
1841 /* Allocate a direct mapped domain */
1842 ret = -ENOMEM;
1843 dm_domain = __iommu_domain_alloc(dev->bus, IOMMU_DOMAIN_IDENTITY);
1844 if (!dm_domain)
1845 goto out;
1846
1847 /* Attach the device to the domain */
1848 ret = __iommu_attach_group(dm_domain, group);
1849 if (ret) {
1850 iommu_domain_free(dm_domain);
1851 goto out;
1852 }
1853
1854 /* Make the direct mapped domain the default for this group */
1855 if (group->default_domain)
1856 iommu_domain_free(group->default_domain);
1857 group->default_domain = dm_domain;
1858
1859 pr_info("Using direct mapping for device %s\n", dev_name(dev));
1860
1861 ret = 0;
1862out:
1863 mutex_unlock(&group->mutex);
1864 iommu_group_put(group);
1865
1866 return ret;
1867}
57f98d2f 1868
534766df 1869const struct iommu_ops *iommu_ops_from_fwnode(struct fwnode_handle *fwnode)
e4f10ffe 1870{
e4f10ffe 1871 const struct iommu_ops *ops = NULL;
d0f6f583 1872 struct iommu_device *iommu;
e4f10ffe 1873
d0f6f583
JR
1874 spin_lock(&iommu_device_lock);
1875 list_for_each_entry(iommu, &iommu_device_list, list)
1876 if (iommu->fwnode == fwnode) {
1877 ops = iommu->ops;
e4f10ffe
LP
1878 break;
1879 }
d0f6f583 1880 spin_unlock(&iommu_device_lock);
e4f10ffe
LP
1881 return ops;
1882}
1883
57f98d2f
RM
1884int iommu_fwspec_init(struct device *dev, struct fwnode_handle *iommu_fwnode,
1885 const struct iommu_ops *ops)
1886{
1887 struct iommu_fwspec *fwspec = dev->iommu_fwspec;
1888
1889 if (fwspec)
1890 return ops == fwspec->ops ? 0 : -EINVAL;
1891
1892 fwspec = kzalloc(sizeof(*fwspec), GFP_KERNEL);
1893 if (!fwspec)
1894 return -ENOMEM;
1895
1896 of_node_get(to_of_node(iommu_fwnode));
1897 fwspec->iommu_fwnode = iommu_fwnode;
1898 fwspec->ops = ops;
1899 dev->iommu_fwspec = fwspec;
1900 return 0;
1901}
1902EXPORT_SYMBOL_GPL(iommu_fwspec_init);
1903
1904void iommu_fwspec_free(struct device *dev)
1905{
1906 struct iommu_fwspec *fwspec = dev->iommu_fwspec;
1907
1908 if (fwspec) {
1909 fwnode_handle_put(fwspec->iommu_fwnode);
1910 kfree(fwspec);
1911 dev->iommu_fwspec = NULL;
1912 }
1913}
1914EXPORT_SYMBOL_GPL(iommu_fwspec_free);
1915
1916int iommu_fwspec_add_ids(struct device *dev, u32 *ids, int num_ids)
1917{
1918 struct iommu_fwspec *fwspec = dev->iommu_fwspec;
1919 size_t size;
1920 int i;
1921
1922 if (!fwspec)
1923 return -EINVAL;
1924
1925 size = offsetof(struct iommu_fwspec, ids[fwspec->num_ids + num_ids]);
1926 if (size > sizeof(*fwspec)) {
1927 fwspec = krealloc(dev->iommu_fwspec, size, GFP_KERNEL);
1928 if (!fwspec)
1929 return -ENOMEM;
909111ba
ZL
1930
1931 dev->iommu_fwspec = fwspec;
57f98d2f
RM
1932 }
1933
1934 for (i = 0; i < num_ids; i++)
1935 fwspec->ids[fwspec->num_ids + i] = ids[i];
1936
1937 fwspec->num_ids += num_ids;
57f98d2f
RM
1938 return 0;
1939}
1940EXPORT_SYMBOL_GPL(iommu_fwspec_add_ids);