doc: announce vhost-cuse removal
authorYuanhan Liu <yuanhan.liu@linux.intel.com>
Fri, 15 Jul 2016 12:28:33 +0000 (20:28 +0800)
committerThomas Monjalon <thomas.monjalon@6wind.com>
Thu, 28 Jul 2016 18:12:18 +0000 (20:12 +0200)
commit8a3433af84c13964548c8e9ee65d56912996914f
treea2fdb27ba7b68c54f7decd4f428d90c0793b7c7a
parent8acc3ce08847aa048ceac302b34fe2bae1bafd5a
doc: announce vhost-cuse removal

Vhost-cuse was invented before vhost-user exist. The both are actually
doing the same thing: a vhost-net implementation in user space. But they
are not exactly the same thing.

Firstly, vhost-cuse is harder for use; no one seems to care it, either.
Furthermore, since v2.1, a large majority of development effort has gone
to vhost-user. For example, we extended the vhost-user spec to add the
multiple queue support. We also added the vhost-user live migration at
v16.04 and the latest one, vhost-user reconnect that allows vhost app
restart without restarting the guest. Both of them are very important
features for product usage and none of them works for vhost-cuse.

You now see that the difference between vhost-user and vhost-cuse is
big (and will be bigger and bigger as time moves forward), that you
should never use vhost-cuse, that we should drop it completely.

The remove would also result to a much cleaner code base, allowing us
to do all kinds of extending easier.

So here to mark vhost-cuse as deprecated in this release and will be
removed in the next release (v16.11).

Signed-off-by: Yuanhan Liu <yuanhan.liu@linux.intel.com>
Acked-by: Ciara Loftus <ciara.loftus@intel.com>
Acked-by: Thomas Monjalon <thomas.monjalon@6wind.com>
Acked-by: Rich Lane <rich.lane@bigswitch.com>
Acked-by: Jan Viktorin <viktorin@rehivetech.com>
Acked-by: Christian Ehrhardt <christian.ehrhardt@canonical.com>
doc/guides/rel_notes/deprecation.rst