include/sysemu/memory_mapping.h

   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 "qemu/typedefs.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(GuestPhysBlockHead, 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