summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAnthony Liguori2011-12-19 16:12:25 +0100
committerAnthony Liguori2011-12-19 16:12:25 +0100
commitcde7fc31dee7a7bac96779f77a21825b187871d3 (patch)
tree2be2b44d2a413f8af70e50a446bec77e3e701d0e /docs
parentMerge remote-tracking branch 'stefanha/trivial-patches' into staging (diff)
parentdocs: document memory API interaction with migration (diff)
downloadqemu-cde7fc31dee7a7bac96779f77a21825b187871d3.tar.gz
qemu-cde7fc31dee7a7bac96779f77a21825b187871d3.tar.xz
qemu-cde7fc31dee7a7bac96779f77a21825b187871d3.zip
Merge remote-tracking branch 'qemu-kvm/memory/mutators' into staging
Conflicts: memory.h
Diffstat (limited to 'docs')
-rw-r--r--docs/migration.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/migration.txt b/docs/migration.txt
index 4848c1e52d..f3ddd2f1a8 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