[PATCH v2 38/44] qapi: convert intro sections for virtio.json
John Snow <[email protected]> Thu, 23 Jul 2026 00:47:59 -0400
| Newsgroups | org.nongnu.qemu-trivial,org.kernel.vger.linux-cxl,org.kernel.vger.linux-edac,org.nongnu.qemu-devel |
|---|---|
| Message-ID | <[email protected]> |
(Trivial) Signed-off-by: John Snow <[email protected]> --- 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