From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58521) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z4shJ-0003Z1-Bp for qemu-devel@nongnu.org; Tue, 16 Jun 2015 11:22:46 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z4shD-0003Pk-IG for qemu-devel@nongnu.org; Tue, 16 Jun 2015 11:22:45 -0400 Received: from mx1.redhat.com ([209.132.183.28]:60971) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z4shD-0003Pf-46 for qemu-devel@nongnu.org; Tue, 16 Jun 2015 11:22:39 -0400 Received: from int-mx14.intmail.prod.int.phx2.redhat.com (int-mx14.intmail.prod.int.phx2.redhat.com [10.5.11.27]) by mx1.redhat.com (Postfix) with ESMTPS id BEC9F2F1470 for ; Tue, 16 Jun 2015 15:22:38 +0000 (UTC) Message-ID: <55803F34.9050203@redhat.com> Date: Tue, 16 Jun 2015 09:22:28 -0600 From: Eric Blake MIME-Version: 1.0 References: <1434463863-26560-1-git-send-email-ghammer@redhat.com> <1434463863-26560-2-git-send-email-ghammer@redhat.com> In-Reply-To: <1434463863-26560-2-git-send-email-ghammer@redhat.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="wrxO9LOQEkDxBXdmrJqLkhcejlHKbGV2L" Subject: Re: [Qemu-devel] [PATCH V16 1/4] docs: vm generation id device's description List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Gal Hammer , qemu-devel@nongnu.org Cc: pbonzini@redhat.com, imammedo@redhat.com, mst@redhat.com This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --wrxO9LOQEkDxBXdmrJqLkhcejlHKbGV2L Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 06/16/2015 08:11 AM, Gal Hammer wrote: > Signed-off-by: Gal Hammer > --- > docs/specs/vmgenid.txt | 33 +++++++++++++++++++++++++++++++++ > 1 file changed, 33 insertions(+) > create mode 100644 docs/specs/vmgenid.txt >=20 > diff --git a/docs/specs/vmgenid.txt b/docs/specs/vmgenid.txt > new file mode 100644 > index 0000000..d06977a > --- /dev/null > +++ b/docs/specs/vmgenid.txt > @@ -0,0 +1,33 @@ > +VIRTUAL MACHINE GENERATION ID > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D > + > +Copyright (C) 2015 Red Hat, Inc. > + > +This work is licensed under the terms of the GNU GPL, version 2 or lat= er. > +See the COPYING file in the top-level directory. > + > +=3D=3D=3D > + > +The VM generation ID (vmgenid) device is an emulated device which > +is expected to exposes a 128-bit, cryptographically random, integer va= lue s/exposes/expose/ > +identifier, provided by a management system (It is NOT in the device's= > +responsibilty to ensure that the value is cryptographically random). s/responsibilty/responsibility/ > + > +This allows management applications (e.g. libvirt) to notify the guest= > +operating system when the virtual machine is executed with a different= > +configuration (e.g. snapshot execution or creation from a template). > + > +This is specified on the web at: http://go.microsoft.com/fwlink/?LinkI= d=3D260709 > + Hopefully the link doesn't go stale too soon (when the cover page states the same address, and the disclaimer "Information ... in this document, URL and other Internet website references, may change without notice"). On the other hand, the document is fairly loosely licensed ("You may copy and use this document for your internal, reference purposes") even if done in a non-free .docx format. Do we need to hedge our bets and save a copy of it in the qemu wiki? > +--- > + > +The vmgenid device is a device with the following ACPI ID: "QEMU0002".= > + > +It has two properties: > + > +uuid - The virtual machine generation ID (A required UUID string) > +addr - The uuid memory location (A 64-bit address, defaults to 0xfedf0= 000) > + > +According to the specification, any change to the GUID executes an > +ACPI notification. The vmgenid device triggers the GPE._E00 which > +executes the ACPI Notify operation. Still would be nice for this document to contain sample QMP commands for getting at the QOM object necessary for changing the id exposed to the guest via this device (that is, not only talk about how the device is implemented in the ACPI view of the guest, but also how the device is managed from the application driving qemu). --=20 Eric Blake eblake redhat com +1-919-301-3266 Libvirt virtualization library http://libvirt.org --wrxO9LOQEkDxBXdmrJqLkhcejlHKbGV2L Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Public key at http://people.redhat.com/eblake/eblake.gpg Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCAAGBQJVgD80AAoJEKeha0olJ0Nq9UMIALDraqXQ32fx44Xrm+0G4Fyu 4B5AjQOhTwtaxW+9s6YszYFuUCQp4mE56W6f+qLhIvsYWbxsuS4685Swz1EP8lVU wRe6Exa/Y6tA43f0ny8b7Xy3NsPhIBbqwmELwgApgnOHy909/RQ/N6oorB/11qJg SDUzTDy+ofIXT1k68WqtLKY2Z4eYU8vFlivNbTihfDrsEBysVKfugcKAunimD0fm mqVKW9QKQiIWh/ksKV4LbDkBEdZmOE4TK68zyJ9MbxKOB94gv/7oCbI5Ku6Florn eL/KxkQI9fuB2LbnWQP8RxhKkv8KfoJTxkGjdk1VGNS8S85M3JTNlHZs6nijCxg= =KB+B -----END PGP SIGNATURE----- --wrxO9LOQEkDxBXdmrJqLkhcejlHKbGV2L--