ContextQMD
Back to Qemu

vhost-user back ends

docs/system/devices/virtio/vhost-user.rst

11.0.04.2 KB
Original Source

.. _vhost_user:

vhost-user back ends

vhost-user back ends are way to service the request of VirtIO devices outside of QEMU itself. To do this there are a number of things required.

vhost-user device

These are simple stub devices that ensure the VirtIO device is visible 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-blk
    • Block storage
    • :ref:storage-daemon
    • vhost-user-fs
    • File based storage driver
    • virtiofsd <https://gitlab.com/virtio-fs/virtiofsd>_
    • vhost-user-gpio
    • Proxy gpio pins to host
    • vhost-device-gpio <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-gpio>_
    • vhost-user-gpu
    • GPU driver
    • vhost-device-gpu <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-gpu>_ or :ref:vhost_user_gpu
    • vhost-user-i2c
    • Proxy i2c devices to host
    • vhost-device-i2c <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-i2c>_
    • vhost-user-input
    • Generic input driver
    • vhost-device-input <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-input>_ or :ref:vhost_user_input
    • vhost-user-rng
    • Entropy driver
    • vhost-device-rng <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-rng>_
    • vhost-user-scmi
    • System Control and Management Interface
    • vhost-device-scmi <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-scmi>_
    • vhost-user-snd
    • Audio device
    • vhost-device-sound <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-sound>_
    • vhost-user-scsi
    • SCSI based storage
    • :ref:vhost_user_scsi
    • vhost-user-vsock
    • Socket based communication
    • vhost-device-vsock <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-vsock>_
    • vhost-user-spi
    • Proxy spi devices to host
    • vhost-device-spi <https://github.com/rust-vmm/vhost-device/tree/main/vhost-device-spi>_

The referenced daemons are not exhaustive, any conforming backend implementing the device and using the vhost-user protocol should work.

vhost-user-test-device ^^^^^^^^^^^^^^^^^^^^^^

The vhost-user-test-device is a generic development device intended for expert use while developing new backends. The user needs to specify all the required parameters including:

  • Device virtio-id
  • The num_vqs it needs and their vq_size
  • The config_size if needed

.. note:: While this is a useful device for development it is not recommended for production use.

vhost-user daemon

This is a separate process that is connected to by QEMU via a socket following the :ref:vhost_user_proto. There are a number of daemons that can be built when enabled by the project although any daemon that meets the specification for a given device can be used.

.. _shared_memory_object:

Shared memory object

In order for the daemon to access the VirtIO queues to process the requests it needs access to the guest's address space. This is achieved via the memory-backend-file, memory-backend-memfd, or memory-backend-shm objects. A reference to a file-descriptor which can access this object will be passed via the socket as part of the protocol negotiation.

Currently the shared memory object needs to match the size of the main system memory as defined by the -m argument.

Example

First start your daemon.

.. parsed-literal::

$ virtio-foo --socket-path=/var/run/foo.sock $OTHER_ARGS

Then you start your QEMU instance specifying the device, chardev and memory objects.

.. parsed-literal::

$ |qemu_system| \ -m 4096 \ -chardev socket,id=ba1,path=/var/run/foo.sock \ -device vhost-user-foo,chardev=ba1,$OTHER_ARGS \ -object memory-backend-memfd,id=mem,size=4G,share=on \ -numa node,memdev=mem \ ...