Merge tag 'migration-20240802-pull-request' of https://gitlab.com/farosas/qemu into...
[qemu/armbru.git] / system / memory.c
blob5e6eb459d5de064f8fc2f993c0a0c0a53f88b12c
1 /*
2 * Physical memory management
4 * Copyright 2011 Red Hat, Inc. and/or its affiliates
6 * Authors:
7 * Avi Kivity <avi@redhat.com>
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
12 * Contributions after 2012-01-13 are licensed under the terms of the
13 * GNU GPL, version 2 or (at your option) any later version.
16 #include "qemu/osdep.h"
17 #include "qemu/log.h"
18 #include "qapi/error.h"
19 #include "exec/memory.h"
20 #include "qapi/visitor.h"
21 #include "qemu/bitops.h"
22 #include "qemu/error-report.h"
23 #include "qemu/main-loop.h"
24 #include "qemu/qemu-print.h"
25 #include "qom/object.h"
26 #include "trace.h"
28 #include "exec/memory-internal.h"
29 #include "exec/ram_addr.h"
30 #include "sysemu/kvm.h"
31 #include "sysemu/runstate.h"
32 #include "sysemu/tcg.h"
33 #include "qemu/accel.h"
34 #include "hw/boards.h"
35 #include "migration/vmstate.h"
36 #include "exec/address-spaces.h"
38 //#define DEBUG_UNASSIGNED
40 static unsigned memory_region_transaction_depth;
41 static bool memory_region_update_pending;
42 static bool ioeventfd_update_pending;
43 unsigned int global_dirty_tracking;
45 static QTAILQ_HEAD(, MemoryListener) memory_listeners
46 = QTAILQ_HEAD_INITIALIZER(memory_listeners);
48 static QTAILQ_HEAD(, AddressSpace) address_spaces
49 = QTAILQ_HEAD_INITIALIZER(address_spaces);
51 static GHashTable *flat_views;
53 typedef struct AddrRange AddrRange;
56 * Note that signed integers are needed for negative offsetting in aliases
57 * (large MemoryRegion::alias_offset).
59 struct AddrRange {
60 Int128 start;
61 Int128 size;
64 static AddrRange addrrange_make(Int128 start, Int128 size)
66 return (AddrRange) { start, size };
69 static bool addrrange_equal(AddrRange r1, AddrRange r2)
71 return int128_eq(r1.start, r2.start) && int128_eq(r1.size, r2.size);
74 static Int128 addrrange_end(AddrRange r)
76 return int128_add(r.start, r.size);
79 static AddrRange addrrange_shift(AddrRange range, Int128 delta)
81 int128_addto(&range.start, delta);
82 return range;
85 static bool addrrange_contains(AddrRange range, Int128 addr)
87 return int128_ge(addr, range.start)
88 && int128_lt(addr, addrrange_end(range));
91 static bool addrrange_intersects(AddrRange r1, AddrRange r2)
93 return addrrange_contains(r1, r2.start)
94 || addrrange_contains(r2, r1.start);
97 static AddrRange addrrange_intersection(AddrRange r1, AddrRange r2)
99 Int128 start = int128_max(r1.start, r2.start);
100 Int128 end = int128_min(addrrange_end(r1), addrrange_end(r2));
101 return addrrange_make(start, int128_sub(end, start));
104 enum ListenerDirection { Forward, Reverse };
106 #define MEMORY_LISTENER_CALL_GLOBAL(_callback, _direction, _args...) \
107 do { \
108 MemoryListener *_listener; \
110 switch (_direction) { \
111 case Forward: \
112 QTAILQ_FOREACH(_listener, &memory_listeners, link) { \
113 if (_listener->_callback) { \
114 _listener->_callback(_listener, ##_args); \
117 break; \
118 case Reverse: \
119 QTAILQ_FOREACH_REVERSE(_listener, &memory_listeners, link) { \
120 if (_listener->_callback) { \
121 _listener->_callback(_listener, ##_args); \
124 break; \
125 default: \
126 abort(); \
128 } while (0)
130 #define MEMORY_LISTENER_CALL(_as, _callback, _direction, _section, _args...) \
131 do { \
132 MemoryListener *_listener; \
134 switch (_direction) { \
135 case Forward: \
136 QTAILQ_FOREACH(_listener, &(_as)->listeners, link_as) { \
137 if (_listener->_callback) { \
138 _listener->_callback(_listener, _section, ##_args); \
141 break; \
142 case Reverse: \
143 QTAILQ_FOREACH_REVERSE(_listener, &(_as)->listeners, link_as) { \
144 if (_listener->_callback) { \
145 _listener->_callback(_listener, _section, ##_args); \
148 break; \
149 default: \
150 abort(); \
152 } while (0)
154 /* No need to ref/unref .mr, the FlatRange keeps it alive. */
155 #define MEMORY_LISTENER_UPDATE_REGION(fr, as, dir, callback, _args...) \
156 do { \
157 MemoryRegionSection mrs = section_from_flat_range(fr, \
158 address_space_to_flatview(as)); \
159 MEMORY_LISTENER_CALL(as, callback, dir, &mrs, ##_args); \
160 } while(0)
162 struct CoalescedMemoryRange {
163 AddrRange addr;
164 QTAILQ_ENTRY(CoalescedMemoryRange) link;
167 struct MemoryRegionIoeventfd {
168 AddrRange addr;
169 bool match_data;
170 uint64_t data;
171 EventNotifier *e;
174 static bool memory_region_ioeventfd_before(MemoryRegionIoeventfd *a,
175 MemoryRegionIoeventfd *b)
177 if (int128_lt(a->addr.start, b->addr.start)) {
178 return true;
179 } else if (int128_gt(a->addr.start, b->addr.start)) {
180 return false;
181 } else if (int128_lt(a->addr.size, b->addr.size)) {
182 return true;
183 } else if (int128_gt(a->addr.size, b->addr.size)) {
184 return false;
185 } else if (a->match_data < b->match_data) {
186 return true;
187 } else if (a->match_data > b->match_data) {
188 return false;
189 } else if (a->match_data) {
190 if (a->data < b->data) {
191 return true;
192 } else if (a->data > b->data) {
193 return false;
196 if (a->e < b->e) {
197 return true;
198 } else if (a->e > b->e) {
199 return false;
201 return false;
204 static bool memory_region_ioeventfd_equal(MemoryRegionIoeventfd *a,
205 MemoryRegionIoeventfd *b)
207 if (int128_eq(a->addr.start, b->addr.start) &&
208 (!int128_nz(a->addr.size) || !int128_nz(b->addr.size) ||
209 (int128_eq(a->addr.size, b->addr.size) &&
210 (a->match_data == b->match_data) &&
211 ((a->match_data && (a->data == b->data)) || !a->match_data) &&
212 (a->e == b->e))))
213 return true;
215 return false;
218 /* Range of memory in the global map. Addresses are absolute. */
219 struct FlatRange {
220 MemoryRegion *mr;
221 hwaddr offset_in_region;
222 AddrRange addr;
223 uint8_t dirty_log_mask;
224 bool romd_mode;
225 bool readonly;
226 bool nonvolatile;
227 bool unmergeable;
230 #define FOR_EACH_FLAT_RANGE(var, view) \
231 for (var = (view)->ranges; var < (view)->ranges + (view)->nr; ++var)
233 static inline MemoryRegionSection
234 section_from_flat_range(FlatRange *fr, FlatView *fv)
236 return (MemoryRegionSection) {
237 .mr = fr->mr,
238 .fv = fv,
239 .offset_within_region = fr->offset_in_region,
240 .size = fr->addr.size,
241 .offset_within_address_space = int128_get64(fr->addr.start),
242 .readonly = fr->readonly,
243 .nonvolatile = fr->nonvolatile,
244 .unmergeable = fr->unmergeable,
248 static bool flatrange_equal(FlatRange *a, FlatRange *b)
250 return a->mr == b->mr
251 && addrrange_equal(a->addr, b->addr)
252 && a->offset_in_region == b->offset_in_region
253 && a->romd_mode == b->romd_mode
254 && a->readonly == b->readonly
255 && a->nonvolatile == b->nonvolatile
256 && a->unmergeable == b->unmergeable;
259 static FlatView *flatview_new(MemoryRegion *mr_root)
261 FlatView *view;
263 view = g_new0(FlatView, 1);
264 view->ref = 1;
265 view->root = mr_root;
266 memory_region_ref(mr_root);
267 trace_flatview_new(view, mr_root);
269 return view;
272 /* Insert a range into a given position. Caller is responsible for maintaining
273 * sorting order.
275 static void flatview_insert(FlatView *view, unsigned pos, FlatRange *range)
277 if (view->nr == view->nr_allocated) {
278 view->nr_allocated = MAX(2 * view->nr, 10);
279 view->ranges = g_realloc(view->ranges,
280 view->nr_allocated * sizeof(*view->ranges));
282 memmove(view->ranges + pos + 1, view->ranges + pos,
283 (view->nr - pos) * sizeof(FlatRange));
284 view->ranges[pos] = *range;
285 memory_region_ref(range->mr);
286 ++view->nr;
289 static void flatview_destroy(FlatView *view)
291 int i;
293 trace_flatview_destroy(view, view->root);
294 if (view->dispatch) {
295 address_space_dispatch_free(view->dispatch);
297 for (i = 0; i < view->nr; i++) {
298 memory_region_unref(view->ranges[i].mr);
300 g_free(view->ranges);
301 memory_region_unref(view->root);
302 g_free(view);
305 static bool flatview_ref(FlatView *view)
307 return qatomic_fetch_inc_nonzero(&view->ref) > 0;
310 void flatview_unref(FlatView *view)
312 if (qatomic_fetch_dec(&view->ref) == 1) {
313 trace_flatview_destroy_rcu(view, view->root);
314 assert(view->root);
315 call_rcu(view, flatview_destroy, rcu);
319 static bool can_merge(FlatRange *r1, FlatRange *r2)
321 return int128_eq(addrrange_end(r1->addr), r2->addr.start)
322 && r1->mr == r2->mr
323 && int128_eq(int128_add(int128_make64(r1->offset_in_region),
324 r1->addr.size),
325 int128_make64(r2->offset_in_region))
326 && r1->dirty_log_mask == r2->dirty_log_mask
327 && r1->romd_mode == r2->romd_mode
328 && r1->readonly == r2->readonly
329 && r1->nonvolatile == r2->nonvolatile
330 && !r1->unmergeable && !r2->unmergeable;
333 /* Attempt to simplify a view by merging adjacent ranges */
334 static void flatview_simplify(FlatView *view)
336 unsigned i, j, k;
338 i = 0;
339 while (i < view->nr) {
340 j = i + 1;
341 while (j < view->nr
342 && can_merge(&view->ranges[j-1], &view->ranges[j])) {
343 int128_addto(&view->ranges[i].addr.size, view->ranges[j].addr.size);
344 ++j;
346 ++i;
347 for (k = i; k < j; k++) {
348 memory_region_unref(view->ranges[k].mr);
350 memmove(&view->ranges[i], &view->ranges[j],
351 (view->nr - j) * sizeof(view->ranges[j]));
352 view->nr -= j - i;
356 static bool memory_region_big_endian(MemoryRegion *mr)
358 #if TARGET_BIG_ENDIAN
359 return mr->ops->endianness != DEVICE_LITTLE_ENDIAN;
360 #else
361 return mr->ops->endianness == DEVICE_BIG_ENDIAN;
362 #endif
365 static void adjust_endianness(MemoryRegion *mr, uint64_t *data, MemOp op)
367 if ((op & MO_BSWAP) != devend_memop(mr->ops->endianness)) {
368 switch (op & MO_SIZE) {
369 case MO_8:
370 break;
371 case MO_16:
372 *data = bswap16(*data);
373 break;
374 case MO_32:
375 *data = bswap32(*data);
376 break;
377 case MO_64:
378 *data = bswap64(*data);
379 break;
380 default:
381 g_assert_not_reached();
386 static inline void memory_region_shift_read_access(uint64_t *value,
387 signed shift,
388 uint64_t mask,
389 uint64_t tmp)
391 if (shift >= 0) {
392 *value |= (tmp & mask) << shift;
393 } else {
394 *value |= (tmp & mask) >> -shift;
398 static inline uint64_t memory_region_shift_write_access(uint64_t *value,
399 signed shift,
400 uint64_t mask)
402 uint64_t tmp;
404 if (shift >= 0) {
405 tmp = (*value >> shift) & mask;
406 } else {
407 tmp = (*value << -shift) & mask;
410 return tmp;
413 static hwaddr memory_region_to_absolute_addr(MemoryRegion *mr, hwaddr offset)
415 MemoryRegion *root;
416 hwaddr abs_addr = offset;
418 abs_addr += mr->addr;
419 for (root = mr; root->container; ) {
420 root = root->container;
421 abs_addr += root->addr;
424 return abs_addr;
427 static int get_cpu_index(void)
429 if (current_cpu) {
430 return current_cpu->cpu_index;
432 return -1;
435 static MemTxResult memory_region_read_accessor(MemoryRegion *mr,
436 hwaddr addr,
437 uint64_t *value,
438 unsigned size,
439 signed shift,
440 uint64_t mask,
441 MemTxAttrs attrs)
443 uint64_t tmp;
445 tmp = mr->ops->read(mr->opaque, addr, size);
446 if (mr->subpage) {
447 trace_memory_region_subpage_read(get_cpu_index(), mr, addr, tmp, size);
448 } else if (trace_event_get_state_backends(TRACE_MEMORY_REGION_OPS_READ)) {
449 hwaddr abs_addr = memory_region_to_absolute_addr(mr, addr);
450 trace_memory_region_ops_read(get_cpu_index(), mr, abs_addr, tmp, size,
451 memory_region_name(mr));
453 memory_region_shift_read_access(value, shift, mask, tmp);
454 return MEMTX_OK;
457 static MemTxResult memory_region_read_with_attrs_accessor(MemoryRegion *mr,
458 hwaddr addr,
459 uint64_t *value,
460 unsigned size,
461 signed shift,
462 uint64_t mask,
463 MemTxAttrs attrs)
465 uint64_t tmp = 0;
466 MemTxResult r;
468 r = mr->ops->read_with_attrs(mr->opaque, addr, &tmp, size, attrs);
469 if (mr->subpage) {
470 trace_memory_region_subpage_read(get_cpu_index(), mr, addr, tmp, size);
471 } else if (trace_event_get_state_backends(TRACE_MEMORY_REGION_OPS_READ)) {
472 hwaddr abs_addr = memory_region_to_absolute_addr(mr, addr);
473 trace_memory_region_ops_read(get_cpu_index(), mr, abs_addr, tmp, size,
474 memory_region_name(mr));
476 memory_region_shift_read_access(value, shift, mask, tmp);
477 return r;
480 static MemTxResult memory_region_write_accessor(MemoryRegion *mr,
481 hwaddr addr,
482 uint64_t *value,
483 unsigned size,
484 signed shift,
485 uint64_t mask,
486 MemTxAttrs attrs)
488 uint64_t tmp = memory_region_shift_write_access(value, shift, mask);
490 if (mr->subpage) {
491 trace_memory_region_subpage_write(get_cpu_index(), mr, addr, tmp, size);
492 } else if (trace_event_get_state_backends(TRACE_MEMORY_REGION_OPS_WRITE)) {
493 hwaddr abs_addr = memory_region_to_absolute_addr(mr, addr);
494 trace_memory_region_ops_write(get_cpu_index(), mr, abs_addr, tmp, size,
495 memory_region_name(mr));
497 mr->ops->write(mr->opaque, addr, tmp, size);
498 return MEMTX_OK;
501 static MemTxResult memory_region_write_with_attrs_accessor(MemoryRegion *mr,
502 hwaddr addr,
503 uint64_t *value,
504 unsigned size,
505 signed shift,
506 uint64_t mask,
507 MemTxAttrs attrs)
509 uint64_t tmp = memory_region_shift_write_access(value, shift, mask);
511 if (mr->subpage) {
512 trace_memory_region_subpage_write(get_cpu_index(), mr, addr, tmp, size);
513 } else if (trace_event_get_state_backends(TRACE_MEMORY_REGION_OPS_WRITE)) {
514 hwaddr abs_addr = memory_region_to_absolute_addr(mr, addr);
515 trace_memory_region_ops_write(get_cpu_index(), mr, abs_addr, tmp, size,
516 memory_region_name(mr));
518 return mr->ops->write_with_attrs(mr->opaque, addr, tmp, size, attrs);
521 static MemTxResult access_with_adjusted_size(hwaddr addr,
522 uint64_t *value,
523 unsigned size,
524 unsigned access_size_min,
525 unsigned access_size_max,
526 MemTxResult (*access_fn)
527 (MemoryRegion *mr,
528 hwaddr addr,
529 uint64_t *value,
530 unsigned size,
531 signed shift,
532 uint64_t mask,
533 MemTxAttrs attrs),
534 MemoryRegion *mr,
535 MemTxAttrs attrs)
537 uint64_t access_mask;
538 unsigned access_size;
539 unsigned i;
540 MemTxResult r = MEMTX_OK;
541 bool reentrancy_guard_applied = false;
543 if (!access_size_min) {
544 access_size_min = 1;
546 if (!access_size_max) {
547 access_size_max = 4;
550 /* Do not allow more than one simultaneous access to a device's IO Regions */
551 if (mr->dev && !mr->disable_reentrancy_guard &&
552 !mr->ram_device && !mr->ram && !mr->rom_device && !mr->readonly) {
553 if (mr->dev->mem_reentrancy_guard.engaged_in_io) {
554 warn_report_once("Blocked re-entrant IO on MemoryRegion: "
555 "%s at addr: 0x%" HWADDR_PRIX,
556 memory_region_name(mr), addr);
557 return MEMTX_ACCESS_ERROR;
559 mr->dev->mem_reentrancy_guard.engaged_in_io = true;
560 reentrancy_guard_applied = true;
563 /* FIXME: support unaligned access? */
564 access_size = MAX(MIN(size, access_size_max), access_size_min);
565 access_mask = MAKE_64BIT_MASK(0, access_size * 8);
566 if (memory_region_big_endian(mr)) {
567 for (i = 0; i < size; i += access_size) {
568 r |= access_fn(mr, addr + i, value, access_size,
569 (size - access_size - i) * 8, access_mask, attrs);
571 } else {
572 for (i = 0; i < size; i += access_size) {
573 r |= access_fn(mr, addr + i, value, access_size, i * 8,
574 access_mask, attrs);
577 if (mr->dev && reentrancy_guard_applied) {
578 mr->dev->mem_reentrancy_guard.engaged_in_io = false;
580 return r;
583 static AddressSpace *memory_region_to_address_space(MemoryRegion *mr)
585 AddressSpace *as;
587 while (mr->container) {
588 mr = mr->container;
590 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
591 if (mr == as->root) {
592 return as;
595 return NULL;
598 /* Render a memory region into the global view. Ranges in @view obscure
599 * ranges in @mr.
601 static void render_memory_region(FlatView *view,
602 MemoryRegion *mr,
603 Int128 base,
604 AddrRange clip,
605 bool readonly,
606 bool nonvolatile,
607 bool unmergeable)
609 MemoryRegion *subregion;
610 unsigned i;
611 hwaddr offset_in_region;
612 Int128 remain;
613 Int128 now;
614 FlatRange fr;
615 AddrRange tmp;
617 if (!mr->enabled) {
618 return;
621 int128_addto(&base, int128_make64(mr->addr));
622 readonly |= mr->readonly;
623 nonvolatile |= mr->nonvolatile;
624 unmergeable |= mr->unmergeable;
626 tmp = addrrange_make(base, mr->size);
628 if (!addrrange_intersects(tmp, clip)) {
629 return;
632 clip = addrrange_intersection(tmp, clip);
634 if (mr->alias) {
635 int128_subfrom(&base, int128_make64(mr->alias->addr));
636 int128_subfrom(&base, int128_make64(mr->alias_offset));
637 render_memory_region(view, mr->alias, base, clip,
638 readonly, nonvolatile, unmergeable);
639 return;
642 /* Render subregions in priority order. */
643 QTAILQ_FOREACH(subregion, &mr->subregions, subregions_link) {
644 render_memory_region(view, subregion, base, clip,
645 readonly, nonvolatile, unmergeable);
648 if (!mr->terminates) {
649 return;
652 offset_in_region = int128_get64(int128_sub(clip.start, base));
653 base = clip.start;
654 remain = clip.size;
656 fr.mr = mr;
657 fr.dirty_log_mask = memory_region_get_dirty_log_mask(mr);
658 fr.romd_mode = mr->romd_mode;
659 fr.readonly = readonly;
660 fr.nonvolatile = nonvolatile;
661 fr.unmergeable = unmergeable;
663 /* Render the region itself into any gaps left by the current view. */
664 for (i = 0; i < view->nr && int128_nz(remain); ++i) {
665 if (int128_ge(base, addrrange_end(view->ranges[i].addr))) {
666 continue;
668 if (int128_lt(base, view->ranges[i].addr.start)) {
669 now = int128_min(remain,
670 int128_sub(view->ranges[i].addr.start, base));
671 fr.offset_in_region = offset_in_region;
672 fr.addr = addrrange_make(base, now);
673 flatview_insert(view, i, &fr);
674 ++i;
675 int128_addto(&base, now);
676 offset_in_region += int128_get64(now);
677 int128_subfrom(&remain, now);
679 now = int128_sub(int128_min(int128_add(base, remain),
680 addrrange_end(view->ranges[i].addr)),
681 base);
682 int128_addto(&base, now);
683 offset_in_region += int128_get64(now);
684 int128_subfrom(&remain, now);
686 if (int128_nz(remain)) {
687 fr.offset_in_region = offset_in_region;
688 fr.addr = addrrange_make(base, remain);
689 flatview_insert(view, i, &fr);
693 void flatview_for_each_range(FlatView *fv, flatview_cb cb , void *opaque)
695 FlatRange *fr;
697 assert(fv);
698 assert(cb);
700 FOR_EACH_FLAT_RANGE(fr, fv) {
701 if (cb(fr->addr.start, fr->addr.size, fr->mr,
702 fr->offset_in_region, opaque)) {
703 break;
708 static MemoryRegion *memory_region_get_flatview_root(MemoryRegion *mr)
710 while (mr->enabled) {
711 if (mr->alias) {
712 if (!mr->alias_offset && int128_ge(mr->size, mr->alias->size)) {
713 /* The alias is included in its entirety. Use it as
714 * the "real" root, so that we can share more FlatViews.
716 mr = mr->alias;
717 continue;
719 } else if (!mr->terminates) {
720 unsigned int found = 0;
721 MemoryRegion *child, *next = NULL;
722 QTAILQ_FOREACH(child, &mr->subregions, subregions_link) {
723 if (child->enabled) {
724 if (++found > 1) {
725 next = NULL;
726 break;
728 if (!child->addr && int128_ge(mr->size, child->size)) {
729 /* A child is included in its entirety. If it's the only
730 * enabled one, use it in the hope of finding an alias down the
731 * way. This will also let us share FlatViews.
733 next = child;
737 if (found == 0) {
738 return NULL;
740 if (next) {
741 mr = next;
742 continue;
746 return mr;
749 return NULL;
752 /* Render a memory topology into a list of disjoint absolute ranges. */
753 static FlatView *generate_memory_topology(MemoryRegion *mr)
755 int i;
756 FlatView *view;
758 view = flatview_new(mr);
760 if (mr) {
761 render_memory_region(view, mr, int128_zero(),
762 addrrange_make(int128_zero(), int128_2_64()),
763 false, false, false);
765 flatview_simplify(view);
767 view->dispatch = address_space_dispatch_new(view);
768 for (i = 0; i < view->nr; i++) {
769 MemoryRegionSection mrs =
770 section_from_flat_range(&view->ranges[i], view);
771 flatview_add_to_dispatch(view, &mrs);
773 address_space_dispatch_compact(view->dispatch);
774 g_hash_table_replace(flat_views, mr, view);
776 return view;
779 static void address_space_add_del_ioeventfds(AddressSpace *as,
780 MemoryRegionIoeventfd *fds_new,
781 unsigned fds_new_nb,
782 MemoryRegionIoeventfd *fds_old,
783 unsigned fds_old_nb)
785 unsigned iold, inew;
786 MemoryRegionIoeventfd *fd;
787 MemoryRegionSection section;
789 /* Generate a symmetric difference of the old and new fd sets, adding
790 * and deleting as necessary.
793 iold = inew = 0;
794 while (iold < fds_old_nb || inew < fds_new_nb) {
795 if (iold < fds_old_nb
796 && (inew == fds_new_nb
797 || memory_region_ioeventfd_before(&fds_old[iold],
798 &fds_new[inew]))) {
799 fd = &fds_old[iold];
800 section = (MemoryRegionSection) {
801 .fv = address_space_to_flatview(as),
802 .offset_within_address_space = int128_get64(fd->addr.start),
803 .size = fd->addr.size,
805 MEMORY_LISTENER_CALL(as, eventfd_del, Forward, &section,
806 fd->match_data, fd->data, fd->e);
807 ++iold;
808 } else if (inew < fds_new_nb
809 && (iold == fds_old_nb
810 || memory_region_ioeventfd_before(&fds_new[inew],
811 &fds_old[iold]))) {
812 fd = &fds_new[inew];
813 section = (MemoryRegionSection) {
814 .fv = address_space_to_flatview(as),
815 .offset_within_address_space = int128_get64(fd->addr.start),
816 .size = fd->addr.size,
818 MEMORY_LISTENER_CALL(as, eventfd_add, Reverse, &section,
819 fd->match_data, fd->data, fd->e);
820 ++inew;
821 } else {
822 ++iold;
823 ++inew;
828 FlatView *address_space_get_flatview(AddressSpace *as)
830 FlatView *view;
832 RCU_READ_LOCK_GUARD();
833 do {
834 view = address_space_to_flatview(as);
835 /* If somebody has replaced as->current_map concurrently,
836 * flatview_ref returns false.
838 } while (!flatview_ref(view));
839 return view;
842 static void address_space_update_ioeventfds(AddressSpace *as)
844 FlatView *view;
845 FlatRange *fr;
846 unsigned ioeventfd_nb = 0;
847 unsigned ioeventfd_max;
848 MemoryRegionIoeventfd *ioeventfds;
849 AddrRange tmp;
850 unsigned i;
852 if (!as->ioeventfd_notifiers) {
853 return;
857 * It is likely that the number of ioeventfds hasn't changed much, so use
858 * the previous size as the starting value, with some headroom to avoid
859 * gratuitous reallocations.
861 ioeventfd_max = QEMU_ALIGN_UP(as->ioeventfd_nb, 4);
862 ioeventfds = g_new(MemoryRegionIoeventfd, ioeventfd_max);
864 view = address_space_get_flatview(as);
865 FOR_EACH_FLAT_RANGE(fr, view) {
866 for (i = 0; i < fr->mr->ioeventfd_nb; ++i) {
867 tmp = addrrange_shift(fr->mr->ioeventfds[i].addr,
868 int128_sub(fr->addr.start,
869 int128_make64(fr->offset_in_region)));
870 if (addrrange_intersects(fr->addr, tmp)) {
871 ++ioeventfd_nb;
872 if (ioeventfd_nb > ioeventfd_max) {
873 ioeventfd_max = MAX(ioeventfd_max * 2, 4);
874 ioeventfds = g_realloc(ioeventfds,
875 ioeventfd_max * sizeof(*ioeventfds));
877 ioeventfds[ioeventfd_nb-1] = fr->mr->ioeventfds[i];
878 ioeventfds[ioeventfd_nb-1].addr = tmp;
883 address_space_add_del_ioeventfds(as, ioeventfds, ioeventfd_nb,
884 as->ioeventfds, as->ioeventfd_nb);
886 g_free(as->ioeventfds);
887 as->ioeventfds = ioeventfds;
888 as->ioeventfd_nb = ioeventfd_nb;
889 flatview_unref(view);
893 * Notify the memory listeners about the coalesced IO change events of
894 * range `cmr'. Only the part that has intersection of the specified
895 * FlatRange will be sent.
897 static void flat_range_coalesced_io_notify(FlatRange *fr, AddressSpace *as,
898 CoalescedMemoryRange *cmr, bool add)
900 AddrRange tmp;
902 tmp = addrrange_shift(cmr->addr,
903 int128_sub(fr->addr.start,
904 int128_make64(fr->offset_in_region)));
905 if (!addrrange_intersects(tmp, fr->addr)) {
906 return;
908 tmp = addrrange_intersection(tmp, fr->addr);
910 if (add) {
911 MEMORY_LISTENER_UPDATE_REGION(fr, as, Forward, coalesced_io_add,
912 int128_get64(tmp.start),
913 int128_get64(tmp.size));
914 } else {
915 MEMORY_LISTENER_UPDATE_REGION(fr, as, Reverse, coalesced_io_del,
916 int128_get64(tmp.start),
917 int128_get64(tmp.size));
921 static void flat_range_coalesced_io_del(FlatRange *fr, AddressSpace *as)
923 CoalescedMemoryRange *cmr;
925 QTAILQ_FOREACH(cmr, &fr->mr->coalesced, link) {
926 flat_range_coalesced_io_notify(fr, as, cmr, false);
930 static void flat_range_coalesced_io_add(FlatRange *fr, AddressSpace *as)
932 MemoryRegion *mr = fr->mr;
933 CoalescedMemoryRange *cmr;
935 if (QTAILQ_EMPTY(&mr->coalesced)) {
936 return;
939 QTAILQ_FOREACH(cmr, &mr->coalesced, link) {
940 flat_range_coalesced_io_notify(fr, as, cmr, true);
944 static void address_space_update_topology_pass(AddressSpace *as,
945 const FlatView *old_view,
946 const FlatView *new_view,
947 bool adding)
949 unsigned iold, inew;
950 FlatRange *frold, *frnew;
952 /* Generate a symmetric difference of the old and new memory maps.
953 * Kill ranges in the old map, and instantiate ranges in the new map.
955 iold = inew = 0;
956 while (iold < old_view->nr || inew < new_view->nr) {
957 if (iold < old_view->nr) {
958 frold = &old_view->ranges[iold];
959 } else {
960 frold = NULL;
962 if (inew < new_view->nr) {
963 frnew = &new_view->ranges[inew];
964 } else {
965 frnew = NULL;
968 if (frold
969 && (!frnew
970 || int128_lt(frold->addr.start, frnew->addr.start)
971 || (int128_eq(frold->addr.start, frnew->addr.start)
972 && !flatrange_equal(frold, frnew)))) {
973 /* In old but not in new, or in both but attributes changed. */
975 if (!adding) {
976 flat_range_coalesced_io_del(frold, as);
977 MEMORY_LISTENER_UPDATE_REGION(frold, as, Reverse, region_del);
980 ++iold;
981 } else if (frold && frnew && flatrange_equal(frold, frnew)) {
982 /* In both and unchanged (except logging may have changed) */
984 if (adding) {
985 MEMORY_LISTENER_UPDATE_REGION(frnew, as, Forward, region_nop);
986 if (frnew->dirty_log_mask & ~frold->dirty_log_mask) {
987 MEMORY_LISTENER_UPDATE_REGION(frnew, as, Forward, log_start,
988 frold->dirty_log_mask,
989 frnew->dirty_log_mask);
991 if (frold->dirty_log_mask & ~frnew->dirty_log_mask) {
992 MEMORY_LISTENER_UPDATE_REGION(frnew, as, Reverse, log_stop,
993 frold->dirty_log_mask,
994 frnew->dirty_log_mask);
998 ++iold;
999 ++inew;
1000 } else {
1001 /* In new */
1003 if (adding) {
1004 MEMORY_LISTENER_UPDATE_REGION(frnew, as, Forward, region_add);
1005 flat_range_coalesced_io_add(frnew, as);
1008 ++inew;
1013 static void flatviews_init(void)
1015 static FlatView *empty_view;
1017 if (flat_views) {
1018 return;
1021 flat_views = g_hash_table_new_full(g_direct_hash, g_direct_equal, NULL,
1022 (GDestroyNotify) flatview_unref);
1023 if (!empty_view) {
1024 empty_view = generate_memory_topology(NULL);
1025 /* We keep it alive forever in the global variable. */
1026 flatview_ref(empty_view);
1027 } else {
1028 g_hash_table_replace(flat_views, NULL, empty_view);
1029 flatview_ref(empty_view);
1033 static void flatviews_reset(void)
1035 AddressSpace *as;
1037 if (flat_views) {
1038 g_hash_table_unref(flat_views);
1039 flat_views = NULL;
1041 flatviews_init();
1043 /* Render unique FVs */
1044 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
1045 MemoryRegion *physmr = memory_region_get_flatview_root(as->root);
1047 if (g_hash_table_lookup(flat_views, physmr)) {
1048 continue;
1051 generate_memory_topology(physmr);
1055 static void address_space_set_flatview(AddressSpace *as)
1057 FlatView *old_view = address_space_to_flatview(as);
1058 MemoryRegion *physmr = memory_region_get_flatview_root(as->root);
1059 FlatView *new_view = g_hash_table_lookup(flat_views, physmr);
1061 assert(new_view);
1063 if (old_view == new_view) {
1064 return;
1067 if (old_view) {
1068 flatview_ref(old_view);
1071 flatview_ref(new_view);
1073 if (!QTAILQ_EMPTY(&as->listeners)) {
1074 FlatView tmpview = { .nr = 0 }, *old_view2 = old_view;
1076 if (!old_view2) {
1077 old_view2 = &tmpview;
1079 address_space_update_topology_pass(as, old_view2, new_view, false);
1080 address_space_update_topology_pass(as, old_view2, new_view, true);
1083 /* Writes are protected by the BQL. */
1084 qatomic_rcu_set(&as->current_map, new_view);
1085 if (old_view) {
1086 flatview_unref(old_view);
1089 /* Note that all the old MemoryRegions are still alive up to this
1090 * point. This relieves most MemoryListeners from the need to
1091 * ref/unref the MemoryRegions they get---unless they use them
1092 * outside the iothread mutex, in which case precise reference
1093 * counting is necessary.
1095 if (old_view) {
1096 flatview_unref(old_view);
1100 static void address_space_update_topology(AddressSpace *as)
1102 MemoryRegion *physmr = memory_region_get_flatview_root(as->root);
1104 flatviews_init();
1105 if (!g_hash_table_lookup(flat_views, physmr)) {
1106 generate_memory_topology(physmr);
1108 address_space_set_flatview(as);
1111 void memory_region_transaction_begin(void)
1113 qemu_flush_coalesced_mmio_buffer();
1114 ++memory_region_transaction_depth;
1117 void memory_region_transaction_commit(void)
1119 AddressSpace *as;
1121 assert(memory_region_transaction_depth);
1122 assert(bql_locked());
1124 --memory_region_transaction_depth;
1125 if (!memory_region_transaction_depth) {
1126 if (memory_region_update_pending) {
1127 flatviews_reset();
1129 MEMORY_LISTENER_CALL_GLOBAL(begin, Forward);
1131 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
1132 address_space_set_flatview(as);
1133 address_space_update_ioeventfds(as);
1135 memory_region_update_pending = false;
1136 ioeventfd_update_pending = false;
1137 MEMORY_LISTENER_CALL_GLOBAL(commit, Forward);
1138 } else if (ioeventfd_update_pending) {
1139 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
1140 address_space_update_ioeventfds(as);
1142 ioeventfd_update_pending = false;
1147 static void memory_region_destructor_none(MemoryRegion *mr)
1151 static void memory_region_destructor_ram(MemoryRegion *mr)
1153 qemu_ram_free(mr->ram_block);
1156 static bool memory_region_need_escape(char c)
1158 return c == '/' || c == '[' || c == '\\' || c == ']';
1161 static char *memory_region_escape_name(const char *name)
1163 const char *p;
1164 char *escaped, *q;
1165 uint8_t c;
1166 size_t bytes = 0;
1168 for (p = name; *p; p++) {
1169 bytes += memory_region_need_escape(*p) ? 4 : 1;
1171 if (bytes == p - name) {
1172 return g_memdup(name, bytes + 1);
1175 escaped = g_malloc(bytes + 1);
1176 for (p = name, q = escaped; *p; p++) {
1177 c = *p;
1178 if (unlikely(memory_region_need_escape(c))) {
1179 *q++ = '\\';
1180 *q++ = 'x';
1181 *q++ = "0123456789abcdef"[c >> 4];
1182 c = "0123456789abcdef"[c & 15];
1184 *q++ = c;
1186 *q = 0;
1187 return escaped;
1190 static void memory_region_do_init(MemoryRegion *mr,
1191 Object *owner,
1192 const char *name,
1193 uint64_t size)
1195 mr->size = int128_make64(size);
1196 if (size == UINT64_MAX) {
1197 mr->size = int128_2_64();
1199 mr->name = g_strdup(name);
1200 mr->owner = owner;
1201 mr->dev = (DeviceState *) object_dynamic_cast(mr->owner, TYPE_DEVICE);
1202 mr->ram_block = NULL;
1204 if (name) {
1205 char *escaped_name = memory_region_escape_name(name);
1206 char *name_array = g_strdup_printf("%s[*]", escaped_name);
1208 if (!owner) {
1209 owner = container_get(qdev_get_machine(), "/unattached");
1212 object_property_add_child(owner, name_array, OBJECT(mr));
1213 object_unref(OBJECT(mr));
1214 g_free(name_array);
1215 g_free(escaped_name);
1219 void memory_region_init(MemoryRegion *mr,
1220 Object *owner,
1221 const char *name,
1222 uint64_t size)
1224 object_initialize(mr, sizeof(*mr), TYPE_MEMORY_REGION);
1225 memory_region_do_init(mr, owner, name, size);
1228 static void memory_region_get_container(Object *obj, Visitor *v,
1229 const char *name, void *opaque,
1230 Error **errp)
1232 MemoryRegion *mr = MEMORY_REGION(obj);
1233 char *path = (char *)"";
1235 if (mr->container) {
1236 path = object_get_canonical_path(OBJECT(mr->container));
1238 visit_type_str(v, name, &path, errp);
1239 if (mr->container) {
1240 g_free(path);
1244 static Object *memory_region_resolve_container(Object *obj, void *opaque,
1245 const char *part)
1247 MemoryRegion *mr = MEMORY_REGION(obj);
1249 return OBJECT(mr->container);
1252 static void memory_region_get_priority(Object *obj, Visitor *v,
1253 const char *name, void *opaque,
1254 Error **errp)
1256 MemoryRegion *mr = MEMORY_REGION(obj);
1257 int32_t value = mr->priority;
1259 visit_type_int32(v, name, &value, errp);
1262 static void memory_region_get_size(Object *obj, Visitor *v, const char *name,
1263 void *opaque, Error **errp)
1265 MemoryRegion *mr = MEMORY_REGION(obj);
1266 uint64_t value = memory_region_size(mr);
1268 visit_type_uint64(v, name, &value, errp);
1271 static void memory_region_initfn(Object *obj)
1273 MemoryRegion *mr = MEMORY_REGION(obj);
1274 ObjectProperty *op;
1276 mr->ops = &unassigned_mem_ops;
1277 mr->enabled = true;
1278 mr->romd_mode = true;
1279 mr->destructor = memory_region_destructor_none;
1280 QTAILQ_INIT(&mr->subregions);
1281 QTAILQ_INIT(&mr->coalesced);
1283 op = object_property_add(OBJECT(mr), "container",
1284 "link<" TYPE_MEMORY_REGION ">",
1285 memory_region_get_container,
1286 NULL, /* memory_region_set_container */
1287 NULL, NULL);
1288 op->resolve = memory_region_resolve_container;
1290 object_property_add_uint64_ptr(OBJECT(mr), "addr",
1291 &mr->addr, OBJ_PROP_FLAG_READ);
1292 object_property_add(OBJECT(mr), "priority", "uint32",
1293 memory_region_get_priority,
1294 NULL, /* memory_region_set_priority */
1295 NULL, NULL);
1296 object_property_add(OBJECT(mr), "size", "uint64",
1297 memory_region_get_size,
1298 NULL, /* memory_region_set_size, */
1299 NULL, NULL);
1302 static void iommu_memory_region_initfn(Object *obj)
1304 MemoryRegion *mr = MEMORY_REGION(obj);
1306 mr->is_iommu = true;
1309 static uint64_t unassigned_mem_read(void *opaque, hwaddr addr,
1310 unsigned size)
1312 #ifdef DEBUG_UNASSIGNED
1313 printf("Unassigned mem read " HWADDR_FMT_plx "\n", addr);
1314 #endif
1315 return 0;
1318 static void unassigned_mem_write(void *opaque, hwaddr addr,
1319 uint64_t val, unsigned size)
1321 #ifdef DEBUG_UNASSIGNED
1322 printf("Unassigned mem write " HWADDR_FMT_plx " = 0x%"PRIx64"\n", addr, val);
1323 #endif
1326 static bool unassigned_mem_accepts(void *opaque, hwaddr addr,
1327 unsigned size, bool is_write,
1328 MemTxAttrs attrs)
1330 return false;
1333 const MemoryRegionOps unassigned_mem_ops = {
1334 .valid.accepts = unassigned_mem_accepts,
1335 .endianness = DEVICE_NATIVE_ENDIAN,
1338 static uint64_t memory_region_ram_device_read(void *opaque,
1339 hwaddr addr, unsigned size)
1341 MemoryRegion *mr = opaque;
1342 uint64_t data = ldn_he_p(mr->ram_block->host + addr, size);
1344 trace_memory_region_ram_device_read(get_cpu_index(), mr, addr, data, size);
1346 return data;
1349 static void memory_region_ram_device_write(void *opaque, hwaddr addr,
1350 uint64_t data, unsigned size)
1352 MemoryRegion *mr = opaque;
1354 trace_memory_region_ram_device_write(get_cpu_index(), mr, addr, data, size);
1356 stn_he_p(mr->ram_block->host + addr, size, data);
1359 static const MemoryRegionOps ram_device_mem_ops = {
1360 .read = memory_region_ram_device_read,
1361 .write = memory_region_ram_device_write,
1362 .endianness = DEVICE_HOST_ENDIAN,
1363 .valid = {
1364 .min_access_size = 1,
1365 .max_access_size = 8,
1366 .unaligned = true,
1368 .impl = {
1369 .min_access_size = 1,
1370 .max_access_size = 8,
1371 .unaligned = true,
1375 bool memory_region_access_valid(MemoryRegion *mr,
1376 hwaddr addr,
1377 unsigned size,
1378 bool is_write,
1379 MemTxAttrs attrs)
1381 if (mr->ops->valid.accepts
1382 && !mr->ops->valid.accepts(mr->opaque, addr, size, is_write, attrs)) {
1383 qemu_log_mask(LOG_GUEST_ERROR, "Invalid %s at addr 0x%" HWADDR_PRIX
1384 ", size %u, region '%s', reason: rejected\n",
1385 is_write ? "write" : "read",
1386 addr, size, memory_region_name(mr));
1387 return false;
1390 if (!mr->ops->valid.unaligned && (addr & (size - 1))) {
1391 qemu_log_mask(LOG_GUEST_ERROR, "Invalid %s at addr 0x%" HWADDR_PRIX
1392 ", size %u, region '%s', reason: unaligned\n",
1393 is_write ? "write" : "read",
1394 addr, size, memory_region_name(mr));
1395 return false;
1398 /* Treat zero as compatibility all valid */
1399 if (!mr->ops->valid.max_access_size) {
1400 return true;
1403 if (size > mr->ops->valid.max_access_size
1404 || size < mr->ops->valid.min_access_size) {
1405 qemu_log_mask(LOG_GUEST_ERROR, "Invalid %s at addr 0x%" HWADDR_PRIX
1406 ", size %u, region '%s', reason: invalid size "
1407 "(min:%u max:%u)\n",
1408 is_write ? "write" : "read",
1409 addr, size, memory_region_name(mr),
1410 mr->ops->valid.min_access_size,
1411 mr->ops->valid.max_access_size);
1412 return false;
1414 return true;
1417 static MemTxResult memory_region_dispatch_read1(MemoryRegion *mr,
1418 hwaddr addr,
1419 uint64_t *pval,
1420 unsigned size,
1421 MemTxAttrs attrs)
1423 *pval = 0;
1425 if (mr->ops->read) {
1426 return access_with_adjusted_size(addr, pval, size,
1427 mr->ops->impl.min_access_size,
1428 mr->ops->impl.max_access_size,
1429 memory_region_read_accessor,
1430 mr, attrs);
1431 } else {
1432 return access_with_adjusted_size(addr, pval, size,
1433 mr->ops->impl.min_access_size,
1434 mr->ops->impl.max_access_size,
1435 memory_region_read_with_attrs_accessor,
1436 mr, attrs);
1440 MemTxResult memory_region_dispatch_read(MemoryRegion *mr,
1441 hwaddr addr,
1442 uint64_t *pval,
1443 MemOp op,
1444 MemTxAttrs attrs)
1446 unsigned size = memop_size(op);
1447 MemTxResult r;
1449 if (mr->alias) {
1450 return memory_region_dispatch_read(mr->alias,
1451 mr->alias_offset + addr,
1452 pval, op, attrs);
1454 if (!memory_region_access_valid(mr, addr, size, false, attrs)) {
1455 *pval = unassigned_mem_read(mr, addr, size);
1456 return MEMTX_DECODE_ERROR;
1459 r = memory_region_dispatch_read1(mr, addr, pval, size, attrs);
1460 adjust_endianness(mr, pval, op);
1461 return r;
1464 /* Return true if an eventfd was signalled */
1465 static bool memory_region_dispatch_write_eventfds(MemoryRegion *mr,
1466 hwaddr addr,
1467 uint64_t data,
1468 unsigned size,
1469 MemTxAttrs attrs)
1471 MemoryRegionIoeventfd ioeventfd = {
1472 .addr = addrrange_make(int128_make64(addr), int128_make64(size)),
1473 .data = data,
1475 unsigned i;
1477 for (i = 0; i < mr->ioeventfd_nb; i++) {
1478 ioeventfd.match_data = mr->ioeventfds[i].match_data;
1479 ioeventfd.e = mr->ioeventfds[i].e;
1481 if (memory_region_ioeventfd_equal(&ioeventfd, &mr->ioeventfds[i])) {
1482 event_notifier_set(ioeventfd.e);
1483 return true;
1487 return false;
1490 MemTxResult memory_region_dispatch_write(MemoryRegion *mr,
1491 hwaddr addr,
1492 uint64_t data,
1493 MemOp op,
1494 MemTxAttrs attrs)
1496 unsigned size = memop_size(op);
1498 if (mr->alias) {
1499 return memory_region_dispatch_write(mr->alias,
1500 mr->alias_offset + addr,
1501 data, op, attrs);
1503 if (!memory_region_access_valid(mr, addr, size, true, attrs)) {
1504 unassigned_mem_write(mr, addr, data, size);
1505 return MEMTX_DECODE_ERROR;
1508 adjust_endianness(mr, &data, op);
1511 * FIXME: it's not clear why under KVM the write would be processed
1512 * directly, instead of going through eventfd. This probably should
1513 * test "tcg_enabled() || qtest_enabled()", or should just go away.
1515 if (!kvm_enabled() &&
1516 memory_region_dispatch_write_eventfds(mr, addr, data, size, attrs)) {
1517 return MEMTX_OK;
1520 if (mr->ops->write) {
1521 return access_with_adjusted_size(addr, &data, size,
1522 mr->ops->impl.min_access_size,
1523 mr->ops->impl.max_access_size,
1524 memory_region_write_accessor, mr,
1525 attrs);
1526 } else {
1527 return
1528 access_with_adjusted_size(addr, &data, size,
1529 mr->ops->impl.min_access_size,
1530 mr->ops->impl.max_access_size,
1531 memory_region_write_with_attrs_accessor,
1532 mr, attrs);
1536 void memory_region_init_io(MemoryRegion *mr,
1537 Object *owner,
1538 const MemoryRegionOps *ops,
1539 void *opaque,
1540 const char *name,
1541 uint64_t size)
1543 memory_region_init(mr, owner, name, size);
1544 mr->ops = ops ? ops : &unassigned_mem_ops;
1545 mr->opaque = opaque;
1546 mr->terminates = true;
1549 bool memory_region_init_ram_nomigrate(MemoryRegion *mr,
1550 Object *owner,
1551 const char *name,
1552 uint64_t size,
1553 Error **errp)
1555 return memory_region_init_ram_flags_nomigrate(mr, owner, name,
1556 size, 0, errp);
1559 bool memory_region_init_ram_flags_nomigrate(MemoryRegion *mr,
1560 Object *owner,
1561 const char *name,
1562 uint64_t size,
1563 uint32_t ram_flags,
1564 Error **errp)
1566 Error *err = NULL;
1567 memory_region_init(mr, owner, name, size);
1568 mr->ram = true;
1569 mr->terminates = true;
1570 mr->destructor = memory_region_destructor_ram;
1571 mr->ram_block = qemu_ram_alloc(size, ram_flags, mr, &err);
1572 if (err) {
1573 mr->size = int128_zero();
1574 object_unparent(OBJECT(mr));
1575 error_propagate(errp, err);
1576 return false;
1578 return true;
1581 bool memory_region_init_resizeable_ram(MemoryRegion *mr,
1582 Object *owner,
1583 const char *name,
1584 uint64_t size,
1585 uint64_t max_size,
1586 void (*resized)(const char*,
1587 uint64_t length,
1588 void *host),
1589 Error **errp)
1591 Error *err = NULL;
1592 memory_region_init(mr, owner, name, size);
1593 mr->ram = true;
1594 mr->terminates = true;
1595 mr->destructor = memory_region_destructor_ram;
1596 mr->ram_block = qemu_ram_alloc_resizeable(size, max_size, resized,
1597 mr, &err);
1598 if (err) {
1599 mr->size = int128_zero();
1600 object_unparent(OBJECT(mr));
1601 error_propagate(errp, err);
1602 return false;
1604 return true;
1607 #ifdef CONFIG_POSIX
1608 bool memory_region_init_ram_from_file(MemoryRegion *mr,
1609 Object *owner,
1610 const char *name,
1611 uint64_t size,
1612 uint64_t align,
1613 uint32_t ram_flags,
1614 const char *path,
1615 ram_addr_t offset,
1616 Error **errp)
1618 Error *err = NULL;
1619 memory_region_init(mr, owner, name, size);
1620 mr->ram = true;
1621 mr->readonly = !!(ram_flags & RAM_READONLY);
1622 mr->terminates = true;
1623 mr->destructor = memory_region_destructor_ram;
1624 mr->align = align;
1625 mr->ram_block = qemu_ram_alloc_from_file(size, mr, ram_flags, path,
1626 offset, &err);
1627 if (err) {
1628 mr->size = int128_zero();
1629 object_unparent(OBJECT(mr));
1630 error_propagate(errp, err);
1631 return false;
1633 return true;
1636 bool memory_region_init_ram_from_fd(MemoryRegion *mr,
1637 Object *owner,
1638 const char *name,
1639 uint64_t size,
1640 uint32_t ram_flags,
1641 int fd,
1642 ram_addr_t offset,
1643 Error **errp)
1645 Error *err = NULL;
1646 memory_region_init(mr, owner, name, size);
1647 mr->ram = true;
1648 mr->readonly = !!(ram_flags & RAM_READONLY);
1649 mr->terminates = true;
1650 mr->destructor = memory_region_destructor_ram;
1651 mr->ram_block = qemu_ram_alloc_from_fd(size, mr, ram_flags, fd, offset,
1652 &err);
1653 if (err) {
1654 mr->size = int128_zero();
1655 object_unparent(OBJECT(mr));
1656 error_propagate(errp, err);
1657 return false;
1659 return true;
1661 #endif
1663 void memory_region_init_ram_ptr(MemoryRegion *mr,
1664 Object *owner,
1665 const char *name,
1666 uint64_t size,
1667 void *ptr)
1669 memory_region_init(mr, owner, name, size);
1670 mr->ram = true;
1671 mr->terminates = true;
1672 mr->destructor = memory_region_destructor_ram;
1674 /* qemu_ram_alloc_from_ptr cannot fail with ptr != NULL. */
1675 assert(ptr != NULL);
1676 mr->ram_block = qemu_ram_alloc_from_ptr(size, ptr, mr, &error_abort);
1679 void memory_region_init_ram_device_ptr(MemoryRegion *mr,
1680 Object *owner,
1681 const char *name,
1682 uint64_t size,
1683 void *ptr)
1685 memory_region_init(mr, owner, name, size);
1686 mr->ram = true;
1687 mr->terminates = true;
1688 mr->ram_device = true;
1689 mr->ops = &ram_device_mem_ops;
1690 mr->opaque = mr;
1691 mr->destructor = memory_region_destructor_ram;
1693 /* qemu_ram_alloc_from_ptr cannot fail with ptr != NULL. */
1694 assert(ptr != NULL);
1695 mr->ram_block = qemu_ram_alloc_from_ptr(size, ptr, mr, &error_abort);
1698 void memory_region_init_alias(MemoryRegion *mr,
1699 Object *owner,
1700 const char *name,
1701 MemoryRegion *orig,
1702 hwaddr offset,
1703 uint64_t size)
1705 memory_region_init(mr, owner, name, size);
1706 mr->alias = orig;
1707 mr->alias_offset = offset;
1710 bool memory_region_init_rom_nomigrate(MemoryRegion *mr,
1711 Object *owner,
1712 const char *name,
1713 uint64_t size,
1714 Error **errp)
1716 if (!memory_region_init_ram_flags_nomigrate(mr, owner, name,
1717 size, 0, errp)) {
1718 return false;
1720 mr->readonly = true;
1722 return true;
1725 bool memory_region_init_rom_device_nomigrate(MemoryRegion *mr,
1726 Object *owner,
1727 const MemoryRegionOps *ops,
1728 void *opaque,
1729 const char *name,
1730 uint64_t size,
1731 Error **errp)
1733 Error *err = NULL;
1734 assert(ops);
1735 memory_region_init(mr, owner, name, size);
1736 mr->ops = ops;
1737 mr->opaque = opaque;
1738 mr->terminates = true;
1739 mr->rom_device = true;
1740 mr->destructor = memory_region_destructor_ram;
1741 mr->ram_block = qemu_ram_alloc(size, 0, mr, &err);
1742 if (err) {
1743 mr->size = int128_zero();
1744 object_unparent(OBJECT(mr));
1745 error_propagate(errp, err);
1746 return false;
1748 return true;
1751 void memory_region_init_iommu(void *_iommu_mr,
1752 size_t instance_size,
1753 const char *mrtypename,
1754 Object *owner,
1755 const char *name,
1756 uint64_t size)
1758 struct IOMMUMemoryRegion *iommu_mr;
1759 struct MemoryRegion *mr;
1761 object_initialize(_iommu_mr, instance_size, mrtypename);
1762 mr = MEMORY_REGION(_iommu_mr);
1763 memory_region_do_init(mr, owner, name, size);
1764 iommu_mr = IOMMU_MEMORY_REGION(mr);
1765 mr->terminates = true; /* then re-forwards */
1766 QLIST_INIT(&iommu_mr->iommu_notify);
1767 iommu_mr->iommu_notify_flags = IOMMU_NOTIFIER_NONE;
1770 static void memory_region_finalize(Object *obj)
1772 MemoryRegion *mr = MEMORY_REGION(obj);
1774 assert(!mr->container);
1776 /* We know the region is not visible in any address space (it
1777 * does not have a container and cannot be a root either because
1778 * it has no references, so we can blindly clear mr->enabled.
1779 * memory_region_set_enabled instead could trigger a transaction
1780 * and cause an infinite loop.
1782 mr->enabled = false;
1783 memory_region_transaction_begin();
1784 while (!QTAILQ_EMPTY(&mr->subregions)) {
1785 MemoryRegion *subregion = QTAILQ_FIRST(&mr->subregions);
1786 memory_region_del_subregion(mr, subregion);
1788 memory_region_transaction_commit();
1790 mr->destructor(mr);
1791 memory_region_clear_coalescing(mr);
1792 g_free((char *)mr->name);
1793 g_free(mr->ioeventfds);
1796 Object *memory_region_owner(MemoryRegion *mr)
1798 Object *obj = OBJECT(mr);
1799 return obj->parent;
1802 void memory_region_ref(MemoryRegion *mr)
1804 /* MMIO callbacks most likely will access data that belongs
1805 * to the owner, hence the need to ref/unref the owner whenever
1806 * the memory region is in use.
1808 * The memory region is a child of its owner. As long as the
1809 * owner doesn't call unparent itself on the memory region,
1810 * ref-ing the owner will also keep the memory region alive.
1811 * Memory regions without an owner are supposed to never go away;
1812 * we do not ref/unref them because it slows down DMA sensibly.
1814 if (mr && mr->owner) {
1815 object_ref(mr->owner);
1819 void memory_region_unref(MemoryRegion *mr)
1821 if (mr && mr->owner) {
1822 object_unref(mr->owner);
1826 uint64_t memory_region_size(MemoryRegion *mr)
1828 if (int128_eq(mr->size, int128_2_64())) {
1829 return UINT64_MAX;
1831 return int128_get64(mr->size);
1834 const char *memory_region_name(const MemoryRegion *mr)
1836 if (!mr->name) {
1837 ((MemoryRegion *)mr)->name =
1838 g_strdup(object_get_canonical_path_component(OBJECT(mr)));
1840 return mr->name;
1843 bool memory_region_is_ram_device(MemoryRegion *mr)
1845 return mr->ram_device;
1848 bool memory_region_is_protected(MemoryRegion *mr)
1850 return mr->ram && (mr->ram_block->flags & RAM_PROTECTED);
1853 bool memory_region_has_guest_memfd(MemoryRegion *mr)
1855 return mr->ram_block && mr->ram_block->guest_memfd >= 0;
1858 uint8_t memory_region_get_dirty_log_mask(MemoryRegion *mr)
1860 uint8_t mask = mr->dirty_log_mask;
1861 RAMBlock *rb = mr->ram_block;
1863 if (global_dirty_tracking && ((rb && qemu_ram_is_migratable(rb)) ||
1864 memory_region_is_iommu(mr))) {
1865 mask |= (1 << DIRTY_MEMORY_MIGRATION);
1868 if (tcg_enabled() && rb) {
1869 /* TCG only cares about dirty memory logging for RAM, not IOMMU. */
1870 mask |= (1 << DIRTY_MEMORY_CODE);
1872 return mask;
1875 bool memory_region_is_logging(MemoryRegion *mr, uint8_t client)
1877 return memory_region_get_dirty_log_mask(mr) & (1 << client);
1880 static int memory_region_update_iommu_notify_flags(IOMMUMemoryRegion *iommu_mr,
1881 Error **errp)
1883 IOMMUNotifierFlag flags = IOMMU_NOTIFIER_NONE;
1884 IOMMUNotifier *iommu_notifier;
1885 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
1886 int ret = 0;
1888 IOMMU_NOTIFIER_FOREACH(iommu_notifier, iommu_mr) {
1889 flags |= iommu_notifier->notifier_flags;
1892 if (flags != iommu_mr->iommu_notify_flags && imrc->notify_flag_changed) {
1893 ret = imrc->notify_flag_changed(iommu_mr,
1894 iommu_mr->iommu_notify_flags,
1895 flags, errp);
1898 if (!ret) {
1899 iommu_mr->iommu_notify_flags = flags;
1901 return ret;
1904 int memory_region_register_iommu_notifier(MemoryRegion *mr,
1905 IOMMUNotifier *n, Error **errp)
1907 IOMMUMemoryRegion *iommu_mr;
1908 int ret;
1910 if (mr->alias) {
1911 return memory_region_register_iommu_notifier(mr->alias, n, errp);
1914 /* We need to register for at least one bitfield */
1915 iommu_mr = IOMMU_MEMORY_REGION(mr);
1916 assert(n->notifier_flags != IOMMU_NOTIFIER_NONE);
1917 assert(n->start <= n->end);
1918 assert(n->iommu_idx >= 0 &&
1919 n->iommu_idx < memory_region_iommu_num_indexes(iommu_mr));
1921 QLIST_INSERT_HEAD(&iommu_mr->iommu_notify, n, node);
1922 ret = memory_region_update_iommu_notify_flags(iommu_mr, errp);
1923 if (ret) {
1924 QLIST_REMOVE(n, node);
1926 return ret;
1929 uint64_t memory_region_iommu_get_min_page_size(IOMMUMemoryRegion *iommu_mr)
1931 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
1933 if (imrc->get_min_page_size) {
1934 return imrc->get_min_page_size(iommu_mr);
1936 return TARGET_PAGE_SIZE;
1939 void memory_region_iommu_replay(IOMMUMemoryRegion *iommu_mr, IOMMUNotifier *n)
1941 MemoryRegion *mr = MEMORY_REGION(iommu_mr);
1942 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
1943 hwaddr addr, granularity;
1944 IOMMUTLBEntry iotlb;
1946 /* If the IOMMU has its own replay callback, override */
1947 if (imrc->replay) {
1948 imrc->replay(iommu_mr, n);
1949 return;
1952 granularity = memory_region_iommu_get_min_page_size(iommu_mr);
1954 for (addr = 0; addr < memory_region_size(mr); addr += granularity) {
1955 iotlb = imrc->translate(iommu_mr, addr, IOMMU_NONE, n->iommu_idx);
1956 if (iotlb.perm != IOMMU_NONE) {
1957 n->notify(n, &iotlb);
1960 /* if (2^64 - MR size) < granularity, it's possible to get an
1961 * infinite loop here. This should catch such a wraparound */
1962 if ((addr + granularity) < addr) {
1963 break;
1968 void memory_region_unregister_iommu_notifier(MemoryRegion *mr,
1969 IOMMUNotifier *n)
1971 IOMMUMemoryRegion *iommu_mr;
1973 if (mr->alias) {
1974 memory_region_unregister_iommu_notifier(mr->alias, n);
1975 return;
1977 QLIST_REMOVE(n, node);
1978 iommu_mr = IOMMU_MEMORY_REGION(mr);
1979 memory_region_update_iommu_notify_flags(iommu_mr, NULL);
1982 void memory_region_notify_iommu_one(IOMMUNotifier *notifier,
1983 const IOMMUTLBEvent *event)
1985 const IOMMUTLBEntry *entry = &event->entry;
1986 hwaddr entry_end = entry->iova + entry->addr_mask;
1987 IOMMUTLBEntry tmp = *entry;
1989 if (event->type == IOMMU_NOTIFIER_UNMAP) {
1990 assert(entry->perm == IOMMU_NONE);
1994 * Skip the notification if the notification does not overlap
1995 * with registered range.
1997 if (notifier->start > entry_end || notifier->end < entry->iova) {
1998 return;
2001 if (notifier->notifier_flags & IOMMU_NOTIFIER_DEVIOTLB_UNMAP) {
2002 /* Crop (iova, addr_mask) to range */
2003 tmp.iova = MAX(tmp.iova, notifier->start);
2004 tmp.addr_mask = MIN(entry_end, notifier->end) - tmp.iova;
2005 } else {
2006 assert(entry->iova >= notifier->start && entry_end <= notifier->end);
2009 if (event->type & notifier->notifier_flags) {
2010 notifier->notify(notifier, &tmp);
2014 void memory_region_unmap_iommu_notifier_range(IOMMUNotifier *notifier)
2016 IOMMUTLBEvent event;
2018 event.type = IOMMU_NOTIFIER_UNMAP;
2019 event.entry.target_as = &address_space_memory;
2020 event.entry.iova = notifier->start;
2021 event.entry.perm = IOMMU_NONE;
2022 event.entry.addr_mask = notifier->end - notifier->start;
2024 memory_region_notify_iommu_one(notifier, &event);
2027 void memory_region_notify_iommu(IOMMUMemoryRegion *iommu_mr,
2028 int iommu_idx,
2029 const IOMMUTLBEvent event)
2031 IOMMUNotifier *iommu_notifier;
2033 assert(memory_region_is_iommu(MEMORY_REGION(iommu_mr)));
2035 IOMMU_NOTIFIER_FOREACH(iommu_notifier, iommu_mr) {
2036 if (iommu_notifier->iommu_idx == iommu_idx) {
2037 memory_region_notify_iommu_one(iommu_notifier, &event);
2042 int memory_region_iommu_get_attr(IOMMUMemoryRegion *iommu_mr,
2043 enum IOMMUMemoryRegionAttr attr,
2044 void *data)
2046 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
2048 if (!imrc->get_attr) {
2049 return -EINVAL;
2052 return imrc->get_attr(iommu_mr, attr, data);
2055 int memory_region_iommu_attrs_to_index(IOMMUMemoryRegion *iommu_mr,
2056 MemTxAttrs attrs)
2058 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
2060 if (!imrc->attrs_to_index) {
2061 return 0;
2064 return imrc->attrs_to_index(iommu_mr, attrs);
2067 int memory_region_iommu_num_indexes(IOMMUMemoryRegion *iommu_mr)
2069 IOMMUMemoryRegionClass *imrc = IOMMU_MEMORY_REGION_GET_CLASS(iommu_mr);
2071 if (!imrc->num_indexes) {
2072 return 1;
2075 return imrc->num_indexes(iommu_mr);
2078 RamDiscardManager *memory_region_get_ram_discard_manager(MemoryRegion *mr)
2080 if (!memory_region_is_ram(mr)) {
2081 return NULL;
2083 return mr->rdm;
2086 void memory_region_set_ram_discard_manager(MemoryRegion *mr,
2087 RamDiscardManager *rdm)
2089 g_assert(memory_region_is_ram(mr));
2090 g_assert(!rdm || !mr->rdm);
2091 mr->rdm = rdm;
2094 uint64_t ram_discard_manager_get_min_granularity(const RamDiscardManager *rdm,
2095 const MemoryRegion *mr)
2097 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2099 g_assert(rdmc->get_min_granularity);
2100 return rdmc->get_min_granularity(rdm, mr);
2103 bool ram_discard_manager_is_populated(const RamDiscardManager *rdm,
2104 const MemoryRegionSection *section)
2106 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2108 g_assert(rdmc->is_populated);
2109 return rdmc->is_populated(rdm, section);
2112 int ram_discard_manager_replay_populated(const RamDiscardManager *rdm,
2113 MemoryRegionSection *section,
2114 ReplayRamPopulate replay_fn,
2115 void *opaque)
2117 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2119 g_assert(rdmc->replay_populated);
2120 return rdmc->replay_populated(rdm, section, replay_fn, opaque);
2123 void ram_discard_manager_replay_discarded(const RamDiscardManager *rdm,
2124 MemoryRegionSection *section,
2125 ReplayRamDiscard replay_fn,
2126 void *opaque)
2128 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2130 g_assert(rdmc->replay_discarded);
2131 rdmc->replay_discarded(rdm, section, replay_fn, opaque);
2134 void ram_discard_manager_register_listener(RamDiscardManager *rdm,
2135 RamDiscardListener *rdl,
2136 MemoryRegionSection *section)
2138 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2140 g_assert(rdmc->register_listener);
2141 rdmc->register_listener(rdm, rdl, section);
2144 void ram_discard_manager_unregister_listener(RamDiscardManager *rdm,
2145 RamDiscardListener *rdl)
2147 RamDiscardManagerClass *rdmc = RAM_DISCARD_MANAGER_GET_CLASS(rdm);
2149 g_assert(rdmc->unregister_listener);
2150 rdmc->unregister_listener(rdm, rdl);
2153 /* Called with rcu_read_lock held. */
2154 bool memory_get_xlat_addr(IOMMUTLBEntry *iotlb, void **vaddr,
2155 ram_addr_t *ram_addr, bool *read_only,
2156 bool *mr_has_discard_manager, Error **errp)
2158 MemoryRegion *mr;
2159 hwaddr xlat;
2160 hwaddr len = iotlb->addr_mask + 1;
2161 bool writable = iotlb->perm & IOMMU_WO;
2163 if (mr_has_discard_manager) {
2164 *mr_has_discard_manager = false;
2167 * The IOMMU TLB entry we have just covers translation through
2168 * this IOMMU to its immediate target. We need to translate
2169 * it the rest of the way through to memory.
2171 mr = address_space_translate(&address_space_memory, iotlb->translated_addr,
2172 &xlat, &len, writable, MEMTXATTRS_UNSPECIFIED);
2173 if (!memory_region_is_ram(mr)) {
2174 error_setg(errp, "iommu map to non memory area %" HWADDR_PRIx "", xlat);
2175 return false;
2176 } else if (memory_region_has_ram_discard_manager(mr)) {
2177 RamDiscardManager *rdm = memory_region_get_ram_discard_manager(mr);
2178 MemoryRegionSection tmp = {
2179 .mr = mr,
2180 .offset_within_region = xlat,
2181 .size = int128_make64(len),
2183 if (mr_has_discard_manager) {
2184 *mr_has_discard_manager = true;
2187 * Malicious VMs can map memory into the IOMMU, which is expected
2188 * to remain discarded. vfio will pin all pages, populating memory.
2189 * Disallow that. vmstate priorities make sure any RamDiscardManager
2190 * were already restored before IOMMUs are restored.
2192 if (!ram_discard_manager_is_populated(rdm, &tmp)) {
2193 error_setg(errp, "iommu map to discarded memory (e.g., unplugged"
2194 " via virtio-mem): %" HWADDR_PRIx "",
2195 iotlb->translated_addr);
2196 return false;
2201 * Translation truncates length to the IOMMU page size,
2202 * check that it did not truncate too much.
2204 if (len & iotlb->addr_mask) {
2205 error_setg(errp, "iommu has granularity incompatible with target AS");
2206 return false;
2209 if (vaddr) {
2210 *vaddr = memory_region_get_ram_ptr(mr) + xlat;
2213 if (ram_addr) {
2214 *ram_addr = memory_region_get_ram_addr(mr) + xlat;
2217 if (read_only) {
2218 *read_only = !writable || mr->readonly;
2221 return true;
2224 void memory_region_set_log(MemoryRegion *mr, bool log, unsigned client)
2226 uint8_t mask = 1 << client;
2227 uint8_t old_logging;
2229 assert(client == DIRTY_MEMORY_VGA);
2230 old_logging = mr->vga_logging_count;
2231 mr->vga_logging_count += log ? 1 : -1;
2232 if (!!old_logging == !!mr->vga_logging_count) {
2233 return;
2236 memory_region_transaction_begin();
2237 mr->dirty_log_mask = (mr->dirty_log_mask & ~mask) | (log * mask);
2238 memory_region_update_pending |= mr->enabled;
2239 memory_region_transaction_commit();
2242 void memory_region_set_dirty(MemoryRegion *mr, hwaddr addr,
2243 hwaddr size)
2245 assert(mr->ram_block);
2246 cpu_physical_memory_set_dirty_range(memory_region_get_ram_addr(mr) + addr,
2247 size,
2248 memory_region_get_dirty_log_mask(mr));
2252 * If memory region `mr' is NULL, do global sync. Otherwise, sync
2253 * dirty bitmap for the specified memory region.
2255 static void memory_region_sync_dirty_bitmap(MemoryRegion *mr, bool last_stage)
2257 MemoryListener *listener;
2258 AddressSpace *as;
2259 FlatView *view;
2260 FlatRange *fr;
2262 /* If the same address space has multiple log_sync listeners, we
2263 * visit that address space's FlatView multiple times. But because
2264 * log_sync listeners are rare, it's still cheaper than walking each
2265 * address space once.
2267 QTAILQ_FOREACH(listener, &memory_listeners, link) {
2268 if (listener->log_sync) {
2269 as = listener->address_space;
2270 view = address_space_get_flatview(as);
2271 FOR_EACH_FLAT_RANGE(fr, view) {
2272 if (fr->dirty_log_mask && (!mr || fr->mr == mr)) {
2273 MemoryRegionSection mrs = section_from_flat_range(fr, view);
2274 listener->log_sync(listener, &mrs);
2277 flatview_unref(view);
2278 trace_memory_region_sync_dirty(mr ? mr->name : "(all)", listener->name, 0);
2279 } else if (listener->log_sync_global) {
2281 * No matter whether MR is specified, what we can do here
2282 * is to do a global sync, because we are not capable to
2283 * sync in a finer granularity.
2285 listener->log_sync_global(listener, last_stage);
2286 trace_memory_region_sync_dirty(mr ? mr->name : "(all)", listener->name, 1);
2291 void memory_region_clear_dirty_bitmap(MemoryRegion *mr, hwaddr start,
2292 hwaddr len)
2294 MemoryRegionSection mrs;
2295 MemoryListener *listener;
2296 AddressSpace *as;
2297 FlatView *view;
2298 FlatRange *fr;
2299 hwaddr sec_start, sec_end, sec_size;
2301 QTAILQ_FOREACH(listener, &memory_listeners, link) {
2302 if (!listener->log_clear) {
2303 continue;
2305 as = listener->address_space;
2306 view = address_space_get_flatview(as);
2307 FOR_EACH_FLAT_RANGE(fr, view) {
2308 if (!fr->dirty_log_mask || fr->mr != mr) {
2310 * Clear dirty bitmap operation only applies to those
2311 * regions whose dirty logging is at least enabled
2313 continue;
2316 mrs = section_from_flat_range(fr, view);
2318 sec_start = MAX(mrs.offset_within_region, start);
2319 sec_end = mrs.offset_within_region + int128_get64(mrs.size);
2320 sec_end = MIN(sec_end, start + len);
2322 if (sec_start >= sec_end) {
2324 * If this memory region section has no intersection
2325 * with the requested range, skip.
2327 continue;
2330 /* Valid case; shrink the section if needed */
2331 mrs.offset_within_address_space +=
2332 sec_start - mrs.offset_within_region;
2333 mrs.offset_within_region = sec_start;
2334 sec_size = sec_end - sec_start;
2335 mrs.size = int128_make64(sec_size);
2336 listener->log_clear(listener, &mrs);
2338 flatview_unref(view);
2342 DirtyBitmapSnapshot *memory_region_snapshot_and_clear_dirty(MemoryRegion *mr,
2343 hwaddr addr,
2344 hwaddr size,
2345 unsigned client)
2347 DirtyBitmapSnapshot *snapshot;
2348 assert(mr->ram_block);
2349 memory_region_sync_dirty_bitmap(mr, false);
2350 snapshot = cpu_physical_memory_snapshot_and_clear_dirty(mr, addr, size, client);
2351 memory_global_after_dirty_log_sync();
2352 return snapshot;
2355 bool memory_region_snapshot_get_dirty(MemoryRegion *mr, DirtyBitmapSnapshot *snap,
2356 hwaddr addr, hwaddr size)
2358 assert(mr->ram_block);
2359 return cpu_physical_memory_snapshot_get_dirty(snap,
2360 memory_region_get_ram_addr(mr) + addr, size);
2363 void memory_region_set_readonly(MemoryRegion *mr, bool readonly)
2365 if (mr->readonly != readonly) {
2366 memory_region_transaction_begin();
2367 mr->readonly = readonly;
2368 memory_region_update_pending |= mr->enabled;
2369 memory_region_transaction_commit();
2373 void memory_region_set_nonvolatile(MemoryRegion *mr, bool nonvolatile)
2375 if (mr->nonvolatile != nonvolatile) {
2376 memory_region_transaction_begin();
2377 mr->nonvolatile = nonvolatile;
2378 memory_region_update_pending |= mr->enabled;
2379 memory_region_transaction_commit();
2383 void memory_region_rom_device_set_romd(MemoryRegion *mr, bool romd_mode)
2385 if (mr->romd_mode != romd_mode) {
2386 memory_region_transaction_begin();
2387 mr->romd_mode = romd_mode;
2388 memory_region_update_pending |= mr->enabled;
2389 memory_region_transaction_commit();
2393 void memory_region_reset_dirty(MemoryRegion *mr, hwaddr addr,
2394 hwaddr size, unsigned client)
2396 assert(mr->ram_block);
2397 cpu_physical_memory_test_and_clear_dirty(
2398 memory_region_get_ram_addr(mr) + addr, size, client);
2401 int memory_region_get_fd(MemoryRegion *mr)
2403 RCU_READ_LOCK_GUARD();
2404 while (mr->alias) {
2405 mr = mr->alias;
2407 return mr->ram_block->fd;
2410 void *memory_region_get_ram_ptr(MemoryRegion *mr)
2412 uint64_t offset = 0;
2414 RCU_READ_LOCK_GUARD();
2415 while (mr->alias) {
2416 offset += mr->alias_offset;
2417 mr = mr->alias;
2419 assert(mr->ram_block);
2420 return qemu_map_ram_ptr(mr->ram_block, offset);
2423 MemoryRegion *memory_region_from_host(void *ptr, ram_addr_t *offset)
2425 RAMBlock *block;
2427 block = qemu_ram_block_from_host(ptr, false, offset);
2428 if (!block) {
2429 return NULL;
2432 return block->mr;
2435 ram_addr_t memory_region_get_ram_addr(MemoryRegion *mr)
2437 return mr->ram_block ? mr->ram_block->offset : RAM_ADDR_INVALID;
2440 void memory_region_ram_resize(MemoryRegion *mr, ram_addr_t newsize, Error **errp)
2442 assert(mr->ram_block);
2444 qemu_ram_resize(mr->ram_block, newsize, errp);
2447 void memory_region_msync(MemoryRegion *mr, hwaddr addr, hwaddr size)
2449 if (mr->ram_block) {
2450 qemu_ram_msync(mr->ram_block, addr, size);
2454 void memory_region_writeback(MemoryRegion *mr, hwaddr addr, hwaddr size)
2457 * Might be extended case needed to cover
2458 * different types of memory regions
2460 if (mr->dirty_log_mask) {
2461 memory_region_msync(mr, addr, size);
2466 * Call proper memory listeners about the change on the newly
2467 * added/removed CoalescedMemoryRange.
2469 static void memory_region_update_coalesced_range(MemoryRegion *mr,
2470 CoalescedMemoryRange *cmr,
2471 bool add)
2473 AddressSpace *as;
2474 FlatView *view;
2475 FlatRange *fr;
2477 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
2478 view = address_space_get_flatview(as);
2479 FOR_EACH_FLAT_RANGE(fr, view) {
2480 if (fr->mr == mr) {
2481 flat_range_coalesced_io_notify(fr, as, cmr, add);
2484 flatview_unref(view);
2488 void memory_region_set_coalescing(MemoryRegion *mr)
2490 memory_region_clear_coalescing(mr);
2491 memory_region_add_coalescing(mr, 0, int128_get64(mr->size));
2494 void memory_region_add_coalescing(MemoryRegion *mr,
2495 hwaddr offset,
2496 uint64_t size)
2498 CoalescedMemoryRange *cmr = g_malloc(sizeof(*cmr));
2500 cmr->addr = addrrange_make(int128_make64(offset), int128_make64(size));
2501 QTAILQ_INSERT_TAIL(&mr->coalesced, cmr, link);
2502 memory_region_update_coalesced_range(mr, cmr, true);
2503 memory_region_set_flush_coalesced(mr);
2506 void memory_region_clear_coalescing(MemoryRegion *mr)
2508 CoalescedMemoryRange *cmr;
2510 if (QTAILQ_EMPTY(&mr->coalesced)) {
2511 return;
2514 qemu_flush_coalesced_mmio_buffer();
2515 mr->flush_coalesced_mmio = false;
2517 while (!QTAILQ_EMPTY(&mr->coalesced)) {
2518 cmr = QTAILQ_FIRST(&mr->coalesced);
2519 QTAILQ_REMOVE(&mr->coalesced, cmr, link);
2520 memory_region_update_coalesced_range(mr, cmr, false);
2521 g_free(cmr);
2525 void memory_region_set_flush_coalesced(MemoryRegion *mr)
2527 mr->flush_coalesced_mmio = true;
2530 void memory_region_clear_flush_coalesced(MemoryRegion *mr)
2532 qemu_flush_coalesced_mmio_buffer();
2533 if (QTAILQ_EMPTY(&mr->coalesced)) {
2534 mr->flush_coalesced_mmio = false;
2538 void memory_region_add_eventfd(MemoryRegion *mr,
2539 hwaddr addr,
2540 unsigned size,
2541 bool match_data,
2542 uint64_t data,
2543 EventNotifier *e)
2545 MemoryRegionIoeventfd mrfd = {
2546 .addr.start = int128_make64(addr),
2547 .addr.size = int128_make64(size),
2548 .match_data = match_data,
2549 .data = data,
2550 .e = e,
2552 unsigned i;
2554 if (size) {
2555 adjust_endianness(mr, &mrfd.data, size_memop(size) | MO_TE);
2557 memory_region_transaction_begin();
2558 for (i = 0; i < mr->ioeventfd_nb; ++i) {
2559 if (memory_region_ioeventfd_before(&mrfd, &mr->ioeventfds[i])) {
2560 break;
2563 ++mr->ioeventfd_nb;
2564 mr->ioeventfds = g_realloc(mr->ioeventfds,
2565 sizeof(*mr->ioeventfds) * mr->ioeventfd_nb);
2566 memmove(&mr->ioeventfds[i+1], &mr->ioeventfds[i],
2567 sizeof(*mr->ioeventfds) * (mr->ioeventfd_nb-1 - i));
2568 mr->ioeventfds[i] = mrfd;
2569 ioeventfd_update_pending |= mr->enabled;
2570 memory_region_transaction_commit();
2573 void memory_region_del_eventfd(MemoryRegion *mr,
2574 hwaddr addr,
2575 unsigned size,
2576 bool match_data,
2577 uint64_t data,
2578 EventNotifier *e)
2580 MemoryRegionIoeventfd mrfd = {
2581 .addr.start = int128_make64(addr),
2582 .addr.size = int128_make64(size),
2583 .match_data = match_data,
2584 .data = data,
2585 .e = e,
2587 unsigned i;
2589 if (size) {
2590 adjust_endianness(mr, &mrfd.data, size_memop(size) | MO_TE);
2592 memory_region_transaction_begin();
2593 for (i = 0; i < mr->ioeventfd_nb; ++i) {
2594 if (memory_region_ioeventfd_equal(&mrfd, &mr->ioeventfds[i])) {
2595 break;
2598 assert(i != mr->ioeventfd_nb);
2599 memmove(&mr->ioeventfds[i], &mr->ioeventfds[i+1],
2600 sizeof(*mr->ioeventfds) * (mr->ioeventfd_nb - (i+1)));
2601 --mr->ioeventfd_nb;
2602 mr->ioeventfds = g_realloc(mr->ioeventfds,
2603 sizeof(*mr->ioeventfds)*mr->ioeventfd_nb + 1);
2604 ioeventfd_update_pending |= mr->enabled;
2605 memory_region_transaction_commit();
2608 static void memory_region_update_container_subregions(MemoryRegion *subregion)
2610 MemoryRegion *mr = subregion->container;
2611 MemoryRegion *other;
2613 memory_region_transaction_begin();
2615 memory_region_ref(subregion);
2616 QTAILQ_FOREACH(other, &mr->subregions, subregions_link) {
2617 if (subregion->priority >= other->priority) {
2618 QTAILQ_INSERT_BEFORE(other, subregion, subregions_link);
2619 goto done;
2622 QTAILQ_INSERT_TAIL(&mr->subregions, subregion, subregions_link);
2623 done:
2624 memory_region_update_pending |= mr->enabled && subregion->enabled;
2625 memory_region_transaction_commit();
2628 static void memory_region_add_subregion_common(MemoryRegion *mr,
2629 hwaddr offset,
2630 MemoryRegion *subregion)
2632 MemoryRegion *alias;
2634 assert(!subregion->container);
2635 subregion->container = mr;
2636 for (alias = subregion->alias; alias; alias = alias->alias) {
2637 alias->mapped_via_alias++;
2639 subregion->addr = offset;
2640 memory_region_update_container_subregions(subregion);
2643 void memory_region_add_subregion(MemoryRegion *mr,
2644 hwaddr offset,
2645 MemoryRegion *subregion)
2647 subregion->priority = 0;
2648 memory_region_add_subregion_common(mr, offset, subregion);
2651 void memory_region_add_subregion_overlap(MemoryRegion *mr,
2652 hwaddr offset,
2653 MemoryRegion *subregion,
2654 int priority)
2656 subregion->priority = priority;
2657 memory_region_add_subregion_common(mr, offset, subregion);
2660 void memory_region_del_subregion(MemoryRegion *mr,
2661 MemoryRegion *subregion)
2663 MemoryRegion *alias;
2665 memory_region_transaction_begin();
2666 assert(subregion->container == mr);
2667 subregion->container = NULL;
2668 for (alias = subregion->alias; alias; alias = alias->alias) {
2669 alias->mapped_via_alias--;
2670 assert(alias->mapped_via_alias >= 0);
2672 QTAILQ_REMOVE(&mr->subregions, subregion, subregions_link);
2673 memory_region_unref(subregion);
2674 memory_region_update_pending |= mr->enabled && subregion->enabled;
2675 memory_region_transaction_commit();
2678 void memory_region_set_enabled(MemoryRegion *mr, bool enabled)
2680 if (enabled == mr->enabled) {
2681 return;
2683 memory_region_transaction_begin();
2684 mr->enabled = enabled;
2685 memory_region_update_pending = true;
2686 memory_region_transaction_commit();
2689 void memory_region_set_size(MemoryRegion *mr, uint64_t size)
2691 Int128 s = int128_make64(size);
2693 if (size == UINT64_MAX) {
2694 s = int128_2_64();
2696 if (int128_eq(s, mr->size)) {
2697 return;
2699 memory_region_transaction_begin();
2700 mr->size = s;
2701 memory_region_update_pending = true;
2702 memory_region_transaction_commit();
2705 static void memory_region_readd_subregion(MemoryRegion *mr)
2707 MemoryRegion *container = mr->container;
2709 if (container) {
2710 memory_region_transaction_begin();
2711 memory_region_ref(mr);
2712 memory_region_del_subregion(container, mr);
2713 memory_region_add_subregion_common(container, mr->addr, mr);
2714 memory_region_unref(mr);
2715 memory_region_transaction_commit();
2719 void memory_region_set_address(MemoryRegion *mr, hwaddr addr)
2721 if (addr != mr->addr) {
2722 mr->addr = addr;
2723 memory_region_readd_subregion(mr);
2727 void memory_region_set_alias_offset(MemoryRegion *mr, hwaddr offset)
2729 assert(mr->alias);
2731 if (offset == mr->alias_offset) {
2732 return;
2735 memory_region_transaction_begin();
2736 mr->alias_offset = offset;
2737 memory_region_update_pending |= mr->enabled;
2738 memory_region_transaction_commit();
2741 void memory_region_set_unmergeable(MemoryRegion *mr, bool unmergeable)
2743 if (unmergeable == mr->unmergeable) {
2744 return;
2747 memory_region_transaction_begin();
2748 mr->unmergeable = unmergeable;
2749 memory_region_update_pending |= mr->enabled;
2750 memory_region_transaction_commit();
2753 uint64_t memory_region_get_alignment(const MemoryRegion *mr)
2755 return mr->align;
2758 static int cmp_flatrange_addr(const void *addr_, const void *fr_)
2760 const AddrRange *addr = addr_;
2761 const FlatRange *fr = fr_;
2763 if (int128_le(addrrange_end(*addr), fr->addr.start)) {
2764 return -1;
2765 } else if (int128_ge(addr->start, addrrange_end(fr->addr))) {
2766 return 1;
2768 return 0;
2771 static FlatRange *flatview_lookup(FlatView *view, AddrRange addr)
2773 return bsearch(&addr, view->ranges, view->nr,
2774 sizeof(FlatRange), cmp_flatrange_addr);
2777 bool memory_region_is_mapped(MemoryRegion *mr)
2779 return !!mr->container || mr->mapped_via_alias;
2782 /* Same as memory_region_find, but it does not add a reference to the
2783 * returned region. It must be called from an RCU critical section.
2785 static MemoryRegionSection memory_region_find_rcu(MemoryRegion *mr,
2786 hwaddr addr, uint64_t size)
2788 MemoryRegionSection ret = { .mr = NULL };
2789 MemoryRegion *root;
2790 AddressSpace *as;
2791 AddrRange range;
2792 FlatView *view;
2793 FlatRange *fr;
2795 addr += mr->addr;
2796 for (root = mr; root->container; ) {
2797 root = root->container;
2798 addr += root->addr;
2801 as = memory_region_to_address_space(root);
2802 if (!as) {
2803 return ret;
2805 range = addrrange_make(int128_make64(addr), int128_make64(size));
2807 view = address_space_to_flatview(as);
2808 fr = flatview_lookup(view, range);
2809 if (!fr) {
2810 return ret;
2813 while (fr > view->ranges && addrrange_intersects(fr[-1].addr, range)) {
2814 --fr;
2817 ret.mr = fr->mr;
2818 ret.fv = view;
2819 range = addrrange_intersection(range, fr->addr);
2820 ret.offset_within_region = fr->offset_in_region;
2821 ret.offset_within_region += int128_get64(int128_sub(range.start,
2822 fr->addr.start));
2823 ret.size = range.size;
2824 ret.offset_within_address_space = int128_get64(range.start);
2825 ret.readonly = fr->readonly;
2826 ret.nonvolatile = fr->nonvolatile;
2827 return ret;
2830 MemoryRegionSection memory_region_find(MemoryRegion *mr,
2831 hwaddr addr, uint64_t size)
2833 MemoryRegionSection ret;
2834 RCU_READ_LOCK_GUARD();
2835 ret = memory_region_find_rcu(mr, addr, size);
2836 if (ret.mr) {
2837 memory_region_ref(ret.mr);
2839 return ret;
2842 MemoryRegionSection *memory_region_section_new_copy(MemoryRegionSection *s)
2844 MemoryRegionSection *tmp = g_new(MemoryRegionSection, 1);
2846 *tmp = *s;
2847 if (tmp->mr) {
2848 memory_region_ref(tmp->mr);
2850 if (tmp->fv) {
2851 bool ret = flatview_ref(tmp->fv);
2853 g_assert(ret);
2855 return tmp;
2858 void memory_region_section_free_copy(MemoryRegionSection *s)
2860 if (s->fv) {
2861 flatview_unref(s->fv);
2863 if (s->mr) {
2864 memory_region_unref(s->mr);
2866 g_free(s);
2869 bool memory_region_present(MemoryRegion *container, hwaddr addr)
2871 MemoryRegion *mr;
2873 RCU_READ_LOCK_GUARD();
2874 mr = memory_region_find_rcu(container, addr, 1).mr;
2875 return mr && mr != container;
2878 void memory_global_dirty_log_sync(bool last_stage)
2880 memory_region_sync_dirty_bitmap(NULL, last_stage);
2883 void memory_global_after_dirty_log_sync(void)
2885 MEMORY_LISTENER_CALL_GLOBAL(log_global_after_sync, Forward);
2889 * Dirty track stop flags that are postponed due to VM being stopped. Should
2890 * only be used within vmstate_change hook.
2892 static unsigned int postponed_stop_flags;
2893 static VMChangeStateEntry *vmstate_change;
2894 static void memory_global_dirty_log_stop_postponed_run(void);
2896 static bool memory_global_dirty_log_do_start(Error **errp)
2898 MemoryListener *listener;
2900 QTAILQ_FOREACH(listener, &memory_listeners, link) {
2901 if (listener->log_global_start) {
2902 if (!listener->log_global_start(listener, errp)) {
2903 goto err;
2907 return true;
2909 err:
2910 while ((listener = QTAILQ_PREV(listener, link)) != NULL) {
2911 if (listener->log_global_stop) {
2912 listener->log_global_stop(listener);
2916 return false;
2919 bool memory_global_dirty_log_start(unsigned int flags, Error **errp)
2921 unsigned int old_flags;
2923 assert(flags && !(flags & (~GLOBAL_DIRTY_MASK)));
2925 if (vmstate_change) {
2926 /* If there is postponed stop(), operate on it first */
2927 postponed_stop_flags &= ~flags;
2928 memory_global_dirty_log_stop_postponed_run();
2931 flags &= ~global_dirty_tracking;
2932 if (!flags) {
2933 return true;
2936 old_flags = global_dirty_tracking;
2937 global_dirty_tracking |= flags;
2938 trace_global_dirty_changed(global_dirty_tracking);
2940 if (!old_flags) {
2941 if (!memory_global_dirty_log_do_start(errp)) {
2942 global_dirty_tracking &= ~flags;
2943 trace_global_dirty_changed(global_dirty_tracking);
2944 return false;
2947 memory_region_transaction_begin();
2948 memory_region_update_pending = true;
2949 memory_region_transaction_commit();
2951 return true;
2954 static void memory_global_dirty_log_do_stop(unsigned int flags)
2956 assert(flags && !(flags & (~GLOBAL_DIRTY_MASK)));
2957 assert((global_dirty_tracking & flags) == flags);
2958 global_dirty_tracking &= ~flags;
2960 trace_global_dirty_changed(global_dirty_tracking);
2962 if (!global_dirty_tracking) {
2963 memory_region_transaction_begin();
2964 memory_region_update_pending = true;
2965 memory_region_transaction_commit();
2966 MEMORY_LISTENER_CALL_GLOBAL(log_global_stop, Reverse);
2971 * Execute the postponed dirty log stop operations if there is, then reset
2972 * everything (including the flags and the vmstate change hook).
2974 static void memory_global_dirty_log_stop_postponed_run(void)
2976 /* This must be called with the vmstate handler registered */
2977 assert(vmstate_change);
2979 /* Note: postponed_stop_flags can be cleared in log start routine */
2980 if (postponed_stop_flags) {
2981 memory_global_dirty_log_do_stop(postponed_stop_flags);
2982 postponed_stop_flags = 0;
2985 qemu_del_vm_change_state_handler(vmstate_change);
2986 vmstate_change = NULL;
2989 static void memory_vm_change_state_handler(void *opaque, bool running,
2990 RunState state)
2992 if (running) {
2993 memory_global_dirty_log_stop_postponed_run();
2997 void memory_global_dirty_log_stop(unsigned int flags)
2999 if (!runstate_is_running()) {
3000 /* Postpone the dirty log stop, e.g., to when VM starts again */
3001 if (vmstate_change) {
3002 /* Batch with previous postponed flags */
3003 postponed_stop_flags |= flags;
3004 } else {
3005 postponed_stop_flags = flags;
3006 vmstate_change = qemu_add_vm_change_state_handler(
3007 memory_vm_change_state_handler, NULL);
3009 return;
3012 memory_global_dirty_log_do_stop(flags);
3015 static void listener_add_address_space(MemoryListener *listener,
3016 AddressSpace *as)
3018 FlatView *view;
3019 FlatRange *fr;
3021 if (listener->begin) {
3022 listener->begin(listener);
3024 if (global_dirty_tracking) {
3026 * Currently only VFIO can fail log_global_start(), and it's not
3027 * yet allowed to hotplug any PCI device during migration. So this
3028 * should never fail when invoked, guard it with error_abort. If
3029 * it can start to fail in the future, we need to be able to fail
3030 * the whole listener_add_address_space() and its callers.
3032 if (listener->log_global_start) {
3033 listener->log_global_start(listener, &error_abort);
3037 view = address_space_get_flatview(as);
3038 FOR_EACH_FLAT_RANGE(fr, view) {
3039 MemoryRegionSection section = section_from_flat_range(fr, view);
3041 if (listener->region_add) {
3042 listener->region_add(listener, &section);
3044 if (fr->dirty_log_mask && listener->log_start) {
3045 listener->log_start(listener, &section, 0, fr->dirty_log_mask);
3048 if (listener->commit) {
3049 listener->commit(listener);
3051 flatview_unref(view);
3054 static void listener_del_address_space(MemoryListener *listener,
3055 AddressSpace *as)
3057 FlatView *view;
3058 FlatRange *fr;
3060 if (listener->begin) {
3061 listener->begin(listener);
3063 view = address_space_get_flatview(as);
3064 FOR_EACH_FLAT_RANGE(fr, view) {
3065 MemoryRegionSection section = section_from_flat_range(fr, view);
3067 if (fr->dirty_log_mask && listener->log_stop) {
3068 listener->log_stop(listener, &section, fr->dirty_log_mask, 0);
3070 if (listener->region_del) {
3071 listener->region_del(listener, &section);
3074 if (listener->commit) {
3075 listener->commit(listener);
3077 flatview_unref(view);
3080 void memory_listener_register(MemoryListener *listener, AddressSpace *as)
3082 MemoryListener *other = NULL;
3084 /* Only one of them can be defined for a listener */
3085 assert(!(listener->log_sync && listener->log_sync_global));
3087 listener->address_space = as;
3088 if (QTAILQ_EMPTY(&memory_listeners)
3089 || listener->priority >= QTAILQ_LAST(&memory_listeners)->priority) {
3090 QTAILQ_INSERT_TAIL(&memory_listeners, listener, link);
3091 } else {
3092 QTAILQ_FOREACH(other, &memory_listeners, link) {
3093 if (listener->priority < other->priority) {
3094 break;
3097 QTAILQ_INSERT_BEFORE(other, listener, link);
3100 if (QTAILQ_EMPTY(&as->listeners)
3101 || listener->priority >= QTAILQ_LAST(&as->listeners)->priority) {
3102 QTAILQ_INSERT_TAIL(&as->listeners, listener, link_as);
3103 } else {
3104 QTAILQ_FOREACH(other, &as->listeners, link_as) {
3105 if (listener->priority < other->priority) {
3106 break;
3109 QTAILQ_INSERT_BEFORE(other, listener, link_as);
3112 listener_add_address_space(listener, as);
3114 if (listener->eventfd_add || listener->eventfd_del) {
3115 as->ioeventfd_notifiers++;
3119 void memory_listener_unregister(MemoryListener *listener)
3121 if (!listener->address_space) {
3122 return;
3125 if (listener->eventfd_add || listener->eventfd_del) {
3126 listener->address_space->ioeventfd_notifiers--;
3129 listener_del_address_space(listener, listener->address_space);
3130 QTAILQ_REMOVE(&memory_listeners, listener, link);
3131 QTAILQ_REMOVE(&listener->address_space->listeners, listener, link_as);
3132 listener->address_space = NULL;
3135 void address_space_remove_listeners(AddressSpace *as)
3137 while (!QTAILQ_EMPTY(&as->listeners)) {
3138 memory_listener_unregister(QTAILQ_FIRST(&as->listeners));
3142 void address_space_init(AddressSpace *as, MemoryRegion *root, const char *name)
3144 memory_region_ref(root);
3145 as->root = root;
3146 as->current_map = NULL;
3147 as->ioeventfd_nb = 0;
3148 as->ioeventfds = NULL;
3149 QTAILQ_INIT(&as->listeners);
3150 QTAILQ_INSERT_TAIL(&address_spaces, as, address_spaces_link);
3151 as->bounce.in_use = false;
3152 qemu_mutex_init(&as->map_client_list_lock);
3153 QLIST_INIT(&as->map_client_list);
3154 as->name = g_strdup(name ? name : "anonymous");
3155 address_space_update_topology(as);
3156 address_space_update_ioeventfds(as);
3159 static void do_address_space_destroy(AddressSpace *as)
3161 assert(!qatomic_read(&as->bounce.in_use));
3162 assert(QLIST_EMPTY(&as->map_client_list));
3163 qemu_mutex_destroy(&as->map_client_list_lock);
3165 assert(QTAILQ_EMPTY(&as->listeners));
3167 flatview_unref(as->current_map);
3168 g_free(as->name);
3169 g_free(as->ioeventfds);
3170 memory_region_unref(as->root);
3173 void address_space_destroy(AddressSpace *as)
3175 MemoryRegion *root = as->root;
3177 /* Flush out anything from MemoryListeners listening in on this */
3178 memory_region_transaction_begin();
3179 as->root = NULL;
3180 memory_region_transaction_commit();
3181 QTAILQ_REMOVE(&address_spaces, as, address_spaces_link);
3183 /* At this point, as->dispatch and as->current_map are dummy
3184 * entries that the guest should never use. Wait for the old
3185 * values to expire before freeing the data.
3187 as->root = root;
3188 call_rcu(as, do_address_space_destroy, rcu);
3191 static const char *memory_region_type(MemoryRegion *mr)
3193 if (mr->alias) {
3194 return memory_region_type(mr->alias);
3196 if (memory_region_is_ram_device(mr)) {
3197 return "ramd";
3198 } else if (memory_region_is_romd(mr)) {
3199 return "romd";
3200 } else if (memory_region_is_rom(mr)) {
3201 return "rom";
3202 } else if (memory_region_is_ram(mr)) {
3203 return "ram";
3204 } else {
3205 return "i/o";
3209 typedef struct MemoryRegionList MemoryRegionList;
3211 struct MemoryRegionList {
3212 const MemoryRegion *mr;
3213 QTAILQ_ENTRY(MemoryRegionList) mrqueue;
3216 typedef QTAILQ_HEAD(, MemoryRegionList) MemoryRegionListHead;
3218 #define MR_SIZE(size) (int128_nz(size) ? (hwaddr)int128_get64( \
3219 int128_sub((size), int128_one())) : 0)
3220 #define MTREE_INDENT " "
3222 static void mtree_expand_owner(const char *label, Object *obj)
3224 DeviceState *dev = (DeviceState *) object_dynamic_cast(obj, TYPE_DEVICE);
3226 qemu_printf(" %s:{%s", label, dev ? "dev" : "obj");
3227 if (dev && dev->id) {
3228 qemu_printf(" id=%s", dev->id);
3229 } else {
3230 char *canonical_path = object_get_canonical_path(obj);
3231 if (canonical_path) {
3232 qemu_printf(" path=%s", canonical_path);
3233 g_free(canonical_path);
3234 } else {
3235 qemu_printf(" type=%s", object_get_typename(obj));
3238 qemu_printf("}");
3241 static void mtree_print_mr_owner(const MemoryRegion *mr)
3243 Object *owner = mr->owner;
3244 Object *parent = memory_region_owner((MemoryRegion *)mr);
3246 if (!owner && !parent) {
3247 qemu_printf(" orphan");
3248 return;
3250 if (owner) {
3251 mtree_expand_owner("owner", owner);
3253 if (parent && parent != owner) {
3254 mtree_expand_owner("parent", parent);
3258 static void mtree_print_mr(const MemoryRegion *mr, unsigned int level,
3259 hwaddr base,
3260 MemoryRegionListHead *alias_print_queue,
3261 bool owner, bool display_disabled)
3263 MemoryRegionList *new_ml, *ml, *next_ml;
3264 MemoryRegionListHead submr_print_queue;
3265 const MemoryRegion *submr;
3266 unsigned int i;
3267 hwaddr cur_start, cur_end;
3269 if (!mr) {
3270 return;
3273 cur_start = base + mr->addr;
3274 cur_end = cur_start + MR_SIZE(mr->size);
3277 * Try to detect overflow of memory region. This should never
3278 * happen normally. When it happens, we dump something to warn the
3279 * user who is observing this.
3281 if (cur_start < base || cur_end < cur_start) {
3282 qemu_printf("[DETECTED OVERFLOW!] ");
3285 if (mr->alias) {
3286 bool found = false;
3288 /* check if the alias is already in the queue */
3289 QTAILQ_FOREACH(ml, alias_print_queue, mrqueue) {
3290 if (ml->mr == mr->alias) {
3291 found = true;
3295 if (!found) {
3296 ml = g_new(MemoryRegionList, 1);
3297 ml->mr = mr->alias;
3298 QTAILQ_INSERT_TAIL(alias_print_queue, ml, mrqueue);
3300 if (mr->enabled || display_disabled) {
3301 for (i = 0; i < level; i++) {
3302 qemu_printf(MTREE_INDENT);
3304 qemu_printf(HWADDR_FMT_plx "-" HWADDR_FMT_plx
3305 " (prio %d, %s%s): alias %s @%s " HWADDR_FMT_plx
3306 "-" HWADDR_FMT_plx "%s",
3307 cur_start, cur_end,
3308 mr->priority,
3309 mr->nonvolatile ? "nv-" : "",
3310 memory_region_type((MemoryRegion *)mr),
3311 memory_region_name(mr),
3312 memory_region_name(mr->alias),
3313 mr->alias_offset,
3314 mr->alias_offset + MR_SIZE(mr->size),
3315 mr->enabled ? "" : " [disabled]");
3316 if (owner) {
3317 mtree_print_mr_owner(mr);
3319 qemu_printf("\n");
3321 } else {
3322 if (mr->enabled || display_disabled) {
3323 for (i = 0; i < level; i++) {
3324 qemu_printf(MTREE_INDENT);
3326 qemu_printf(HWADDR_FMT_plx "-" HWADDR_FMT_plx
3327 " (prio %d, %s%s): %s%s",
3328 cur_start, cur_end,
3329 mr->priority,
3330 mr->nonvolatile ? "nv-" : "",
3331 memory_region_type((MemoryRegion *)mr),
3332 memory_region_name(mr),
3333 mr->enabled ? "" : " [disabled]");
3334 if (owner) {
3335 mtree_print_mr_owner(mr);
3337 qemu_printf("\n");
3341 QTAILQ_INIT(&submr_print_queue);
3343 QTAILQ_FOREACH(submr, &mr->subregions, subregions_link) {
3344 new_ml = g_new(MemoryRegionList, 1);
3345 new_ml->mr = submr;
3346 QTAILQ_FOREACH(ml, &submr_print_queue, mrqueue) {
3347 if (new_ml->mr->addr < ml->mr->addr ||
3348 (new_ml->mr->addr == ml->mr->addr &&
3349 new_ml->mr->priority > ml->mr->priority)) {
3350 QTAILQ_INSERT_BEFORE(ml, new_ml, mrqueue);
3351 new_ml = NULL;
3352 break;
3355 if (new_ml) {
3356 QTAILQ_INSERT_TAIL(&submr_print_queue, new_ml, mrqueue);
3360 QTAILQ_FOREACH(ml, &submr_print_queue, mrqueue) {
3361 mtree_print_mr(ml->mr, level + 1, cur_start,
3362 alias_print_queue, owner, display_disabled);
3365 QTAILQ_FOREACH_SAFE(ml, &submr_print_queue, mrqueue, next_ml) {
3366 g_free(ml);
3370 struct FlatViewInfo {
3371 int counter;
3372 bool dispatch_tree;
3373 bool owner;
3374 AccelClass *ac;
3377 static void mtree_print_flatview(gpointer key, gpointer value,
3378 gpointer user_data)
3380 FlatView *view = key;
3381 GArray *fv_address_spaces = value;
3382 struct FlatViewInfo *fvi = user_data;
3383 FlatRange *range = &view->ranges[0];
3384 MemoryRegion *mr;
3385 int n = view->nr;
3386 int i;
3387 AddressSpace *as;
3389 qemu_printf("FlatView #%d\n", fvi->counter);
3390 ++fvi->counter;
3392 for (i = 0; i < fv_address_spaces->len; ++i) {
3393 as = g_array_index(fv_address_spaces, AddressSpace*, i);
3394 qemu_printf(" AS \"%s\", root: %s",
3395 as->name, memory_region_name(as->root));
3396 if (as->root->alias) {
3397 qemu_printf(", alias %s", memory_region_name(as->root->alias));
3399 qemu_printf("\n");
3402 qemu_printf(" Root memory region: %s\n",
3403 view->root ? memory_region_name(view->root) : "(none)");
3405 if (n <= 0) {
3406 qemu_printf(MTREE_INDENT "No rendered FlatView\n\n");
3407 return;
3410 while (n--) {
3411 mr = range->mr;
3412 if (range->offset_in_region) {
3413 qemu_printf(MTREE_INDENT HWADDR_FMT_plx "-" HWADDR_FMT_plx
3414 " (prio %d, %s%s): %s @" HWADDR_FMT_plx,
3415 int128_get64(range->addr.start),
3416 int128_get64(range->addr.start)
3417 + MR_SIZE(range->addr.size),
3418 mr->priority,
3419 range->nonvolatile ? "nv-" : "",
3420 range->readonly ? "rom" : memory_region_type(mr),
3421 memory_region_name(mr),
3422 range->offset_in_region);
3423 } else {
3424 qemu_printf(MTREE_INDENT HWADDR_FMT_plx "-" HWADDR_FMT_plx
3425 " (prio %d, %s%s): %s",
3426 int128_get64(range->addr.start),
3427 int128_get64(range->addr.start)
3428 + MR_SIZE(range->addr.size),
3429 mr->priority,
3430 range->nonvolatile ? "nv-" : "",
3431 range->readonly ? "rom" : memory_region_type(mr),
3432 memory_region_name(mr));
3434 if (fvi->owner) {
3435 mtree_print_mr_owner(mr);
3438 if (fvi->ac) {
3439 for (i = 0; i < fv_address_spaces->len; ++i) {
3440 as = g_array_index(fv_address_spaces, AddressSpace*, i);
3441 if (fvi->ac->has_memory(current_machine, as,
3442 int128_get64(range->addr.start),
3443 MR_SIZE(range->addr.size) + 1)) {
3444 qemu_printf(" %s", fvi->ac->name);
3448 qemu_printf("\n");
3449 range++;
3452 #if !defined(CONFIG_USER_ONLY)
3453 if (fvi->dispatch_tree && view->root) {
3454 mtree_print_dispatch(view->dispatch, view->root);
3456 #endif
3458 qemu_printf("\n");
3461 static gboolean mtree_info_flatview_free(gpointer key, gpointer value,
3462 gpointer user_data)
3464 FlatView *view = key;
3465 GArray *fv_address_spaces = value;
3467 g_array_unref(fv_address_spaces);
3468 flatview_unref(view);
3470 return true;
3473 static void mtree_info_flatview(bool dispatch_tree, bool owner)
3475 struct FlatViewInfo fvi = {
3476 .counter = 0,
3477 .dispatch_tree = dispatch_tree,
3478 .owner = owner,
3480 AddressSpace *as;
3481 FlatView *view;
3482 GArray *fv_address_spaces;
3483 GHashTable *views = g_hash_table_new(g_direct_hash, g_direct_equal);
3484 AccelClass *ac = ACCEL_GET_CLASS(current_accel());
3486 if (ac->has_memory) {
3487 fvi.ac = ac;
3490 /* Gather all FVs in one table */
3491 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
3492 view = address_space_get_flatview(as);
3494 fv_address_spaces = g_hash_table_lookup(views, view);
3495 if (!fv_address_spaces) {
3496 fv_address_spaces = g_array_new(false, false, sizeof(as));
3497 g_hash_table_insert(views, view, fv_address_spaces);
3500 g_array_append_val(fv_address_spaces, as);
3503 /* Print */
3504 g_hash_table_foreach(views, mtree_print_flatview, &fvi);
3506 /* Free */
3507 g_hash_table_foreach_remove(views, mtree_info_flatview_free, 0);
3508 g_hash_table_unref(views);
3511 struct AddressSpaceInfo {
3512 MemoryRegionListHead *ml_head;
3513 bool owner;
3514 bool disabled;
3517 /* Returns negative value if a < b; zero if a = b; positive value if a > b. */
3518 static gint address_space_compare_name(gconstpointer a, gconstpointer b)
3520 const AddressSpace *as_a = a;
3521 const AddressSpace *as_b = b;
3523 return g_strcmp0(as_a->name, as_b->name);
3526 static void mtree_print_as_name(gpointer data, gpointer user_data)
3528 AddressSpace *as = data;
3530 qemu_printf("address-space: %s\n", as->name);
3533 static void mtree_print_as(gpointer key, gpointer value, gpointer user_data)
3535 MemoryRegion *mr = key;
3536 GSList *as_same_root_mr_list = value;
3537 struct AddressSpaceInfo *asi = user_data;
3539 g_slist_foreach(as_same_root_mr_list, mtree_print_as_name, NULL);
3540 mtree_print_mr(mr, 1, 0, asi->ml_head, asi->owner, asi->disabled);
3541 qemu_printf("\n");
3544 static gboolean mtree_info_as_free(gpointer key, gpointer value,
3545 gpointer user_data)
3547 GSList *as_same_root_mr_list = value;
3549 g_slist_free(as_same_root_mr_list);
3551 return true;
3554 static void mtree_info_as(bool dispatch_tree, bool owner, bool disabled)
3556 MemoryRegionListHead ml_head;
3557 MemoryRegionList *ml, *ml2;
3558 AddressSpace *as;
3559 GHashTable *views = g_hash_table_new(g_direct_hash, g_direct_equal);
3560 GSList *as_same_root_mr_list;
3561 struct AddressSpaceInfo asi = {
3562 .ml_head = &ml_head,
3563 .owner = owner,
3564 .disabled = disabled,
3567 QTAILQ_INIT(&ml_head);
3569 QTAILQ_FOREACH(as, &address_spaces, address_spaces_link) {
3570 /* Create hashtable, key=AS root MR, value = list of AS */
3571 as_same_root_mr_list = g_hash_table_lookup(views, as->root);
3572 as_same_root_mr_list = g_slist_insert_sorted(as_same_root_mr_list, as,
3573 address_space_compare_name);
3574 g_hash_table_insert(views, as->root, as_same_root_mr_list);
3577 /* print address spaces */
3578 g_hash_table_foreach(views, mtree_print_as, &asi);
3579 g_hash_table_foreach_remove(views, mtree_info_as_free, 0);
3580 g_hash_table_unref(views);
3582 /* print aliased regions */
3583 QTAILQ_FOREACH(ml, &ml_head, mrqueue) {
3584 qemu_printf("memory-region: %s\n", memory_region_name(ml->mr));
3585 mtree_print_mr(ml->mr, 1, 0, &ml_head, owner, disabled);
3586 qemu_printf("\n");
3589 QTAILQ_FOREACH_SAFE(ml, &ml_head, mrqueue, ml2) {
3590 g_free(ml);
3594 void mtree_info(bool flatview, bool dispatch_tree, bool owner, bool disabled)
3596 if (flatview) {
3597 mtree_info_flatview(dispatch_tree, owner);
3598 } else {
3599 mtree_info_as(dispatch_tree, owner, disabled);
3603 bool memory_region_init_ram(MemoryRegion *mr,
3604 Object *owner,
3605 const char *name,
3606 uint64_t size,
3607 Error **errp)
3609 DeviceState *owner_dev;
3611 if (!memory_region_init_ram_nomigrate(mr, owner, name, size, errp)) {
3612 return false;
3614 /* This will assert if owner is neither NULL nor a DeviceState.
3615 * We only want the owner here for the purposes of defining a
3616 * unique name for migration. TODO: Ideally we should implement
3617 * a naming scheme for Objects which are not DeviceStates, in
3618 * which case we can relax this restriction.
3620 owner_dev = DEVICE(owner);
3621 vmstate_register_ram(mr, owner_dev);
3623 return true;
3626 bool memory_region_init_ram_guest_memfd(MemoryRegion *mr,
3627 Object *owner,
3628 const char *name,
3629 uint64_t size,
3630 Error **errp)
3632 DeviceState *owner_dev;
3634 if (!memory_region_init_ram_flags_nomigrate(mr, owner, name, size,
3635 RAM_GUEST_MEMFD, errp)) {
3636 return false;
3638 /* This will assert if owner is neither NULL nor a DeviceState.
3639 * We only want the owner here for the purposes of defining a
3640 * unique name for migration. TODO: Ideally we should implement
3641 * a naming scheme for Objects which are not DeviceStates, in
3642 * which case we can relax this restriction.
3644 owner_dev = DEVICE(owner);
3645 vmstate_register_ram(mr, owner_dev);
3647 return true;
3650 bool memory_region_init_rom(MemoryRegion *mr,
3651 Object *owner,
3652 const char *name,
3653 uint64_t size,
3654 Error **errp)
3656 DeviceState *owner_dev;
3658 if (!memory_region_init_rom_nomigrate(mr, owner, name, size, errp)) {
3659 return false;
3661 /* This will assert if owner is neither NULL nor a DeviceState.
3662 * We only want the owner here for the purposes of defining a
3663 * unique name for migration. TODO: Ideally we should implement
3664 * a naming scheme for Objects which are not DeviceStates, in
3665 * which case we can relax this restriction.
3667 owner_dev = DEVICE(owner);
3668 vmstate_register_ram(mr, owner_dev);
3670 return true;
3673 bool memory_region_init_rom_device(MemoryRegion *mr,
3674 Object *owner,
3675 const MemoryRegionOps *ops,
3676 void *opaque,
3677 const char *name,
3678 uint64_t size,
3679 Error **errp)
3681 DeviceState *owner_dev;
3683 if (!memory_region_init_rom_device_nomigrate(mr, owner, ops, opaque,
3684 name, size, errp)) {
3685 return false;
3687 /* This will assert if owner is neither NULL nor a DeviceState.
3688 * We only want the owner here for the purposes of defining a
3689 * unique name for migration. TODO: Ideally we should implement
3690 * a naming scheme for Objects which are not DeviceStates, in
3691 * which case we can relax this restriction.
3693 owner_dev = DEVICE(owner);
3694 vmstate_register_ram(mr, owner_dev);
3696 return true;
3700 * Support system builds with CONFIG_FUZZ using a weak symbol and a stub for
3701 * the fuzz_dma_read_cb callback
3703 #ifdef CONFIG_FUZZ
3704 void __attribute__((weak)) fuzz_dma_read_cb(size_t addr,
3705 size_t len,
3706 MemoryRegion *mr)
3709 #endif
3711 static const TypeInfo memory_region_info = {
3712 .parent = TYPE_OBJECT,
3713 .name = TYPE_MEMORY_REGION,
3714 .class_size = sizeof(MemoryRegionClass),
3715 .instance_size = sizeof(MemoryRegion),
3716 .instance_init = memory_region_initfn,
3717 .instance_finalize = memory_region_finalize,
3720 static const TypeInfo iommu_memory_region_info = {
3721 .parent = TYPE_MEMORY_REGION,
3722 .name = TYPE_IOMMU_MEMORY_REGION,
3723 .class_size = sizeof(IOMMUMemoryRegionClass),
3724 .instance_size = sizeof(IOMMUMemoryRegion),
3725 .instance_init = iommu_memory_region_initfn,
3726 .abstract = true,
3729 static const TypeInfo ram_discard_manager_info = {
3730 .parent = TYPE_INTERFACE,
3731 .name = TYPE_RAM_DISCARD_MANAGER,
3732 .class_size = sizeof(RamDiscardManagerClass),
3735 static void memory_register_types(void)
3737 type_register_static(&memory_region_info);
3738 type_register_static(&iommu_memory_region_info);
3739 type_register_static(&ram_discard_manager_info);
3742 type_init(memory_register_types)