2 * DMA memory preregistration
5 * Alexey Kardashevskiy <aik@ozlabs.ru>
7 * This work is licensed under the terms of the GNU GPL, version 2. See
8 * the COPYING file in the top-level directory.
11 #include "qemu/osdep.h"
12 #include <sys/ioctl.h>
13 #include <linux/vfio.h>
15 #include <linux/kvm.h>
17 #include "sysemu/kvm.h"
18 #include "exec/address-spaces.h"
20 #include "hw/vfio/vfio-common.h"
22 #include "exec/ram_addr.h"
23 #include "qemu/error-report.h"
24 #include "qapi/error.h"
27 typedef struct VFIOSpaprContainer
{
28 VFIOContainer container
;
29 MemoryListener prereg_listener
;
30 QLIST_HEAD(, VFIOHostDMAWindow
) hostwin_list
;
33 static bool vfio_prereg_listener_skipped_section(MemoryRegionSection
*section
)
35 if (memory_region_is_iommu(section
->mr
)) {
36 hw_error("Cannot possibly preregister IOMMU memory");
39 return !memory_region_is_ram(section
->mr
) ||
40 memory_region_is_ram_device(section
->mr
);
43 static void *vfio_prereg_gpa_to_vaddr(MemoryRegionSection
*section
, hwaddr gpa
)
45 return memory_region_get_ram_ptr(section
->mr
) +
46 section
->offset_within_region
+
47 (gpa
- section
->offset_within_address_space
);
50 static void vfio_prereg_listener_region_add(MemoryListener
*listener
,
51 MemoryRegionSection
*section
)
53 VFIOSpaprContainer
*scontainer
= container_of(listener
, VFIOSpaprContainer
,
55 VFIOContainer
*container
= &scontainer
->container
;
56 VFIOContainerBase
*bcontainer
= &container
->bcontainer
;
57 const hwaddr gpa
= section
->offset_within_address_space
;
60 hwaddr page_mask
= qemu_real_host_page_mask();
61 struct vfio_iommu_spapr_register_memory reg
= {
66 if (vfio_prereg_listener_skipped_section(section
)) {
67 trace_vfio_prereg_listener_region_add_skip(
68 section
->offset_within_address_space
,
69 section
->offset_within_address_space
+
70 int128_get64(int128_sub(section
->size
, int128_one())));
74 if (unlikely((section
->offset_within_address_space
& ~page_mask
) ||
75 (section
->offset_within_region
& ~page_mask
) ||
76 (int128_get64(section
->size
) & ~page_mask
))) {
77 error_report("%s received unaligned region", __func__
);
81 end
= section
->offset_within_address_space
+ int128_get64(section
->size
);
86 memory_region_ref(section
->mr
);
88 reg
.vaddr
= (uintptr_t) vfio_prereg_gpa_to_vaddr(section
, gpa
);
91 ret
= ioctl(container
->fd
, VFIO_IOMMU_SPAPR_REGISTER_MEMORY
, ®
);
92 trace_vfio_prereg_register(reg
.vaddr
, reg
.size
, ret
? -errno
: 0);
95 * On the initfn path, store the first error in the container so we
96 * can gracefully fail. Runtime, there's not much we can do other
97 * than throw a hardware error.
99 if (!bcontainer
->initialized
) {
100 if (!bcontainer
->error
) {
101 error_setg_errno(&bcontainer
->error
, -ret
,
102 "Memory registering failed");
105 hw_error("vfio: Memory registering failed, unable to continue");
110 static void vfio_prereg_listener_region_del(MemoryListener
*listener
,
111 MemoryRegionSection
*section
)
113 VFIOSpaprContainer
*scontainer
= container_of(listener
, VFIOSpaprContainer
,
115 VFIOContainer
*container
= &scontainer
->container
;
116 const hwaddr gpa
= section
->offset_within_address_space
;
119 hwaddr page_mask
= qemu_real_host_page_mask();
120 struct vfio_iommu_spapr_register_memory reg
= {
121 .argsz
= sizeof(reg
),
125 if (vfio_prereg_listener_skipped_section(section
)) {
126 trace_vfio_prereg_listener_region_del_skip(
127 section
->offset_within_address_space
,
128 section
->offset_within_address_space
+
129 int128_get64(int128_sub(section
->size
, int128_one())));
133 if (unlikely((section
->offset_within_address_space
& ~page_mask
) ||
134 (section
->offset_within_region
& ~page_mask
) ||
135 (int128_get64(section
->size
) & ~page_mask
))) {
136 error_report("%s received unaligned region", __func__
);
140 end
= section
->offset_within_address_space
+ int128_get64(section
->size
);
145 reg
.vaddr
= (uintptr_t) vfio_prereg_gpa_to_vaddr(section
, gpa
);
146 reg
.size
= end
- gpa
;
148 ret
= ioctl(container
->fd
, VFIO_IOMMU_SPAPR_UNREGISTER_MEMORY
, ®
);
149 trace_vfio_prereg_unregister(reg
.vaddr
, reg
.size
, ret
? -errno
: 0);
152 static const MemoryListener vfio_prereg_listener
= {
153 .name
= "vfio-pre-reg",
154 .region_add
= vfio_prereg_listener_region_add
,
155 .region_del
= vfio_prereg_listener_region_del
,
158 static void vfio_host_win_add(VFIOSpaprContainer
*scontainer
, hwaddr min_iova
,
159 hwaddr max_iova
, uint64_t iova_pgsizes
)
161 VFIOHostDMAWindow
*hostwin
;
163 QLIST_FOREACH(hostwin
, &scontainer
->hostwin_list
, hostwin_next
) {
164 if (ranges_overlap(hostwin
->min_iova
,
165 hostwin
->max_iova
- hostwin
->min_iova
+ 1,
167 max_iova
- min_iova
+ 1)) {
168 hw_error("%s: Overlapped IOMMU are not enabled", __func__
);
172 hostwin
= g_malloc0(sizeof(*hostwin
));
174 hostwin
->min_iova
= min_iova
;
175 hostwin
->max_iova
= max_iova
;
176 hostwin
->iova_pgsizes
= iova_pgsizes
;
177 QLIST_INSERT_HEAD(&scontainer
->hostwin_list
, hostwin
, hostwin_next
);
180 static int vfio_host_win_del(VFIOSpaprContainer
*scontainer
,
181 hwaddr min_iova
, hwaddr max_iova
)
183 VFIOHostDMAWindow
*hostwin
;
185 QLIST_FOREACH(hostwin
, &scontainer
->hostwin_list
, hostwin_next
) {
186 if (hostwin
->min_iova
== min_iova
&& hostwin
->max_iova
== max_iova
) {
187 QLIST_REMOVE(hostwin
, hostwin_next
);
196 static VFIOHostDMAWindow
*vfio_find_hostwin(VFIOSpaprContainer
*container
,
197 hwaddr iova
, hwaddr end
)
199 VFIOHostDMAWindow
*hostwin
;
200 bool hostwin_found
= false;
202 QLIST_FOREACH(hostwin
, &container
->hostwin_list
, hostwin_next
) {
203 if (hostwin
->min_iova
<= iova
&& end
<= hostwin
->max_iova
) {
204 hostwin_found
= true;
209 return hostwin_found
? hostwin
: NULL
;
212 static int vfio_spapr_remove_window(VFIOContainer
*container
,
213 hwaddr offset_within_address_space
)
215 struct vfio_iommu_spapr_tce_remove remove
= {
216 .argsz
= sizeof(remove
),
217 .start_addr
= offset_within_address_space
,
221 ret
= ioctl(container
->fd
, VFIO_IOMMU_SPAPR_TCE_REMOVE
, &remove
);
223 error_report("Failed to remove window at %"PRIx64
,
224 (uint64_t)remove
.start_addr
);
228 trace_vfio_spapr_remove_window(offset_within_address_space
);
233 static int vfio_spapr_create_window(VFIOContainer
*container
,
234 MemoryRegionSection
*section
,
238 VFIOContainerBase
*bcontainer
= &container
->bcontainer
;
239 IOMMUMemoryRegion
*iommu_mr
= IOMMU_MEMORY_REGION(section
->mr
);
240 uint64_t pagesize
= memory_region_iommu_get_min_page_size(iommu_mr
), pgmask
;
241 unsigned entries
, bits_total
, bits_per_level
, max_levels
;
242 struct vfio_iommu_spapr_tce_create create
= { .argsz
= sizeof(create
) };
243 long rampagesize
= qemu_minrampagesize();
246 * The host might not support the guest supported IOMMU page size,
247 * so we will use smaller physical IOMMU pages to back them.
249 if (pagesize
> rampagesize
) {
250 pagesize
= rampagesize
;
252 pgmask
= bcontainer
->pgsizes
& (pagesize
| (pagesize
- 1));
253 pagesize
= pgmask
? (1ULL << (63 - clz64(pgmask
))) : 0;
255 error_report("Host doesn't support page size 0x%"PRIx64
256 ", the supported mask is 0x%lx",
257 memory_region_iommu_get_min_page_size(iommu_mr
),
258 bcontainer
->pgsizes
);
263 * FIXME: For VFIO iommu types which have KVM acceleration to
264 * avoid bouncing all map/unmaps through qemu this way, this
265 * would be the right place to wire that up (tell the KVM
266 * device emulation the VFIO iommu handles to use).
268 create
.window_size
= int128_get64(section
->size
);
269 create
.page_shift
= ctz64(pagesize
);
271 * SPAPR host supports multilevel TCE tables. We try to guess optimal
272 * levels number and if this fails (for example due to the host memory
273 * fragmentation), we increase levels. The DMA address structure is:
274 * rrrrrrrr rxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx iiiiiiii
276 * r = reserved (bits >= 55 are reserved in the existing hardware)
277 * i = IOMMU page offset (64K in this example)
278 * x = bits to index a TCE which can be split to equal chunks to index
280 * The aim is to split "x" to smaller possible number of levels.
282 entries
= create
.window_size
>> create
.page_shift
;
283 /* bits_total is number of "x" needed */
284 bits_total
= ctz64(entries
* sizeof(uint64_t));
286 * bits_per_level is a safe guess of how much we can allocate per level:
287 * 8 is the current minimum for CONFIG_FORCE_MAX_ZONEORDER and MAX_ORDER
288 * is usually bigger than that.
289 * Below we look at qemu_real_host_page_size as TCEs are allocated from
292 bits_per_level
= ctz64(qemu_real_host_page_size()) + 8;
293 create
.levels
= bits_total
/ bits_per_level
;
294 if (bits_total
% bits_per_level
) {
297 max_levels
= (64 - create
.page_shift
) / ctz64(qemu_real_host_page_size());
298 for ( ; create
.levels
<= max_levels
; ++create
.levels
) {
299 ret
= ioctl(container
->fd
, VFIO_IOMMU_SPAPR_TCE_CREATE
, &create
);
305 error_report("Failed to create a window, ret = %d (%m)", ret
);
309 if (create
.start_addr
!= section
->offset_within_address_space
) {
310 vfio_spapr_remove_window(container
, create
.start_addr
);
312 error_report("Host doesn't support DMA window at %"HWADDR_PRIx
", must be %"PRIx64
,
313 section
->offset_within_address_space
,
314 (uint64_t)create
.start_addr
);
317 trace_vfio_spapr_create_window(create
.page_shift
,
327 vfio_spapr_container_add_section_window(VFIOContainerBase
*bcontainer
,
328 MemoryRegionSection
*section
,
331 VFIOContainer
*container
= container_of(bcontainer
, VFIOContainer
,
333 VFIOSpaprContainer
*scontainer
= container_of(container
, VFIOSpaprContainer
,
335 VFIOHostDMAWindow
*hostwin
;
340 * VFIO_SPAPR_TCE_IOMMU supports a single host window between
341 * [dma32_window_start, dma32_window_size), we need to ensure
342 * the section fall in this range.
344 if (container
->iommu_type
== VFIO_SPAPR_TCE_IOMMU
) {
347 iova
= section
->offset_within_address_space
;
348 end
= iova
+ int128_get64(section
->size
) - 1;
350 if (!vfio_find_hostwin(scontainer
, iova
, end
)) {
351 error_setg(errp
, "Container %p can't map guest IOVA region"
352 " 0x%"HWADDR_PRIx
"..0x%"HWADDR_PRIx
, container
,
359 if (container
->iommu_type
!= VFIO_SPAPR_TCE_v2_IOMMU
) {
363 /* For now intersections are not allowed, we may relax this later */
364 QLIST_FOREACH(hostwin
, &scontainer
->hostwin_list
, hostwin_next
) {
365 if (ranges_overlap(hostwin
->min_iova
,
366 hostwin
->max_iova
- hostwin
->min_iova
+ 1,
367 section
->offset_within_address_space
,
368 int128_get64(section
->size
))) {
370 "region [0x%"PRIx64
",0x%"PRIx64
"] overlaps with existing"
371 "host DMA window [0x%"PRIx64
",0x%"PRIx64
"]",
372 section
->offset_within_address_space
,
373 section
->offset_within_address_space
+
374 int128_get64(section
->size
) - 1,
375 hostwin
->min_iova
, hostwin
->max_iova
);
380 ret
= vfio_spapr_create_window(container
, section
, &pgsize
);
382 error_setg_errno(errp
, -ret
, "Failed to create SPAPR window");
386 vfio_host_win_add(scontainer
, section
->offset_within_address_space
,
387 section
->offset_within_address_space
+
388 int128_get64(section
->size
) - 1, pgsize
);
392 IOMMUMemoryRegion
*iommu_mr
= IOMMU_MEMORY_REGION(section
->mr
);
393 struct kvm_vfio_spapr_tce param
;
394 struct kvm_device_attr attr
= {
395 .group
= KVM_DEV_VFIO_GROUP
,
396 .attr
= KVM_DEV_VFIO_GROUP_SET_SPAPR_TCE
,
397 .addr
= (uint64_t)(unsigned long)¶m
,
400 if (!memory_region_iommu_get_attr(iommu_mr
, IOMMU_ATTR_SPAPR_TCE_FD
,
402 QLIST_FOREACH(group
, &container
->group_list
, container_next
) {
403 param
.groupfd
= group
->fd
;
404 if (ioctl(vfio_kvm_device_fd
, KVM_SET_DEVICE_ATTR
, &attr
)) {
405 error_setg_errno(errp
, errno
,
406 "vfio: failed GROUP_SET_SPAPR_TCE for "
407 "KVM VFIO device %d and group fd %d",
408 param
.tablefd
, param
.groupfd
);
411 trace_vfio_spapr_group_attach(param
.groupfd
, param
.tablefd
);
420 vfio_spapr_container_del_section_window(VFIOContainerBase
*bcontainer
,
421 MemoryRegionSection
*section
)
423 VFIOContainer
*container
= container_of(bcontainer
, VFIOContainer
,
425 VFIOSpaprContainer
*scontainer
= container_of(container
, VFIOSpaprContainer
,
428 if (container
->iommu_type
!= VFIO_SPAPR_TCE_v2_IOMMU
) {
432 vfio_spapr_remove_window(container
,
433 section
->offset_within_address_space
);
434 if (vfio_host_win_del(scontainer
,
435 section
->offset_within_address_space
,
436 section
->offset_within_address_space
+
437 int128_get64(section
->size
) - 1) < 0) {
438 hw_error("%s: Cannot delete missing window at %"HWADDR_PRIx
,
439 __func__
, section
->offset_within_address_space
);
443 static void vfio_spapr_container_release(VFIOContainerBase
*bcontainer
)
445 VFIOContainer
*container
= container_of(bcontainer
, VFIOContainer
,
447 VFIOSpaprContainer
*scontainer
= container_of(container
, VFIOSpaprContainer
,
449 VFIOHostDMAWindow
*hostwin
, *next
;
451 if (container
->iommu_type
== VFIO_SPAPR_TCE_v2_IOMMU
) {
452 memory_listener_unregister(&scontainer
->prereg_listener
);
454 QLIST_FOREACH_SAFE(hostwin
, &scontainer
->hostwin_list
, hostwin_next
,
456 QLIST_REMOVE(hostwin
, hostwin_next
);
461 static int vfio_spapr_container_setup(VFIOContainerBase
*bcontainer
,
464 VFIOContainer
*container
= container_of(bcontainer
, VFIOContainer
,
466 VFIOSpaprContainer
*scontainer
= container_of(container
, VFIOSpaprContainer
,
468 struct vfio_iommu_spapr_tce_info info
;
469 bool v2
= container
->iommu_type
== VFIO_SPAPR_TCE_v2_IOMMU
;
470 int ret
, fd
= container
->fd
;
472 QLIST_INIT(&scontainer
->hostwin_list
);
475 * The host kernel code implementing VFIO_IOMMU_DISABLE is called
476 * when container fd is closed so we do not call it explicitly
480 ret
= ioctl(fd
, VFIO_IOMMU_ENABLE
);
482 error_setg_errno(errp
, errno
, "failed to enable container");
486 scontainer
->prereg_listener
= vfio_prereg_listener
;
488 memory_listener_register(&scontainer
->prereg_listener
,
489 &address_space_memory
);
490 if (bcontainer
->error
) {
492 error_propagate_prepend(errp
, bcontainer
->error
,
493 "RAM memory listener initialization failed: ");
494 goto listener_unregister_exit
;
498 info
.argsz
= sizeof(info
);
499 ret
= ioctl(fd
, VFIO_IOMMU_SPAPR_TCE_GET_INFO
, &info
);
501 error_setg_errno(errp
, errno
,
502 "VFIO_IOMMU_SPAPR_TCE_GET_INFO failed");
504 goto listener_unregister_exit
;
508 bcontainer
->pgsizes
= info
.ddw
.pgsizes
;
510 * There is a default window in just created container.
511 * To make region_add/del simpler, we better remove this
512 * window now and let those iommu_listener callbacks
513 * create/remove them when needed.
515 ret
= vfio_spapr_remove_window(container
, info
.dma32_window_start
);
517 error_setg_errno(errp
, -ret
,
518 "failed to remove existing window");
519 goto listener_unregister_exit
;
522 /* The default table uses 4K pages */
523 bcontainer
->pgsizes
= 0x1000;
524 vfio_host_win_add(scontainer
, info
.dma32_window_start
,
525 info
.dma32_window_start
+
526 info
.dma32_window_size
- 1,
532 listener_unregister_exit
:
534 memory_listener_unregister(&scontainer
->prereg_listener
);
539 static void vfio_iommu_spapr_class_init(ObjectClass
*klass
, void *data
)
541 VFIOIOMMUClass
*vioc
= VFIO_IOMMU_CLASS(klass
);
543 vioc
->add_window
= vfio_spapr_container_add_section_window
;
544 vioc
->del_window
= vfio_spapr_container_del_section_window
;
545 vioc
->release
= vfio_spapr_container_release
;
546 vioc
->setup
= vfio_spapr_container_setup
;
549 static const TypeInfo types
[] = {
551 .name
= TYPE_VFIO_IOMMU_SPAPR
,
552 .parent
= TYPE_VFIO_IOMMU_LEGACY
,
553 .class_init
= vfio_iommu_spapr_class_init
,