ec150c7e09
Back in 2016, we discussed[1] rules for headers, and these were
generally liked:
1. Have a carefully curated header that's included everywhere first. We
got that already thanks to Peter: osdep.h.
2. Headers should normally include everything they need beyond osdep.h.
If exceptions are needed for some reason, they must be documented in
the header. If all that's needed from a header is typedefs, put
those into qemu/typedefs.h instead of including the header.
3. Cyclic inclusion is forbidden.
This patch gets include/ closer to obeying 2.
It's actually extracted from my "[RFC] Baby steps towards saner
headers" series[2], which demonstrates a possible path towards
checking 2 automatically. It passes the RFC test there.
[1] Message-ID: <87h9g8j57d.fsf@blackfin.pond.sub.org>
https://lists.nongnu.org/archive/html/qemu-devel/2016-03/msg03345.html
[2] Message-Id: <20190711122827.18970-1-armbru@redhat.com>
https://lists.nongnu.org/archive/html/qemu-devel/2019-07/msg02715.html
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Alistair Francis <alistair.francis@wdc.com>
Message-Id: <20190812052359.30071-2-armbru@redhat.com>
Tested-by: Philippe Mathieu-Daudé <philmd@redhat.com>
88 lines
2.5 KiB
C
88 lines
2.5 KiB
C
/*
|
|
* QEMU memory mapping
|
|
*
|
|
* Copyright Fujitsu, Corp. 2011, 2012
|
|
*
|
|
* Authors:
|
|
* Wen Congyang <wency@cn.fujitsu.com>
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2 or later.
|
|
* See the COPYING file in the top-level directory.
|
|
*
|
|
*/
|
|
|
|
#ifndef MEMORY_MAPPING_H
|
|
#define MEMORY_MAPPING_H
|
|
|
|
#include "qemu/queue.h"
|
|
#include "exec/cpu-common.h"
|
|
#include "exec/cpu-defs.h"
|
|
#include "exec/memory.h"
|
|
|
|
typedef struct GuestPhysBlock {
|
|
/* visible to guest, reflects PCI hole, etc */
|
|
hwaddr target_start;
|
|
|
|
/* implies size */
|
|
hwaddr target_end;
|
|
|
|
/* points into host memory */
|
|
uint8_t *host_addr;
|
|
|
|
/* points to the MemoryRegion that this block belongs to */
|
|
MemoryRegion *mr;
|
|
|
|
QTAILQ_ENTRY(GuestPhysBlock) next;
|
|
} GuestPhysBlock;
|
|
|
|
/* point-in-time snapshot of guest-visible physical mappings */
|
|
typedef struct GuestPhysBlockList {
|
|
unsigned num;
|
|
QTAILQ_HEAD(, GuestPhysBlock) head;
|
|
} GuestPhysBlockList;
|
|
|
|
/* The physical and virtual address in the memory mapping are contiguous. */
|
|
typedef struct MemoryMapping {
|
|
hwaddr phys_addr;
|
|
target_ulong virt_addr;
|
|
ram_addr_t length;
|
|
QTAILQ_ENTRY(MemoryMapping) next;
|
|
} MemoryMapping;
|
|
|
|
struct MemoryMappingList {
|
|
unsigned int num;
|
|
MemoryMapping *last_mapping;
|
|
QTAILQ_HEAD(, MemoryMapping) head;
|
|
};
|
|
|
|
/*
|
|
* add or merge the memory region [phys_addr, phys_addr + length) into the
|
|
* memory mapping's list. The region's virtual address starts with virt_addr,
|
|
* and is contiguous. The list is sorted by phys_addr.
|
|
*/
|
|
void memory_mapping_list_add_merge_sorted(MemoryMappingList *list,
|
|
hwaddr phys_addr,
|
|
hwaddr virt_addr,
|
|
ram_addr_t length);
|
|
|
|
void memory_mapping_list_free(MemoryMappingList *list);
|
|
|
|
void memory_mapping_list_init(MemoryMappingList *list);
|
|
|
|
void guest_phys_blocks_free(GuestPhysBlockList *list);
|
|
void guest_phys_blocks_init(GuestPhysBlockList *list);
|
|
void guest_phys_blocks_append(GuestPhysBlockList *list);
|
|
|
|
void qemu_get_guest_memory_mapping(MemoryMappingList *list,
|
|
const GuestPhysBlockList *guest_phys_blocks,
|
|
Error **errp);
|
|
|
|
/* get guest's memory mapping without do paging(virtual address is 0). */
|
|
void qemu_get_guest_simple_memory_mapping(MemoryMappingList *list,
|
|
const GuestPhysBlockList *guest_phys_blocks);
|
|
|
|
void memory_mapping_filter(MemoryMappingList *list, int64_t begin,
|
|
int64_t length);
|
|
|
|
#endif
|