From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 513F5A00C5; Wed, 13 Jul 2022 21:51:34 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4142C42B6D; Wed, 13 Jul 2022 21:51:34 +0200 (CEST) Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) by mails.dpdk.org (Postfix) with ESMTP id 5CEAB42836 for ; Wed, 13 Jul 2022 21:51:33 +0200 (CEST) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 5CB0F5C00CA; Wed, 13 Jul 2022 15:51:30 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Wed, 13 Jul 2022 15:51:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to; s=fm3; t=1657741890; x= 1657828290; bh=IsAT+68HaSxvDDkX3b39koT6BS36Imj408ydoRCH+Is=; b=I sugElpcaWhgQROlwhhnU+rWkvfg0PuDh71ydP+IggP5HEuO+IjN2NpDxOgqUZVv7 B/ZJ7EVFG936nJcX9Lli8SF9MjYhhVZFBxihwwEMmqUqmqBlraBngsTEeWz1Cp2n a++uEHHuZcm1C5qFvFwP4Bjf27NVut2KDIVT+fiatfH6ZEYiM1CAXRRIT5VEFPCt lVJrTtmSXyga/OfDaUPnmN3zy2YClcnClFpR9P0ae4iA5hQuCDCuCar5jRgqqLHf mYgIY4sK4r8TcEg2H6ifD4LN213zePtbwQWjDANPbvuaJIwcZvV6tnOJK8q9MmRk kYzxuzHtuTPgff8sn16Aw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1657741890; x= 1657828290; bh=IsAT+68HaSxvDDkX3b39koT6BS36Imj408ydoRCH+Is=; b=Z VW2xzwpSDRDYJND7ax0UyLs67jETk+W/OoSToHfNz7nwm8iObTlBrFiX3Lxolk4/ mV3kY4uvQEvtrCqPdDDkYP8qhV1MvFrXq370SCPCvX5R+sIbeJ/2cPGQhenFyFDQ iHJ5GVsGftgSIkDhIJs3QyqVhXMUruhR40aME+R0T0B4S378bzq0caaI1ZrXnsgE suFGJpoWbEfbgwB5p9dKx0FHij0WDfUxLVaF37cgZYsmJ7OCbt7tI8CkyH980G2i zx1CUui1red1Ze2pXl+j/fdcqMHbdlRAawRM6VAZglaE3oq2VvJd/h767Uiqs0Il JQXQ1s10Edbxi8hlsrBmA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrudejjedgudegudcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefhvfevufffkfgjfhgggfgtsehtufertddttddvnecuhfhrohhmpefvhhho mhgrshcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqne cuggftrfgrthhtvghrnhepjeejffffgfffkeefffelgfekleetjeffleeludeghfehleff teehveduffdugfdvnecuffhomhgrihhnpeguphgukhdrohhrghenucevlhhushhtvghruf hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl ohhnrdhnvght X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 13 Jul 2022 15:51:28 -0400 (EDT) From: Thomas Monjalon To: dev@dpdk.org Cc: david.marchand@redhat.com, andrew.rybchenko@oktetlabs.ru, maxime.coquelin@redhat.com, chenbo.xia@intel.com, mdr@ashroe.eu, ferruh.yigit@xilinx.com, olivier.matz@6wind.com, jerinj@marvell.com, Ferruh Yigit Subject: Re: [PATCH v4] doc: announce KNI deprecation Date: Wed, 13 Jul 2022 21:51:26 +0200 Message-ID: <3807503.vtBmWVcJkq@thomas> In-Reply-To: <20220713161047.121805-1-thomas@monjalon.net> References: <20211124171609.3101896-2-ferruh.yigit@intel.com> <20220713161047.121805-1-thomas@monjalon.net> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org 13/07/2022 18:10, Thomas Monjalon: > From: Ferruh Yigit > > Announce the deprecation plan for KNI kernel module, library and example. > > Signed-off-by: Ferruh Yigit > Signed-off-by: Thomas Monjalon > --- > Squashed and updated 2 deprecations: > https://patches.dpdk.org/project/dpdk/patch/20211124171609.3101896-2-ferruh.yigit@intel.com/ > https://patches.dpdk.org/project/dpdk/patch/20211124171609.3101896-2-ferruh.yigit@intel.com/ This is a mistake. The second deprecation squashed here is https://patches.dpdk.org/project/dpdk/patch/20220630165031.79183-1-bruce.richardson@intel.com/ > --- > doc/guides/prog_guide/kernel_nic_interface.rst | 3 +++ > doc/guides/rel_notes/deprecation.rst | 9 +++++++++ > 2 files changed, 12 insertions(+) > > diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst b/doc/guides/prog_guide/kernel_nic_interface.rst > index e021cc69b6..03b5bca958 100644 > --- a/doc/guides/prog_guide/kernel_nic_interface.rst > +++ b/doc/guides/prog_guide/kernel_nic_interface.rst > @@ -8,6 +8,9 @@ Kernel NIC Interface > > .. note:: > > + KNI is deprecated and will be removed in future. > + See :doc:`../rel_notes/deprecation`. > + > For an alternative to KNI, that does not require any out-of-tree Linux kernel modules, > or a custom library, see :ref:`virtio_user_as_exception_path`. > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index 4e5b23c53d..e54597c591 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -48,6 +48,15 @@ Deprecation Notices > in the header will not be considered as ABI anymore. This change is inspired > by the RFC https://patchwork.dpdk.org/project/dpdk/list/?series=17176. > > +* kni: The KNI kernel module and library are not recommended for use by new > + applications - other technologies such as virtio-user are recommended instead. > + The KNI kernel module and library will be removed from DPDK 23.11, > + following the DPDK technical board > + `decision `_ > + and `refinement `_. > + The first steps are to add deprecation warnings > + and to remove the example application from 22.11. > + > * lib: will fix extending some enum/define breaking the ABI. There are multiple > samples in DPDK that enum/define terminated with a ``.*MAX.*`` value which is > used by iterators, and arrays holding these values are sized with this >