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
21typedef 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 */
38typedef 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. */
44typedef struct MemoryMapping {
45 hwaddr phys_addr;
46 target_ulong virt_addr;
47 ram_addr_t length;
48 QTAILQ_ENTRY(MemoryMapping) next;
49} MemoryMapping;
50
51struct 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 */
62void memory_mapping_list_add_merge_sorted(MemoryMappingList *list,
63 hwaddr phys_addr,
64 hwaddr virt_addr,
65 ram_addr_t length);
66
67void memory_mapping_list_free(MemoryMappingList *list);
68
69void memory_mapping_list_init(MemoryMappingList *list);
70
71void guest_phys_blocks_free(GuestPhysBlockList *list);
72void guest_phys_blocks_init(GuestPhysBlockList *list);
73void guest_phys_blocks_append(GuestPhysBlockList *list);
74
75void 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). */
80void qemu_get_guest_simple_memory_mapping(MemoryMappingList *list,
81 const GuestPhysBlockList *guest_phys_blocks);
82
83void memory_mapping_filter(MemoryMappingList *list, int64_t begin,
84 int64_t length);
85
86#endif
87