c300b8e80b
- vfio/migration: Add support for manual clear vfio dirty log - vfio: Maintain DMA mapping range for the container - linux-headers: update against 5.10 and manual clear vfio dirty log series - arm/acpi: Fix when make qemu-system-aarch64 at x86_64 host bios_tables_test fail reason: __aarch64__ macro let build_pptt at x86_64 and aarch64 host build different function that let bios_tables_test fail. - pl031: support rtc-timer property for pl031 - feature: Add logs for vm start and destroy - feature: Add log for each modules - log: Add log at boot & cpu init for aarch64 - bugfix: irq: Avoid covering object refcount of qemu_irq - i386: cache passthrough: Update AMD 8000_001D.EAX[25:14] based on vCPU topo - freeclock: set rtc_date_diff for X86 - freeclock: set rtc_date_diff for arm - freeclock: add qmp command to get time offset of vm in seconds - tests: Disable filemonitor testcase - shadow_dev: introduce shadow dev for virtio-net device - pl011: reset read FIFO when UARTTIMSC=0 & UARTICR=0xffff - tests: virt: Update expected ACPI tables for virt test(update BinDir) - arm64: Add the cpufreq device to show cpufreq info to guest - hw/arm64: add vcpu cache info support - tests: virt: Allow changes to PPTT test table - cpu: add Cortex-A72 processor kvm target support - cpu: add Kunpeng-920 cpu support - net: eepro100: validate various address valuesi(CVE-2021-20255) - ide: ahci: add check to avoid null dereference (CVE-2019-12067) - vdpa: set vring enable only if the vring address has already been set - docs: Add generic vhost-vdpa device documentation - vdpa: don't suspend/resume device when vdpa device not started - vdpa: correct param passed in when unregister save - vdpa: suspend function return 0 when the vdpa device is stopped - vdpa: support vdpa device suspend/resume - vdpa: move memory listener to the realize stage - vdpa: implement vdpa device migration - vhost: implement migration state notifier for vdpa device - vhost: implement post resume bh - vhost: implement savevm_handler for vdpa device - vhost: implement vhost_vdpa_device_suspend/resume - vhost: implement vhost-vdpa suspend/resume - vhost: add vhost_dev_suspend/resume_op - vhost: introduce bytemap for vhost backend logging - vhost-vdpa: add migration log ops for VhostOps - vhost-vdpa: add VHOST_BACKEND_F_BYTEMAPLOG - hw/usb: reduce the vpcu cost of UHCI when VNC disconnect - virtio-net: update the default and max of rx/tx_queue_size - virtio-net: set the max of queue size to 4096 - virtio-net: fix max vring buf size when set ring num - virtio-net: bugfix: do not delete netdev before virtio net - monitor: Discard BLOCK_IO_ERROR event when VM rebooted - vhost-user: add unregister_savevm when vhost-user cleanup - vhost-user: add vhost_set_mem_table when vm load_setup at destination - vhost-user: quit infinite loop while used memslots is more than the backend limit - fix qemu-core when vhost-user-net config with server mode - vhost-user: Add support reconnect vhost-user socket - vhost-user: Set the acked_features to vm's featrue - i6300esb watchdog: bugfix: Add a runstate transition - hw/net/rocker_of_dpa: fix double free bug of rocker device - net/dump.c: Suppress spurious compiler warning - pcie: Add pcie-root-port fast plug/unplug feature - pcie: Compat with devices which do not support Link Width, such as ioh3420 - qdev/monitors: Fix reundant error_setg of qdev_add_device - qemu-nbd: set timeout to qemu-nbd socket - qemu-nbd: make native as the default aio mode - nbd/server.c: fix invalid read after client was already free - virtio-scsi: bugfix: fix qemu crash for hotplug scsi disk with dataplane - virtio: bugfix: check the value of caches before accessing it - virtio: print the guest virtio_net features that host does not support - virtio: bugfix: add rcu_read_lock when vring_avail_idx is called - virtio: check descriptor numbers - migration: report multiFd related thread pid to libvirt - migration: report migration related thread pid to libvirt - cpu/features: fix bug for memory leakage - doc: Update multi-thread compression doc - migration: Add compress_level sanity check - migration: Add zstd support in multi-thread compression - migration: Add multi-thread compress ops - migration: Refactoring multi-thread compress migration - migration: Add multi-thread compress method - migration: skip cache_drop for bios bootloader and nvram template - oslib-posix: optimise vm startup time for 1G hugepage - monitor/qmp: drop inflight rsp if qmp client broken - ps2: fix oob in ps2 kbd - Currently, while kvm and qemu can not handle some kvm exit, qemu will do vm_stop, which will make vm in pause state. This action make vm unrecoverable, so send guest panic to libvirt instead. - vhost: cancel migration when vhost-user restarted during migraiton Signed-off-by: Jiabo Feng <fengjiabo1@huawei.com>
79 lines
2.5 KiB
Diff
79 lines
2.5 KiB
Diff
From 28ed79b98f08b5701dcaab7c6ad1015602b28e02 Mon Sep 17 00:00:00 2001
|
|
From: libai <libai12@huawei.com>
|
|
Date: Sat, 12 Nov 2022 22:40:13 +0800
|
|
Subject: [PATCH] docs: Add generic vhost-vdpa device documentation
|
|
|
|
Add the description of the generic vhost-vdpa device
|
|
|
|
Signed-off-by: libai <libai12@huawei.com>
|
|
---
|
|
docs/system/device-emulation.rst | 1 +
|
|
.../devices/vhost-vdpa-generic-device.rst | 46 +++++++++++++++++++
|
|
2 files changed, 47 insertions(+)
|
|
create mode 100644 docs/system/devices/vhost-vdpa-generic-device.rst
|
|
|
|
diff --git a/docs/system/device-emulation.rst b/docs/system/device-emulation.rst
|
|
index d1f3277cb0..e1b2d18fb1 100644
|
|
--- a/docs/system/device-emulation.rst
|
|
+++ b/docs/system/device-emulation.rst
|
|
@@ -98,3 +98,4 @@ Emulated Devices
|
|
devices/canokey.rst
|
|
devices/usb-u2f.rst
|
|
devices/igb.rst
|
|
+ devices/vhost-vdpa-generic-device.rst
|
|
diff --git a/docs/system/devices/vhost-vdpa-generic-device.rst b/docs/system/devices/vhost-vdpa-generic-device.rst
|
|
new file mode 100644
|
|
index 0000000000..25fbcac60e
|
|
--- /dev/null
|
|
+++ b/docs/system/devices/vhost-vdpa-generic-device.rst
|
|
@@ -0,0 +1,46 @@
|
|
+
|
|
+=========================
|
|
+vhost-vDPA generic device
|
|
+=========================
|
|
+
|
|
+This document explains the usage of the vhost-vDPA generic device.
|
|
+
|
|
+Description
|
|
+-----------
|
|
+
|
|
+vDPA(virtio data path acceleration) device is a device that uses a datapath
|
|
+which complies with the virtio specifications with vendor specific control
|
|
+path.
|
|
+
|
|
+QEMU provides two types of vhost-vDPA devices to enable the vDPA device, one
|
|
+is type sensitive which means QEMU needs to know the actual device type
|
|
+(e.g. net, blk, scsi) and another is called "vhost-vDPA generic device" which
|
|
+is type insensitive
|
|
+
|
|
+The vhost-vDPA generic device builds on the vhost-vdpa subsystem and virtio
|
|
+subsystem. It is quite small, but it can support any type of virtio device.
|
|
+
|
|
+Examples
|
|
+--------
|
|
+
|
|
+Prepare the vhost-vDPA backends first:
|
|
+
|
|
+::
|
|
+ host# ls -l /dev/vhost-vdpa-*
|
|
+ crw------- 1 root root 236, 0 Nov 2 00:49 /dev/vhost-vdpa-0
|
|
+
|
|
+Start QEMU with virtio-mmio bus:
|
|
+
|
|
+::
|
|
+ host# qemu-system \
|
|
+ -M microvm -m 512 -smp 2 -kernel ... -initrd ... \
|
|
+ -device vhost-vdpa-device,vhostdev=/dev/vhost-vdpa-0 \
|
|
+ ...
|
|
+
|
|
+Start QEMU with virtio-pci bus:
|
|
+
|
|
+::
|
|
+ host# qemu-system \
|
|
+ -M pc -m 512 -smp 2 \
|
|
+ -device vhost-vdpa-device-pci,vhostdev=/dev/vhost-vdpa-0 \
|
|
+ ...\
|
|
--
|
|
2.27.0
|
|
|