xref: /qemu/include/sysemu/memory_mapping.h (revision abff1abf)
1 /*
2  * QEMU memory mapping
3  *
4  * Copyright Fujitsu, Corp. 2011, 2012
5  *
6  * Authors:
7  *     Wen Congyang <wency@cn.fujitsu.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2 or later.
10  * See the COPYING file in the top-level directory.
11  *
12  */
13 
14 #ifndef MEMORY_MAPPING_H
15 #define MEMORY_MAPPING_H
16 
17 #include "qemu/queue.h"
18 #include "exec/cpu-defs.h"
19 #include "exec/memory.h"
20 
21 typedef struct GuestPhysBlock {
22     /* visible to guest, reflects PCI hole, etc */
23     hwaddr target_start;
24 
25     /* implies size */
26     hwaddr target_end;
27 
28     /* points into host memory */
29     uint8_t *host_addr;
30 
31     /* points to the MemoryRegion that this block belongs to */
32     MemoryRegion *mr;
33 
34     QTAILQ_ENTRY(GuestPhysBlock) next;
35 } GuestPhysBlock;
36 
37 /* point-in-time snapshot of guest-visible physical mappings */
38 typedef struct GuestPhysBlockList {
39     unsigned num;
40     QTAILQ_HEAD(, GuestPhysBlock) head;
41 } GuestPhysBlockList;
42 
43 /* The physical and virtual address in the memory mapping are contiguous. */
44 typedef struct MemoryMapping {
45     hwaddr phys_addr;
46     target_ulong virt_addr;
47     ram_addr_t length;
48     QTAILQ_ENTRY(MemoryMapping) next;
49 } MemoryMapping;
50 
51 struct MemoryMappingList {
52     unsigned int num;
53     MemoryMapping *last_mapping;
54     QTAILQ_HEAD(, MemoryMapping) head;
55 };
56 
57 /*
58  * add or merge the memory region [phys_addr, phys_addr + length) into the
59  * memory mapping's list. The region's virtual address starts with virt_addr,
60  * and is contiguous. The list is sorted by phys_addr.
61  */
62 void memory_mapping_list_add_merge_sorted(MemoryMappingList *list,
63                                           hwaddr phys_addr,
64                                           hwaddr virt_addr,
65                                           ram_addr_t length);
66 
67 void memory_mapping_list_free(MemoryMappingList *list);
68 
69 void memory_mapping_list_init(MemoryMappingList *list);
70 
71 void guest_phys_blocks_free(GuestPhysBlockList *list);
72 void guest_phys_blocks_init(GuestPhysBlockList *list);
73 void guest_phys_blocks_append(GuestPhysBlockList *list);
74 
75 void qemu_get_guest_memory_mapping(MemoryMappingList *list,
76                                    const GuestPhysBlockList *guest_phys_blocks,
77                                    Error **errp);
78 
79 /* get guest's memory mapping without do paging(virtual address is 0). */
80 void qemu_get_guest_simple_memory_mapping(MemoryMappingList *list,
81                                   const GuestPhysBlockList *guest_phys_blocks);
82 
83 void memory_mapping_filter(MemoryMappingList *list, int64_t begin,
84                            int64_t length);
85 
86 #endif
87