From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Alex Bennée" <alex.bennee@linaro.org>,
"Lukas Straub" <lukasstraub2@web.de>,
"Vladimir Sementsov-Ogievskiy" <vsementsov@yandex-team.ru>,
"Zhao Liu" <zhao1.liu@intel.com>,
"Laurent Vivier" <laurent@vivier.eu>,
"Markus Armbruster" <armbru@redhat.com>,
"Gonglei (Arei)" <arei.gonglei@huawei.com>,
"Philippe Mathieu-Daudé" <philmd@mailo.com>,
"Alex Williamson" <alex@shazbot.org>,
"zhenwei pi" <zhenwei.pi@linux.dev>,
"Hanna Reitz" <hreitz@redhat.com>,
"Ani Sinha" <anisinha@redhat.com>,
qemu-block@nongnu.org, "Paolo Bonzini" <pbonzini@redhat.com>,
"Peter Xu" <peterx@redhat.com>, "Kevin Wolf" <kwolf@redhat.com>,
linux-cxl@vger.kernel.org, "Jiri Pirko" <jiri@resnulli.us>,
"Daniel P. Berrangé" <berrange@redhat.com>,
"Stefan Berger" <stefanb@linux.vnet.ibm.com>,
"Fabiano Rosas" <farosas@suse.de>, "John Snow" <jsnow@redhat.com>,
"Stefan Hajnoczi" <stefanha@redhat.com>,
"Michael Tokarev" <mjt@tls.msk.ru>,
"Igor Mammedov" <imammedo@redhat.com>,
"Michael S. Tsirkin" <mst@redhat.com>,
"Gerd Hoffmann" <kraxel@redhat.com>,
"Mauro Carvalho Chehab" <mchehab+huawei@kernel.org>,
linux-edac@vger.kernel.org,
"Marc-André Lureau" <marcandre.lureau@redhat.com>,
"Richard Henderson" <richard.henderson@linaro.org>,
"Eric Blake" <eblake@redhat.com>,
"Cédric Le Goater" <clg@redhat.com>,
"Jason Wang" <jasowangio@gmail.com>,
qemu-trivial@nongnu.org, "Jonathan Cameron" <jic23@kernel.org>
Subject: [PATCH v2 38/44] qapi: convert intro sections for virtio.json
Date: Thu, 23 Jul 2026 00:47:59 -0400 [thread overview]
Message-ID: <20260723044805.527643-39-jsnow@redhat.com> (raw)
In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com>
(Trivial)
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/virtio.json | 91 +++++++++++++++++++-----------------------------
1 file changed, 36 insertions(+), 55 deletions(-)
diff --git a/qapi/virtio.json b/qapi/virtio.json
index 1fc4e38a44d..0a4753cc343 100644
--- a/qapi/virtio.json
+++ b/qapi/virtio.json
@@ -10,8 +10,7 @@
##
# @VirtioInfo:
-#
-# Basic information about a given VirtIODevice
+# Basic information about a given VirtIODevice
#
# @path: The VirtIODevice's canonical QOM path
#
@@ -25,8 +24,7 @@
##
# @x-query-virtio:
-#
-# Return a list of all realized VirtIODevices
+# Return a list of all realized VirtIODevices
#
# Features:
#
@@ -69,9 +67,8 @@
##
# @VhostStatus:
-#
-# Information about a vhost device. This information will only be
-# displayed if the vhost device is active.
+# Information about a vhost device. This information will only be
+# displayed if the vhost device is active.
#
# @n-mem-sections: vhost_dev n_mem_sections
#
@@ -112,10 +109,9 @@
##
# @VirtioStatus:
-#
-# Full status of the virtio device with most VirtIODevice members.
-# Also includes the full status of the corresponding vhost device if
-# the vhost device is active.
+# Full status of the virtio device with most VirtIODevice members.
+# Also includes the full status of the corresponding vhost device
+# if the vhost device is active.
#
# @name: VirtIODevice name
#
@@ -189,8 +185,7 @@
##
# @x-query-virtio-status:
-#
-# Poll for a comprehensive status of a given virtio device
+# Poll for a comprehensive status of a given virtio device
#
# @path: Canonical QOM path of the VirtIODevice
#
@@ -442,9 +437,8 @@
##
# @VirtioDeviceStatus:
-#
-# A structure defined to list the configuration statuses of a virtio
-# device
+# A structure defined to list the configuration statuses of a
+# virtio device
#
# @statuses: List of decoded configuration statuses of the virtio
# device
@@ -460,9 +454,8 @@
##
# @VhostDeviceProtocols:
-#
-# A structure defined to list the vhost user protocol features of a
-# Vhost User device
+# A structure defined to list the vhost user protocol features of
+# a Vhost User device
#
# @protocols: List of decoded vhost user protocol features of a vhost
# user device
@@ -478,9 +471,9 @@
##
# @VirtioDeviceFeatures:
-#
-# The common fields that apply to most Virtio devices. Some devices
-# may not have their own device-specific features (e.g. virtio-rng).
+# The common fields that apply to most Virtio devices. Some
+# devices may not have their own device-specific features
+# (e.g. virtio-rng).
#
# @transports: List of transport features of the virtio device
#
@@ -503,9 +496,8 @@
##
# @VirtQueueStatus:
-#
-# Information of a VirtIODevice VirtQueue, including most members of
-# the VirtQueue data structure.
+# Information of a VirtIODevice VirtQueue, including most members
+# of the VirtQueue data structure.
#
# @name: Name of the VirtIODevice that uses this VirtQueue
#
@@ -556,8 +548,7 @@
##
# @x-query-virtio-queue-status:
-#
-# Return the status of a given VirtIODevice's VirtQueue
+# Return the status of a given VirtIODevice's VirtQueue
#
# @path: VirtIODevice canonical QOM path
#
@@ -640,9 +631,8 @@
##
# @VirtVhostQueueStatus:
-#
-# Information of a vhost device's vhost_virtqueue, including most
-# members of the vhost_dev vhost_virtqueue data structure.
+# Information of a vhost device's vhost_virtqueue, including most
+# members of the vhost_dev vhost_virtqueue data structure.
#
# @name: Name of the VirtIODevice that uses this vhost_virtqueue
#
@@ -682,8 +672,7 @@
##
# @x-query-virtio-vhost-queue-status:
-#
-# Return information of a given vhost device's vhost_virtqueue
+# Return information of a given vhost device's vhost_virtqueue
#
# @path: VirtIODevice canonical QOM path
#
@@ -746,8 +735,7 @@
##
# @VirtioRingDesc:
-#
-# Information regarding the vring descriptor area
+# Information regarding the vring descriptor area
#
# @addr: Guest physical address of the descriptor area
#
@@ -764,8 +752,7 @@
##
# @VirtioRingAvail:
-#
-# Information regarding the avail vring (a.k.a. driver area)
+# Information regarding the avail vring (a.k.a. driver area)
#
# @flags: VRingAvail flags
#
@@ -782,8 +769,7 @@
##
# @VirtioRingUsed:
-#
-# Information regarding the used vring (a.k.a. device area)
+# Information regarding the used vring (a.k.a. device area)
#
# @flags: VRingUsed flags
#
@@ -797,9 +783,8 @@
##
# @VirtioQueueElement:
-#
-# Information regarding a VirtQueue's VirtQueueElement including
-# descriptor, driver, and device areas
+# Information regarding a VirtQueue's VirtQueueElement including
+# descriptor, driver, and device areas
#
# @name: Name of the VirtIODevice that uses this VirtQueue
#
@@ -822,8 +807,7 @@
##
# @x-query-virtio-queue-element:
-#
-# Return the information about a VirtQueue's VirtQueueElement
+# Return the information about a VirtQueue's VirtQueueElement
#
# @path: VirtIODevice canonical QOM path
#
@@ -933,8 +917,7 @@
##
# @IOThreadVirtQueueMapping:
-#
-# Describes the subset of virtqueues assigned to an IOThread.
+# Describes the subset of virtqueues assigned to an IOThread.
#
# @iothread: the id of IOThread object
#
@@ -951,13 +934,12 @@
##
# @VirtIOGPUOutput:
-#
-# Describes configuration of a VirtIO GPU output. If both @xres and
-# @yres are set, they take precedence over root virtio-gpu resolution
-# configuration and enable the corresponding output. If none of @xres
-# and @yres are set, root virtio-gpu resolution configuration takes
-# precedence and only the first output is enabled. Only setting one
-# of @xres or @yres is an error.
+# Describes configuration of a VirtIO GPU output. If both @xres
+# and @yres are set, they take precedence over root virtio-gpu
+# resolution configuration and enable the corresponding output.
+# If none of @xres and @yres are set, root virtio-gpu resolution
+# configuration takes precedence and only the first output is
+# enabled. Only setting one of @xres or @yres is an error.
#
# @name: the name of the output
#
@@ -973,9 +955,8 @@
##
# @DummyVirtioForceArrays:
-#
-# Not used by QMP; hack to let us use IOThreadVirtQueueMappingList and
-# VirtIOGPUOutputList internally
+# Not used by QMP; hack to let us use IOThreadVirtQueueMappingList
+# and VirtIOGPUOutputList internally
#
# Since: 9.0
##
--
2.55.0
next prev parent reply other threads:[~2026-07-23 4:54 UTC|newest]
Thread overview: 52+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-23 4:47 [PATCH v2 00/44] qapi: convert trivial intro sections John Snow
2026-07-23 4:47 ` [PATCH v2 01/44] qapi: convert intro sections for error.json John Snow
2026-07-23 4:47 ` [PATCH v2 02/44] qapi: convert intro sections for acpi-hest.json John Snow
2026-07-23 7:29 ` Mauro Carvalho Chehab
2026-07-23 4:47 ` [PATCH v2 03/44] qapi: convert intro sections for ebpf.json John Snow
2026-07-23 4:47 ` [PATCH v2 04/44] qapi: convert intro sections for uefi.json John Snow
2026-07-23 4:47 ` [PATCH v2 05/44] qapi: convert trivial intro sections for compat.json John Snow
2026-07-23 4:47 ` [PATCH v2 06/44] qapi: convert intro sections for vfio.json John Snow
2026-07-23 4:47 ` [PATCH v2 07/44] qapi: convert intro sections for trace.json John Snow
2026-07-23 4:47 ` [PATCH v2 08/44] qapi: convert trivial intro sections for misc-arm.json John Snow
2026-07-23 4:47 ` [PATCH v2 09/44] qapi: convert intro sections for cryptodev.json John Snow
2026-07-23 9:11 ` zhenwei pi
2026-07-23 4:47 ` [PATCH v2 10/44] qapi: convert intro sections for machine-common.json John Snow
2026-07-23 4:47 ` [PATCH v2 11/44] qapi: convert intro sections for accelerator.json John Snow
2026-07-23 4:47 ` [PATCH v2 12/44] qapi: convert intro sections for authz.json John Snow
2026-07-23 4:47 ` [PATCH v2 13/44] qapi: convert trivial intro sections for yank.json John Snow
2026-07-23 10:19 ` Lukas Straub
2026-07-23 4:47 ` [PATCH v2 14/44] qapi: convert intro sections for replay.json John Snow
2026-07-23 4:47 ` [PATCH v2 15/44] qapi: convert trivial intro sections for machine-s390x.json John Snow
2026-07-23 4:47 ` [PATCH v2 16/44] qapi: convert trivial intro sections for acpi.json John Snow
2026-07-23 4:47 ` [PATCH v2 17/44] qapi: convert intro sections for tpm.json John Snow
2026-07-23 4:47 ` [PATCH v2 18/44] qapi: convert trivial intro sections for qdev.json John Snow
2026-07-23 4:47 ` [PATCH v2 19/44] qapi: convert trivial intro sections for control.json John Snow
2026-07-23 4:47 ` [PATCH v2 20/44] qapi: convert intro sections for dump.json John Snow
2026-07-23 4:47 ` [PATCH v2 21/44] qapi: convert intro sections for common.json John Snow
2026-07-23 4:47 ` [PATCH v2 22/44] qapi: convert intro sections for sockets.json John Snow
2026-07-23 4:47 ` [PATCH v2 23/44] qapi: convert trivial intro sections for transaction.json John Snow
2026-07-23 4:47 ` [PATCH v2 24/44] qapi: convert trivial intro sections for stats.json John Snow
2026-07-23 4:47 ` [PATCH v2 25/44] qapi: convert trivial intro sections for job.json John Snow
2026-07-23 4:47 ` [PATCH v2 26/44] qapi: convert intro sections for pci.json John Snow
2026-07-23 4:47 ` [PATCH v2 27/44] qapi: convert trivial intro sections for introspect.json John Snow
2026-07-23 4:47 ` [PATCH v2 28/44] qapi: convert intro sections for rocker.json John Snow
2026-07-23 4:47 ` [PATCH v2 29/44] qapi: convert trivial intro sections for misc-i386.json John Snow
2026-07-23 4:47 ` [PATCH v2 30/44] qapi: convert trivial intro sections for block-export.json John Snow
2026-07-23 4:47 ` [PATCH v2 31/44] qapi: convert intro sections for audio.json John Snow
2026-07-23 4:47 ` [PATCH v2 32/44] qapi: convert trivial intro sections for block.json John Snow
2026-07-23 4:47 ` [PATCH v2 33/44] qapi: convert trivial intro sections for misc.json John Snow
2026-07-23 4:47 ` [PATCH v2 34/44] qapi: convert trivial intro sections for crypto.json John Snow
2026-07-23 4:47 ` [PATCH v2 35/44] qapi: convert intro sections for cxl.json John Snow
2026-07-23 4:47 ` [PATCH v2 36/44] qapi: convert trivial intro sections for run-state.json John Snow
2026-07-23 4:47 ` [PATCH v2 37/44] qapi: convert intro sections for char.json John Snow
2026-07-23 4:47 ` John Snow [this message]
2026-07-23 4:48 ` [PATCH v2 39/44] qapi: convert trivial intro sections for net.json John Snow
2026-07-23 4:48 ` [PATCH v2 40/44] qapi: convert trivial intro sections for qom.json John Snow
2026-07-23 13:00 ` Markus Armbruster
2026-07-23 4:48 ` [PATCH v2 41/44] qapi: convert trivial intro sections for ui.json John Snow
2026-07-23 12:59 ` Markus Armbruster
2026-07-23 4:48 ` [PATCH v2 42/44] qapi: convert trivial intro sections for migration.json John Snow
2026-07-23 4:48 ` [PATCH v2 43/44] qapi: convert trivial intro sections for machine.json John Snow
2026-07-23 4:48 ` [PATCH v2 44/44] qapi: convert trivial intro sections for block-core.json John Snow
2026-07-23 13:01 ` Markus Armbruster
2026-07-23 12:57 ` [PATCH v2 00/44] qapi: convert trivial intro sections Markus Armbruster
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260723044805.527643-39-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=alex.bennee@linaro.org \
--cc=alex@shazbot.org \
--cc=anisinha@redhat.com \
--cc=arei.gonglei@huawei.com \
--cc=armbru@redhat.com \
--cc=berrange@redhat.com \
--cc=clg@redhat.com \
--cc=eblake@redhat.com \
--cc=farosas@suse.de \
--cc=hreitz@redhat.com \
--cc=imammedo@redhat.com \
--cc=jasowangio@gmail.com \
--cc=jic23@kernel.org \
--cc=jiri@resnulli.us \
--cc=kraxel@redhat.com \
--cc=kwolf@redhat.com \
--cc=laurent@vivier.eu \
--cc=linux-cxl@vger.kernel.org \
--cc=linux-edac@vger.kernel.org \
--cc=lukasstraub2@web.de \
--cc=marcandre.lureau@redhat.com \
--cc=mchehab+huawei@kernel.org \
--cc=mjt@tls.msk.ru \
--cc=mst@redhat.com \
--cc=pbonzini@redhat.com \
--cc=peterx@redhat.com \
--cc=philmd@mailo.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=qemu-trivial@nongnu.org \
--cc=richard.henderson@linaro.org \
--cc=stefanb@linux.vnet.ibm.com \
--cc=stefanha@redhat.com \
--cc=vsementsov@yandex-team.ru \
--cc=zhao1.liu@intel.com \
--cc=zhenwei.pi@linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox