From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Vrabel Subject: Re: [PATCH v5 RFC 01/14] docs: libxc migration stream specification Date: Thu, 12 Jun 2014 10:45:29 +0100 Message-ID: <539976B9.2000406@citrix.com> References: <1402510482-21099-1-git-send-email-andrew.cooper3@citrix.com> <1402510482-21099-2-git-send-email-andrew.cooper3@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <1402510482-21099-2-git-send-email-andrew.cooper3@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: Andrew Cooper , Xen-devel Cc: Ian Jackson , Ian Campbell List-Id: xen-devel@lists.xenproject.org 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 (and extended markdown format) and the documentation build system is extended to generate PDFs from pandoc documents.