doc: note a pitfall on vhost reconnect feature
authorYuanhan Liu <yuanhan.liu@linux.intel.com>
Tue, 19 Jul 2016 04:17:48 +0000 (12:17 +0800)
committerThomas Monjalon <thomas.monjalon@6wind.com>
Fri, 22 Jul 2016 17:58:10 +0000 (19:58 +0200)
commitf6ee75b542bf9b971bc6b292209ee2d92ba99b64
tree4c8bcca5adeee75b717718f6749622dbda4f53c1
parentf079630304df4e471370311c778da01d234add0e
doc: note a pitfall on vhost reconnect feature

The vhost feature negotiation only happens at virtio reset stage, say
when a virtio-net device is firstly initiated, or when DPDK virtio PMD
initiates. That means, if vhost APP restarts after the negotiation and
reconnects, the feature negotiation process will not be triggered again,
meaning the info is lost. To make reconnect work, QEMU simply saves
the negotiated features before the restart and restores it afterwards.

Therefore, the vhost supported features must be exactly the same before
and after the restart. For example, if TSO is disabled and then enabled,
nothing will work and undefined issues might happen.

Signed-off-by: Yuanhan Liu <yuanhan.liu@linux.intel.com>
Acked-by: John McNamara <john.mcnamara@intel.com>
doc/guides/prog_guide/vhost_lib.rst