[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 04/14] qapi/machine: Clarify query-uuid value when none has been s
From: |
Markus Armbruster |
Subject: |
[PULL 04/14] qapi/machine: Clarify query-uuid value when none has been specified |
Date: |
Wed, 17 Jul 2024 12:48:57 +0200 |
When no UUID has been specified, query-uuid returns
{"UUID": "00000000-0000-0000-0000-000000000000"}
The doc comment calls this "a null UUID", which I find less than
clear. RFC 9562 calls it "the nil UUID (all zeroes)", so use that
instead.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240711112228.2140606-4-armbru@redhat.com>
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>
[Wording improved, commit message adjusted]
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>
---
qapi/machine.json | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/qapi/machine.json b/qapi/machine.json
index 50ff102d56..eb2fd01e95 100644
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -305,9 +305,8 @@
#
# Since: 0.14
#
-# .. note:: If no UUID was specified for the guest, a null UUID is
-# returned.
-#
+# .. note:: If no UUID was specified for the guest, the nil UUID (all
+# zeroes) is returned.
##
{ 'struct': 'UuidInfo', 'data': {'UUID': 'str'} }
--
2.45.0
- [PULL 00/14] QAPI patches patches for 2024-07-17, Markus Armbruster, 2024/07/17
- [PULL 02/14] qapi/pci: Clean up documentation around PciDeviceClass, Markus Armbruster, 2024/07/17
- [PULL 04/14] qapi/machine: Clarify query-uuid value when none has been specified,
Markus Armbruster <=
- [PULL 03/14] qapi/machine: Clean up documentation around CpuInstanceProperties, Markus Armbruster, 2024/07/17
- [PULL 12/14] qapi: convert "Example" sections with titles, Markus Armbruster, 2024/07/17
- [PULL 06/14] qapi/ui: Drop note on naming of SpiceQueryMouseMode, Markus Armbruster, 2024/07/17
- [PULL 05/14] qapi/sockets: Move deprecation note out of SocketAddress doc comment, Markus Armbruster, 2024/07/17
- [PULL 01/14] qapi/qom: Document feature unstable of @x-vfio-user-server, Markus Armbruster, 2024/07/17
- [PULL 10/14] docs/sphinx: add CSS styling for qmp-example directive, Markus Armbruster, 2024/07/17
- [PULL 09/14] docs/qapidoc: add QMP highlighting to annotated qmp-example blocks, Markus Armbruster, 2024/07/17
- [PULL 14/14] qapi: remove "Example" doc section, Markus Armbruster, 2024/07/17
- [PULL 07/14] docs/qapidoc: factor out do_parse(), Markus Armbruster, 2024/07/17
- [PULL 11/14] qapi: convert "Example" sections without titles, Markus Armbruster, 2024/07/17