#
# @name: Name of the VirtIODevice
#
-# Since: 7.1
-#
+# Since: 7.2
##
{ 'struct': 'VirtioInfo',
'data': { 'path': 'str',
# Returns a list of all realized VirtIODevices
#
# Features:
+#
# @unstable: This command is meant for debugging.
#
# Returns: List of gathered VirtIODevices
#
-# Since: 7.1
+# Since: 7.2
#
# Example:
#
# }
# ]
# }
-#
##
-
{ 'command': 'x-query-virtio',
'returns': [ 'VirtioInfo' ],
'features': [ 'unstable' ] }
##
# @VhostStatus:
#
-# Information about a vhost device. This information will only be
+# 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
#
# @log-size: vhost_dev log_size
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VhostStatus',
'data': { 'n-mem-sections': 'int',
'n-tmp-sections': 'int',
# @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.
+# Also includes the full status of the corresponding vhost device if
+# the vhost device is active.
#
# @name: VirtIODevice name
#
#
# @device-endian: VirtIODevice device_endian
#
-# @num-vqs: VirtIODevice virtqueue count. This is the number of active
-# virtqueues being used by the VirtIODevice.
+# @num-vqs: VirtIODevice virtqueue count. This is the number of
+# active virtqueues being used by the VirtIODevice.
#
# @status: VirtIODevice configuration status (VirtioDeviceStatus)
#
#
# @use-guest-notifier-mask: VirtIODevice use_guest_notifier_mask flag
#
-# @vhost-dev: Corresponding vhost device info for a given VirtIODevice.
-# Present if the given VirtIODevice has an active vhost
-# device.
-#
-# Since: 7.1
+# @vhost-dev: Corresponding vhost device info for a given
+# VirtIODevice. Present if the given VirtIODevice has an active
+# vhost device.
#
+# Since: 7.2
##
-
{ 'struct': 'VirtioStatus',
'data': { 'name': 'str',
'device-id': 'uint16',
# @path: Canonical QOM path of the VirtIODevice
#
# Features:
+#
# @unstable: This command is meant for debugging.
#
# Returns: VirtioStatus of the virtio device
#
-# Since: 7.1
+# Since: 7.2
#
# Examples:
#
# },
# "backend-features": {
# "dev-features": [
-# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protocol features negotation supported",
+# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protocol features negotiation supported",
# "VIRTIO_NET_F_GSO: Handling GSO-type packets supported",
# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set through control channel",
# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratuitous packets supported",
# },
# "host-features": {
# "dev-features": [
-# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protocol features negotation supported",
+# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protocol features negotiation supported",
# "VIRTIO_NET_F_GSO: Handling GSO-type packets supported",
# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set through control channel",
# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratuitous packets supported",
# "use-started": true
# }
# }
-#
##
-
{ 'command': 'x-query-virtio-status',
'data': { 'path': 'str' },
'returns': 'VirtioStatus',
# device
#
# @statuses: List of decoded configuration statuses of the virtio
-# device
+# device
#
-# @unknown-statuses: Virtio device statuses bitmap that have not been decoded
+# @unknown-statuses: Virtio device statuses bitmap that have not been
+# decoded
#
-# Since: 7.1
+# Since: 7.2
##
-
{ 'struct': 'VirtioDeviceStatus',
'data': { 'statuses': [ 'str' ],
'*unknown-statuses': 'uint8' } }
# Vhost User device
#
# @protocols: List of decoded vhost user protocol features of a vhost
-# user device
+# user device
#
# @unknown-protocols: Vhost user device protocol features bitmap that
-# have not been decoded
+# have not been decoded
#
-# Since: 7.1
+# Since: 7.2
##
-
{ 'struct': 'VhostDeviceProtocols',
'data': { 'protocols': [ 'str' ],
'*unknown-protocols': 'uint64' } }
##
# @VirtioDeviceFeatures:
#
-# The common fields that apply to most Virtio devices. Some devices
+# 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
#
# @dev-features: List of device-specific features (if the device has
-# unique features)
+# unique features)
#
# @unknown-dev-features: Virtio device features bitmap that have not
-# been decoded
+# been decoded
#
-# Since: 7.1
+# Since: 7.2
##
-
{ 'struct': 'VirtioDeviceFeatures',
'data': { 'transports': [ 'str' ],
'*dev-features': [ 'str' ],
# @vring-used: VirtQueue vring.used (device area)
#
# @last-avail-idx: VirtQueue last_avail_idx or return of vhost_dev
-# vhost_get_vring_base (if vhost active)
+# vhost_get_vring_base (if vhost active)
#
# @shadow-avail-idx: VirtQueue shadow_avail_idx
#
#
# @signalled-used-valid: VirtQueue signalled_used_valid flag
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtQueueStatus',
'data': { 'name': 'str',
'queue-index': 'uint16',
# @queue: VirtQueue index to examine
#
# Features:
+#
# @unstable: This command is meant for debugging.
#
# Returns: VirtQueueStatus of the VirtQueue
#
-# Notes: last_avail_idx will not be displayed in the case where
-# the selected VirtIODevice has a running vhost device and
-# the VirtIODevice VirtQueue index (queue) does not exist for
-# the corresponding vhost device vhost_virtqueue. Also,
-# shadow_avail_idx will not be displayed in the case where
-# the selected VirtIODevice has a running vhost device.
+# Notes: last_avail_idx will not be displayed in the case where the
+# selected VirtIODevice has a running vhost device and the
+# VirtIODevice VirtQueue index (queue) does not exist for the
+# corresponding vhost device vhost_virtqueue. Also,
+# shadow_avail_idx will not be displayed in the case where the
+# selected VirtIODevice has a running vhost device.
#
-# Since: 7.1
+# Since: 7.2
#
# Examples:
#
# "vring-num": 128
# }
# }
-#
##
-
{ 'command': 'x-query-virtio-queue-status',
'data': { 'path': 'str', 'queue': 'uint16' },
'returns': 'VirtQueueStatus',
#
# @used-size: vhost_virtqueue used_size
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtVhostQueueStatus',
'data': { 'name': 'str',
'kick': 'int',
# @queue: vhost_virtqueue index to examine
#
# Features:
+#
# @unstable: This command is meant for debugging.
#
# Returns: VirtVhostQueueStatus of the vhost_virtqueue
#
-# Since: 7.1
+# Since: 7.2
#
# Examples:
#
# "kick": 0
# }
# }
-#
##
-
{ 'command': 'x-query-virtio-vhost-queue-status',
'data': { 'path': 'str', 'queue': 'uint16' },
'returns': 'VirtVhostQueueStatus',
#
# @flags: List of descriptor flags
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtioRingDesc',
'data': { 'addr': 'uint64',
'len': 'uint32',
#
# @ring: VRingAvail ring[] entry at provided index
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtioRingAvail',
'data': { 'flags': 'uint16',
'idx': 'uint16',
#
# @idx: VRingUsed index
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtioRingUsed',
'data': { 'flags': 'uint16',
'idx': 'uint16' } }
#
# @used: VRingUsed info
#
-# Since: 7.1
-#
+# Since: 7.2
##
-
{ 'struct': 'VirtioQueueElement',
'data': { 'name': 'str',
'index': 'uint32',
#
# @queue: VirtQueue index to examine
#
-# @index: Index of the element in the queue
-# (default: head of the queue)
+# @index: Index of the element in the queue (default: head of the
+# queue)
#
# Features:
+#
# @unstable: This command is meant for debugging.
#
# Returns: VirtioQueueElement information
#
-# Since: 7.1
+# Since: 7.2
#
# Examples:
#
# }
# }
# }
-#
##
-
{ 'command': 'x-query-virtio-queue-element',
'data': { 'path': 'str', 'queue': 'uint16', '*index': 'uint16' },
'returns': 'VirtioQueueElement',