[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v2 13/13] docs/system: add a basic enumeration of vhost-user devi
From: |
Alex Bennée |
Subject: |
[PATCH v2 13/13] docs/system: add a basic enumeration of vhost-user devices |
Date: |
Tue, 18 Apr 2023 17:21:40 +0100 |
Make it clear the vhost-user-device is intended for expert use only.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
v2
- make clear vhost-user-device for expert use
---
docs/system/devices/vhost-user-rng.rst | 2 ++
docs/system/devices/vhost-user.rst | 41 ++++++++++++++++++++++++++
2 files changed, 43 insertions(+)
diff --git a/docs/system/devices/vhost-user-rng.rst
b/docs/system/devices/vhost-user-rng.rst
index a145d4105c..ead1405326 100644
--- a/docs/system/devices/vhost-user-rng.rst
+++ b/docs/system/devices/vhost-user-rng.rst
@@ -1,3 +1,5 @@
+.. _vhost_user_rng:
+
QEMU vhost-user-rng - RNG emulation
===================================
diff --git a/docs/system/devices/vhost-user.rst
b/docs/system/devices/vhost-user.rst
index 86128114fa..7038cece3e 100644
--- a/docs/system/devices/vhost-user.rst
+++ b/docs/system/devices/vhost-user.rst
@@ -15,6 +15,47 @@ to the guest. The code is mostly boilerplate although each
device has
a ``chardev`` option which specifies the ID of the ``--chardev``
device that connects via a socket to the vhost-user *daemon*.
+Each device will have an virtio-mmio and virtio-pci variant. See your
+platform details for what sort of virtio bus to use.
+
+.. list-table:: vhost-user devices
+ :widths: 20 20 60
+ :header-rows: 1
+
+ * - Device
+ - Type
+ - Notes
+ * - vhost-user-device
+ - Generic Development Device
+ - You must manually specify ``virtio-id`` and the correct ``num_vqs``.
Intended for expert use.
+ * - vhost-user-blk
+ - Block storage
+ -
+ * - vhost-user-fs
+ - File based storage driver
+ - See https://gitlab.com/virtio-fs/virtiofsd
+ * - vhost-user-scsi
+ - SCSI based storage
+ - See contrib/vhost-user/scsi
+ * - vhost-user-gpio
+ - Proxy gpio pins to host
+ - See https://github.com/rust-vmm/vhost-device
+ * - vhost-user-i2c
+ - Proxy i2c devices to host
+ - See https://github.com/rust-vmm/vhost-device
+ * - vhost-user-input
+ - Generic input driver
+ - See contrib/vhost-user-input
+ * - vhost-user-rng
+ - Entropy driver
+ - :ref:`vhost_user_rng`
+ * - vhost-user-gpu
+ - GPU driver
+ -
+ * - vhost-user-vsock
+ - Socket based communication
+ - See https://github.com/rust-vmm/vhost-device
+
vhost-user daemon
=================
--
2.39.2
- Re: [PATCH v2 06/13] include/hw/virtio: document some more usage of notifiers, (continued)
- [PATCH v2 12/13] hw/virtio: derive vhost-user-i2c from vhost-user-base, Alex Bennée, 2023/04/18
- [PATCH v2 10/13] hw/virtio: add config support to vhost-user-device, Alex Bennée, 2023/04/18
- [PATCH v2 11/13] hw/virtio: derive vhost-user-gpio from vhost-user-device, Alex Bennée, 2023/04/18
- [PATCH v2 09/13] hw/virtio: derive vhost-user-rng from vhost-user-device, Alex Bennée, 2023/04/18
- [PATCH v2 08/13] virtio: add PCI stub for vhost-user-device, Alex Bennée, 2023/04/18
- [PATCH v2 13/13] docs/system: add a basic enumeration of vhost-user devices,
Alex Bennée <=