pvcalls: Document correctly and explicitely the padding for all arches
authorJulien Grall <jgrall@amazon.com>
Sat, 27 Jun 2020 09:55:33 +0000 (10:55 +0100)
committerStefano Stabellini <sstabellini@kernel.org>
Fri, 10 Jul 2020 16:52:24 +0000 (09:52 -0700)
commit02d69864b51a4302a148c28d6d391238a6778b4b
tree315eee1351dbaa6f6816275bd60ecf211c6876a2
parent8655fb5f468e85536d4647c9fdd5140005d56d83
pvcalls: Document correctly and explicitely the padding for all arches

The specification of pvcalls suggests there is padding for 32-bit x86 at
the end of most the structure. However, they are not described in in the
public header.

Because of that all the structures would have a different size between
32-bit x86 and 64-bit x86.

For all the other architectures supported (Arm and 64-bit x86), the
structure have the sames sizes because they contain implicit padding
thanks to the 64-bit alignment of the field uint64_t field.

Given the specification is authoritative, the padding will now be the
same for all architectures. The potential breakage of compatibility is
ought to be fine as pvcalls is still a tech preview.

Signed-off-by: Julien Grall <jgrall@amazon.com>
Reviewed-by: Juergen Gross <jgross@suse.com>
Reviewed-by: Stefano Stabellini <sstabellini@kernel.org>
Release-acked-by: Paul Durrant <paul@xen.org>
Signed-off-by: Stefano Stabellini <stefano.stabellini@xilinx.com>
docs/misc/pvcalls.pandoc
xen/include/public/io/pvcalls.h