[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 7/7] docs: document memory API interaction with migr
From: |
Avi Kivity |
Subject: |
[Qemu-devel] [PATCH 7/7] docs: document memory API interaction with migration |
Date: |
Thu, 15 Dec 2011 17:18:39 +0200 |
Signed-off-by: Avi Kivity <address@hidden>
---
docs/migration.txt | 12 ++++++++++++
1 files changed, 12 insertions(+), 0 deletions(-)
diff --git a/docs/migration.txt b/docs/migration.txt
index 4848c1e..f3ddd2f 100644
--- a/docs/migration.txt
+++ b/docs/migration.txt
@@ -219,6 +219,18 @@ The functions to do that are inside a vmstate definition,
and are called:
Example: You can look at hpet.c, that uses the three function to
massage the state that is transferred.
+If you use memory API functions that update memory layout outside
+initialization (i.e., in response to a guest action), this is a strong
+indication that you need to call these functions in a post_load callback.
+Examples of such memory API functions are:
+
+ - memory_region_add_subregion()
+ - memory_region_del_subregion()
+ - memory_region_set_readonly()
+ - memory_region_set_enabled()
+ - memory_region_set_address()
+ - memory_region_set_alias_offset()
+
=== Subsections ===
The use of version_id allows to be able to migrate from older versions
--
1.7.7.1
- [Qemu-devel] [PULL v3 0/7] Memory API mutators, Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 3/7] memory: introduce memory_region_set_alias_offset(), Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 2/7] memory: introduce memory_region_set_address(), Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 4/7] memory: optimize empty transactions due to mutators, Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 7/7] docs: document memory API interaction with migration,
Avi Kivity <=
- [Qemu-devel] [PATCH 6/7] piix_pci: adapt smram mapping to use memory mutators, Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 5/7] cirrus_vga: adapt to memory mutators API, Avi Kivity, 2011/12/15
- [Qemu-devel] [PATCH 1/7] memory: introduce memory_region_set_enabled(), Avi Kivity, 2011/12/15
- Re: [Qemu-devel] [PULL v3 0/7] Memory API mutators, Anthony Liguori, 2011/12/19