From patchwork Fri Dec 20 17:25:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Cooper X-Patchwork-Id: 11306057 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 65C5017EF for ; Fri, 20 Dec 2019 17:26:36 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 41E6D206A5 for ; Fri, 20 Dec 2019 17:26:36 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=citrix.com header.i=@citrix.com header.b="dA3ui6+Y" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 41E6D206A5 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=citrix.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iiM1x-0007Ys-Tu; Fri, 20 Dec 2019 17:25:37 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iiM1x-0007Yl-Ao for xen-devel@lists.xenproject.org; Fri, 20 Dec 2019 17:25:37 +0000 X-Inumbo-ID: b704dee0-234d-11ea-b6f1-bc764e2007e4 Received: from esa3.hc3370-68.iphmx.com (unknown [216.71.145.155]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id b704dee0-234d-11ea-b6f1-bc764e2007e4; Fri, 20 Dec 2019 17:25:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=citrix.com; s=securemail; t=1576862729; h=from:to:cc:subject:date:message-id:mime-version; bh=zS2Q98Gy7j6eOS6aHbF3CxRbnNIEjMw/s+gqWVzfiGc=; b=dA3ui6+YiO5l+pn0qvcZuErpv/1LbYMMQm81vEMS4D0M40TJKd5buf94 RNeK2PV1v1cRwMaNwObA3EZITzu5+oRgzvDY9mKuK0Qmfq79y4TMTgM4C /kpjay5SQf6ItWYu/9u+X1rjoiWSAzv+EYhrX4Eo34WLp1z0ohlM7+yRw g=; Authentication-Results: esa3.hc3370-68.iphmx.com; dkim=none (message not signed) header.i=none; spf=None smtp.pra=andrew.cooper3@citrix.com; spf=Pass smtp.mailfrom=Andrew.Cooper3@citrix.com; spf=None smtp.helo=postmaster@mail.citrix.com Received-SPF: None (esa3.hc3370-68.iphmx.com: no sender authenticity information available from domain of andrew.cooper3@citrix.com) identity=pra; client-ip=162.221.158.21; receiver=esa3.hc3370-68.iphmx.com; envelope-from="Andrew.Cooper3@citrix.com"; x-sender="andrew.cooper3@citrix.com"; x-conformance=sidf_compatible Received-SPF: Pass (esa3.hc3370-68.iphmx.com: domain of Andrew.Cooper3@citrix.com designates 162.221.158.21 as permitted sender) identity=mailfrom; client-ip=162.221.158.21; receiver=esa3.hc3370-68.iphmx.com; envelope-from="Andrew.Cooper3@citrix.com"; x-sender="Andrew.Cooper3@citrix.com"; x-conformance=sidf_compatible; x-record-type="v=spf1"; x-record-text="v=spf1 ip4:209.167.231.154 ip4:178.63.86.133 ip4:195.66.111.40/30 ip4:85.115.9.32/28 ip4:199.102.83.4 ip4:192.28.146.160 ip4:192.28.146.107 ip4:216.52.6.88 ip4:216.52.6.188 ip4:162.221.158.21 ip4:162.221.156.83 ip4:168.245.78.127 ~all" Received-SPF: None (esa3.hc3370-68.iphmx.com: no sender authenticity information available from domain of postmaster@mail.citrix.com) identity=helo; client-ip=162.221.158.21; receiver=esa3.hc3370-68.iphmx.com; envelope-from="Andrew.Cooper3@citrix.com"; x-sender="postmaster@mail.citrix.com"; x-conformance=sidf_compatible IronPort-SDR: mNDtrFx8zT7uMm4oC1Qp16DR2t8V8gsdVrnSjidqNK8wzNNp0JMgW/7Yjfmiz8jLhg4ALesz8/ 20Eq+Y0QJNNHdeOsMjemwCbXmXoxHHY8blTOc8acGMam2qc1IZpdB1j0YquNgiakhoDDWfDWjW dbyciQpgDMNR7WtygHZMmNPeFw41v0HUc5ldMUX4KbwI8u2MaW/fH1Gh6weJaFBeh34o33ohYo t4Zk4carD7ytPjAnS1F7/bjK4olHdj8VATZncJRqvOMf0nZelzP4CJ4OqruzwP/NMobypATQDX oVY= X-SBRS: 2.7 X-MesageID: 9991238 X-Ironport-Server: esa3.hc3370-68.iphmx.com X-Remote-IP: 162.221.158.21 X-Policy: $RELAYED X-IronPort-AV: E=Sophos;i="5.69,336,1571716800"; d="scan'208";a="9991238" From: Andrew Cooper To: Xen-devel Date: Fri, 20 Dec 2019 17:25:23 +0000 Message-ID: <20191220172523.1359-1-andrew.cooper3@citrix.com> X-Mailer: git-send-email 2.11.0 MIME-Version: 1.0 Subject: [Xen-devel] [PATCH] docs/migration: Remove numbering for typical records X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Stefano Stabellini , Julien Grall , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Jan Beulich , Ian Jackson Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" The numbers aren't referenced directly, and explicit numbering makes an unnecesserily large diff when inserting something new in the middle. Signed-off-by: Andrew Cooper Acked-by: Ian Jackson --- CC: George Dunlap CC: Ian Jackson CC: Jan Beulich CC: Konrad Rzeszutek Wilk CC: Stefano Stabellini CC: Wei Liu CC: Julien Grall --- docs/specs/libxc-migration-stream.pandoc | 46 ++++++++++++++++---------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/specs/libxc-migration-stream.pandoc b/docs/specs/libxc-migration-stream.pandoc index 97dacb6e30..a365dba0c8 100644 --- a/docs/specs/libxc-migration-stream.pandoc +++ b/docs/specs/libxc-migration-stream.pandoc @@ -641,40 +641,40 @@ x86 PV Guest A typical save record for an x86 PV guest image would look like: -1. Image header -2. Domain header -3. X86_PV_INFO record -4. X86_PV_P2M_FRAMES record -5. Many PAGE_DATA records -6. TSC_INFO -7. SHARED_INFO record -8. VCPU context records for each online VCPU - a. X86_PV_VCPU_BASIC record - b. X86_PV_VCPU_EXTENDED record - c. X86_PV_VCPU_XSAVE record - d. X86_PV_VCPU_MSRS record -9. END record +* Image header +* Domain header +* X86_PV_INFO record +* X86_PV_P2M_FRAMES record +* Many PAGE_DATA records +* TSC_INFO +* SHARED_INFO record +* VCPU context records for each online VCPU + * X86_PV_VCPU_BASIC record + * X86_PV_VCPU_EXTENDED record + * X86_PV_VCPU_XSAVE record + * X86_PV_VCPU_MSRS record +* END record There are some strict ordering requirements. The following records must be present in the following order as each of them depends on information present in the preceding ones. -1. X86_PV_INFO record -2. X86_PV_P2M_FRAMES record -3. PAGE_DATA records -4. VCPU records +* X86_PV_INFO record +* X86_PV_P2M_FRAMES record +* PAGE_DATA records +* VCPU records x86 HVM Guest ------------- A typical save record for an x86 HVM guest image would look like: -1. Image header -2. Domain header -3. Many PAGE_DATA records -4. TSC_INFO -5. HVM_PARAMS -6. HVM_CONTEXT +* Image header +* Domain header +* Many PAGE_DATA records +* TSC_INFO +* HVM_PARAMS +* HVM_CONTEXT HVM_PARAMS must precede HVM_CONTEXT, as certain parameters can affect the validity of architectural state in the context.