qemu/docs/interop
Hanna Czenczek 019233096c vhost-user.rst: Migrating back-end-internal state
For vhost-user devices, qemu can migrate the virtio state, but not the
back-end's internal state.  To do so, we need to be able to transfer
this internal state between front-end (qemu) and back-end.

At this point, this new feature is added for the purpose of virtio-fs
migration.  Because virtiofsd's internal state will not be too large, we
believe it is best to transfer it as a single binary blob after the
streaming phase.

These are the additions to the protocol:
- New vhost-user protocol feature VHOST_USER_PROTOCOL_F_DEVICE_STATE
- SET_DEVICE_STATE_FD function: Front-end and back-end negotiate a file
  descriptor over which to transfer the state.
- CHECK_DEVICE_STATE: After the state has been transferred through the
  file descriptor, the front-end invokes this function to verify
  success.  There is no in-band way (through the file descriptor) to
  indicate failure, so we need to check explicitly.

Once the transfer FD has been established via SET_DEVICE_STATE_FD
(which includes establishing the direction of transfer and migration
phase), the sending side writes its data into it, and the reading side
reads it until it sees an EOF.  Then, the front-end will check for
success via CHECK_DEVICE_STATE, which on the destination side includes
checking for integrity (i.e. errors during deserialization).

Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Hanna Czenczek <hreitz@redhat.com>
Message-Id: <20231016134243.68248-5-hreitz@redhat.com>
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
2023-11-07 03:39:10 -05:00
..
barrier.rst
bitmaps.rst
dbus-display.rst
dbus-vmstate.rst
dbus.rst
firmware.json
index.rst
live-block-operations.rst
nbd.txt
parallels.txt
pr-helper.rst
prl-xml.txt
qcow2.txt
qed_spec.txt
qemu-ga-ref.rst
qemu-ga.rst
qemu-qmp-ref.rst
qemu-storage-daemon-qmp-ref.rst
qmp-spec.rst
vhost-user-gpu.rst
vhost-user.json
vhost-user.rst vhost-user.rst: Migrating back-end-internal state 2023-11-07 03:39:10 -05:00
vhost-vdpa.rst
virtio-balloon-stats.rst
vnc-ledstate-pseudo-encoding.rst