[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 12/12] docs/system: add a basic enumeration of vhost-user devices
From: |
Alex Bennée |
Subject: |
[PATCH 12/12] docs/system: add a basic enumeration of vhost-user devices |
Date: |
Fri, 14 Apr 2023 17:04:33 +0100 |
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
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..99b352823e 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
+ - You must manually specify ``virtio-id`` and the correct ``num_vqs``
+ * - 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
- [PATCH 00/12] virtio: add vhost-user-generic and reduce copy and paste, Alex Bennée, 2023/04/14
- [PATCH 03/12] include/hw/virtio: add kerneldoc for virtio_init, Alex Bennée, 2023/04/14
- [PATCH 02/12] include/hw/virtio: document virtio_notify_config, Alex Bennée, 2023/04/14
- [PATCH 06/12] virtio: add PCI stub for vhost-user-device, Alex Bennée, 2023/04/14
- [PATCH 01/12] hw/virtio: fix typo in VIRTIO_CONFIG_IRQ_IDX comments, Alex Bennée, 2023/04/14
- [PATCH 12/12] docs/system: add a basic enumeration of vhost-user devices,
Alex Bennée <=
- [PATCH 11/12] hw/virtio: derive vhost-user-gpio from vhost-user-device (!BROKEN), Alex Bennée, 2023/04/14
- [PATCH 05/12] virtio: add generic vhost-user-device, Alex Bennée, 2023/04/14
- [PATCH 09/12] hw/virtio: derive vhost-user-rng from vhost-user-device, Alex Bennée, 2023/04/14
- [PATCH 04/12] include/hw/virtio: document some more usage of notifiers, Alex Bennée, 2023/04/14
- [PATCH 10/12] hw/virtio: add config support to vhost-user-device, Alex Bennée, 2023/04/14
- [PATCH 08/12] qom: allow for properties to become "fixed", Alex Bennée, 2023/04/14
- [PATCH 07/12] include: attempt to document device_class_set_props, Alex Bennée, 2023/04/14