All of lore.kernel.org
 help / color / mirror / Atom feed
* [RFC PATCH] docs/interop: define STANDALONE protocol feature for vhost-user
@ 2023-07-04 12:36 ` Alex Bennée
  0 siblings, 0 replies; 42+ messages in thread
From: Alex Bennée @ 2023-07-04 12:36 UTC (permalink / raw)
  To: qemu-devel
  Cc: virtio-dev, slp, mst, marcandre.lureau, stefanha, viresh.kumar,
	sgarzare, takahiro.akashi, erik.schilling, manos.pitsidianakis,
	mathieu.poirier, Alex Bennée

Currently QEMU has to know some details about the back-end to be able
to setup the guest. While various parts of the setup can be delegated
to the backend (for example config handling) this is a very piecemeal
approach.

This patch suggests a new feature flag (VHOST_USER_PROTOCOL_F_STANDALONE)
which the back-end can advertise which allows a probe message to be
sent to get all the details QEMU needs to know in one message.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>

---
Initial RFC for discussion. I intend to prototype this work with QEMU
and one of the rust-vmm vhost-user daemons.
---
 docs/interop/vhost-user.rst | 37 +++++++++++++++++++++++++++++++++++++
 hw/virtio/vhost-user.c      |  8 ++++++++
 2 files changed, 45 insertions(+)

diff --git a/docs/interop/vhost-user.rst b/docs/interop/vhost-user.rst
index 5a070adbc1..85b1b1583a 100644
--- a/docs/interop/vhost-user.rst
+++ b/docs/interop/vhost-user.rst
@@ -275,6 +275,21 @@ Inflight description
 
 :queue size: a 16-bit size of virtqueues
 
+Backend specifications
+^^^^^^^^^^^^^^^^^^^^^^
+
++-----------+-------------+------------+------------+
+| device id | config size |   min_vqs  |   max_vqs  |
++-----------+-------------+------------+------------+
+
+:device id: a 32-bit value holding the VirtIO device ID
+
+:config size: a 32-bit value holding the config size (see ``VHOST_USER_GET_CONFIG``)
+
+:min_vqs: a 32-bit value holding the minimum number of vqs supported
+
+:max_vqs: a 32-bit value holding the maximum number of vqs supported, must be >= min_vqs
+
 C structure
 -----------
 
@@ -296,6 +311,7 @@ In QEMU the vhost-user message is implemented with the following struct:
           VhostUserConfig config;
           VhostUserVringArea area;
           VhostUserInflight inflight;
+          VhostUserBackendSpecs specs;
       };
   } QEMU_PACKED VhostUserMsg;
 
@@ -316,6 +332,7 @@ replies. Here is a list of the ones that do:
 * ``VHOST_USER_GET_VRING_BASE``
 * ``VHOST_USER_SET_LOG_BASE`` (if ``VHOST_USER_PROTOCOL_F_LOG_SHMFD``)
 * ``VHOST_USER_GET_INFLIGHT_FD`` (if ``VHOST_USER_PROTOCOL_F_INFLIGHT_SHMFD``)
+* ``VHOST_USER_GET_BACKEND_SPECS`` (if ``VHOST_USER_PROTOCOL_F_STANDALONE``)
 
 .. seealso::
 
@@ -885,6 +902,13 @@ Protocol features
   #define VHOST_USER_PROTOCOL_F_CONFIGURE_MEM_SLOTS  15
   #define VHOST_USER_PROTOCOL_F_STATUS               16
   #define VHOST_USER_PROTOCOL_F_XEN_MMAP             17
+  #define VHOST_USER_PROTOCOL_F_STANDALONE           18
+
+Some features are only valid in the presence of other supporting
+features. In the case of ``VHOST_USER_PROTOCOL_F_STANDALONE`` the
+backend must also support ``VHOST_USER_PROTOCOL_F_CONFIG`` and
+``VHOST_USER_PROTOCOL_F_STATUS``.
+
 
 Front-end message types
 -----------------------
@@ -1440,6 +1464,19 @@ Front-end message types
   query the back-end for its device status as defined in the Virtio
   specification.
 
+``VHOST_USER_GET_BACKEND_SPECS``
+  :id: 41
+  :request payload: N/A
+  :reply payload: ``Backend specifications``
+
+  When the ``VHOST_USER_PROTOCOL_F_STANDALONE`` protocol feature has been
+  successfully negotiated, this message is submitted by the front-end to
+  query the back-end for its capabilities. This is intended to remove
+  the need for the front-end to know ahead of time what the VirtIO
+  device the backend emulates is.
+
+  The reply contains the device id, size of the config space and the
+  range of VirtQueues the backend supports.
 
 Back-end message types
 ----------------------
diff --git a/hw/virtio/vhost-user.c b/hw/virtio/vhost-user.c
index c4e0cbd702..28b021d5d3 100644
--- a/hw/virtio/vhost-user.c
+++ b/hw/virtio/vhost-user.c
@@ -202,6 +202,13 @@ typedef struct VhostUserInflight {
     uint16_t queue_size;
 } VhostUserInflight;
 
+typedef struct VhostUserBackendSpecs {
+    uint32_t device_id;
+    uint32_t config_size;
+    uint32_t min_vqs;
+    uint32_t max_vqs;
+} VhostUserBackendSpecs;
+
 typedef struct {
     VhostUserRequest request;
 
@@ -226,6 +233,7 @@ typedef union {
         VhostUserCryptoSession session;
         VhostUserVringArea area;
         VhostUserInflight inflight;
+        VhostUserBackendSpecs specs;
 } VhostUserPayload;
 
 typedef struct VhostUserMsg {
-- 
2.39.2



^ permalink raw reply related	[flat|nested] 42+ messages in thread

end of thread, other threads:[~2023-07-26 19:07 UTC | newest]

Thread overview: 42+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-07-04 12:36 [RFC PATCH] docs/interop: define STANDALONE protocol feature for vhost-user Alex Bennée
2023-07-04 12:36 ` [virtio-dev] " Alex Bennée
2023-07-04 14:54 ` Stefano Garzarella
2023-07-04 14:54   ` Stefano Garzarella
2023-07-04 15:02   ` Alex Bennée
2023-07-04 15:02     ` Alex Bennée
2023-07-07 10:27     ` Stefano Garzarella
2023-07-07 10:27       ` Stefano Garzarella
2023-07-20 19:36       ` Stefan Hajnoczi
2023-07-26 16:01         ` Michael S. Tsirkin
2023-07-26 16:01           ` Michael S. Tsirkin
2023-07-26 14:33   ` Erik Schilling
2023-07-26 15:51     ` Stefan Hajnoczi
2023-07-06 16:31 ` Alex Bennée
2023-07-06 16:31   ` [virtio-dev] " Alex Bennée
2023-07-07 10:35   ` Stefano Garzarella
2023-07-07 10:35     ` [virtio-dev] " Stefano Garzarella
2023-07-06 16:48 ` Michael S. Tsirkin
2023-07-06 16:48   ` Michael S. Tsirkin
2023-07-07  7:58   ` [virtio-dev] " Alex Bennée
2023-07-07  7:58     ` Alex Bennée
2023-07-07  9:57     ` [virtio-dev] " Michael S. Tsirkin
2023-07-07  9:57       ` Michael S. Tsirkin
2023-07-07 13:12       ` Alex Bennée
2023-07-07 13:12         ` [virtio-dev] " Alex Bennée
2023-07-20 19:58   ` Stefan Hajnoczi
2023-07-20 19:58     ` Stefan Hajnoczi
2023-07-20 21:14     ` [virtio-dev] " Michael S. Tsirkin
2023-07-20 21:14       ` Michael S. Tsirkin
2023-07-20 21:31       ` Stefan Hajnoczi
2023-07-20 22:22         ` [virtio-dev] " Michael S. Tsirkin
2023-07-20 22:22           ` Michael S. Tsirkin
2023-07-24 18:08           ` [virtio-dev] " Stefan Hajnoczi
2023-07-24 18:08             ` Stefan Hajnoczi
2023-07-26 16:02             ` [virtio-dev] " Michael S. Tsirkin
2023-07-26 16:02               ` Michael S. Tsirkin
2023-07-26 17:37               ` [virtio-dev] " Stefan Hajnoczi
2023-07-26 17:37                 ` Stefan Hajnoczi
2023-07-20 19:32 ` Stefan Hajnoczi
2023-07-20 19:32   ` [virtio-dev] " Stefan Hajnoczi
2023-07-20 19:34 ` Stefan Hajnoczi
2023-07-20 19:34   ` [virtio-dev] " Stefan Hajnoczi

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.