From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:54766) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQEFU-0002rS-Aa for qemu-devel@nongnu.org; Mon, 22 Oct 2012 05:24:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQEFF-0006fs-Ni for qemu-devel@nongnu.org; Mon, 22 Oct 2012 05:24:40 -0400 Received: from e28smtp01.in.ibm.com ([122.248.162.1]:57678) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQEFF-0006fG-3l for qemu-devel@nongnu.org; Mon, 22 Oct 2012 05:24:25 -0400 Received: from /spool/local by e28smtp01.in.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Mon, 22 Oct 2012 14:54:20 +0530 Received: from d28av01.in.ibm.com (d28av01.in.ibm.com [9.184.220.63]) by d28relay04.in.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id q9M9OHlE34996264 for ; Mon, 22 Oct 2012 14:54:17 +0530 Received: from d28av01.in.ibm.com (loopback [127.0.0.1]) by d28av01.in.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id q9MEs8KH028053 for ; Mon, 22 Oct 2012 14:54:09 GMT From: Liu Ping Fan Date: Mon, 22 Oct 2012 17:23:49 +0800 Message-Id: <1350897839-29593-7-git-send-email-pingfank@linux.vnet.ibm.com> In-Reply-To: <1350897839-29593-1-git-send-email-pingfank@linux.vnet.ibm.com> References: <1350897839-29593-1-git-send-email-pingfank@linux.vnet.ibm.com> Subject: [Qemu-devel] [patch v4 06/16] memory: document ref, unref interface List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: Stefan Hajnoczi , Marcelo Tosatti , Avi Kivity , Anthony Liguori , Jan Kiszka , Paolo Bonzini Signed-off-by: Liu Ping Fan --- docs/memory.txt | 5 +++++ 1 files changed, 5 insertions(+), 0 deletions(-) diff --git a/docs/memory.txt b/docs/memory.txt index 5bbee8e..3f88812 100644 --- a/docs/memory.txt +++ b/docs/memory.txt @@ -170,3 +170,8 @@ various constraints can be supplied to control how these callbacks are called: - .old_portio and .old_mmio can be used to ease porting from code using cpu_register_io_memory() and register_ioport(). They should not be used in new code. + +MMIO regions are provided with ->ref() and ->unref() callbacks; This pair callbacks +are optional. When ref() return non-zero, Both MemoryRegion and its opaque are +safe to use. + -- 1.7.4.4