2 * VFIO: IOMMU DMA mapping support for Type1 IOMMU
4 * Copyright (C) 2012 Red Hat, Inc. All rights reserved.
5 * Author: Alex Williamson <alex.williamson@redhat.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * Derived from original vfio:
12 * Copyright 2010 Cisco Systems, Inc. All rights reserved.
13 * Author: Tom Lyon, pugs@cisco.com
15 * We arbitrarily define a Type1 IOMMU as one matching the below code.
16 * It could be called the x86 IOMMU as it's designed for AMD-Vi & Intel
17 * VT-d, but that makes it harder to re-use as theoretically anyone
18 * implementing a similar IOMMU could make use of this. We expect the
19 * IOMMU to support the IOMMU API and have few to no restrictions around
20 * the IOVA range that can be mapped. The Type1 IOMMU is currently
21 * optimized for relatively static mappings of a userspace process with
22 * userpsace pages pinned into memory. We also assume devices and IOMMU
23 * domains are PCI based as the IOMMU API is still centered around a
24 * device/bus interface rather than a group interface.
27 #include <linux/compat.h>
28 #include <linux/device.h>
30 #include <linux/iommu.h>
31 #include <linux/module.h>
33 #include <linux/rbtree.h>
34 #include <linux/sched.h>
35 #include <linux/slab.h>
36 #include <linux/uaccess.h>
37 #include <linux/vfio.h>
38 #include <linux/workqueue.h>
39 #include <linux/pid_namespace.h>
40 #include <linux/mdev.h>
41 #include <linux/notifier.h>
42 #include <linux/dma-iommu.h>
44 #define DRIVER_VERSION "0.2"
45 #define DRIVER_AUTHOR "Alex Williamson <alex.williamson@redhat.com>"
46 #define DRIVER_DESC "Type1 IOMMU driver for VFIO"
48 static bool allow_unsafe_interrupts;
49 module_param_named(allow_unsafe_interrupts,
50 allow_unsafe_interrupts, bool, S_IRUGO | S_IWUSR);
51 MODULE_PARM_DESC(allow_unsafe_interrupts,
52 "Enable VFIO IOMMU support for on platforms without interrupt remapping support.");
54 static bool disable_hugepages;
55 module_param_named(disable_hugepages,
56 disable_hugepages, bool, S_IRUGO | S_IWUSR);
57 MODULE_PARM_DESC(disable_hugepages,
58 "Disable VFIO IOMMU support for IOMMU hugepages.");
61 struct list_head domain_list;
62 struct vfio_domain *external_domain; /* domain for external user */
64 struct rb_root dma_list;
65 struct blocking_notifier_head notifier;
71 struct iommu_domain *domain;
72 struct list_head next;
73 struct list_head group_list;
74 int prot; /* IOMMU_CACHE */
75 bool fgsp; /* Fine-grained super pages */
80 dma_addr_t iova; /* Device address */
81 unsigned long vaddr; /* Process virtual addr */
82 size_t size; /* Map size (bytes) */
83 int prot; /* IOMMU_READ/WRITE */
85 struct task_struct *task;
86 struct rb_root pfn_list; /* Ex-user pinned pfn list */
90 struct iommu_group *iommu_group;
91 struct list_head next;
95 * Guest RAM pinning working set or DMA target
99 dma_addr_t iova; /* Device address */
100 unsigned long pfn; /* Host pfn */
104 #define IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu) \
105 (!list_empty(&iommu->domain_list))
107 static int put_pfn(unsigned long pfn, int prot);
110 * This code handles mapping and unmapping of user data buffers
111 * into DMA'ble space using the IOMMU
114 static struct vfio_dma *vfio_find_dma(struct vfio_iommu *iommu,
115 dma_addr_t start, size_t size)
117 struct rb_node *node = iommu->dma_list.rb_node;
120 struct vfio_dma *dma = rb_entry(node, struct vfio_dma, node);
122 if (start + size <= dma->iova)
123 node = node->rb_left;
124 else if (start >= dma->iova + dma->size)
125 node = node->rb_right;
133 static void vfio_link_dma(struct vfio_iommu *iommu, struct vfio_dma *new)
135 struct rb_node **link = &iommu->dma_list.rb_node, *parent = NULL;
136 struct vfio_dma *dma;
140 dma = rb_entry(parent, struct vfio_dma, node);
142 if (new->iova + new->size <= dma->iova)
143 link = &(*link)->rb_left;
145 link = &(*link)->rb_right;
148 rb_link_node(&new->node, parent, link);
149 rb_insert_color(&new->node, &iommu->dma_list);
152 static void vfio_unlink_dma(struct vfio_iommu *iommu, struct vfio_dma *old)
154 rb_erase(&old->node, &iommu->dma_list);
158 * Helper Functions for host iova-pfn list
160 static struct vfio_pfn *vfio_find_vpfn(struct vfio_dma *dma, dma_addr_t iova)
162 struct vfio_pfn *vpfn;
163 struct rb_node *node = dma->pfn_list.rb_node;
166 vpfn = rb_entry(node, struct vfio_pfn, node);
168 if (iova < vpfn->iova)
169 node = node->rb_left;
170 else if (iova > vpfn->iova)
171 node = node->rb_right;
178 static void vfio_link_pfn(struct vfio_dma *dma,
179 struct vfio_pfn *new)
181 struct rb_node **link, *parent = NULL;
182 struct vfio_pfn *vpfn;
184 link = &dma->pfn_list.rb_node;
187 vpfn = rb_entry(parent, struct vfio_pfn, node);
189 if (new->iova < vpfn->iova)
190 link = &(*link)->rb_left;
192 link = &(*link)->rb_right;
195 rb_link_node(&new->node, parent, link);
196 rb_insert_color(&new->node, &dma->pfn_list);
199 static void vfio_unlink_pfn(struct vfio_dma *dma, struct vfio_pfn *old)
201 rb_erase(&old->node, &dma->pfn_list);
204 static int vfio_add_to_pfn_list(struct vfio_dma *dma, dma_addr_t iova,
207 struct vfio_pfn *vpfn;
209 vpfn = kzalloc(sizeof(*vpfn), GFP_KERNEL);
215 atomic_set(&vpfn->ref_count, 1);
216 vfio_link_pfn(dma, vpfn);
220 static void vfio_remove_from_pfn_list(struct vfio_dma *dma,
221 struct vfio_pfn *vpfn)
223 vfio_unlink_pfn(dma, vpfn);
227 static struct vfio_pfn *vfio_iova_get_vfio_pfn(struct vfio_dma *dma,
230 struct vfio_pfn *vpfn = vfio_find_vpfn(dma, iova);
233 atomic_inc(&vpfn->ref_count);
237 static int vfio_iova_put_vfio_pfn(struct vfio_dma *dma, struct vfio_pfn *vpfn)
241 if (atomic_dec_and_test(&vpfn->ref_count)) {
242 ret = put_pfn(vpfn->pfn, dma->prot);
243 vfio_remove_from_pfn_list(dma, vpfn);
249 struct mm_struct *mm;
251 struct work_struct work;
254 /* delayed decrement/increment for locked_vm */
255 static void vfio_lock_acct_bg(struct work_struct *work)
257 struct vwork *vwork = container_of(work, struct vwork, work);
258 struct mm_struct *mm;
261 down_write(&mm->mmap_sem);
262 mm->locked_vm += vwork->npage;
263 up_write(&mm->mmap_sem);
268 static void vfio_lock_acct(struct task_struct *task, long npage)
271 struct mm_struct *mm;
277 is_current = (task->mm == current->mm);
279 mm = is_current ? task->mm : get_task_mm(task);
281 return; /* process exited */
283 if (down_write_trylock(&mm->mmap_sem)) {
284 mm->locked_vm += npage;
285 up_write(&mm->mmap_sem);
292 mm = get_task_mm(task);
298 * Couldn't get mmap_sem lock, so must setup to update
299 * mm->locked_vm later. If locked_vm were atomic, we
300 * wouldn't need this silliness
302 vwork = kmalloc(sizeof(struct vwork), GFP_KERNEL);
303 if (WARN_ON(!vwork)) {
307 INIT_WORK(&vwork->work, vfio_lock_acct_bg);
309 vwork->npage = npage;
310 schedule_work(&vwork->work);
314 * Some mappings aren't backed by a struct page, for example an mmap'd
315 * MMIO range for our own or another device. These use a different
316 * pfn conversion and shouldn't be tracked as locked pages.
318 static bool is_invalid_reserved_pfn(unsigned long pfn)
320 if (pfn_valid(pfn)) {
322 struct page *tail = pfn_to_page(pfn);
323 struct page *head = compound_head(tail);
324 reserved = !!(PageReserved(head));
327 * "head" is not a dangling pointer
328 * (compound_head takes care of that)
329 * but the hugepage may have been split
330 * from under us (and we may not hold a
331 * reference count on the head page so it can
332 * be reused before we run PageReferenced), so
333 * we've to check PageTail before returning
340 return PageReserved(tail);
346 static int put_pfn(unsigned long pfn, int prot)
348 if (!is_invalid_reserved_pfn(pfn)) {
349 struct page *page = pfn_to_page(pfn);
350 if (prot & IOMMU_WRITE)
358 static int vaddr_get_pfn(struct mm_struct *mm, unsigned long vaddr,
359 int prot, unsigned long *pfn)
361 struct page *page[1];
362 struct vm_area_struct *vma;
365 if (mm == current->mm) {
366 ret = get_user_pages_fast(vaddr, 1, !!(prot & IOMMU_WRITE),
369 unsigned int flags = 0;
371 if (prot & IOMMU_WRITE)
374 down_read(&mm->mmap_sem);
375 ret = get_user_pages_remote(NULL, mm, vaddr, 1, flags, page,
377 up_read(&mm->mmap_sem);
381 *pfn = page_to_pfn(page[0]);
385 down_read(&mm->mmap_sem);
387 vma = find_vma_intersection(mm, vaddr, vaddr + 1);
389 if (vma && vma->vm_flags & VM_PFNMAP) {
390 *pfn = ((vaddr - vma->vm_start) >> PAGE_SHIFT) + vma->vm_pgoff;
391 if (is_invalid_reserved_pfn(*pfn))
395 up_read(&mm->mmap_sem);
400 * Attempt to pin pages. We really don't want to track all the pfns and
401 * the iommu can only map chunks of consecutive pfns anyway, so get the
402 * first page and all consecutive pages with the same locking.
404 static long vfio_pin_pages_remote(struct vfio_dma *dma, unsigned long vaddr,
405 long npage, unsigned long *pfn_base)
407 unsigned long limit = rlimit(RLIMIT_MEMLOCK) >> PAGE_SHIFT;
408 bool lock_cap = capable(CAP_IPC_LOCK);
409 long ret, pinned = 0, lock_acct = 0;
411 dma_addr_t iova = vaddr - dma->vaddr + dma->iova;
413 /* This code path is only user initiated */
417 ret = vaddr_get_pfn(current->mm, vaddr, dma->prot, pfn_base);
422 rsvd = is_invalid_reserved_pfn(*pfn_base);
425 * Reserved pages aren't counted against the user, externally pinned
426 * pages are already counted against the user.
428 if (!rsvd && !vfio_find_vpfn(dma, iova)) {
429 if (!lock_cap && current->mm->locked_vm + 1 > limit) {
430 put_pfn(*pfn_base, dma->prot);
431 pr_warn("%s: RLIMIT_MEMLOCK (%ld) exceeded\n", __func__,
432 limit << PAGE_SHIFT);
438 if (unlikely(disable_hugepages))
441 /* Lock all the consecutive pages from pfn_base */
442 for (vaddr += PAGE_SIZE, iova += PAGE_SIZE; pinned < npage;
443 pinned++, vaddr += PAGE_SIZE, iova += PAGE_SIZE) {
444 unsigned long pfn = 0;
446 ret = vaddr_get_pfn(current->mm, vaddr, dma->prot, &pfn);
450 if (pfn != *pfn_base + pinned ||
451 rsvd != is_invalid_reserved_pfn(pfn)) {
452 put_pfn(pfn, dma->prot);
456 if (!rsvd && !vfio_find_vpfn(dma, iova)) {
458 current->mm->locked_vm + lock_acct + 1 > limit) {
459 put_pfn(pfn, dma->prot);
460 pr_warn("%s: RLIMIT_MEMLOCK (%ld) exceeded\n",
461 __func__, limit << PAGE_SHIFT);
469 vfio_lock_acct(current, lock_acct);
474 static long vfio_unpin_pages_remote(struct vfio_dma *dma, dma_addr_t iova,
475 unsigned long pfn, long npage,
478 long unlocked = 0, locked = 0;
481 for (i = 0; i < npage; i++, iova += PAGE_SIZE) {
482 if (put_pfn(pfn++, dma->prot)) {
484 if (vfio_find_vpfn(dma, iova))
490 vfio_lock_acct(dma->task, locked - unlocked);
495 static int vfio_pin_page_external(struct vfio_dma *dma, unsigned long vaddr,
496 unsigned long *pfn_base, bool do_accounting)
499 bool lock_cap = ns_capable(task_active_pid_ns(dma->task)->user_ns,
501 struct mm_struct *mm;
505 mm = get_task_mm(dma->task);
509 ret = vaddr_get_pfn(mm, vaddr, dma->prot, pfn_base);
513 rsvd = is_invalid_reserved_pfn(*pfn_base);
514 limit = task_rlimit(dma->task, RLIMIT_MEMLOCK) >> PAGE_SHIFT;
516 if (!rsvd && !lock_cap && mm->locked_vm + 1 > limit) {
517 put_pfn(*pfn_base, dma->prot);
518 pr_warn("%s: Task %s (%d) RLIMIT_MEMLOCK (%ld) exceeded\n",
519 __func__, dma->task->comm, task_pid_nr(dma->task),
520 limit << PAGE_SHIFT);
525 if (!rsvd && do_accounting)
526 vfio_lock_acct(dma->task, 1);
534 static int vfio_unpin_page_external(struct vfio_dma *dma, dma_addr_t iova,
538 struct vfio_pfn *vpfn = vfio_find_vpfn(dma, iova);
543 unlocked = vfio_iova_put_vfio_pfn(dma, vpfn);
546 vfio_lock_acct(dma->task, -unlocked);
551 static int vfio_iommu_type1_pin_pages(void *iommu_data,
552 unsigned long *user_pfn,
554 unsigned long *phys_pfn)
556 struct vfio_iommu *iommu = iommu_data;
558 unsigned long remote_vaddr;
559 struct vfio_dma *dma;
562 if (!iommu || !user_pfn || !phys_pfn)
565 /* Supported for v2 version only */
569 mutex_lock(&iommu->lock);
571 /* Fail if notifier list is empty */
572 if ((!iommu->external_domain) || (!iommu->notifier.head)) {
578 * If iommu capable domain exist in the container then all pages are
579 * already pinned and accounted. Accouting should be done if there is no
580 * iommu capable domain in the container.
582 do_accounting = !IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu);
584 for (i = 0; i < npage; i++) {
586 struct vfio_pfn *vpfn;
588 iova = user_pfn[i] << PAGE_SHIFT;
589 dma = vfio_find_dma(iommu, iova, PAGE_SIZE);
595 if ((dma->prot & prot) != prot) {
600 vpfn = vfio_iova_get_vfio_pfn(dma, iova);
602 phys_pfn[i] = vpfn->pfn;
606 remote_vaddr = dma->vaddr + iova - dma->iova;
607 ret = vfio_pin_page_external(dma, remote_vaddr, &phys_pfn[i],
614 ret = vfio_add_to_pfn_list(dma, iova, phys_pfn[i]);
616 vfio_unpin_page_external(dma, iova, do_accounting);
626 for (j = 0; j < i; j++) {
629 iova = user_pfn[j] << PAGE_SHIFT;
630 dma = vfio_find_dma(iommu, iova, PAGE_SIZE);
631 vfio_unpin_page_external(dma, iova, do_accounting);
635 mutex_unlock(&iommu->lock);
639 static int vfio_iommu_type1_unpin_pages(void *iommu_data,
640 unsigned long *user_pfn,
643 struct vfio_iommu *iommu = iommu_data;
647 if (!iommu || !user_pfn)
650 /* Supported for v2 version only */
654 mutex_lock(&iommu->lock);
656 if (!iommu->external_domain) {
657 mutex_unlock(&iommu->lock);
661 do_accounting = !IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu);
662 for (i = 0; i < npage; i++) {
663 struct vfio_dma *dma;
666 iova = user_pfn[i] << PAGE_SHIFT;
667 dma = vfio_find_dma(iommu, iova, PAGE_SIZE);
670 vfio_unpin_page_external(dma, iova, do_accounting);
674 mutex_unlock(&iommu->lock);
675 return i > npage ? npage : (i > 0 ? i : -EINVAL);
678 static long vfio_unmap_unpin(struct vfio_iommu *iommu, struct vfio_dma *dma,
681 dma_addr_t iova = dma->iova, end = dma->iova + dma->size;
682 struct vfio_domain *domain, *d;
688 if (!IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu))
692 * We use the IOMMU to track the physical addresses, otherwise we'd
693 * need a much more complicated tracking system. Unfortunately that
694 * means we need to use one of the iommu domains to figure out the
695 * pfns to unpin. The rest need to be unmapped in advance so we have
696 * no iommu translations remaining when the pages are unpinned.
698 domain = d = list_first_entry(&iommu->domain_list,
699 struct vfio_domain, next);
701 list_for_each_entry_continue(d, &iommu->domain_list, next) {
702 iommu_unmap(d->domain, dma->iova, dma->size);
707 size_t unmapped, len;
708 phys_addr_t phys, next;
710 phys = iommu_iova_to_phys(domain->domain, iova);
711 if (WARN_ON(!phys)) {
717 * To optimize for fewer iommu_unmap() calls, each of which
718 * may require hardware cache flushing, try to find the
719 * largest contiguous physical memory chunk to unmap.
721 for (len = PAGE_SIZE;
722 !domain->fgsp && iova + len < end; len += PAGE_SIZE) {
723 next = iommu_iova_to_phys(domain->domain, iova + len);
724 if (next != phys + len)
728 unmapped = iommu_unmap(domain->domain, iova, len);
729 if (WARN_ON(!unmapped))
732 unlocked += vfio_unpin_pages_remote(dma, iova,
734 unmapped >> PAGE_SHIFT,
741 dma->iommu_mapped = false;
743 vfio_lock_acct(dma->task, -unlocked);
749 static void vfio_remove_dma(struct vfio_iommu *iommu, struct vfio_dma *dma)
751 vfio_unmap_unpin(iommu, dma, true);
752 vfio_unlink_dma(iommu, dma);
753 put_task_struct(dma->task);
757 static unsigned long vfio_pgsize_bitmap(struct vfio_iommu *iommu)
759 struct vfio_domain *domain;
760 unsigned long bitmap = ULONG_MAX;
762 mutex_lock(&iommu->lock);
763 list_for_each_entry(domain, &iommu->domain_list, next)
764 bitmap &= domain->domain->pgsize_bitmap;
765 mutex_unlock(&iommu->lock);
768 * In case the IOMMU supports page sizes smaller than PAGE_SIZE
769 * we pretend PAGE_SIZE is supported and hide sub-PAGE_SIZE sizes.
770 * That way the user will be able to map/unmap buffers whose size/
771 * start address is aligned with PAGE_SIZE. Pinning code uses that
772 * granularity while iommu driver can use the sub-PAGE_SIZE size
775 if (bitmap & ~PAGE_MASK) {
783 static int vfio_dma_do_unmap(struct vfio_iommu *iommu,
784 struct vfio_iommu_type1_dma_unmap *unmap)
787 struct vfio_dma *dma, *dma_last = NULL;
789 int ret = 0, retries = 0;
791 mask = ((uint64_t)1 << __ffs(vfio_pgsize_bitmap(iommu))) - 1;
793 if (unmap->iova & mask)
795 if (!unmap->size || unmap->size & mask)
798 WARN_ON(mask & PAGE_MASK);
800 mutex_lock(&iommu->lock);
803 * vfio-iommu-type1 (v1) - User mappings were coalesced together to
804 * avoid tracking individual mappings. This means that the granularity
805 * of the original mapping was lost and the user was allowed to attempt
806 * to unmap any range. Depending on the contiguousness of physical
807 * memory and page sizes supported by the IOMMU, arbitrary unmaps may
808 * or may not have worked. We only guaranteed unmap granularity
809 * matching the original mapping; even though it was untracked here,
810 * the original mappings are reflected in IOMMU mappings. This
811 * resulted in a couple unusual behaviors. First, if a range is not
812 * able to be unmapped, ex. a set of 4k pages that was mapped as a
813 * 2M hugepage into the IOMMU, the unmap ioctl returns success but with
814 * a zero sized unmap. Also, if an unmap request overlaps the first
815 * address of a hugepage, the IOMMU will unmap the entire hugepage.
816 * This also returns success and the returned unmap size reflects the
817 * actual size unmapped.
819 * We attempt to maintain compatibility with this "v1" interface, but
820 * we take control out of the hands of the IOMMU. Therefore, an unmap
821 * request offset from the beginning of the original mapping will
822 * return success with zero sized unmap. And an unmap request covering
823 * the first iova of mapping will unmap the entire range.
825 * The v2 version of this interface intends to be more deterministic.
826 * Unmap requests must fully cover previous mappings. Multiple
827 * mappings may still be unmaped by specifying large ranges, but there
828 * must not be any previous mappings bisected by the range. An error
829 * will be returned if these conditions are not met. The v2 interface
830 * will only return success and a size of zero if there were no
831 * mappings within the range.
834 dma = vfio_find_dma(iommu, unmap->iova, 1);
835 if (dma && dma->iova != unmap->iova) {
839 dma = vfio_find_dma(iommu, unmap->iova + unmap->size - 1, 0);
840 if (dma && dma->iova + dma->size != unmap->iova + unmap->size) {
846 while ((dma = vfio_find_dma(iommu, unmap->iova, unmap->size))) {
847 if (!iommu->v2 && unmap->iova > dma->iova)
850 * Task with same address space who mapped this iova range is
851 * allowed to unmap the iova range.
853 if (dma->task->mm != current->mm)
856 if (!RB_EMPTY_ROOT(&dma->pfn_list)) {
857 struct vfio_iommu_type1_dma_unmap nb_unmap;
859 if (dma_last == dma) {
860 BUG_ON(++retries > 10);
866 nb_unmap.iova = dma->iova;
867 nb_unmap.size = dma->size;
870 * Notify anyone (mdev vendor drivers) to invalidate and
871 * unmap iovas within the range we're about to unmap.
872 * Vendor drivers MUST unpin pages in response to an
875 mutex_unlock(&iommu->lock);
876 blocking_notifier_call_chain(&iommu->notifier,
877 VFIO_IOMMU_NOTIFY_DMA_UNMAP,
881 unmapped += dma->size;
882 vfio_remove_dma(iommu, dma);
886 mutex_unlock(&iommu->lock);
888 /* Report how much was unmapped */
889 unmap->size = unmapped;
895 * Turns out AMD IOMMU has a page table bug where it won't map large pages
896 * to a region that previously mapped smaller pages. This should be fixed
897 * soon, so this is just a temporary workaround to break mappings down into
898 * PAGE_SIZE. Better to map smaller pages than nothing.
900 static int map_try_harder(struct vfio_domain *domain, dma_addr_t iova,
901 unsigned long pfn, long npage, int prot)
906 for (i = 0; i < npage; i++, pfn++, iova += PAGE_SIZE) {
907 ret = iommu_map(domain->domain, iova,
908 (phys_addr_t)pfn << PAGE_SHIFT,
909 PAGE_SIZE, prot | domain->prot);
914 for (; i < npage && i > 0; i--, iova -= PAGE_SIZE)
915 iommu_unmap(domain->domain, iova, PAGE_SIZE);
920 static int vfio_iommu_map(struct vfio_iommu *iommu, dma_addr_t iova,
921 unsigned long pfn, long npage, int prot)
923 struct vfio_domain *d;
926 list_for_each_entry(d, &iommu->domain_list, next) {
927 ret = iommu_map(d->domain, iova, (phys_addr_t)pfn << PAGE_SHIFT,
928 npage << PAGE_SHIFT, prot | d->prot);
931 map_try_harder(d, iova, pfn, npage, prot))
941 list_for_each_entry_continue_reverse(d, &iommu->domain_list, next)
942 iommu_unmap(d->domain, iova, npage << PAGE_SHIFT);
947 static int vfio_pin_map_dma(struct vfio_iommu *iommu, struct vfio_dma *dma,
950 dma_addr_t iova = dma->iova;
951 unsigned long vaddr = dma->vaddr;
952 size_t size = map_size;
958 /* Pin a contiguous chunk of memory */
959 npage = vfio_pin_pages_remote(dma, vaddr + dma->size,
960 size >> PAGE_SHIFT, &pfn);
968 ret = vfio_iommu_map(iommu, iova + dma->size, pfn, npage,
971 vfio_unpin_pages_remote(dma, iova + dma->size, pfn,
976 size -= npage << PAGE_SHIFT;
977 dma->size += npage << PAGE_SHIFT;
980 dma->iommu_mapped = true;
983 vfio_remove_dma(iommu, dma);
988 static int vfio_dma_do_map(struct vfio_iommu *iommu,
989 struct vfio_iommu_type1_dma_map *map)
991 dma_addr_t iova = map->iova;
992 unsigned long vaddr = map->vaddr;
993 size_t size = map->size;
994 int ret = 0, prot = 0;
996 struct vfio_dma *dma;
998 /* Verify that none of our __u64 fields overflow */
999 if (map->size != size || map->vaddr != vaddr || map->iova != iova)
1002 mask = ((uint64_t)1 << __ffs(vfio_pgsize_bitmap(iommu))) - 1;
1004 WARN_ON(mask & PAGE_MASK);
1006 /* READ/WRITE from device perspective */
1007 if (map->flags & VFIO_DMA_MAP_FLAG_WRITE)
1008 prot |= IOMMU_WRITE;
1009 if (map->flags & VFIO_DMA_MAP_FLAG_READ)
1012 if (!prot || !size || (size | iova | vaddr) & mask)
1015 /* Don't allow IOVA or virtual address wrap */
1016 if (iova + size - 1 < iova || vaddr + size - 1 < vaddr)
1019 mutex_lock(&iommu->lock);
1021 if (vfio_find_dma(iommu, iova, size)) {
1026 dma = kzalloc(sizeof(*dma), GFP_KERNEL);
1035 get_task_struct(current);
1036 dma->task = current;
1037 dma->pfn_list = RB_ROOT;
1039 /* Insert zero-sized and grow as we map chunks of it */
1040 vfio_link_dma(iommu, dma);
1042 /* Don't pin and map if container doesn't contain IOMMU capable domain*/
1043 if (!IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu))
1046 ret = vfio_pin_map_dma(iommu, dma, size);
1049 mutex_unlock(&iommu->lock);
1053 static int vfio_bus_type(struct device *dev, void *data)
1055 struct bus_type **bus = data;
1057 if (*bus && *bus != dev->bus)
1065 static int vfio_iommu_replay(struct vfio_iommu *iommu,
1066 struct vfio_domain *domain)
1068 struct vfio_domain *d;
1072 /* Arbitrarily pick the first domain in the list for lookups */
1073 d = list_first_entry(&iommu->domain_list, struct vfio_domain, next);
1074 n = rb_first(&iommu->dma_list);
1076 for (; n; n = rb_next(n)) {
1077 struct vfio_dma *dma;
1080 dma = rb_entry(n, struct vfio_dma, node);
1083 while (iova < dma->iova + dma->size) {
1087 if (dma->iommu_mapped) {
1091 phys = iommu_iova_to_phys(d->domain, iova);
1093 if (WARN_ON(!phys)) {
1101 while (i < dma->iova + dma->size &&
1102 p == iommu_iova_to_phys(d->domain, i)) {
1109 unsigned long vaddr = dma->vaddr +
1111 size_t n = dma->iova + dma->size - iova;
1114 npage = vfio_pin_pages_remote(dma, vaddr,
1123 phys = pfn << PAGE_SHIFT;
1124 size = npage << PAGE_SHIFT;
1127 ret = iommu_map(domain->domain, iova, phys,
1128 size, dma->prot | domain->prot);
1134 dma->iommu_mapped = true;
1140 * We change our unmap behavior slightly depending on whether the IOMMU
1141 * supports fine-grained superpages. IOMMUs like AMD-Vi will use a superpage
1142 * for practically any contiguous power-of-two mapping we give it. This means
1143 * we don't need to look for contiguous chunks ourselves to make unmapping
1144 * more efficient. On IOMMUs with coarse-grained super pages, like Intel VT-d
1145 * with discrete 2M/1G/512G/1T superpages, identifying contiguous chunks
1146 * significantly boosts non-hugetlbfs mappings and doesn't seem to hurt when
1147 * hugetlbfs is in use.
1149 static void vfio_test_domain_fgsp(struct vfio_domain *domain)
1152 int ret, order = get_order(PAGE_SIZE * 2);
1154 pages = alloc_pages(GFP_KERNEL | __GFP_ZERO, order);
1158 ret = iommu_map(domain->domain, 0, page_to_phys(pages), PAGE_SIZE * 2,
1159 IOMMU_READ | IOMMU_WRITE | domain->prot);
1161 size_t unmapped = iommu_unmap(domain->domain, 0, PAGE_SIZE);
1163 if (unmapped == PAGE_SIZE)
1164 iommu_unmap(domain->domain, PAGE_SIZE, PAGE_SIZE);
1166 domain->fgsp = true;
1169 __free_pages(pages, order);
1172 static struct vfio_group *find_iommu_group(struct vfio_domain *domain,
1173 struct iommu_group *iommu_group)
1175 struct vfio_group *g;
1177 list_for_each_entry(g, &domain->group_list, next) {
1178 if (g->iommu_group == iommu_group)
1185 static bool vfio_iommu_has_resv_msi(struct iommu_group *group,
1188 struct list_head group_resv_regions;
1189 struct iommu_resv_region *region, *next;
1192 INIT_LIST_HEAD(&group_resv_regions);
1193 iommu_get_group_resv_regions(group, &group_resv_regions);
1194 list_for_each_entry(region, &group_resv_regions, list) {
1195 if (region->type & IOMMU_RESV_MSI) {
1196 *base = region->start;
1202 list_for_each_entry_safe(region, next, &group_resv_regions, list)
1207 static int vfio_iommu_type1_attach_group(void *iommu_data,
1208 struct iommu_group *iommu_group)
1210 struct vfio_iommu *iommu = iommu_data;
1211 struct vfio_group *group;
1212 struct vfio_domain *domain, *d;
1213 struct bus_type *bus = NULL, *mdev_bus;
1216 phys_addr_t resv_msi_base;
1218 mutex_lock(&iommu->lock);
1220 list_for_each_entry(d, &iommu->domain_list, next) {
1221 if (find_iommu_group(d, iommu_group)) {
1222 mutex_unlock(&iommu->lock);
1227 if (iommu->external_domain) {
1228 if (find_iommu_group(iommu->external_domain, iommu_group)) {
1229 mutex_unlock(&iommu->lock);
1234 group = kzalloc(sizeof(*group), GFP_KERNEL);
1235 domain = kzalloc(sizeof(*domain), GFP_KERNEL);
1236 if (!group || !domain) {
1241 group->iommu_group = iommu_group;
1243 /* Determine bus_type in order to allocate a domain */
1244 ret = iommu_group_for_each_dev(iommu_group, &bus, vfio_bus_type);
1248 mdev_bus = symbol_get(mdev_bus_type);
1251 if ((bus == mdev_bus) && !iommu_present(bus)) {
1252 symbol_put(mdev_bus_type);
1253 if (!iommu->external_domain) {
1254 INIT_LIST_HEAD(&domain->group_list);
1255 iommu->external_domain = domain;
1259 list_add(&group->next,
1260 &iommu->external_domain->group_list);
1261 mutex_unlock(&iommu->lock);
1264 symbol_put(mdev_bus_type);
1267 domain->domain = iommu_domain_alloc(bus);
1268 if (!domain->domain) {
1273 if (iommu->nesting) {
1276 ret = iommu_domain_set_attr(domain->domain, DOMAIN_ATTR_NESTING,
1282 ret = iommu_attach_group(domain->domain, iommu_group);
1286 resv_msi = vfio_iommu_has_resv_msi(iommu_group, &resv_msi_base);
1288 INIT_LIST_HEAD(&domain->group_list);
1289 list_add(&group->next, &domain->group_list);
1291 if (!allow_unsafe_interrupts &&
1292 !iommu_capable(bus, IOMMU_CAP_INTR_REMAP)) {
1293 pr_warn("%s: No interrupt remapping support. Use the module param \"allow_unsafe_interrupts\" to enable VFIO IOMMU support on this platform\n",
1299 if (iommu_capable(bus, IOMMU_CAP_CACHE_COHERENCY))
1300 domain->prot |= IOMMU_CACHE;
1303 * Try to match an existing compatible domain. We don't want to
1304 * preclude an IOMMU driver supporting multiple bus_types and being
1305 * able to include different bus_types in the same IOMMU domain, so
1306 * we test whether the domains use the same iommu_ops rather than
1307 * testing if they're on the same bus_type.
1309 list_for_each_entry(d, &iommu->domain_list, next) {
1310 if (d->domain->ops == domain->domain->ops &&
1311 d->prot == domain->prot) {
1312 iommu_detach_group(domain->domain, iommu_group);
1313 if (!iommu_attach_group(d->domain, iommu_group)) {
1314 list_add(&group->next, &d->group_list);
1315 iommu_domain_free(domain->domain);
1317 mutex_unlock(&iommu->lock);
1321 ret = iommu_attach_group(domain->domain, iommu_group);
1327 vfio_test_domain_fgsp(domain);
1329 /* replay mappings on new domains */
1330 ret = vfio_iommu_replay(iommu, domain);
1334 if (resv_msi && iommu_get_msi_cookie(domain->domain, resv_msi_base))
1337 list_add(&domain->next, &iommu->domain_list);
1339 mutex_unlock(&iommu->lock);
1344 iommu_detach_group(domain->domain, iommu_group);
1346 iommu_domain_free(domain->domain);
1350 mutex_unlock(&iommu->lock);
1354 static void vfio_iommu_unmap_unpin_all(struct vfio_iommu *iommu)
1356 struct rb_node *node;
1358 while ((node = rb_first(&iommu->dma_list)))
1359 vfio_remove_dma(iommu, rb_entry(node, struct vfio_dma, node));
1362 static void vfio_iommu_unmap_unpin_reaccount(struct vfio_iommu *iommu)
1364 struct rb_node *n, *p;
1366 n = rb_first(&iommu->dma_list);
1367 for (; n; n = rb_next(n)) {
1368 struct vfio_dma *dma;
1369 long locked = 0, unlocked = 0;
1371 dma = rb_entry(n, struct vfio_dma, node);
1372 unlocked += vfio_unmap_unpin(iommu, dma, false);
1373 p = rb_first(&dma->pfn_list);
1374 for (; p; p = rb_next(p)) {
1375 struct vfio_pfn *vpfn = rb_entry(p, struct vfio_pfn,
1378 if (!is_invalid_reserved_pfn(vpfn->pfn))
1381 vfio_lock_acct(dma->task, locked - unlocked);
1385 static void vfio_sanity_check_pfn_list(struct vfio_iommu *iommu)
1389 n = rb_first(&iommu->dma_list);
1390 for (; n; n = rb_next(n)) {
1391 struct vfio_dma *dma;
1393 dma = rb_entry(n, struct vfio_dma, node);
1395 if (WARN_ON(!RB_EMPTY_ROOT(&dma->pfn_list)))
1398 /* mdev vendor driver must unregister notifier */
1399 WARN_ON(iommu->notifier.head);
1402 static void vfio_iommu_type1_detach_group(void *iommu_data,
1403 struct iommu_group *iommu_group)
1405 struct vfio_iommu *iommu = iommu_data;
1406 struct vfio_domain *domain;
1407 struct vfio_group *group;
1409 mutex_lock(&iommu->lock);
1411 if (iommu->external_domain) {
1412 group = find_iommu_group(iommu->external_domain, iommu_group);
1414 list_del(&group->next);
1417 if (list_empty(&iommu->external_domain->group_list)) {
1418 vfio_sanity_check_pfn_list(iommu);
1420 if (!IS_IOMMU_CAP_DOMAIN_IN_CONTAINER(iommu))
1421 vfio_iommu_unmap_unpin_all(iommu);
1423 kfree(iommu->external_domain);
1424 iommu->external_domain = NULL;
1426 goto detach_group_done;
1430 list_for_each_entry(domain, &iommu->domain_list, next) {
1431 group = find_iommu_group(domain, iommu_group);
1435 iommu_detach_group(domain->domain, iommu_group);
1436 list_del(&group->next);
1439 * Group ownership provides privilege, if the group list is
1440 * empty, the domain goes away. If it's the last domain with
1441 * iommu and external domain doesn't exist, then all the
1442 * mappings go away too. If it's the last domain with iommu and
1443 * external domain exist, update accounting
1445 if (list_empty(&domain->group_list)) {
1446 if (list_is_singular(&iommu->domain_list)) {
1447 if (!iommu->external_domain)
1448 vfio_iommu_unmap_unpin_all(iommu);
1450 vfio_iommu_unmap_unpin_reaccount(iommu);
1452 iommu_domain_free(domain->domain);
1453 list_del(&domain->next);
1460 mutex_unlock(&iommu->lock);
1463 static void *vfio_iommu_type1_open(unsigned long arg)
1465 struct vfio_iommu *iommu;
1467 iommu = kzalloc(sizeof(*iommu), GFP_KERNEL);
1469 return ERR_PTR(-ENOMEM);
1472 case VFIO_TYPE1_IOMMU:
1474 case VFIO_TYPE1_NESTING_IOMMU:
1475 iommu->nesting = true;
1476 case VFIO_TYPE1v2_IOMMU:
1481 return ERR_PTR(-EINVAL);
1484 INIT_LIST_HEAD(&iommu->domain_list);
1485 iommu->dma_list = RB_ROOT;
1486 mutex_init(&iommu->lock);
1487 BLOCKING_INIT_NOTIFIER_HEAD(&iommu->notifier);
1492 static void vfio_release_domain(struct vfio_domain *domain, bool external)
1494 struct vfio_group *group, *group_tmp;
1496 list_for_each_entry_safe(group, group_tmp,
1497 &domain->group_list, next) {
1499 iommu_detach_group(domain->domain, group->iommu_group);
1500 list_del(&group->next);
1505 iommu_domain_free(domain->domain);
1508 static void vfio_iommu_type1_release(void *iommu_data)
1510 struct vfio_iommu *iommu = iommu_data;
1511 struct vfio_domain *domain, *domain_tmp;
1513 if (iommu->external_domain) {
1514 vfio_release_domain(iommu->external_domain, true);
1515 vfio_sanity_check_pfn_list(iommu);
1516 kfree(iommu->external_domain);
1519 vfio_iommu_unmap_unpin_all(iommu);
1521 list_for_each_entry_safe(domain, domain_tmp,
1522 &iommu->domain_list, next) {
1523 vfio_release_domain(domain, false);
1524 list_del(&domain->next);
1530 static int vfio_domains_have_iommu_cache(struct vfio_iommu *iommu)
1532 struct vfio_domain *domain;
1535 mutex_lock(&iommu->lock);
1536 list_for_each_entry(domain, &iommu->domain_list, next) {
1537 if (!(domain->prot & IOMMU_CACHE)) {
1542 mutex_unlock(&iommu->lock);
1547 static long vfio_iommu_type1_ioctl(void *iommu_data,
1548 unsigned int cmd, unsigned long arg)
1550 struct vfio_iommu *iommu = iommu_data;
1551 unsigned long minsz;
1553 if (cmd == VFIO_CHECK_EXTENSION) {
1555 case VFIO_TYPE1_IOMMU:
1556 case VFIO_TYPE1v2_IOMMU:
1557 case VFIO_TYPE1_NESTING_IOMMU:
1559 case VFIO_DMA_CC_IOMMU:
1562 return vfio_domains_have_iommu_cache(iommu);
1566 } else if (cmd == VFIO_IOMMU_GET_INFO) {
1567 struct vfio_iommu_type1_info info;
1569 minsz = offsetofend(struct vfio_iommu_type1_info, iova_pgsizes);
1571 if (copy_from_user(&info, (void __user *)arg, minsz))
1574 if (info.argsz < minsz)
1577 info.flags = VFIO_IOMMU_INFO_PGSIZES;
1579 info.iova_pgsizes = vfio_pgsize_bitmap(iommu);
1581 return copy_to_user((void __user *)arg, &info, minsz) ?
1584 } else if (cmd == VFIO_IOMMU_MAP_DMA) {
1585 struct vfio_iommu_type1_dma_map map;
1586 uint32_t mask = VFIO_DMA_MAP_FLAG_READ |
1587 VFIO_DMA_MAP_FLAG_WRITE;
1589 minsz = offsetofend(struct vfio_iommu_type1_dma_map, size);
1591 if (copy_from_user(&map, (void __user *)arg, minsz))
1594 if (map.argsz < minsz || map.flags & ~mask)
1597 return vfio_dma_do_map(iommu, &map);
1599 } else if (cmd == VFIO_IOMMU_UNMAP_DMA) {
1600 struct vfio_iommu_type1_dma_unmap unmap;
1603 minsz = offsetofend(struct vfio_iommu_type1_dma_unmap, size);
1605 if (copy_from_user(&unmap, (void __user *)arg, minsz))
1608 if (unmap.argsz < minsz || unmap.flags)
1611 ret = vfio_dma_do_unmap(iommu, &unmap);
1615 return copy_to_user((void __user *)arg, &unmap, minsz) ?
1622 static int vfio_iommu_type1_register_notifier(void *iommu_data,
1623 unsigned long *events,
1624 struct notifier_block *nb)
1626 struct vfio_iommu *iommu = iommu_data;
1628 /* clear known events */
1629 *events &= ~VFIO_IOMMU_NOTIFY_DMA_UNMAP;
1631 /* refuse to register if still events remaining */
1635 return blocking_notifier_chain_register(&iommu->notifier, nb);
1638 static int vfio_iommu_type1_unregister_notifier(void *iommu_data,
1639 struct notifier_block *nb)
1641 struct vfio_iommu *iommu = iommu_data;
1643 return blocking_notifier_chain_unregister(&iommu->notifier, nb);
1646 static const struct vfio_iommu_driver_ops vfio_iommu_driver_ops_type1 = {
1647 .name = "vfio-iommu-type1",
1648 .owner = THIS_MODULE,
1649 .open = vfio_iommu_type1_open,
1650 .release = vfio_iommu_type1_release,
1651 .ioctl = vfio_iommu_type1_ioctl,
1652 .attach_group = vfio_iommu_type1_attach_group,
1653 .detach_group = vfio_iommu_type1_detach_group,
1654 .pin_pages = vfio_iommu_type1_pin_pages,
1655 .unpin_pages = vfio_iommu_type1_unpin_pages,
1656 .register_notifier = vfio_iommu_type1_register_notifier,
1657 .unregister_notifier = vfio_iommu_type1_unregister_notifier,
1660 static int __init vfio_iommu_type1_init(void)
1662 return vfio_register_iommu_driver(&vfio_iommu_driver_ops_type1);
1665 static void __exit vfio_iommu_type1_cleanup(void)
1667 vfio_unregister_iommu_driver(&vfio_iommu_driver_ops_type1);
1670 module_init(vfio_iommu_type1_init);
1671 module_exit(vfio_iommu_type1_cleanup);
1673 MODULE_VERSION(DRIVER_VERSION);
1674 MODULE_LICENSE("GPL v2");
1675 MODULE_AUTHOR(DRIVER_AUTHOR);
1676 MODULE_DESCRIPTION(DRIVER_DESC);