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 85554A0C47; Tue, 23 Nov 2021 11:22:07 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4E17840040; Tue, 23 Nov 2021 11:22:07 +0100 (CET) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by mails.dpdk.org (Postfix) with ESMTP id 9B4294003C for ; Tue, 23 Nov 2021 11:22:04 +0100 (CET) X-IronPort-AV: E=McAfee;i="6200,9189,10176"; a="258861726" X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="258861726" Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Nov 2021 02:22:03 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="508958868" Received: from fmsmsx602.amr.corp.intel.com ([10.18.126.82]) by fmsmga007.fm.intel.com with ESMTP; 23 Nov 2021 02:22:03 -0800 Received: from fmsmsx611.amr.corp.intel.com (10.18.126.91) by fmsmsx602.amr.corp.intel.com (10.18.126.82) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12; Tue, 23 Nov 2021 02:22:03 -0800 Received: from FMSEDG603.ED.cps.intel.com (10.1.192.133) by fmsmsx611.amr.corp.intel.com (10.18.126.91) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12 via Frontend Transport; Tue, 23 Nov 2021 02:22:03 -0800 Received: from NAM12-DM6-obe.outbound.protection.outlook.com (104.47.59.174) by edgegateway.intel.com (192.55.55.68) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2242.12; Tue, 23 Nov 2021 02:22:03 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=TR9bA1v27KdfVniPmoyu2tfHlz9UiTORxxEX9yzmOA/Nv/dvl/Oe2Xm/iw4UUJYo2uozkcTfAnPT3ny+Id9YhaHuCFx/OQT/9dBE3iSQgZ7iEEPiRxpGTZi29koxl6EAxmaUfomVtT2zLB6lBxFcHKxeryky5H0tr4wxyt34CbBovHzJ6FTECBgVccww6J0xGoKRbtOEpnR3fPlDDZOXMGe5vVdUmu4+DYLS2IaGlr1xPV7CbbN9fnSiB0wKNxREhDjx4FDbekJtdDKLO1CUvSWKte/4drJKd2xirTgarcoAMvdQGvqvJV3z8CXmRl7XfjFRmeEjvtQMuFrWviZJ7w== 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=MB4b29aiObkE8tMSu7lAEUTk1FLaUinacXiaZvJSYas=; b=ZgSB9rgLrHdooZc6O0QyUs2LklWPFjvf3C2PMPgknymqS+/FD24coiDqv+sUYeyp/XXUu/UqzORQA9/QChrq0pCXCgvdNY2b2WuPcx8YMGLhMYn4sas1xvyqqa1ARlH5JJnRv4/epMqZV8a95gN0hyskPc3xPoY0xFxgIf3s8U6CECSqwx5+XtUy8hJtvbbzweT8bPMlVGuWSiB1KYMamds1qEmnh5JhB+yHc8OCxpCVqLMuiteziQUYfRiK1eiu1ukDEVH7EDsdfIx9nSVXGJOsVag/1Swkt2TBxHC70drqRuT7s13ejgg6u82ZPzW77YaA2VLlu03CisrJVtRkBg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=MB4b29aiObkE8tMSu7lAEUTk1FLaUinacXiaZvJSYas=; b=tlltxZ+prWQzuoTqrjCnmj9k4i470WQW1s9Ka7buPyI5JBKa8NMzXYz3SeM2GKiD1vtbWv4ONAgHEJpvVkD93l/2ouWndiuPHzHdZ2F+vCeaE/NPFu9tbRILInuSHqQm3let3VnyRJnnIz3OfwnRCmm3LdhFujK5Sfd1uOov7BU= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from PH0PR11MB5000.namprd11.prod.outlook.com (2603:10b6:510:41::19) by PH0PR11MB5096.namprd11.prod.outlook.com (2603:10b6:510:3c::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4690.26; Tue, 23 Nov 2021 10:22:02 +0000 Received: from PH0PR11MB5000.namprd11.prod.outlook.com ([fe80::bc5f:31a7:10ad:443c]) by PH0PR11MB5000.namprd11.prod.outlook.com ([fe80::bc5f:31a7:10ad:443c%5]) with mapi id 15.20.4690.028; Tue, 23 Nov 2021 10:22:02 +0000 Message-ID: Date: Tue, 23 Nov 2021 10:21:55 +0000 Subject: Re: [dpdk-dev] [PATCH] doc: note KNI alternatives and deprecation plan Content-Language: en-US To: Olivier Matz CC: , Keith Wiles , Stephen Hemminger , Thomas Monjalon References: <20210623173142.3803801-1-ferruh.yigit@intel.com> From: Ferruh Yigit X-User: ferruhy In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ClientProxiedBy: DU2PR04CA0159.eurprd04.prod.outlook.com (2603:10a6:10:2b0::14) To PH0PR11MB5000.namprd11.prod.outlook.com (2603:10b6:510:41::19) MIME-Version: 1.0 Received: from [192.168.0.206] (37.228.236.146) by DU2PR04CA0159.eurprd04.prod.outlook.com (2603:10a6:10:2b0::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4713.19 via Frontend Transport; Tue, 23 Nov 2021 10:22:00 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 6372e5c5-445c-4b37-72d0-08d9ae6b16cd X-MS-TrafficTypeDiagnostic: PH0PR11MB5096: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: VnGYu6KhB1LyjfkUIMfElDNwjSrj/fMI4TMCdJm0eKEirtDD5fVFHJv4JEhJCVdF0VhRMV/q0MTXiok801Pql3ZMAByLP64ltqwq3N5zcvE9qnnWEKQ8VOLGzQAj5ONKuHvjNwN73Z4fCNjTstiR1YX8iDDVMXs5ETA+x4oduDyHMD7ZSiRiV6z5V3vjWaMNXeFvDb4iNYxq/gZBp3r83DaoTpRwj4BWvF5DNxV9jzKDnvPxtYMPZUS+tAXZ5YVqmHkn/RPixNfvGNHrXN6RuFXSsaYUhHAd+UhSMCtitjdBvPMGx2Guplgy0AHjHCYXknGHb80HLEi8UxdGoTvCMu1JTnlgu5J+3oXMSpxB4xVKKD6SkezeUsWxbkPMAvQy7ynDxRCBVHGZFxMYaUpUrX3xmbWSNk9b0wUgaAmUYwWm8FzR1TSw2EqG9FSnQQ68TX9dawZMaiStmiQMSbaexT6QQYX/kDmqFb/S4QTkYVgM49sQyEqaYgL2/k1Jv5uCo+OevE36ilM+NotDLY+fHhWSbTuODvkX7dId46iMqT5qMuAUS8VGiCls2/M/tlEIqJ9OquR6rVOxt5vGA+qHmIUluegmDMHo4DH9qNcwkXgCKCJWpCQCRM2RgBps0C3uccxGq6jCEX58LGohZhzJh/zj6/DhtvwBbhiC3PHo/mJVOlCxIavQXkobw7dyBevbekd5TORuQV/neWnZSIPgEPKzslYsWtHVx6YwIjhiDb4k81u8CXDzaEJPjiohM1qFWmLRJTSsV35YVFyy6H4h5uTwq8Pi6V08veNx3wSTVnxoIX3YhL6pyg2CuwhjT+i3RMLEml5jU+95N9+ri5oIHQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR11MB5000.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(53546011)(36756003)(2906002)(8676002)(86362001)(16576012)(2616005)(8936002)(956004)(6486002)(82960400001)(66556008)(66476007)(5660300002)(186003)(83380400001)(44832011)(508600001)(4326008)(26005)(6916009)(31696002)(31686004)(316002)(54906003)(38100700002)(66946007)(6666004)(45980500001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?bkhKYWlzcTh6VStOSlEySUVlUDJxOVc0T0d3WkROeXZ3TElyQVgyT1Y3VmxE?= =?utf-8?B?Q1F1c3FOOWtIS3R0SmdpRHlSUmlic2ZNaXQycW9vNmcrNG5PNTBNS2VIaHpU?= =?utf-8?B?b25EOEo0ZTlhZlZYWGhnbU5qcGpsYzVNYU5hRUR6bXdxNnBCa3N4ek5RT0Fm?= =?utf-8?B?ZEg4T2x5K0ozZldkS0g2Y2FxQklDVlI4NFRITmlZamhZMWkyTlhNeGZ4c1R5?= =?utf-8?B?cms3TEFHSi9nSDdVeGpZMklqVTYwdEJMM0hZTTdYbzRmdHhMR20yUGtYajF2?= =?utf-8?B?K09nSjkzMjBIR01tVXBVMkU4WjFLcEZmaHJ5T3VodWEwcE95cmxkUFJEc20w?= =?utf-8?B?amJCR29YRUNhSVRIOWpNODMvbCtqZ3BYbzZsSTg0UHRreGNxQkhrMGpXWmlZ?= =?utf-8?B?Z2FQNVI1Umt5S0ErbXY1ZGRtcHRmNTJURHhUQU8xUU9GS2haMlg2ZDNDUXFr?= =?utf-8?B?Z3JsRWRSMHQ1bUhwWWpMemV6U3hKaDFRdDlTUzFuQkoyY1lPTVpjZ0ZpVThX?= =?utf-8?B?c1pBVExMaUFSMS9Wbzl2QnNNOFNQQktjSHVVNGxtLytlcGZLS0FHRHpGaWZZ?= =?utf-8?B?SXZkVEp0MU9LY2hVMmFNNm1PeDl3Qk9iSXA2dE96V2RFbjQ1Q1QwYU4weUsv?= =?utf-8?B?QU5PZWxUcDlGaDJ4dFA5aDREMWNYWWMyeEFyQm53OXlPMGN4Zm9FV1ZjKzV0?= =?utf-8?B?NFpBd0dMalVMK3pPYThXWGpSNERocml6N2dwdm43WGdxc3ZDcmYyUjA0V2FS?= =?utf-8?B?WEJVdFRKTGdSTXViOFErcVdQckxGY2VIQTNGbFUyRnpPNUV6WkJEY04yWmRT?= =?utf-8?B?ZUE3REovZEhNVmQxalFEaWE1VmxadnhISkhLSjQ2Rm5vTmwzelFHZE5rdlJS?= =?utf-8?B?N1lyaW1SbG9rd1JBaDBSRFpHZitNL2VteW44Uk15YklyWkN1QXc4VXAxalNP?= =?utf-8?B?S2cyL0JMeThWWW9VUTF1SCtpYWV4VHZQcFNieFhmUVhqaWVRZGZ0Rms5YkFJ?= =?utf-8?B?YjJyMEhLRFBUcDE0MmNFcWRvY25EcHhOL1pQQ01qb2c3a0pwNy9xTmMxanBO?= =?utf-8?B?RCs2UHMreDFkZWRtTzJRTEJiUlNkYW5qK1Eyd3JoRERYOUlabDU0bEJKL1l2?= =?utf-8?B?eUVHbFhMbU50UjQ3RDV6RStReklsZzd6L05INm9LOEZXd2dheUhYMlVVbkd6?= =?utf-8?B?VWhDa2hOZ0tackJac3BxaGxITktWcnZyQlp3YlczVXIrb3M2ME9yR2k3WTRH?= =?utf-8?B?UTBMaU1VWUwyMXNLa1UyVHBUM2V6Snd1UGFuSTNRWGRlYnAyNG03L0tGWFl2?= =?utf-8?B?MmdsR2plUEtudHY4UkREejYycEYzM21TWUxPdENBQ1NsM2V1RnZYenpNbUZF?= =?utf-8?B?b1psclVWWE5vUC9sdVdhdnR1ancwaTlYem1JRzlOcnVUK2NnRXBvMGdWaEZ2?= =?utf-8?B?clNFQURKbERQc29ycGtPWE13U252L2loY3I2L0U5YXpUcFQvdUF3M2pGU25x?= =?utf-8?B?MUtYQ09MUjF6d09oemZhZlpvVmpYbFNXcTd5SzdiVDhES3NiaFRZeDZGWFBa?= =?utf-8?B?VjMzdGlLYTRMYjN4bVh0a0JIWFZaVS9JSWx4eGJENk5zSXh6YjA2Vm1XYWlj?= =?utf-8?B?bVY0SXNhOTBORzkyTjhubk9Ra1I0cHZSMG5nTVA0TjdCdFYwcnh3WHh5V0Fl?= =?utf-8?B?emxiN2krYmFubmgxYzZRcmpwb1ZuelZYUDBLU0M5ZkVXQkNNdnByeFVEem4y?= =?utf-8?B?NERIaHl3bnJKZUJIR29kdUlrbjVxWW5UdGIzNElqdFE5NzJuT0RqSHFqTndR?= =?utf-8?B?QUorYTU0L1phUGRWL3JDYjVwWEdYQ3QvYXhvVzE5MUdSYzl6elRsNm5vRHdB?= =?utf-8?B?eUU4YU9qTEJWcHY5TkpMbjRCRHorZGRoNFJDVjZzeVFkS2VxUVA2T1pPK0Fm?= =?utf-8?B?STZQSjVBNGVxdHlwLzg2Rkh1WU5UZi9ZWHkxU3B2RFRvb1h4cFJvdlNyN3J6?= =?utf-8?B?T0RSdXVNRWZqL2hNajUyMDMvV2ZUMnRsOC90akZ0bjg5UmJDVW8xQml0RHYr?= =?utf-8?B?WG1XYnB4cWFCSjZGZFVDTmErR0lUWTBZZ1FJa2tlb1RDWXZwcWovSEo1RUlr?= =?utf-8?B?eEdndDk5Y0tOaXBtMHBlLzczZk9ZK3hrdVk3b3AvVWFITDNKV05yajg4ZEZy?= =?utf-8?Q?y2qMdXg6qP/W/JLYUXbsYVg=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: 6372e5c5-445c-4b37-72d0-08d9ae6b16cd X-MS-Exchange-CrossTenant-AuthSource: PH0PR11MB5000.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Nov 2021 10:22:01.9650 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: f99h/BzO+UN54AN7W5reyVZIrtmGvH5Fo8orgvrRHkJYmjTN1da8yFT3tRHfuiZoCHoIv+upFBvaolTgL78xnw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5096 X-OriginatorOrg: intel.com 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/30/2021 1:48 PM, Olivier Matz wrote: > Hi Ferruh, > > Few minor comments below. > > On Wed, Jun 23, 2021 at 06:31:42PM +0100, Ferruh Yigit wrote: >> Add a note that KNI kernel module will be moved to dpdk-kmods git repo >> and there is a long term plan to deprecate it. >> >> Also add some more details on the alternatives to KNI and cons of the >> KNI against these alternatives. >> >> Signed-off-by: Ferruh Yigit >> --- >> doc/guides/nics/tap.rst | 2 + >> .../prog_guide/kernel_nic_interface.rst | 38 +++++++++++++++++-- >> 2 files changed, 37 insertions(+), 3 deletions(-) >> >> diff --git a/doc/guides/nics/tap.rst b/doc/guides/nics/tap.rst >> index 3ce696b605d1..07315fe32422 100644 >> --- a/doc/guides/nics/tap.rst >> +++ b/doc/guides/nics/tap.rst >> @@ -1,6 +1,8 @@ >> .. SPDX-License-Identifier: BSD-3-Clause >> Copyright(c) 2016 Intel Corporation. >> >> +.. _TunTap_PMD: >> + >> Tun|Tap Poll Mode Driver >> ======================== >> >> diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst b/doc/guides/prog_guide/kernel_nic_interface.rst >> index 1ce03ec1a374..29f8c92fd9d6 100644 >> --- a/doc/guides/prog_guide/kernel_nic_interface.rst >> +++ b/doc/guides/prog_guide/kernel_nic_interface.rst >> @@ -6,16 +6,48 @@ >> Kernel NIC Interface >> ==================== >> >> +.. Note:: >> + >> + KNI kernel module will be removed from main git repository to `dpdk-kmods `_ > > removed -> moved? > ack > Or "removed from main and moved to" > >> + repository by the `DPDK technical board decision `_. >> + Also there is a `long term plan `_ to deprecate the KNI. >> + >> + :ref:`virtio_user_as_exceptional_path` alternative is preferred way for >> + interfacing with Linux network stack as it is being in-kernel solution and >> + similar performance expectations. >> + >> The DPDK Kernel NIC Interface (KNI) allows userspace applications access to the Linux* control plane. >> >> -The benefits of using the DPDK KNI are: >> +KNI allows an interface with the kernel network stack and allows management of >> +DPDK ports using standard Linux net tools such as ``ethtool``, ``ifconfig`` and >> +``tcpdump``. >> + >> +Main use case of KNI is get/receive exception packets from/to Linux network >> +stack while main datapath IO is done bypassing the networking stack. >> + >> +There are other alternatives to KNI, all are available in the upstream Linux: >> + >> +#. :ref:`TunTap_PMD` as wrapper to `Linux tun/tap >> + `_ >> + >> +#. :ref:`virtio_user_as_exceptional_path` > > Shouldn't virtio_user be the first item? > ack >> + >> +The benefits of using the DPDK KNI against alternatives are: >> >> * Faster than existing Linux TUN/TAP interfaces >> (by eliminating system calls and copy_to_user()/copy_from_user() operations. >> >> -* Allows management of DPDK ports using standard Linux net tools such as ethtool, ifconfig and tcpdump. >> +The cons of the DPDK KNI are: >> + >> +* It is out-of-tree Linux kernel module and it can't be distributed as binary as >> + part of OSV DPDK packages. This makes it harder to consume, although it is > > OSV -> OVS > I mean 'Operating System Vendor', I will use long version to prevent confusion. >> + always possible to compile it from the source code. >> + >> +* As it shares memory between userspace and kernelspace, and kernel part >> + directly uses input provided by userspace, it is not safe. This makes hard to >> + upstream the module. >> >> -* Allows an interface with the kernel network stack. >> +* Only a subset of control commands are supported by KNI. >> >> The components of an application using the DPDK Kernel NIC Interface are shown in :numref:`figure_kernel_nic_intf`. >> >> -- >> 2.31.1 >>