From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Vrabel Subject: [PATCH 1/6] docs: update docs for the ~/platform/generation-id key Date: Tue, 27 May 2014 18:31:44 +0100 Message-ID: <1401211909-27771-2-git-send-email-david.vrabel@citrix.com> References: <1401211909-27771-1-git-send-email-david.vrabel@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1WpLED-00086q-Pw for xen-devel@lists.xenproject.org; Tue, 27 May 2014 17:31:58 +0000 In-Reply-To: <1401211909-27771-1-git-send-email-david.vrabel@citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: xen-devel@lists.xenproject.org Cc: David Vrabel , Ian Jackson , Ian Campbell , Stefano Stabellini List-Id: xen-devel@lists.xenproject.org Signed-off-by: David Vrabel --- docs/misc/xenstore-paths.markdown | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/docs/misc/xenstore-paths.markdown b/docs/misc/xenstore-paths.markdown index 70ab7f4..41d7d6d 100644 --- a/docs/misc/xenstore-paths.markdown +++ b/docs/misc/xenstore-paths.markdown @@ -166,11 +166,6 @@ use the xenstore-based protocol instead (see ~/control/shutdown, below) even if the guest has advertised support for the event channel protocol. -#### ~/hvmloader/generation-id-address = ADDRESS [r,HVM,INTERNAL] - -The hexadecimal representation of the address of the domain's -"generation id". - #### ~/hvmloader/allow-memory-relocate = ("1"|"0") [HVM,INTERNAL] If the default low MMIO hole (below 4GiB) is not big enough for all @@ -193,9 +188,22 @@ Various platform properties. #### ~/platform/generation-id = INTEGER ":" INTEGER [HVM,INTERNAL] -Two 64 bit values that represent the Windows Generation ID. -Is used by the BIOS initializer to get this value. -If not present or "0:0" (all zeroes) device will not be present to the machine. +The upper and lower 64-bit words of the 128-bit VM Generation ID. + +This key is used by hvmloader to create the ACPI VM Generation ID +device. It initialises a 16 octet region of guest memory with this +value. The guest physical address of this region is saved in the +HVM_PARAM_VM_GENERATION_ID_ADDR HVM parameter. + +If this key is not present, is empty, or is all-zeros ("0:0") then the +ACPI device is not created. + +The toolstack should, before unpausing a created or restored HVM +domain, set this key and write the same ID to the guest memory +location in HVM_PARAM_VM_GENERATION_ID_ADDR (if this address is +non-zero). + +See Microsoft's "Virtual Machine Generation ID" specification. ### Frontend device paths -- 1.7.10.4