xref: /openbmc/qemu/include/system/physmem.h (revision 637a8b25a6ff233540b3d1b656359294f5dfb33f)
1 /*
2  * QEMU physical memory interfaces (target independent).
3  *
4  *  Copyright (c) 2003 Fabrice Bellard
5  *
6  * SPDX-License-Identifier: GPL-2.0-or-later
7  */
8 #ifndef QEMU_SYSTEM_PHYSMEM_H
9 #define QEMU_SYSTEM_PHYSMEM_H
10 
11 #include "exec/hwaddr.h"
12 #include "exec/ramlist.h"
13 
14 #define DIRTY_CLIENTS_ALL     ((1 << DIRTY_MEMORY_NUM) - 1)
15 #define DIRTY_CLIENTS_NOCODE  (DIRTY_CLIENTS_ALL & ~(1 << DIRTY_MEMORY_CODE))
16 
17 bool physical_memory_get_dirty_flag(ram_addr_t addr, unsigned client);
18 
19 bool physical_memory_is_clean(ram_addr_t addr);
20 
21 uint8_t physical_memory_range_includes_clean(ram_addr_t start,
22                                              ram_addr_t length,
23                                              uint8_t mask);
24 
25 void physical_memory_set_dirty_flag(ram_addr_t addr, unsigned client);
26 
27 void physical_memory_set_dirty_range(ram_addr_t start, ram_addr_t length,
28                                      uint8_t mask);
29 
30 /*
31  * Contrary to physical_memory_sync_dirty_bitmap() this function returns
32  * the number of dirty pages in @bitmap passed as argument. On the other hand,
33  * physical_memory_sync_dirty_bitmap() returns newly dirtied pages that
34  * weren't set in the global migration bitmap.
35  */
36 uint64_t physical_memory_set_dirty_lebitmap(unsigned long *bitmap,
37                                             ram_addr_t start,
38                                             ram_addr_t pages);
39 
40 void physical_memory_dirty_bits_cleared(ram_addr_t start, ram_addr_t length);
41 
42 bool physical_memory_test_and_clear_dirty(ram_addr_t start,
43                                           ram_addr_t length,
44                                           unsigned client);
45 
46 DirtyBitmapSnapshot *
47 physical_memory_snapshot_and_clear_dirty(MemoryRegion *mr, hwaddr offset,
48                                          hwaddr length, unsigned client);
49 
50 bool physical_memory_snapshot_get_dirty(DirtyBitmapSnapshot *snap,
51                                         ram_addr_t start,
52                                         ram_addr_t length);
53 
54 #endif
55