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 0E935A0032; Thu, 14 Jul 2022 17:03:22 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A3E4442B7E; Thu, 14 Jul 2022 17:03:21 +0200 (CEST) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2064.outbound.protection.outlook.com [40.107.94.64]) by mails.dpdk.org (Postfix) with ESMTP id 9FB3D42B74 for ; Thu, 14 Jul 2022 17:03:20 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jW1fsfU/C7jCc6S6b4NewhtIdEd6d3AM0kCvyPtd/MuWIeJu4XVLcndYe7CW25FnFfQRoNGMgoxDGGMoccr32dTl1p+/YordVk74gx7hzi8qLBC5s/qyuUOquyj7dJi3JrmJE3QnreGC/bdPReOchiKh/KFWwSSGzDLR5gh0oAdnehZ1ZbJYZp/g3weSLDav4IV65+Ulzq6xZbSPdF1lfdrFO3FfMWFKx1zbmr+tnKx4nPFt7Rc8ogDqEqbTa7JJFAytDl7ZwiHIPufbkEf9VGTwPO9LkhE10MJsbTPQvKtMEetp6avTjMwU90z3Z8+9l00FnKFpSPpicMH9z6UXbw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=LVY9GsGc8YOPxdI9YKpdkLbddMOFznRVug7keWtSS1A=; b=cktIPSKKRd6OlZZGGyVbZK9IB0hN3JQ1QYoZDGt4ohT/Pss6wVafK8emknWRAqy4Es4/QCbkuK0qNR6cBcBiYkhzZYwvp5Uh3XDctqgOqKcdIRAPPstwZTmIJhAOWw3CAW4ddd8pi6klmlNHgNX5wXFc/fr0NG3pXk6lCF0tSlJ+qRTWz9Na6qovyn46rm072GAAH/NB7TR6TkmPNvlVCLPQ2vJwAGxKhHxEECr0sXxCLAyloNv7FbvJTOno3+i2vKeS5ZHZY8N5qMbw0sIV7JX2ridQAuBDzICTjneIkerZyWQ5ceWQRFV/il/YgbBgrErpiVhVfFGiZ79IkfKEfg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 149.199.80.198) smtp.rcpttodomain=intel.com smtp.mailfrom=xilinx.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=xilinx.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector2-xilinx-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=LVY9GsGc8YOPxdI9YKpdkLbddMOFznRVug7keWtSS1A=; b=nLiXo5O6P5uDsqryEUEwcn8RaOaPRta6ZXoT1jhMzGDFXrWpDNi8Yh/Kz3nkiSBTArbSkM02ZCE5IKRcU7yGBOiHvBhCBMLUndkhyOJUE8Eth19Thmo66tHiK/MTZtbUHZgeQF1Ac2esVH29yZsWa/P4rP+hQ70mWnm4Rd5IIm8= Received: from BN9PR03CA0744.namprd03.prod.outlook.com (2603:10b6:408:110::29) by CH2PR02MB7030.namprd02.prod.outlook.com (2603:10b6:610:87::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.16; Thu, 14 Jul 2022 15:03:17 +0000 Received: from BN1NAM02FT005.eop-nam02.prod.protection.outlook.com (2603:10b6:408:110:cafe::ac) by BN9PR03CA0744.outlook.office365.com (2603:10b6:408:110::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.17 via Frontend Transport; Thu, 14 Jul 2022 15:03:17 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 149.199.80.198) smtp.mailfrom=xilinx.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=xilinx.com; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.80.198 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.80.198; helo=xir-pvapexch01.xlnx.xilinx.com; pr=C Received: from xir-pvapexch01.xlnx.xilinx.com (149.199.80.198) by BN1NAM02FT005.mail.protection.outlook.com (10.13.2.124) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5438.12 via Frontend Transport; Thu, 14 Jul 2022 15:03:16 +0000 Received: from xir-pvapexch02.xlnx.xilinx.com (172.21.17.17) by xir-pvapexch01.xlnx.xilinx.com (172.21.17.15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2176.14; Thu, 14 Jul 2022 16:03:15 +0100 Received: from smtp.xilinx.com (172.21.105.198) by xir-pvapexch02.xlnx.xilinx.com (172.21.17.17) with Microsoft SMTP Server id 15.1.2176.14 via Frontend Transport; Thu, 14 Jul 2022 16:03:15 +0100 Envelope-to: bruce.richardson@intel.com, thomas@monjalon.net, john.mcnamara@intel.com, dev@dpdk.org, david.marchand@redhat.com, andrew.rybchenko@oktetlabs.ru, maxime.coquelin@redhat.com, chenbo.xia@intel.com, mdr@ashroe.eu, olivier.matz@6wind.com, jerinj@marvell.com Received: from [172.21.36.148] (port=53023) by smtp.xilinx.com with esmtp (Exim 4.90) (envelope-from ) id 1oC0N1-0006qJ-FP; Thu, 14 Jul 2022 16:03:15 +0100 Message-ID: <9eeed029-5fb3-b999-b532-59f3f5743144@xilinx.com> Date: Thu, 14 Jul 2022 16:03:15 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.0.2 Subject: Re: [PATCH v4] doc: announce KNI deprecation Content-Language: en-US From: Ferruh Yigit To: Bruce Richardson , Thomas Monjalon , "Mcnamara, John" CC: , , , , , , , References: <20211124171609.3101896-2-ferruh.yigit@intel.com> <20220713161047.121805-1-thomas@monjalon.net> In-Reply-To: Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 8bit X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 2259953b-c6df-412c-11f4-08da65a9fb98 X-MS-TrafficTypeDiagnostic: CH2PR02MB7030:EE_ X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: tX88C14vjwFx8PuNR7aMNpKz2YSpVX4kA/jWeKUXiZSTTYVmoTBa0HTH5ytgv8577uLeyBh06/wnjTfjCvTX6hNBq7/HGlpVu8NGxA4w9qCVHvYVxzrnNvn2ek8PBSZzAopxE3Iws+Kev/5Lv/DEyp4OQj+SdYsocJYehVQQEDANhZ8KrVCrenHAYUnzXsACdLs3bBxAHSLZuLoNYcZGItvIDd3xcghlUSrFnEd3+vAu44fsx5V/dWeQOknvsF1A718v08HLh+JTZWQqBPfuJ/3gLFeJ3fnG/kdFGfMQPfx/TBdyRzDfPCnlCzTFTPc1X9z5C3zMvm4nKyjFMpLxEfFIg4sJWoTqpwAp1z6PSOp81+HPFBgvOi56jSYhLIP30/uYgYkD/LrUH1UVxrnGLjeTsy7UtJSHHPnBCnfQFcUj0TSpsmCDjqUI4zOk4yYKTnZeUv1qTBnBibNeDLYQqpJPJcUDWFBV4cbyCsgi/9eU2zPH6Gx5ejfMfTVpGuoRs3ixbJUByJhLktd1hJGOZ3f0+PjfXCQfRaits0z9XXdMnMxwQVQ6J5gxotY8uXfKHh5uR6INFwWom3vWU5TOnj7PvM0IrvIm32Hu+H1qPWxOhq7635/fct+aJBuCKt/ZCqP62TUW0gOMMgEK/D/CkIPGJHgliVad93P19rnriyMXgaGGy/6qNX/MQqWnlnde5xh5PTPMIHq3OZJDPjvbiFDZNrgfE8GDKuDG3P/XCFL5D/dtc/aTKF+q2xjaZ1lMdyMJRjUAlcYtt7q1O7gExtRIwdiwju9pDbueA0zJhZzBAJU+US8aBfJ/XOmYn0+RQnRo+ty74Dhp6/oxGJzs8Ttqu5DEqdPNDiMwPEOnwgOcIwT5fAKry50wtQMWDRgo4tbp6F5fs5xCpm8WK0zqsYLflczVYzf0XtFB/fQ2rGnKzCrOqGukz47Q/4Oa8XOv X-Forefront-Antispam-Report: CIP:149.199.80.198; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:xir-pvapexch01.xlnx.xilinx.com; PTR:unknown-80-198.xilinx.com; CAT:NONE; SFS:(13230016)(4636009)(376002)(396003)(39860400002)(346002)(136003)(36840700001)(46966006)(40470700004)(44832011)(70206006)(70586007)(316002)(83380400001)(82740400003)(26005)(110136005)(47076005)(426003)(36756003)(40460700003)(336012)(54906003)(2906002)(82310400005)(41300700001)(7636003)(2616005)(53546011)(7416002)(4326008)(8676002)(5660300002)(40480700001)(966005)(9786002)(8936002)(186003)(31686004)(356005)(31696002)(478600001)(36860700001)(50156003)(43740500002); DIR:OUT; SFP:1101; X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Jul 2022 15:03:16.9553 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2259953b-c6df-412c-11f4-08da65a9fb98 X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.80.198]; Helo=[xir-pvapexch01.xlnx.xilinx.com] X-MS-Exchange-CrossTenant-AuthSource: BN1NAM02FT005.eop-nam02.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR02MB7030 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 On 7/14/2022 3:50 PM, Ferruh Yigit wrote: > On 7/14/2022 10:20 AM, Bruce Richardson wrote: >> On Wed, Jul 13, 2022 at 06:10:47PM +0200, Thomas Monjalon wrote: >>> 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/ >>> --- >> >> One suggestion below. >> With corrected link and with/without suggested change: >> >> Acked-by: Bruce Richardson >> >>>   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. >>> + >> >> I wonder whether having this done as bullet points in chronological order >> might be clearer. Something like: >> >> * kni: The KNI kernel module and library are not recommended for use >> by new >>    applications - other technologies such as virtio-user are >> recommended instead. >>    Following the DPDK technical board >>    `decision >> `_ >>    and `refinement >> `_: >>    * The KNI example application will be removed from DPDK 22.11 release >>    * The KNI kernel module and library will be removed from the DPDK >> 23.11 >>      release > > +1 to list actions in chronological order > > I have a concern with removing sample application without replacing one > with alternate methods: virtio-user and tun/tap. > > It is easy to create a virtio-user PMD by testpmd or any sample > application, and as far as I understand Bruce already documented this. > But for many KNI users they are not using KNI PMD, so replacing KNI with > this new method may require some hand holding. As mentioned KNI PMD, it also should be removed when library and module are removed, may be good to list above to be explicit. > One option can be hotplug the virtio-user PMD and use the port_id for > packet forwarding, and I don't know if the PMD has APIs that > applications can use directly, as done in KNI, @Maxime & @Chenbo can > answer this better. > > It can be good to have a sample application for above before deprecating > the KNI sample application. > And same sample can use tun/tap PMD with a runtime parameter, to show > how other example can be used, again tap can be used as tap PMD or Linux > tun/tap APIs. > > Question is who can work on such a sample, but if we can find some > resource I am for having a replacement exception path sample app before > deprecating KNI. > > Thanks, > ferruh > > >