qemu/docs
Kevin Wolf 31009d13cc docs/vhost-user: Clarifications for VHOST_USER_ADD/REM_MEM_REG
The specification for VHOST_USER_ADD/REM_MEM_REG messages is unclear
in several points, which has led to clients having incompatible
implementations. This changes the specification to be more explicit
about them:

* VHOST_USER_ADD_MEM_REG is not specified as receiving a file
  descriptor, though it obviously does need to do so. All
  implementations agree on this one, fix the specification.

* VHOST_USER_REM_MEM_REG is not specified as receiving a file
  descriptor either, and it also has no reason to do so. rust-vmm does
  not send file descriptors for removing a memory region (in agreement
  with the specification), libvhost-user and QEMU do (which is a bug),
  though libvhost-user doesn't actually make any use of it.

  Change the specification so that for compatibility QEMU's behaviour
  becomes legal, even if discouraged, but rust-vmm's behaviour becomes
  the explicitly recommended mode of operation.

* VHOST_USER_ADD_MEM_REG doesn't have a documented return value, which
  is the desired behaviour in the non-postcopy case. It also implemented
  like this in QEMU and rust-vmm, though libvhost-user is buggy and
  sometimes sends an unexpected reply. This will be fixed in a separate
  patch.

  However, in postcopy mode it does reply like VHOST_USER_SET_MEM_TABLE.
  This behaviour is shared between libvhost-user and QEMU; rust-vmm
  doesn't implement postcopy mode yet. Mention it explicitly in the
  spec.

* The specification doesn't mention how VHOST_USER_REM_MEM_REG
  identifies the memory region to be removed. Change it to describe the
  existing behaviour of libvhost-user (guest address, user address and
  size must match).

Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Message-Id: <20220407133657.155281-2-kwolf@redhat.com>
Reviewed-by: Raphael Norwitz <raphael.norwitz@nutanix.com>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
2022-05-04 15:55:23 +02:00
..
_templates
about remove -writeconfig 2022-04-28 08:51:56 +02:00
config
devel tests: move libqtest.h back under qtest/ 2022-05-03 15:16:51 +04:00
interop docs/vhost-user: Clarifications for VHOST_USER_ADD/REM_MEM_REG 2022-05-04 15:55:23 +02:00
specs virtio,pc,pci: features, cleanups, fixes 2022-03-08 22:27:34 +00:00
sphinx
sphinx-static
spin
system hw/riscv: Enable TPM backends 2022-04-29 10:48:48 +10:00
tools qemu-img: properly list formats which have consistency check implemented 2022-05-04 15:55:23 +02:00
user linux-user: Remove the deprecated ppc64abi32 target 2022-02-09 13:29:38 +00:00
COLO-FT.txt
block-replication.txt
bypass-iommu.txt
colo-proxy.txt
conf.py Update copyright dates to 2022 2022-01-28 14:29:46 +00:00
defs.rst.inc
hyperv.txt hyperv: Add support to process syndbg commands 2022-04-06 14:31:56 +02:00
igd-assign.txt
image-fuzzer.txt
index.rst
memory-hotplug.txt
meson.build configure, meson: move guest-agent, tools to meson 2022-02-21 10:35:53 +01:00
multi-thread-compression.txt
multiseat.txt
nvdimm.txt
pci_expander_bridge.txt
pcie.txt
pcie_pci_bridge.txt
pcie_sriov.txt docs: Replace Qemu -> QEMU 2022-04-26 12:38:44 +02:00
pvrdma.txt
qcow2-cache.txt
qdev-device-use.txt
qemu-option-trace.rst.inc
qemupciserial.inf
rdma.txt
replay.txt
spice-port-fqdn.txt
throttle.txt
u2f.txt
xbzrle.txt
xen-save-devices-state.txt