From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:52771) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T1hi1-00039N-UZ for qemu-devel@nongnu.org; Wed, 15 Aug 2012 13:48:46 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T1hi0-0007oR-Mp for qemu-devel@nongnu.org; Wed, 15 Aug 2012 13:48:45 -0400 Received: from mx1.redhat.com ([209.132.183.28]:55526) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T1hi0-0007o6-Es for qemu-devel@nongnu.org; Wed, 15 Aug 2012 13:48:44 -0400 Message-ID: <502BE0C7.2000608@redhat.com> Date: Wed, 15 Aug 2012 11:47:51 -0600 From: Eric Blake MIME-Version: 1.0 References: <1345042466-31743-1-git-send-email-benoit@irqsave.net> <1345042466-31743-3-git-send-email-benoit@irqsave.net> <502BCBB2.4030301@redhat.com> In-Reply-To: <502BCBB2.4030301@redhat.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="------------enig6B1DB72A9A5227E99DA26EC1" Subject: Re: [Qemu-devel] [PATCH 2/3] qapi: Add ImageInfo. List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: aliguori@us.ibm.com, =?UTF-8?B?QmVub8OudCBDYW5ldA==?= , =?UTF-8?B?QmVub8OudCBDYW5ldA==?= , qemu-devel@nongnu.org, pbonzini@redhat.com, xiawenc@linux.vnet.ibm.com, stefanha@linux.vnet.ibm.com This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig6B1DB72A9A5227E99DA26EC1 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 08/15/2012 10:17 AM, Eric Blake wrote: > On 08/15/2012 08:54 AM, Beno=C3=AEt Canet wrote: >> Signed-off-by: Benoit Canet >> --- >> qapi-schema.json | 33 +++++++++++++++++++++++++++++++++ >> 1 file changed, 33 insertions(+) >> +# @ImageInfo: >> +# >> +# Information about a QEMU image file >> +# >> +# @filename: name of the image file >> +# >> +# @format: format of the image file These always exist. >> +# >> +# @dirty-flag: true if image is not cleanly closed This exists for QED and qcow2v3, but not for raw or qcow2 without v3 extensions, so probably worth marking #optional >> +# >> +# @cluster-size: size of a cluster in bytes This exists for qcow2, but not for raw, so probably worth marking #option= al >> +# >> +# @encrypted: true if the image is encrypted Again, probably #optional >> +# >> +# @actual-size: actual size on disk in bytes of the image Always exists. But is this the size of the contents seen by the guest, or the size of the metadata seen by the host? Both numbers are useful. >> +# >> +# @virtual-size: maximum capacity in bytes of the image Tough call. For qcow2, this would be read from the metadata. For raw, do we list the current size of the file, or do we list the size of free space on the file system containing the file, or do we omit it for raw? >> +# >> +# @backing-filename: name of the backing file >=20 > Should this be #optional, in the case where there is no backing file? >=20 > Missing @backing-filename-format, when that is recorded (as long as > we're going for machine-parseable, print everything useful, even if > qemu-img info doesn't print it right now). Definitely #optional, since= > it won't be present when @backing-filename is missing, and even when a > backing file name is present, the format might not have been recorded. >=20 >> +# >> +# @snapshots: list of VM snapshots >=20 > Should this be #optional, in the case where there are no snapshots? >=20 >> +# >> +# Since: 1.3 >=20 > So no way it will make 1.2 hard freeze today :) Actually, I'd like to see this in 1.2, if we can muster up enough other reviewers. --=20 Eric Blake eblake@redhat.com +1-919-301-3266 Libvirt virtualization library http://libvirt.org --------------enig6B1DB72A9A5227E99DA26EC1 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) Comment: Public key at http://people.redhat.com/eblake/eblake.gpg Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQEcBAEBCAAGBQJQK+DHAAoJEKeha0olJ0NqM0oIAIJNU4ei/judFEz9J+c0E0Oa dZR3uGOL9foHdhjDnbZ7YC1JY5Kzn2DuNV54AndK+OMoKR2KiFL0mcZFgS/tPAD6 FVpiO5haZVloAKCNSHlONbq9/G8kVHLlriEaCmlwM+JhB3/Sd9C0gMU7WCXM2tYA zQ7fyL3+uNUcdqIAeB+mh68k6R5iL9HIxW4MtYVjhkcD0bfqVz8yQtzebrNxcyKN 8bpUlW4X2L1CQh4BUlavjO0r/PezeY69pCKYetT8ba7YmyzYlYTkPg4F2mSzHy03 a7XGJGcnK4I9rsdxyIYbwzl+dxlYZORqxXsY20b2tnoBq5CO/7HuTNQwBboxDAM= =oVig -----END PGP SIGNATURE----- --------------enig6B1DB72A9A5227E99DA26EC1--