From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:39458) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbD5Y-0008F4-AT for qemu-devel@nongnu.org; Thu, 15 Dec 2011 10:19:21 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RbD5F-0003mu-B3 for qemu-devel@nongnu.org; Thu, 15 Dec 2011 10:19:16 -0500 Received: from mx1.redhat.com ([209.132.183.28]:9310) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbD5F-0003me-1Q for qemu-devel@nongnu.org; Thu, 15 Dec 2011 10:18:57 -0500 From: Avi Kivity Date: Thu, 15 Dec 2011 17:18:39 +0200 Message-Id: <1323962319-13762-8-git-send-email-avi@redhat.com> In-Reply-To: <1323962319-13762-1-git-send-email-avi@redhat.com> References: <1323962319-13762-1-git-send-email-avi@redhat.com> Subject: [Qemu-devel] [PATCH 7/7] docs: document memory API interaction with migration List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Anthony Liguori Cc: qemu-devel@nongnu.org Signed-off-by: Avi Kivity --- 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