qemu/docs/devel/migration
Fabiano Rosas 8d60280e4f migration: Add documentation for fdset with multifd + file
With the last few changes to the fdset infrastructure, we now allow
multifd to use an fdset when migrating to a file. This is useful for
the scenario where the management layer wants to have control over the
migration file.

By receiving the file descriptors directly, QEMU can delegate some
high level operating system operations to the management layer (such
as mandatory access control). The management layer might also want to
add its own headers before the migration stream.

Document the "file:/dev/fdset/#" syntax for the multifd migration with
mapped-ram. The requirements for the fdset mechanism are:

- the fdset must contain two fds that are not duplicates between
  themselves;

- if direct-io is to be used, exactly one of the fds must have the
  O_DIRECT flag set;

- the file must be opened with WRONLY on the migration source side;

- the file must be opened with RDONLY on the migration destination
  side.

Reviewed-by: Peter Xu <peterx@redhat.com>
Signed-off-by: Fabiano Rosas <farosas@suse.de>
2024-06-21 09:47:22 -03:00
..
best-practices.rst docs/migration: Split "Debugging" and "Firmware" 2024-01-16 11:16:10 +08:00
compatibility.rst docs/migration: Split "Backwards compatibility" separately 2024-01-16 11:16:10 +08:00
CPR.rst migration: cpr-reboot documentation 2024-03-13 10:59:25 -04:00
dirty-limit.rst docs/migration: Split "dirty limit" 2024-01-16 11:16:10 +08:00
features.rst docs/migration: add uadk compression feature 2024-06-14 14:01:29 -03:00
index.rst docs/migration: Further move virtio to be feature of migration 2024-01-16 11:16:10 +08:00
main.rst migration: Add documentation for fdset with multifd + file 2024-06-21 09:47:22 -03:00
mapped-ram.rst migration: Add documentation for fdset with multifd + file 2024-06-21 09:47:22 -03:00
postcopy.rst docs/migration: Organize "Postcopy" page 2024-01-16 11:16:10 +08:00
qpl-compression.rst docs/migration: add qpl compression feature 2024-06-14 14:01:28 -03:00
uadk-compression.rst docs/migration: add uadk compression feature 2024-06-14 14:01:29 -03:00
vfio.rst docs/migration: Create index page 2024-01-16 11:16:10 +08:00
virtio.rst docs/migration: Convert virtio.txt into rST 2024-01-16 11:16:10 +08:00