2 * Copyright (C) 2007-2008 Advanced Micro Devices, Inc.
3 * Author: Joerg Roedel <jroedel@suse.de>
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.
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.
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
19 #define pr_fmt(fmt) "iommu: " fmt
21 #include <linux/device.h>
22 #include <linux/kernel.h>
23 #include <linux/bug.h>
24 #include <linux/types.h>
25 #include <linux/init.h>
26 #include <linux/export.h>
27 #include <linux/slab.h>
28 #include <linux/errno.h>
29 #include <linux/iommu.h>
30 #include <linux/idr.h>
31 #include <linux/notifier.h>
32 #include <linux/err.h>
33 #include <linux/pci.h>
34 #include <linux/bitops.h>
35 #include <linux/property.h>
36 #include <linux/fsl/mc.h>
37 #include <trace/events/iommu.h>
39 static struct kset
*iommu_group_kset
;
40 static DEFINE_IDA(iommu_group_ida
);
41 #ifdef CONFIG_IOMMU_DEFAULT_PASSTHROUGH
42 static unsigned int iommu_def_domain_type
= IOMMU_DOMAIN_IDENTITY
;
44 static unsigned int iommu_def_domain_type
= IOMMU_DOMAIN_DMA
;
46 static bool iommu_dma_strict __read_mostly
= true;
48 struct iommu_callback_data
{
49 const struct iommu_ops
*ops
;
54 struct kobject
*devices_kobj
;
55 struct list_head devices
;
57 struct blocking_notifier_head notifier
;
59 void (*iommu_data_release
)(void *iommu_data
);
62 struct iommu_domain
*default_domain
;
63 struct iommu_domain
*domain
;
67 struct list_head list
;
72 struct iommu_group_attribute
{
73 struct attribute attr
;
74 ssize_t (*show
)(struct iommu_group
*group
, char *buf
);
75 ssize_t (*store
)(struct iommu_group
*group
,
76 const char *buf
, size_t count
);
79 static const char * const iommu_group_resv_type_string
[] = {
80 [IOMMU_RESV_DIRECT
] = "direct",
81 [IOMMU_RESV_RESERVED
] = "reserved",
82 [IOMMU_RESV_MSI
] = "msi",
83 [IOMMU_RESV_SW_MSI
] = "msi",
86 #define IOMMU_GROUP_ATTR(_name, _mode, _show, _store) \
87 struct iommu_group_attribute iommu_group_attr_##_name = \
88 __ATTR(_name, _mode, _show, _store)
90 #define to_iommu_group_attr(_attr) \
91 container_of(_attr, struct iommu_group_attribute, attr)
92 #define to_iommu_group(_kobj) \
93 container_of(_kobj, struct iommu_group, kobj)
95 static LIST_HEAD(iommu_device_list
);
96 static DEFINE_SPINLOCK(iommu_device_lock
);
98 int iommu_device_register(struct iommu_device
*iommu
)
100 spin_lock(&iommu_device_lock
);
101 list_add_tail(&iommu
->list
, &iommu_device_list
);
102 spin_unlock(&iommu_device_lock
);
107 void iommu_device_unregister(struct iommu_device
*iommu
)
109 spin_lock(&iommu_device_lock
);
110 list_del(&iommu
->list
);
111 spin_unlock(&iommu_device_lock
);
114 int iommu_probe_device(struct device
*dev
)
116 const struct iommu_ops
*ops
= dev
->bus
->iommu_ops
;
119 WARN_ON(dev
->iommu_group
);
122 ret
= ops
->add_device(dev
);
127 void iommu_release_device(struct device
*dev
)
129 const struct iommu_ops
*ops
= dev
->bus
->iommu_ops
;
131 if (dev
->iommu_group
)
132 ops
->remove_device(dev
);
135 static struct iommu_domain
*__iommu_domain_alloc(struct bus_type
*bus
,
137 static int __iommu_attach_device(struct iommu_domain
*domain
,
139 static int __iommu_attach_group(struct iommu_domain
*domain
,
140 struct iommu_group
*group
);
141 static void __iommu_detach_group(struct iommu_domain
*domain
,
142 struct iommu_group
*group
);
144 static int __init
iommu_set_def_domain_type(char *str
)
149 ret
= kstrtobool(str
, &pt
);
153 iommu_def_domain_type
= pt
? IOMMU_DOMAIN_IDENTITY
: IOMMU_DOMAIN_DMA
;
156 early_param("iommu.passthrough", iommu_set_def_domain_type
);
158 static int __init
iommu_dma_setup(char *str
)
160 return kstrtobool(str
, &iommu_dma_strict
);
162 early_param("iommu.strict", iommu_dma_setup
);
164 static ssize_t
iommu_group_attr_show(struct kobject
*kobj
,
165 struct attribute
*__attr
, char *buf
)
167 struct iommu_group_attribute
*attr
= to_iommu_group_attr(__attr
);
168 struct iommu_group
*group
= to_iommu_group(kobj
);
172 ret
= attr
->show(group
, buf
);
176 static ssize_t
iommu_group_attr_store(struct kobject
*kobj
,
177 struct attribute
*__attr
,
178 const char *buf
, size_t count
)
180 struct iommu_group_attribute
*attr
= to_iommu_group_attr(__attr
);
181 struct iommu_group
*group
= to_iommu_group(kobj
);
185 ret
= attr
->store(group
, buf
, count
);
189 static const struct sysfs_ops iommu_group_sysfs_ops
= {
190 .show
= iommu_group_attr_show
,
191 .store
= iommu_group_attr_store
,
194 static int iommu_group_create_file(struct iommu_group
*group
,
195 struct iommu_group_attribute
*attr
)
197 return sysfs_create_file(&group
->kobj
, &attr
->attr
);
200 static void iommu_group_remove_file(struct iommu_group
*group
,
201 struct iommu_group_attribute
*attr
)
203 sysfs_remove_file(&group
->kobj
, &attr
->attr
);
206 static ssize_t
iommu_group_show_name(struct iommu_group
*group
, char *buf
)
208 return sprintf(buf
, "%s\n", group
->name
);
212 * iommu_insert_resv_region - Insert a new region in the
213 * list of reserved regions.
214 * @new: new region to insert
215 * @regions: list of regions
217 * The new element is sorted by address with respect to the other
218 * regions of the same type. In case it overlaps with another
219 * region of the same type, regions are merged. In case it
220 * overlaps with another region of different type, regions are
223 static int iommu_insert_resv_region(struct iommu_resv_region
*new,
224 struct list_head
*regions
)
226 struct iommu_resv_region
*region
;
227 phys_addr_t start
= new->start
;
228 phys_addr_t end
= new->start
+ new->length
- 1;
229 struct list_head
*pos
= regions
->next
;
231 while (pos
!= regions
) {
232 struct iommu_resv_region
*entry
=
233 list_entry(pos
, struct iommu_resv_region
, list
);
234 phys_addr_t a
= entry
->start
;
235 phys_addr_t b
= entry
->start
+ entry
->length
- 1;
236 int type
= entry
->type
;
240 } else if (start
> b
) {
242 } else if ((start
>= a
) && (end
<= b
)) {
243 if (new->type
== type
)
248 if (new->type
== type
) {
249 phys_addr_t new_start
= min(a
, start
);
250 phys_addr_t new_end
= max(b
, end
);
252 list_del(&entry
->list
);
253 entry
->start
= new_start
;
254 entry
->length
= new_end
- new_start
+ 1;
255 iommu_insert_resv_region(entry
, regions
);
262 region
= iommu_alloc_resv_region(new->start
, new->length
,
263 new->prot
, new->type
);
267 list_add_tail(®ion
->list
, pos
);
273 iommu_insert_device_resv_regions(struct list_head
*dev_resv_regions
,
274 struct list_head
*group_resv_regions
)
276 struct iommu_resv_region
*entry
;
279 list_for_each_entry(entry
, dev_resv_regions
, list
) {
280 ret
= iommu_insert_resv_region(entry
, group_resv_regions
);
287 int iommu_get_group_resv_regions(struct iommu_group
*group
,
288 struct list_head
*head
)
290 struct group_device
*device
;
293 mutex_lock(&group
->mutex
);
294 list_for_each_entry(device
, &group
->devices
, list
) {
295 struct list_head dev_resv_regions
;
297 INIT_LIST_HEAD(&dev_resv_regions
);
298 iommu_get_resv_regions(device
->dev
, &dev_resv_regions
);
299 ret
= iommu_insert_device_resv_regions(&dev_resv_regions
, head
);
300 iommu_put_resv_regions(device
->dev
, &dev_resv_regions
);
304 mutex_unlock(&group
->mutex
);
307 EXPORT_SYMBOL_GPL(iommu_get_group_resv_regions
);
309 static ssize_t
iommu_group_show_resv_regions(struct iommu_group
*group
,
312 struct iommu_resv_region
*region
, *next
;
313 struct list_head group_resv_regions
;
316 INIT_LIST_HEAD(&group_resv_regions
);
317 iommu_get_group_resv_regions(group
, &group_resv_regions
);
319 list_for_each_entry_safe(region
, next
, &group_resv_regions
, list
) {
320 str
+= sprintf(str
, "0x%016llx 0x%016llx %s\n",
321 (long long int)region
->start
,
322 (long long int)(region
->start
+
324 iommu_group_resv_type_string
[region
->type
]);
331 static ssize_t
iommu_group_show_type(struct iommu_group
*group
,
334 char *type
= "unknown\n";
336 if (group
->default_domain
) {
337 switch (group
->default_domain
->type
) {
338 case IOMMU_DOMAIN_BLOCKED
:
341 case IOMMU_DOMAIN_IDENTITY
:
344 case IOMMU_DOMAIN_UNMANAGED
:
345 type
= "unmanaged\n";
347 case IOMMU_DOMAIN_DMA
:
357 static IOMMU_GROUP_ATTR(name
, S_IRUGO
, iommu_group_show_name
, NULL
);
359 static IOMMU_GROUP_ATTR(reserved_regions
, 0444,
360 iommu_group_show_resv_regions
, NULL
);
362 static IOMMU_GROUP_ATTR(type
, 0444, iommu_group_show_type
, NULL
);
364 static void iommu_group_release(struct kobject
*kobj
)
366 struct iommu_group
*group
= to_iommu_group(kobj
);
368 pr_debug("Releasing group %d\n", group
->id
);
370 if (group
->iommu_data_release
)
371 group
->iommu_data_release(group
->iommu_data
);
373 ida_simple_remove(&iommu_group_ida
, group
->id
);
375 if (group
->default_domain
)
376 iommu_domain_free(group
->default_domain
);
382 static struct kobj_type iommu_group_ktype
= {
383 .sysfs_ops
= &iommu_group_sysfs_ops
,
384 .release
= iommu_group_release
,
388 * iommu_group_alloc - Allocate a new group
390 * This function is called by an iommu driver to allocate a new iommu
391 * group. The iommu group represents the minimum granularity of the iommu.
392 * Upon successful return, the caller holds a reference to the supplied
393 * group in order to hold the group until devices are added. Use
394 * iommu_group_put() to release this extra reference count, allowing the
395 * group to be automatically reclaimed once it has no devices or external
398 struct iommu_group
*iommu_group_alloc(void)
400 struct iommu_group
*group
;
403 group
= kzalloc(sizeof(*group
), GFP_KERNEL
);
405 return ERR_PTR(-ENOMEM
);
407 group
->kobj
.kset
= iommu_group_kset
;
408 mutex_init(&group
->mutex
);
409 INIT_LIST_HEAD(&group
->devices
);
410 BLOCKING_INIT_NOTIFIER_HEAD(&group
->notifier
);
412 ret
= ida_simple_get(&iommu_group_ida
, 0, 0, GFP_KERNEL
);
419 ret
= kobject_init_and_add(&group
->kobj
, &iommu_group_ktype
,
420 NULL
, "%d", group
->id
);
422 ida_simple_remove(&iommu_group_ida
, group
->id
);
427 group
->devices_kobj
= kobject_create_and_add("devices", &group
->kobj
);
428 if (!group
->devices_kobj
) {
429 kobject_put(&group
->kobj
); /* triggers .release & free */
430 return ERR_PTR(-ENOMEM
);
434 * The devices_kobj holds a reference on the group kobject, so
435 * as long as that exists so will the group. We can therefore
436 * use the devices_kobj for reference counting.
438 kobject_put(&group
->kobj
);
440 ret
= iommu_group_create_file(group
,
441 &iommu_group_attr_reserved_regions
);
445 ret
= iommu_group_create_file(group
, &iommu_group_attr_type
);
449 pr_debug("Allocated group %d\n", group
->id
);
453 EXPORT_SYMBOL_GPL(iommu_group_alloc
);
455 struct iommu_group
*iommu_group_get_by_id(int id
)
457 struct kobject
*group_kobj
;
458 struct iommu_group
*group
;
461 if (!iommu_group_kset
)
464 name
= kasprintf(GFP_KERNEL
, "%d", id
);
468 group_kobj
= kset_find_obj(iommu_group_kset
, name
);
474 group
= container_of(group_kobj
, struct iommu_group
, kobj
);
475 BUG_ON(group
->id
!= id
);
477 kobject_get(group
->devices_kobj
);
478 kobject_put(&group
->kobj
);
482 EXPORT_SYMBOL_GPL(iommu_group_get_by_id
);
485 * iommu_group_get_iommudata - retrieve iommu_data registered for a group
488 * iommu drivers can store data in the group for use when doing iommu
489 * operations. This function provides a way to retrieve it. Caller
490 * should hold a group reference.
492 void *iommu_group_get_iommudata(struct iommu_group
*group
)
494 return group
->iommu_data
;
496 EXPORT_SYMBOL_GPL(iommu_group_get_iommudata
);
499 * iommu_group_set_iommudata - set iommu_data for a group
501 * @iommu_data: new data
502 * @release: release function for iommu_data
504 * iommu drivers can store data in the group for use when doing iommu
505 * operations. This function provides a way to set the data after
506 * the group has been allocated. Caller should hold a group reference.
508 void iommu_group_set_iommudata(struct iommu_group
*group
, void *iommu_data
,
509 void (*release
)(void *iommu_data
))
511 group
->iommu_data
= iommu_data
;
512 group
->iommu_data_release
= release
;
514 EXPORT_SYMBOL_GPL(iommu_group_set_iommudata
);
517 * iommu_group_set_name - set name for a group
521 * Allow iommu driver to set a name for a group. When set it will
522 * appear in a name attribute file under the group in sysfs.
524 int iommu_group_set_name(struct iommu_group
*group
, const char *name
)
529 iommu_group_remove_file(group
, &iommu_group_attr_name
);
536 group
->name
= kstrdup(name
, GFP_KERNEL
);
540 ret
= iommu_group_create_file(group
, &iommu_group_attr_name
);
549 EXPORT_SYMBOL_GPL(iommu_group_set_name
);
551 static int iommu_group_create_direct_mappings(struct iommu_group
*group
,
554 struct iommu_domain
*domain
= group
->default_domain
;
555 struct iommu_resv_region
*entry
;
556 struct list_head mappings
;
557 unsigned long pg_size
;
560 if (!domain
|| domain
->type
!= IOMMU_DOMAIN_DMA
)
563 BUG_ON(!domain
->pgsize_bitmap
);
565 pg_size
= 1UL << __ffs(domain
->pgsize_bitmap
);
566 INIT_LIST_HEAD(&mappings
);
568 iommu_get_resv_regions(dev
, &mappings
);
570 /* We need to consider overlapping regions for different devices */
571 list_for_each_entry(entry
, &mappings
, list
) {
572 dma_addr_t start
, end
, addr
;
574 if (domain
->ops
->apply_resv_region
)
575 domain
->ops
->apply_resv_region(dev
, domain
, entry
);
577 start
= ALIGN(entry
->start
, pg_size
);
578 end
= ALIGN(entry
->start
+ entry
->length
, pg_size
);
580 if (entry
->type
!= IOMMU_RESV_DIRECT
)
583 for (addr
= start
; addr
< end
; addr
+= pg_size
) {
584 phys_addr_t phys_addr
;
586 phys_addr
= iommu_iova_to_phys(domain
, addr
);
590 ret
= iommu_map(domain
, addr
, addr
, pg_size
, entry
->prot
);
597 iommu_flush_tlb_all(domain
);
600 iommu_put_resv_regions(dev
, &mappings
);
606 * iommu_group_add_device - add a device to an iommu group
607 * @group: the group into which to add the device (reference should be held)
610 * This function is called by an iommu driver to add a device into a
611 * group. Adding a device increments the group reference count.
613 int iommu_group_add_device(struct iommu_group
*group
, struct device
*dev
)
616 struct group_device
*device
;
618 device
= kzalloc(sizeof(*device
), GFP_KERNEL
);
624 ret
= sysfs_create_link(&dev
->kobj
, &group
->kobj
, "iommu_group");
626 goto err_free_device
;
628 device
->name
= kasprintf(GFP_KERNEL
, "%s", kobject_name(&dev
->kobj
));
632 goto err_remove_link
;
635 ret
= sysfs_create_link_nowarn(group
->devices_kobj
,
636 &dev
->kobj
, device
->name
);
638 if (ret
== -EEXIST
&& i
>= 0) {
640 * Account for the slim chance of collision
641 * and append an instance to the name.
644 device
->name
= kasprintf(GFP_KERNEL
, "%s.%d",
645 kobject_name(&dev
->kobj
), i
++);
651 kobject_get(group
->devices_kobj
);
653 dev
->iommu_group
= group
;
655 iommu_group_create_direct_mappings(group
, dev
);
657 mutex_lock(&group
->mutex
);
658 list_add_tail(&device
->list
, &group
->devices
);
660 ret
= __iommu_attach_device(group
->domain
, dev
);
661 mutex_unlock(&group
->mutex
);
665 /* Notify any listeners about change to group. */
666 blocking_notifier_call_chain(&group
->notifier
,
667 IOMMU_GROUP_NOTIFY_ADD_DEVICE
, dev
);
669 trace_add_device_to_group(group
->id
, dev
);
671 dev_info(dev
, "Adding to iommu group %d\n", group
->id
);
676 mutex_lock(&group
->mutex
);
677 list_del(&device
->list
);
678 mutex_unlock(&group
->mutex
);
679 dev
->iommu_group
= NULL
;
680 kobject_put(group
->devices_kobj
);
684 sysfs_remove_link(&dev
->kobj
, "iommu_group");
687 dev_err(dev
, "Failed to add to iommu group %d: %d\n", group
->id
, ret
);
690 EXPORT_SYMBOL_GPL(iommu_group_add_device
);
693 * iommu_group_remove_device - remove a device from it's current group
694 * @dev: device to be removed
696 * This function is called by an iommu driver to remove the device from
697 * it's current group. This decrements the iommu group reference count.
699 void iommu_group_remove_device(struct device
*dev
)
701 struct iommu_group
*group
= dev
->iommu_group
;
702 struct group_device
*tmp_device
, *device
= NULL
;
704 dev_info(dev
, "Removing from iommu group %d\n", group
->id
);
706 /* Pre-notify listeners that a device is being removed. */
707 blocking_notifier_call_chain(&group
->notifier
,
708 IOMMU_GROUP_NOTIFY_DEL_DEVICE
, dev
);
710 mutex_lock(&group
->mutex
);
711 list_for_each_entry(tmp_device
, &group
->devices
, list
) {
712 if (tmp_device
->dev
== dev
) {
714 list_del(&device
->list
);
718 mutex_unlock(&group
->mutex
);
723 sysfs_remove_link(group
->devices_kobj
, device
->name
);
724 sysfs_remove_link(&dev
->kobj
, "iommu_group");
726 trace_remove_device_from_group(group
->id
, dev
);
730 dev
->iommu_group
= NULL
;
731 kobject_put(group
->devices_kobj
);
733 EXPORT_SYMBOL_GPL(iommu_group_remove_device
);
735 static int iommu_group_device_count(struct iommu_group
*group
)
737 struct group_device
*entry
;
740 list_for_each_entry(entry
, &group
->devices
, list
)
747 * iommu_group_for_each_dev - iterate over each device in the group
749 * @data: caller opaque data to be passed to callback function
750 * @fn: caller supplied callback function
752 * This function is called by group users to iterate over group devices.
753 * Callers should hold a reference count to the group during callback.
754 * The group->mutex is held across callbacks, which will block calls to
755 * iommu_group_add/remove_device.
757 static int __iommu_group_for_each_dev(struct iommu_group
*group
, void *data
,
758 int (*fn
)(struct device
*, void *))
760 struct group_device
*device
;
763 list_for_each_entry(device
, &group
->devices
, list
) {
764 ret
= fn(device
->dev
, data
);
772 int iommu_group_for_each_dev(struct iommu_group
*group
, void *data
,
773 int (*fn
)(struct device
*, void *))
777 mutex_lock(&group
->mutex
);
778 ret
= __iommu_group_for_each_dev(group
, data
, fn
);
779 mutex_unlock(&group
->mutex
);
783 EXPORT_SYMBOL_GPL(iommu_group_for_each_dev
);
786 * iommu_group_get - Return the group for a device and increment reference
787 * @dev: get the group that this device belongs to
789 * This function is called by iommu drivers and users to get the group
790 * for the specified device. If found, the group is returned and the group
791 * reference in incremented, else NULL.
793 struct iommu_group
*iommu_group_get(struct device
*dev
)
795 struct iommu_group
*group
= dev
->iommu_group
;
798 kobject_get(group
->devices_kobj
);
802 EXPORT_SYMBOL_GPL(iommu_group_get
);
805 * iommu_group_ref_get - Increment reference on a group
806 * @group: the group to use, must not be NULL
808 * This function is called by iommu drivers to take additional references on an
809 * existing group. Returns the given group for convenience.
811 struct iommu_group
*iommu_group_ref_get(struct iommu_group
*group
)
813 kobject_get(group
->devices_kobj
);
818 * iommu_group_put - Decrement group reference
819 * @group: the group to use
821 * This function is called by iommu drivers and users to release the
822 * iommu group. Once the reference count is zero, the group is released.
824 void iommu_group_put(struct iommu_group
*group
)
827 kobject_put(group
->devices_kobj
);
829 EXPORT_SYMBOL_GPL(iommu_group_put
);
832 * iommu_group_register_notifier - Register a notifier for group changes
833 * @group: the group to watch
834 * @nb: notifier block to signal
836 * This function allows iommu group users to track changes in a group.
837 * See include/linux/iommu.h for actions sent via this notifier. Caller
838 * should hold a reference to the group throughout notifier registration.
840 int iommu_group_register_notifier(struct iommu_group
*group
,
841 struct notifier_block
*nb
)
843 return blocking_notifier_chain_register(&group
->notifier
, nb
);
845 EXPORT_SYMBOL_GPL(iommu_group_register_notifier
);
848 * iommu_group_unregister_notifier - Unregister a notifier
849 * @group: the group to watch
850 * @nb: notifier block to signal
852 * Unregister a previously registered group notifier block.
854 int iommu_group_unregister_notifier(struct iommu_group
*group
,
855 struct notifier_block
*nb
)
857 return blocking_notifier_chain_unregister(&group
->notifier
, nb
);
859 EXPORT_SYMBOL_GPL(iommu_group_unregister_notifier
);
862 * iommu_group_id - Return ID for a group
863 * @group: the group to ID
865 * Return the unique ID for the group matching the sysfs group number.
867 int iommu_group_id(struct iommu_group
*group
)
871 EXPORT_SYMBOL_GPL(iommu_group_id
);
873 static struct iommu_group
*get_pci_alias_group(struct pci_dev
*pdev
,
874 unsigned long *devfns
);
877 * To consider a PCI device isolated, we require ACS to support Source
878 * Validation, Request Redirection, Completer Redirection, and Upstream
879 * Forwarding. This effectively means that devices cannot spoof their
880 * requester ID, requests and completions cannot be redirected, and all
881 * transactions are forwarded upstream, even as it passes through a
882 * bridge where the target device is downstream.
884 #define REQ_ACS_FLAGS (PCI_ACS_SV | PCI_ACS_RR | PCI_ACS_CR | PCI_ACS_UF)
887 * For multifunction devices which are not isolated from each other, find
888 * all the other non-isolated functions and look for existing groups. For
889 * each function, we also need to look for aliases to or from other devices
890 * that may already have a group.
892 static struct iommu_group
*get_pci_function_alias_group(struct pci_dev
*pdev
,
893 unsigned long *devfns
)
895 struct pci_dev
*tmp
= NULL
;
896 struct iommu_group
*group
;
898 if (!pdev
->multifunction
|| pci_acs_enabled(pdev
, REQ_ACS_FLAGS
))
901 for_each_pci_dev(tmp
) {
902 if (tmp
== pdev
|| tmp
->bus
!= pdev
->bus
||
903 PCI_SLOT(tmp
->devfn
) != PCI_SLOT(pdev
->devfn
) ||
904 pci_acs_enabled(tmp
, REQ_ACS_FLAGS
))
907 group
= get_pci_alias_group(tmp
, devfns
);
918 * Look for aliases to or from the given device for existing groups. DMA
919 * aliases are only supported on the same bus, therefore the search
920 * space is quite small (especially since we're really only looking at pcie
921 * device, and therefore only expect multiple slots on the root complex or
922 * downstream switch ports). It's conceivable though that a pair of
923 * multifunction devices could have aliases between them that would cause a
924 * loop. To prevent this, we use a bitmap to track where we've been.
926 static struct iommu_group
*get_pci_alias_group(struct pci_dev
*pdev
,
927 unsigned long *devfns
)
929 struct pci_dev
*tmp
= NULL
;
930 struct iommu_group
*group
;
932 if (test_and_set_bit(pdev
->devfn
& 0xff, devfns
))
935 group
= iommu_group_get(&pdev
->dev
);
939 for_each_pci_dev(tmp
) {
940 if (tmp
== pdev
|| tmp
->bus
!= pdev
->bus
)
943 /* We alias them or they alias us */
944 if (pci_devs_are_dma_aliases(pdev
, tmp
)) {
945 group
= get_pci_alias_group(tmp
, devfns
);
951 group
= get_pci_function_alias_group(tmp
, devfns
);
962 struct group_for_pci_data
{
963 struct pci_dev
*pdev
;
964 struct iommu_group
*group
;
968 * DMA alias iterator callback, return the last seen device. Stop and return
969 * the IOMMU group if we find one along the way.
971 static int get_pci_alias_or_group(struct pci_dev
*pdev
, u16 alias
, void *opaque
)
973 struct group_for_pci_data
*data
= opaque
;
976 data
->group
= iommu_group_get(&pdev
->dev
);
978 return data
->group
!= NULL
;
982 * Generic device_group call-back function. It just allocates one
983 * iommu-group per device.
985 struct iommu_group
*generic_device_group(struct device
*dev
)
987 return iommu_group_alloc();
991 * Use standard PCI bus topology, isolation features, and DMA alias quirks
992 * to find or create an IOMMU group for a device.
994 struct iommu_group
*pci_device_group(struct device
*dev
)
996 struct pci_dev
*pdev
= to_pci_dev(dev
);
997 struct group_for_pci_data data
;
999 struct iommu_group
*group
= NULL
;
1000 u64 devfns
[4] = { 0 };
1002 if (WARN_ON(!dev_is_pci(dev
)))
1003 return ERR_PTR(-EINVAL
);
1006 * Find the upstream DMA alias for the device. A device must not
1007 * be aliased due to topology in order to have its own IOMMU group.
1008 * If we find an alias along the way that already belongs to a
1011 if (pci_for_each_dma_alias(pdev
, get_pci_alias_or_group
, &data
))
1017 * Continue upstream from the point of minimum IOMMU granularity
1018 * due to aliases to the point where devices are protected from
1019 * peer-to-peer DMA by PCI ACS. Again, if we find an existing
1022 for (bus
= pdev
->bus
; !pci_is_root_bus(bus
); bus
= bus
->parent
) {
1026 if (pci_acs_path_enabled(bus
->self
, NULL
, REQ_ACS_FLAGS
))
1031 group
= iommu_group_get(&pdev
->dev
);
1037 * Look for existing groups on device aliases. If we alias another
1038 * device or another device aliases us, use the same group.
1040 group
= get_pci_alias_group(pdev
, (unsigned long *)devfns
);
1045 * Look for existing groups on non-isolated functions on the same
1046 * slot and aliases of those funcions, if any. No need to clear
1047 * the search bitmap, the tested devfns are still valid.
1049 group
= get_pci_function_alias_group(pdev
, (unsigned long *)devfns
);
1053 /* No shared group found, allocate new */
1054 return iommu_group_alloc();
1057 /* Get the IOMMU group for device on fsl-mc bus */
1058 struct iommu_group
*fsl_mc_device_group(struct device
*dev
)
1060 struct device
*cont_dev
= fsl_mc_cont_dev(dev
);
1061 struct iommu_group
*group
;
1063 group
= iommu_group_get(cont_dev
);
1065 group
= iommu_group_alloc();
1070 * iommu_group_get_for_dev - Find or create the IOMMU group for a device
1071 * @dev: target device
1073 * This function is intended to be called by IOMMU drivers and extended to
1074 * support common, bus-defined algorithms when determining or creating the
1075 * IOMMU group for a device. On success, the caller will hold a reference
1076 * to the returned IOMMU group, which will already include the provided
1077 * device. The reference should be released with iommu_group_put().
1079 struct iommu_group
*iommu_group_get_for_dev(struct device
*dev
)
1081 const struct iommu_ops
*ops
= dev
->bus
->iommu_ops
;
1082 struct iommu_group
*group
;
1085 group
= iommu_group_get(dev
);
1090 return ERR_PTR(-EINVAL
);
1092 group
= ops
->device_group(dev
);
1093 if (WARN_ON_ONCE(group
== NULL
))
1094 return ERR_PTR(-EINVAL
);
1100 * Try to allocate a default domain - needs support from the
1103 if (!group
->default_domain
) {
1104 struct iommu_domain
*dom
;
1106 dom
= __iommu_domain_alloc(dev
->bus
, iommu_def_domain_type
);
1107 if (!dom
&& iommu_def_domain_type
!= IOMMU_DOMAIN_DMA
) {
1108 dom
= __iommu_domain_alloc(dev
->bus
, IOMMU_DOMAIN_DMA
);
1111 "failed to allocate default IOMMU domain of type %u; falling back to IOMMU_DOMAIN_DMA",
1112 iommu_def_domain_type
);
1116 group
->default_domain
= dom
;
1118 group
->domain
= dom
;
1120 if (dom
&& !iommu_dma_strict
) {
1122 iommu_domain_set_attr(dom
,
1123 DOMAIN_ATTR_DMA_USE_FLUSH_QUEUE
,
1128 ret
= iommu_group_add_device(group
, dev
);
1130 iommu_group_put(group
);
1131 return ERR_PTR(ret
);
1137 struct iommu_domain
*iommu_group_default_domain(struct iommu_group
*group
)
1139 return group
->default_domain
;
1142 static int add_iommu_group(struct device
*dev
, void *data
)
1144 int ret
= iommu_probe_device(dev
);
1147 * We ignore -ENODEV errors for now, as they just mean that the
1148 * device is not translated by an IOMMU. We still care about
1149 * other errors and fail to initialize when they happen.
1157 static int remove_iommu_group(struct device
*dev
, void *data
)
1159 iommu_release_device(dev
);
1164 static int iommu_bus_notifier(struct notifier_block
*nb
,
1165 unsigned long action
, void *data
)
1167 unsigned long group_action
= 0;
1168 struct device
*dev
= data
;
1169 struct iommu_group
*group
;
1172 * ADD/DEL call into iommu driver ops if provided, which may
1173 * result in ADD/DEL notifiers to group->notifier
1175 if (action
== BUS_NOTIFY_ADD_DEVICE
) {
1178 ret
= iommu_probe_device(dev
);
1179 return (ret
) ? NOTIFY_DONE
: NOTIFY_OK
;
1180 } else if (action
== BUS_NOTIFY_REMOVED_DEVICE
) {
1181 iommu_release_device(dev
);
1186 * Remaining BUS_NOTIFYs get filtered and republished to the
1187 * group, if anyone is listening
1189 group
= iommu_group_get(dev
);
1194 case BUS_NOTIFY_BIND_DRIVER
:
1195 group_action
= IOMMU_GROUP_NOTIFY_BIND_DRIVER
;
1197 case BUS_NOTIFY_BOUND_DRIVER
:
1198 group_action
= IOMMU_GROUP_NOTIFY_BOUND_DRIVER
;
1200 case BUS_NOTIFY_UNBIND_DRIVER
:
1201 group_action
= IOMMU_GROUP_NOTIFY_UNBIND_DRIVER
;
1203 case BUS_NOTIFY_UNBOUND_DRIVER
:
1204 group_action
= IOMMU_GROUP_NOTIFY_UNBOUND_DRIVER
;
1209 blocking_notifier_call_chain(&group
->notifier
,
1212 iommu_group_put(group
);
1216 static int iommu_bus_init(struct bus_type
*bus
, const struct iommu_ops
*ops
)
1219 struct notifier_block
*nb
;
1220 struct iommu_callback_data cb
= {
1224 nb
= kzalloc(sizeof(struct notifier_block
), GFP_KERNEL
);
1228 nb
->notifier_call
= iommu_bus_notifier
;
1230 err
= bus_register_notifier(bus
, nb
);
1234 err
= bus_for_each_dev(bus
, NULL
, &cb
, add_iommu_group
);
1243 bus_for_each_dev(bus
, NULL
, &cb
, remove_iommu_group
);
1244 bus_unregister_notifier(bus
, nb
);
1253 * bus_set_iommu - set iommu-callbacks for the bus
1255 * @ops: the callbacks provided by the iommu-driver
1257 * This function is called by an iommu driver to set the iommu methods
1258 * used for a particular bus. Drivers for devices on that bus can use
1259 * the iommu-api after these ops are registered.
1260 * This special function is needed because IOMMUs are usually devices on
1261 * the bus itself, so the iommu drivers are not initialized when the bus
1262 * is set up. With this function the iommu-driver can set the iommu-ops
1265 int bus_set_iommu(struct bus_type
*bus
, const struct iommu_ops
*ops
)
1269 if (bus
->iommu_ops
!= NULL
)
1272 bus
->iommu_ops
= ops
;
1274 /* Do IOMMU specific setup for this bus-type */
1275 err
= iommu_bus_init(bus
, ops
);
1277 bus
->iommu_ops
= NULL
;
1281 EXPORT_SYMBOL_GPL(bus_set_iommu
);
1283 bool iommu_present(struct bus_type
*bus
)
1285 return bus
->iommu_ops
!= NULL
;
1287 EXPORT_SYMBOL_GPL(iommu_present
);
1289 bool iommu_capable(struct bus_type
*bus
, enum iommu_cap cap
)
1291 if (!bus
->iommu_ops
|| !bus
->iommu_ops
->capable
)
1294 return bus
->iommu_ops
->capable(cap
);
1296 EXPORT_SYMBOL_GPL(iommu_capable
);
1299 * iommu_set_fault_handler() - set a fault handler for an iommu domain
1300 * @domain: iommu domain
1301 * @handler: fault handler
1302 * @token: user data, will be passed back to the fault handler
1304 * This function should be used by IOMMU users which want to be notified
1305 * whenever an IOMMU fault happens.
1307 * The fault handler itself should return 0 on success, and an appropriate
1308 * error code otherwise.
1310 void iommu_set_fault_handler(struct iommu_domain
*domain
,
1311 iommu_fault_handler_t handler
,
1316 domain
->handler
= handler
;
1317 domain
->handler_token
= token
;
1319 EXPORT_SYMBOL_GPL(iommu_set_fault_handler
);
1321 static struct iommu_domain
*__iommu_domain_alloc(struct bus_type
*bus
,
1324 struct iommu_domain
*domain
;
1326 if (bus
== NULL
|| bus
->iommu_ops
== NULL
)
1329 domain
= bus
->iommu_ops
->domain_alloc(type
);
1333 domain
->ops
= bus
->iommu_ops
;
1334 domain
->type
= type
;
1335 /* Assume all sizes by default; the driver may override this later */
1336 domain
->pgsize_bitmap
= bus
->iommu_ops
->pgsize_bitmap
;
1341 struct iommu_domain
*iommu_domain_alloc(struct bus_type
*bus
)
1343 return __iommu_domain_alloc(bus
, IOMMU_DOMAIN_UNMANAGED
);
1345 EXPORT_SYMBOL_GPL(iommu_domain_alloc
);
1347 void iommu_domain_free(struct iommu_domain
*domain
)
1349 domain
->ops
->domain_free(domain
);
1351 EXPORT_SYMBOL_GPL(iommu_domain_free
);
1353 static int __iommu_attach_device(struct iommu_domain
*domain
,
1357 if ((domain
->ops
->is_attach_deferred
!= NULL
) &&
1358 domain
->ops
->is_attach_deferred(domain
, dev
))
1361 if (unlikely(domain
->ops
->attach_dev
== NULL
))
1364 ret
= domain
->ops
->attach_dev(domain
, dev
);
1366 trace_attach_device_to_domain(dev
);
1370 int iommu_attach_device(struct iommu_domain
*domain
, struct device
*dev
)
1372 struct iommu_group
*group
;
1375 group
= iommu_group_get(dev
);
1380 * Lock the group to make sure the device-count doesn't
1381 * change while we are attaching
1383 mutex_lock(&group
->mutex
);
1385 if (iommu_group_device_count(group
) != 1)
1388 ret
= __iommu_attach_group(domain
, group
);
1391 mutex_unlock(&group
->mutex
);
1392 iommu_group_put(group
);
1396 EXPORT_SYMBOL_GPL(iommu_attach_device
);
1398 static void __iommu_detach_device(struct iommu_domain
*domain
,
1401 if ((domain
->ops
->is_attach_deferred
!= NULL
) &&
1402 domain
->ops
->is_attach_deferred(domain
, dev
))
1405 if (unlikely(domain
->ops
->detach_dev
== NULL
))
1408 domain
->ops
->detach_dev(domain
, dev
);
1409 trace_detach_device_from_domain(dev
);
1412 void iommu_detach_device(struct iommu_domain
*domain
, struct device
*dev
)
1414 struct iommu_group
*group
;
1416 group
= iommu_group_get(dev
);
1420 mutex_lock(&group
->mutex
);
1421 if (iommu_group_device_count(group
) != 1) {
1426 __iommu_detach_group(domain
, group
);
1429 mutex_unlock(&group
->mutex
);
1430 iommu_group_put(group
);
1432 EXPORT_SYMBOL_GPL(iommu_detach_device
);
1434 struct iommu_domain
*iommu_get_domain_for_dev(struct device
*dev
)
1436 struct iommu_domain
*domain
;
1437 struct iommu_group
*group
;
1439 group
= iommu_group_get(dev
);
1443 domain
= group
->domain
;
1445 iommu_group_put(group
);
1449 EXPORT_SYMBOL_GPL(iommu_get_domain_for_dev
);
1452 * For IOMMU_DOMAIN_DMA implementations which already provide their own
1453 * guarantees that the group and its default domain are valid and correct.
1455 struct iommu_domain
*iommu_get_dma_domain(struct device
*dev
)
1457 return dev
->iommu_group
->default_domain
;
1461 * IOMMU groups are really the natural working unit of the IOMMU, but
1462 * the IOMMU API works on domains and devices. Bridge that gap by
1463 * iterating over the devices in a group. Ideally we'd have a single
1464 * device which represents the requestor ID of the group, but we also
1465 * allow IOMMU drivers to create policy defined minimum sets, where
1466 * the physical hardware may be able to distiguish members, but we
1467 * wish to group them at a higher level (ex. untrusted multi-function
1468 * PCI devices). Thus we attach each device.
1470 static int iommu_group_do_attach_device(struct device
*dev
, void *data
)
1472 struct iommu_domain
*domain
= data
;
1474 return __iommu_attach_device(domain
, dev
);
1477 static int __iommu_attach_group(struct iommu_domain
*domain
,
1478 struct iommu_group
*group
)
1482 if (group
->default_domain
&& group
->domain
!= group
->default_domain
)
1485 ret
= __iommu_group_for_each_dev(group
, domain
,
1486 iommu_group_do_attach_device
);
1488 group
->domain
= domain
;
1493 int iommu_attach_group(struct iommu_domain
*domain
, struct iommu_group
*group
)
1497 mutex_lock(&group
->mutex
);
1498 ret
= __iommu_attach_group(domain
, group
);
1499 mutex_unlock(&group
->mutex
);
1503 EXPORT_SYMBOL_GPL(iommu_attach_group
);
1505 static int iommu_group_do_detach_device(struct device
*dev
, void *data
)
1507 struct iommu_domain
*domain
= data
;
1509 __iommu_detach_device(domain
, dev
);
1514 static void __iommu_detach_group(struct iommu_domain
*domain
,
1515 struct iommu_group
*group
)
1519 if (!group
->default_domain
) {
1520 __iommu_group_for_each_dev(group
, domain
,
1521 iommu_group_do_detach_device
);
1522 group
->domain
= NULL
;
1526 if (group
->domain
== group
->default_domain
)
1529 /* Detach by re-attaching to the default domain */
1530 ret
= __iommu_group_for_each_dev(group
, group
->default_domain
,
1531 iommu_group_do_attach_device
);
1535 group
->domain
= group
->default_domain
;
1538 void iommu_detach_group(struct iommu_domain
*domain
, struct iommu_group
*group
)
1540 mutex_lock(&group
->mutex
);
1541 __iommu_detach_group(domain
, group
);
1542 mutex_unlock(&group
->mutex
);
1544 EXPORT_SYMBOL_GPL(iommu_detach_group
);
1546 phys_addr_t
iommu_iova_to_phys(struct iommu_domain
*domain
, dma_addr_t iova
)
1548 if (unlikely(domain
->ops
->iova_to_phys
== NULL
))
1551 return domain
->ops
->iova_to_phys(domain
, iova
);
1553 EXPORT_SYMBOL_GPL(iommu_iova_to_phys
);
1555 static size_t iommu_pgsize(struct iommu_domain
*domain
,
1556 unsigned long addr_merge
, size_t size
)
1558 unsigned int pgsize_idx
;
1561 /* Max page size that still fits into 'size' */
1562 pgsize_idx
= __fls(size
);
1564 /* need to consider alignment requirements ? */
1565 if (likely(addr_merge
)) {
1566 /* Max page size allowed by address */
1567 unsigned int align_pgsize_idx
= __ffs(addr_merge
);
1568 pgsize_idx
= min(pgsize_idx
, align_pgsize_idx
);
1571 /* build a mask of acceptable page sizes */
1572 pgsize
= (1UL << (pgsize_idx
+ 1)) - 1;
1574 /* throw away page sizes not supported by the hardware */
1575 pgsize
&= domain
->pgsize_bitmap
;
1577 /* make sure we're still sane */
1580 /* pick the biggest page */
1581 pgsize_idx
= __fls(pgsize
);
1582 pgsize
= 1UL << pgsize_idx
;
1587 int iommu_map(struct iommu_domain
*domain
, unsigned long iova
,
1588 phys_addr_t paddr
, size_t size
, int prot
)
1590 const struct iommu_ops
*ops
= domain
->ops
;
1591 unsigned long orig_iova
= iova
;
1592 unsigned int min_pagesz
;
1593 size_t orig_size
= size
;
1594 phys_addr_t orig_paddr
= paddr
;
1597 if (unlikely(ops
->map
== NULL
||
1598 domain
->pgsize_bitmap
== 0UL))
1601 if (unlikely(!(domain
->type
& __IOMMU_DOMAIN_PAGING
)))
1604 /* find out the minimum page size supported */
1605 min_pagesz
= 1 << __ffs(domain
->pgsize_bitmap
);
1608 * both the virtual address and the physical one, as well as
1609 * the size of the mapping, must be aligned (at least) to the
1610 * size of the smallest page supported by the hardware
1612 if (!IS_ALIGNED(iova
| paddr
| size
, min_pagesz
)) {
1613 pr_err("unaligned: iova 0x%lx pa %pa size 0x%zx min_pagesz 0x%x\n",
1614 iova
, &paddr
, size
, min_pagesz
);
1618 pr_debug("map: iova 0x%lx pa %pa size 0x%zx\n", iova
, &paddr
, size
);
1621 size_t pgsize
= iommu_pgsize(domain
, iova
| paddr
, size
);
1623 pr_debug("mapping: iova 0x%lx pa %pa pgsize 0x%zx\n",
1624 iova
, &paddr
, pgsize
);
1626 ret
= ops
->map(domain
, iova
, paddr
, pgsize
, prot
);
1635 if (ops
->iotlb_sync_map
)
1636 ops
->iotlb_sync_map(domain
);
1638 /* unroll mapping in case something went wrong */
1640 iommu_unmap(domain
, orig_iova
, orig_size
- size
);
1642 trace_map(orig_iova
, orig_paddr
, orig_size
);
1646 EXPORT_SYMBOL_GPL(iommu_map
);
1648 static size_t __iommu_unmap(struct iommu_domain
*domain
,
1649 unsigned long iova
, size_t size
,
1652 const struct iommu_ops
*ops
= domain
->ops
;
1653 size_t unmapped_page
, unmapped
= 0;
1654 unsigned long orig_iova
= iova
;
1655 unsigned int min_pagesz
;
1657 if (unlikely(ops
->unmap
== NULL
||
1658 domain
->pgsize_bitmap
== 0UL))
1661 if (unlikely(!(domain
->type
& __IOMMU_DOMAIN_PAGING
)))
1664 /* find out the minimum page size supported */
1665 min_pagesz
= 1 << __ffs(domain
->pgsize_bitmap
);
1668 * The virtual address, as well as the size of the mapping, must be
1669 * aligned (at least) to the size of the smallest page supported
1672 if (!IS_ALIGNED(iova
| size
, min_pagesz
)) {
1673 pr_err("unaligned: iova 0x%lx size 0x%zx min_pagesz 0x%x\n",
1674 iova
, size
, min_pagesz
);
1678 pr_debug("unmap this: iova 0x%lx size 0x%zx\n", iova
, size
);
1681 * Keep iterating until we either unmap 'size' bytes (or more)
1682 * or we hit an area that isn't mapped.
1684 while (unmapped
< size
) {
1685 size_t pgsize
= iommu_pgsize(domain
, iova
, size
- unmapped
);
1687 unmapped_page
= ops
->unmap(domain
, iova
, pgsize
);
1691 if (sync
&& ops
->iotlb_range_add
)
1692 ops
->iotlb_range_add(domain
, iova
, pgsize
);
1694 pr_debug("unmapped: iova 0x%lx size 0x%zx\n",
1695 iova
, unmapped_page
);
1697 iova
+= unmapped_page
;
1698 unmapped
+= unmapped_page
;
1701 if (sync
&& ops
->iotlb_sync
)
1702 ops
->iotlb_sync(domain
);
1704 trace_unmap(orig_iova
, size
, unmapped
);
1708 size_t iommu_unmap(struct iommu_domain
*domain
,
1709 unsigned long iova
, size_t size
)
1711 return __iommu_unmap(domain
, iova
, size
, true);
1713 EXPORT_SYMBOL_GPL(iommu_unmap
);
1715 size_t iommu_unmap_fast(struct iommu_domain
*domain
,
1716 unsigned long iova
, size_t size
)
1718 return __iommu_unmap(domain
, iova
, size
, false);
1720 EXPORT_SYMBOL_GPL(iommu_unmap_fast
);
1722 size_t iommu_map_sg(struct iommu_domain
*domain
, unsigned long iova
,
1723 struct scatterlist
*sg
, unsigned int nents
, int prot
)
1725 size_t len
= 0, mapped
= 0;
1730 while (i
<= nents
) {
1731 phys_addr_t s_phys
= sg_phys(sg
);
1733 if (len
&& s_phys
!= start
+ len
) {
1734 ret
= iommu_map(domain
, iova
+ mapped
, start
, len
, prot
);
1756 /* undo mappings already done */
1757 iommu_unmap(domain
, iova
, mapped
);
1762 EXPORT_SYMBOL_GPL(iommu_map_sg
);
1764 int iommu_domain_window_enable(struct iommu_domain
*domain
, u32 wnd_nr
,
1765 phys_addr_t paddr
, u64 size
, int prot
)
1767 if (unlikely(domain
->ops
->domain_window_enable
== NULL
))
1770 return domain
->ops
->domain_window_enable(domain
, wnd_nr
, paddr
, size
,
1773 EXPORT_SYMBOL_GPL(iommu_domain_window_enable
);
1775 void iommu_domain_window_disable(struct iommu_domain
*domain
, u32 wnd_nr
)
1777 if (unlikely(domain
->ops
->domain_window_disable
== NULL
))
1780 return domain
->ops
->domain_window_disable(domain
, wnd_nr
);
1782 EXPORT_SYMBOL_GPL(iommu_domain_window_disable
);
1785 * report_iommu_fault() - report about an IOMMU fault to the IOMMU framework
1786 * @domain: the iommu domain where the fault has happened
1787 * @dev: the device where the fault has happened
1788 * @iova: the faulting address
1789 * @flags: mmu fault flags (e.g. IOMMU_FAULT_READ/IOMMU_FAULT_WRITE/...)
1791 * This function should be called by the low-level IOMMU implementations
1792 * whenever IOMMU faults happen, to allow high-level users, that are
1793 * interested in such events, to know about them.
1795 * This event may be useful for several possible use cases:
1796 * - mere logging of the event
1797 * - dynamic TLB/PTE loading
1798 * - if restarting of the faulting device is required
1800 * Returns 0 on success and an appropriate error code otherwise (if dynamic
1801 * PTE/TLB loading will one day be supported, implementations will be able
1802 * to tell whether it succeeded or not according to this return value).
1804 * Specifically, -ENOSYS is returned if a fault handler isn't installed
1805 * (though fault handlers can also return -ENOSYS, in case they want to
1806 * elicit the default behavior of the IOMMU drivers).
1808 int report_iommu_fault(struct iommu_domain
*domain
, struct device
*dev
,
1809 unsigned long iova
, int flags
)
1814 * if upper layers showed interest and installed a fault handler,
1817 if (domain
->handler
)
1818 ret
= domain
->handler(domain
, dev
, iova
, flags
,
1819 domain
->handler_token
);
1821 trace_io_page_fault(dev
, iova
, flags
);
1824 EXPORT_SYMBOL_GPL(report_iommu_fault
);
1826 static int __init
iommu_init(void)
1828 iommu_group_kset
= kset_create_and_add("iommu_groups",
1830 BUG_ON(!iommu_group_kset
);
1832 iommu_debugfs_setup();
1836 core_initcall(iommu_init
);
1838 int iommu_domain_get_attr(struct iommu_domain
*domain
,
1839 enum iommu_attr attr
, void *data
)
1841 struct iommu_domain_geometry
*geometry
;
1846 case DOMAIN_ATTR_GEOMETRY
:
1848 *geometry
= domain
->geometry
;
1851 case DOMAIN_ATTR_PAGING
:
1853 *paging
= (domain
->pgsize_bitmap
!= 0UL);
1856 if (!domain
->ops
->domain_get_attr
)
1859 ret
= domain
->ops
->domain_get_attr(domain
, attr
, data
);
1864 EXPORT_SYMBOL_GPL(iommu_domain_get_attr
);
1866 int iommu_domain_set_attr(struct iommu_domain
*domain
,
1867 enum iommu_attr attr
, void *data
)
1873 if (domain
->ops
->domain_set_attr
== NULL
)
1876 ret
= domain
->ops
->domain_set_attr(domain
, attr
, data
);
1881 EXPORT_SYMBOL_GPL(iommu_domain_set_attr
);
1883 void iommu_get_resv_regions(struct device
*dev
, struct list_head
*list
)
1885 const struct iommu_ops
*ops
= dev
->bus
->iommu_ops
;
1887 if (ops
&& ops
->get_resv_regions
)
1888 ops
->get_resv_regions(dev
, list
);
1891 void iommu_put_resv_regions(struct device
*dev
, struct list_head
*list
)
1893 const struct iommu_ops
*ops
= dev
->bus
->iommu_ops
;
1895 if (ops
&& ops
->put_resv_regions
)
1896 ops
->put_resv_regions(dev
, list
);
1899 struct iommu_resv_region
*iommu_alloc_resv_region(phys_addr_t start
,
1900 size_t length
, int prot
,
1901 enum iommu_resv_type type
)
1903 struct iommu_resv_region
*region
;
1905 region
= kzalloc(sizeof(*region
), GFP_KERNEL
);
1909 INIT_LIST_HEAD(®ion
->list
);
1910 region
->start
= start
;
1911 region
->length
= length
;
1912 region
->prot
= prot
;
1913 region
->type
= type
;
1917 /* Request that a device is direct mapped by the IOMMU */
1918 int iommu_request_dm_for_dev(struct device
*dev
)
1920 struct iommu_domain
*dm_domain
;
1921 struct iommu_group
*group
;
1924 /* Device must already be in a group before calling this function */
1925 group
= iommu_group_get_for_dev(dev
);
1927 return PTR_ERR(group
);
1929 mutex_lock(&group
->mutex
);
1931 /* Check if the default domain is already direct mapped */
1933 if (group
->default_domain
&&
1934 group
->default_domain
->type
== IOMMU_DOMAIN_IDENTITY
)
1937 /* Don't change mappings of existing devices */
1939 if (iommu_group_device_count(group
) != 1)
1942 /* Allocate a direct mapped domain */
1944 dm_domain
= __iommu_domain_alloc(dev
->bus
, IOMMU_DOMAIN_IDENTITY
);
1948 /* Attach the device to the domain */
1949 ret
= __iommu_attach_group(dm_domain
, group
);
1951 iommu_domain_free(dm_domain
);
1955 /* Make the direct mapped domain the default for this group */
1956 if (group
->default_domain
)
1957 iommu_domain_free(group
->default_domain
);
1958 group
->default_domain
= dm_domain
;
1960 dev_info(dev
, "Using iommu direct mapping\n");
1964 mutex_unlock(&group
->mutex
);
1965 iommu_group_put(group
);
1970 const struct iommu_ops
*iommu_ops_from_fwnode(struct fwnode_handle
*fwnode
)
1972 const struct iommu_ops
*ops
= NULL
;
1973 struct iommu_device
*iommu
;
1975 spin_lock(&iommu_device_lock
);
1976 list_for_each_entry(iommu
, &iommu_device_list
, list
)
1977 if (iommu
->fwnode
== fwnode
) {
1981 spin_unlock(&iommu_device_lock
);
1985 int iommu_fwspec_init(struct device
*dev
, struct fwnode_handle
*iommu_fwnode
,
1986 const struct iommu_ops
*ops
)
1988 struct iommu_fwspec
*fwspec
= dev_iommu_fwspec_get(dev
);
1991 return ops
== fwspec
->ops
? 0 : -EINVAL
;
1993 fwspec
= kzalloc(sizeof(*fwspec
), GFP_KERNEL
);
1997 of_node_get(to_of_node(iommu_fwnode
));
1998 fwspec
->iommu_fwnode
= iommu_fwnode
;
2000 dev_iommu_fwspec_set(dev
, fwspec
);
2003 EXPORT_SYMBOL_GPL(iommu_fwspec_init
);
2005 void iommu_fwspec_free(struct device
*dev
)
2007 struct iommu_fwspec
*fwspec
= dev_iommu_fwspec_get(dev
);
2010 fwnode_handle_put(fwspec
->iommu_fwnode
);
2012 dev_iommu_fwspec_set(dev
, NULL
);
2015 EXPORT_SYMBOL_GPL(iommu_fwspec_free
);
2017 int iommu_fwspec_add_ids(struct device
*dev
, u32
*ids
, int num_ids
)
2019 struct iommu_fwspec
*fwspec
= dev_iommu_fwspec_get(dev
);
2026 size
= offsetof(struct iommu_fwspec
, ids
[fwspec
->num_ids
+ num_ids
]);
2027 if (size
> sizeof(*fwspec
)) {
2028 fwspec
= krealloc(fwspec
, size
, GFP_KERNEL
);
2032 dev_iommu_fwspec_set(dev
, fwspec
);
2035 for (i
= 0; i
< num_ids
; i
++)
2036 fwspec
->ids
[fwspec
->num_ids
+ i
] = ids
[i
];
2038 fwspec
->num_ids
+= num_ids
;
2041 EXPORT_SYMBOL_GPL(iommu_fwspec_add_ids
);