summaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorAlex Bennée2022-08-02 11:49:54 +0200
committerMichael S. Tsirkin2022-10-07 15:41:51 +0200
commitc7066f2d30d6d9c7f83cf741afb2f489e0cdd16d (patch)
tree1c50b71a5981b0524f78f766c36b1b48ce854f41 /include
parentinclude/hw/virtio: more comment for VIRTIO_F_BAD_FEATURE (diff)
downloadqemu-c7066f2d30d6d9c7f83cf741afb2f489e0cdd16d.tar.gz
qemu-c7066f2d30d6d9c7f83cf741afb2f489e0cdd16d.tar.xz
qemu-c7066f2d30d6d9c7f83cf741afb2f489e0cdd16d.zip
include/hw: document vhost_dev feature life-cycle
Try and explicitly document the various state of feature bits as related to the vhost_dev structure. Importantly the backend_features can advertise things like VHOST_USER_F_PROTOCOL_FEATURES which is never exposed to the driver and is only present in the vhost-user feature negotiation. Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Acked-by: Jason Wang <jasowang@redhat.com> Message-Id: <20220802095010.3330793-7-alex.bennee@linaro.org> Reviewed-by: Michael S. Tsirkin <mst@redhat.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Diffstat (limited to 'include')
-rw-r--r--include/hw/virtio/vhost.h3
1 files changed, 3 insertions, 0 deletions
diff --git a/include/hw/virtio/vhost.h b/include/hw/virtio/vhost.h
index a346f23d13..586c5457e2 100644
--- a/include/hw/virtio/vhost.h
+++ b/include/hw/virtio/vhost.h
@@ -86,8 +86,11 @@ struct vhost_dev {
/* if non-zero, minimum required value for max_queues */
int num_queues;
uint64_t features;
+ /** @acked_features: final set of negotiated features */
uint64_t acked_features;
+ /** @backend_features: backend specific feature bits */
uint64_t backend_features;
+ /** @protocol_features: final negotiated protocol features */
uint64_t protocol_features;
uint64_t max_queues;
uint64_t backend_cap;