xref: /openbmc/qemu/include/exec/cpu-common.h (revision dd8d6a2d)
1 #ifndef CPU_COMMON_H
2 #define CPU_COMMON_H
3 
4 /* CPU interfaces that are target independent.  */
5 
6 #ifndef CONFIG_USER_ONLY
7 #include "exec/hwaddr.h"
8 #endif
9 
10 #include "qemu/bswap.h"
11 #include "qemu/queue.h"
12 #include "qemu/fprintf-fn.h"
13 
14 /**
15  * CPUListState:
16  * @cpu_fprintf: Print function.
17  * @file: File to print to using @cpu_fprint.
18  *
19  * State commonly used for iterating over CPU models.
20  */
21 typedef struct CPUListState {
22     fprintf_function cpu_fprintf;
23     FILE *file;
24 } CPUListState;
25 
26 /* The CPU list lock nests outside page_(un)lock or mmap_(un)lock */
27 void qemu_init_cpu_list(void);
28 void cpu_list_lock(void);
29 void cpu_list_unlock(void);
30 
31 void tcg_flush_softmmu_tlb(CPUState *cs);
32 
33 #if !defined(CONFIG_USER_ONLY)
34 
35 enum device_endian {
36     DEVICE_NATIVE_ENDIAN,
37     DEVICE_BIG_ENDIAN,
38     DEVICE_LITTLE_ENDIAN,
39 };
40 
41 #if defined(HOST_WORDS_BIGENDIAN)
42 #define DEVICE_HOST_ENDIAN DEVICE_BIG_ENDIAN
43 #else
44 #define DEVICE_HOST_ENDIAN DEVICE_LITTLE_ENDIAN
45 #endif
46 
47 /* address in the RAM (different from a physical address) */
48 #if defined(CONFIG_XEN_BACKEND)
49 typedef uint64_t ram_addr_t;
50 #  define RAM_ADDR_MAX UINT64_MAX
51 #  define RAM_ADDR_FMT "%" PRIx64
52 #else
53 typedef uintptr_t ram_addr_t;
54 #  define RAM_ADDR_MAX UINTPTR_MAX
55 #  define RAM_ADDR_FMT "%" PRIxPTR
56 #endif
57 
58 extern ram_addr_t ram_size;
59 
60 /* memory API */
61 
62 typedef void CPUWriteMemoryFunc(void *opaque, hwaddr addr, uint32_t value);
63 typedef uint32_t CPUReadMemoryFunc(void *opaque, hwaddr addr);
64 
65 void qemu_ram_remap(ram_addr_t addr, ram_addr_t length);
66 /* This should not be used by devices.  */
67 ram_addr_t qemu_ram_addr_from_host(void *ptr);
68 RAMBlock *qemu_ram_block_by_name(const char *name);
69 RAMBlock *qemu_ram_block_from_host(void *ptr, bool round_offset,
70                                    ram_addr_t *offset);
71 ram_addr_t qemu_ram_block_host_offset(RAMBlock *rb, void *host);
72 void qemu_ram_set_idstr(RAMBlock *block, const char *name, DeviceState *dev);
73 void qemu_ram_unset_idstr(RAMBlock *block);
74 const char *qemu_ram_get_idstr(RAMBlock *rb);
75 void *qemu_ram_get_host_addr(RAMBlock *rb);
76 ram_addr_t qemu_ram_get_offset(RAMBlock *rb);
77 ram_addr_t qemu_ram_get_used_length(RAMBlock *rb);
78 bool qemu_ram_is_shared(RAMBlock *rb);
79 bool qemu_ram_is_uf_zeroable(RAMBlock *rb);
80 void qemu_ram_set_uf_zeroable(RAMBlock *rb);
81 bool qemu_ram_is_migratable(RAMBlock *rb);
82 void qemu_ram_set_migratable(RAMBlock *rb);
83 void qemu_ram_unset_migratable(RAMBlock *rb);
84 
85 size_t qemu_ram_pagesize(RAMBlock *block);
86 size_t qemu_ram_pagesize_largest(void);
87 
88 void cpu_physical_memory_rw(hwaddr addr, uint8_t *buf,
89                             hwaddr len, int is_write);
90 static inline void cpu_physical_memory_read(hwaddr addr,
91                                             void *buf, hwaddr len)
92 {
93     cpu_physical_memory_rw(addr, buf, len, 0);
94 }
95 static inline void cpu_physical_memory_write(hwaddr addr,
96                                              const void *buf, hwaddr len)
97 {
98     cpu_physical_memory_rw(addr, (void *)buf, len, 1);
99 }
100 void *cpu_physical_memory_map(hwaddr addr,
101                               hwaddr *plen,
102                               int is_write);
103 void cpu_physical_memory_unmap(void *buffer, hwaddr len,
104                                int is_write, hwaddr access_len);
105 void cpu_register_map_client(QEMUBH *bh);
106 void cpu_unregister_map_client(QEMUBH *bh);
107 
108 bool cpu_physical_memory_is_io(hwaddr phys_addr);
109 
110 /* Coalesced MMIO regions are areas where write operations can be reordered.
111  * This usually implies that write operations are side-effect free.  This allows
112  * batching which can make a major impact on performance when using
113  * virtualization.
114  */
115 void qemu_flush_coalesced_mmio_buffer(void);
116 
117 void cpu_flush_icache_range(hwaddr start, hwaddr len);
118 
119 extern struct MemoryRegion io_mem_rom;
120 extern struct MemoryRegion io_mem_notdirty;
121 
122 typedef int (RAMBlockIterFunc)(RAMBlock *rb, void *opaque);
123 
124 int qemu_ram_foreach_block(RAMBlockIterFunc func, void *opaque);
125 int ram_block_discard_range(RAMBlock *rb, uint64_t start, size_t length);
126 
127 #endif
128 
129 #endif /* CPU_COMMON_H */
130