From mboxrd@z Thu Jan  1 00:00:00 1970
From: Andrew Cooper <andrew.cooper3@citrix.com>
Subject: Re: [PATCH v10 14/15] docs: libxc migration stream
	specification
Date: Tue, 5 May 2015 14:04:47 +0100
Message-ID: <5548BFEF.7010206@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>
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: <1430830994.2660.87.camel@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: Ian Campbell <ian.campbell@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 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.

~Andrew