docs: update the xenstore migration stream documentation
authorJuergen Gross <jgross@suse.com>
Fri, 15 Jan 2021 08:29:48 +0000 (09:29 +0100)
committerAndrew Cooper <andrew.cooper3@citrix.com>
Fri, 15 Jan 2021 11:44:47 +0000 (11:44 +0000)
commit8868a0e3f67436a5fbee750624e24a6533357f52
treed20b72b949e79ee58a3f878a0012ed6e54bd4e68
parent29a6082f21f2109935fd13eff4c9ce0093c2a26e
docs: update the xenstore migration stream documentation

For live update of Xenstore some records defined in the migration
stream document need to be changed:

- Support of the read-only socket has been dropped from all Xenstore
  implementations, so ro-socket-fd in the global record can be removed.

- Some guests require the event channel to Xenstore to remain the same
  on Xenstore side, so Xenstore has to keep the event channel interface
  open across a live update. For this purpose an evtchn-fd needs to be
  added to the global record.

- With no read-only support the flags field in the connection record
  can be dropped.

- The evtchn field in the connection record needs to be switched to
  hold the port of the Xenstore side of the event channel.

- A flags field needs to be added to permission specifiers in order to
  be able to mark a permission as stale (XSA-322).

Signed-off-by: Juergen Gross <jgross@suse.com>
Reviewed-by: Julien Grall <jgrall@amazon.com>
docs/designs/xenstore-migration.md