From 8a3433af84c13964548c8e9ee65d56912996914f Mon Sep 17 00:00:00 2001 From: Yuanhan Liu Date: Fri, 15 Jul 2016 20:28:33 +0800 Subject: [PATCH] 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 Acked-by: Ciara Loftus Acked-by: Thomas Monjalon Acked-by: Rich Lane Acked-by: Jan Viktorin Acked-by: Christian Ehrhardt --- doc/guides/rel_notes/deprecation.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index f16b61b7ed..f5871f8215 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -57,6 +57,10 @@ Deprecation Notices * The ``rte_ivshmem`` feature (including library and EAL code) will be removed in 16.11 because it has some design issues which are not planned to be fixed. +* The vhost-cuse will be removed in 16.11. Since v2.1, a large majority of + development effort has gone to vhost-user, such as multiple-queue, live + migration, reconnect etc. Therefore, vhost-user should be used instead. + * Driver names are quite inconsistent among each others and they will be renamed to something more consistent (net and crypto prefixes) in 16.11. Some of these driver names are used publicly, to create virtual devices,