From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ian Campbell <ian.campbell@citrix.com>
Subject: Re: [PATCH v10 14/15] docs: libxc migration stream
	specification
Date: Tue, 5 May 2015 14:25:08 +0100
Message-ID: <1430832308.2660.95.camel@citrix.com>
References: <1429789725-18768-1-git-send-email-andrew.cooper3@citrix.com>
	<1429789725-18768-15-git-send-email-andrew.cooper3@citrix.com>
	<1430830994.2660.87.camel@citrix.com> <5548BFEF.7010206@citrix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Return-path: <xen-devel-bounces@lists.xen.org>
In-Reply-To: <5548BFEF.7010206@citrix.com>
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: Andrew Cooper <andrew.cooper3@citrix.com>
Cc: Wei Liu <wei.liu2@citrix.com>, Ian Jackson <Ian.Jackson@eu.citrix.com>, David Vrabel <david.vrabel@citrix.com>, Xen-devel <xen-devel@lists.xen.org>
List-Id: xen-devel@lists.xenproject.org

On Tue, 2015-05-05 at 14:04 +0100, Andrew Cooper wrote:
> On 05/05/15 14:03, Ian Campbell wrote:
> > On Thu, 2015-04-23 at 12:48 +0100, Andrew Cooper wrote:
> >> From: David Vrabel <david.vrabel@citrix.com>
> >>
> >> Add the specification for a new migration stream format.  The document
> >> includes all the details but to summarize:
> >>
> >> The existing (legacy) format is dependant on the word size of the
> >> toolstack.  This prevents domains from migrating from hosts running
> >> 32-bit toolstacks to hosts running 64-bit toolstacks (and vice-versa).
> >>
> >> The legacy format lacks any version information making it difficult to
> >> extend in compatible way.
> >>
> >> The new format has a header (the image header) with version information,
> >> a domain header with basic information of the domain and a stream of
> >> records for the image data.
> >>
> >> The format will be used for future domain types (such as on ARM).
> >>
> >> The specification is pandoc format (an extended markdown format) and the
> >> documentation build system is extended to support pandoc format documents.
> >>
> >> Signed-off-by: David Vrabel <david.vrabel@citrix.com>
> >> Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
> > Without reading:
> >
> > Acked-by: Ian Campbell <Ian.Campbell@citrix.com>
> >
> > With two minor comments:
> >
> >> diff --git a/docs/specs/libxc-migration-stream.pandoc b/docs/specs/libxc-migration-stream.pandoc
> >> new file mode 100644
> >> index 0000000..455d1ce
> >> --- /dev/null
> >> +++ b/docs/specs/libxc-migration-stream.pandoc
> >> @@ -0,0 +1,672 @@
> >> +% LibXenCtrl Domain Image Format
> >> +% David Vrabel <<david.vrabel@citrix.com>>
> >> +  Andrew Cooper <<andrew.cooper3@citrix.com>>
> >> +% Draft G
> > No longer a draft? Perhaps s/Draft/Version/?
> 
> Strictly speaking it is still a draft until migration v2 becomes enabled
> by default.  This is one of the areas I was going to cover with my
> post-libxl cleanup patches.

Good point & sounds good, thanks.

Ian.