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 10C77A0C4C; Tue, 23 Nov 2021 11:43:04 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C81F940040; Tue, 23 Nov 2021 11:43:03 +0100 (CET) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by mails.dpdk.org (Postfix) with ESMTP id 991434003C for ; Tue, 23 Nov 2021 11:43:01 +0100 (CET) X-IronPort-AV: E=McAfee;i="6200,9189,10176"; a="234945767" X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="234945767" Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Nov 2021 02:43:00 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="650028949" Received: from orsmsx601.amr.corp.intel.com ([10.22.229.14]) by fmsmga001.fm.intel.com with ESMTP; 23 Nov 2021 02:43:00 -0800 Received: from orsmsx612.amr.corp.intel.com (10.22.229.25) by ORSMSX601.amr.corp.intel.com (10.22.229.14) 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:42:59 -0800 Received: from ORSEDG601.ED.cps.intel.com (10.7.248.6) by orsmsx612.amr.corp.intel.com (10.22.229.25) 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:42:59 -0800 Received: from NAM10-MW2-obe.outbound.protection.outlook.com (104.47.55.100) by edgegateway.intel.com (134.134.137.102) 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:42:59 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=og74EsAtkFhOXxYOdLuNLo1UNHd+o6OUV0SSZxni4L4fWDctEOoJXAJ8lrRzQnWRM0iimvZRo4EoEOzegNZb48FRafUobqqmqV+RrbY+MDu1D+jJZSnt/CycniDZM7EK4SkqBjvT+UHREtKtBJT4o3OqRX+cQ+yj1xfpiu0VU8e6+Ht/zLQPCCpYqkzfz6baFKmquAtO6MQuShE2nXDTU6EBrBhXwOyvjElC+qgvAwqFTHNRUnUe0SPfoiFV/1PlwnLHHJ4faH6BChvSPiv5evElJWbEiqXIBYPbYQ3Twdkv4QdqP3ro+NBE8z4sii+pqBMkDlzXacgAdWVtW16/vg== 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=zWzoVD2ktDW2Knj3BTdkjQO4HfVSd0MDkX/AxhNYkgs=; b=PuoknydixA2eRa9jXo+poNykQOaRXj0a+Za8cvjzyKlwcaIhf2dmBF7BHkKmo/Z8vcNfgTdHe56a+wj4a4oH0a5SOjK96nsgfRvrAAoEJTm9eS8N1572kXiS+qlFiOGLUgJJYfuC+fB2QriCDzRwaJaGRJxcWwYSJZvGYR7mJ9JR67lQFeyVQlYBUBlSf9ZhwaZSF+L+SU+6hjtLWE+ZcvmF76Z1xj93ur6GkbJkBY5g3wwoRSs2TrzTi92dnZv2Vt6b9rEnUEPB+MEMOLM8fgBYJrTlKItBLcgwc6RNy7snmwgYqX4DHPg+e/Lde9qth4ipWle2ClO0mANcCKTgOg== 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=zWzoVD2ktDW2Knj3BTdkjQO4HfVSd0MDkX/AxhNYkgs=; b=at7tmOo69OgeGPPevnTdVOVpEK2Nloo+b1m6bITvL5jSv7TYimS/vjjeHOv1UjeTZHWt/nz0OzJcpio0XaHV6bVlQ2SgC+3jXJLhQrHlCTLFgwi5CFYfL0V8Qw57rvRuL/UOjUtkN6+IrhTPsspV/0AapFztvihPN0G/kTk9idg= 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 PH0PR11MB5143.namprd11.prod.outlook.com (2603:10b6:510:3f::15) 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:42:58 +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:42:58 +0000 Message-ID: <31c34fe5-cc7d-6ded-6a6d-3fdd5a0682c2@intel.com> Date: Tue, 23 Nov 2021 10:42:52 +0000 Content-Language: en-US To: David Marchand CC: dev , Keith Wiles , Stephen Hemminger , Thomas Monjalon , "Mcnamara, John" References: <20210623173142.3803801-1-ferruh.yigit@intel.com> From: Ferruh Yigit Subject: Re: [dpdk-dev] [PATCH] doc: note KNI alternatives and deprecation plan X-User: ferruhy In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ClientProxiedBy: DB6PR1001CA0037.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:4:55::23) 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 DB6PR1001CA0037.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:4:55::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4713.21 via Frontend Transport; Tue, 23 Nov 2021 10:42:57 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: f806f961-8942-4ab4-0c32-08d9ae6e03d0 X-MS-TrafficTypeDiagnostic: PH0PR11MB5143: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:9508; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: r22l90253FVbYzJUTogAZjZ4sWhdVjL4NFU2nXKDgEbDeUUHoJrqNiQ29qmsM7DWPwFCM1RAdELHHRxTpt+Wo01uGJfPVkgu5sKwvtu49DiEEKbVJJWWCsmypLMZmtBSBl31K2kruFVGpgpkijlLKGLx1p7uYI9hOWnkBkLy4oR7OepO6Tc7B2UwUd+Kq6MaYQME028bPvEkjHMuczRBfOQW/7A4mbjQUVtEkpEMn1lckuobuCEF5ern2ZCOva29JMG97aUHw9nnWMsKmQ1hcTVtbnl7CVjWrMbDk0bL89qnu5vDkv6d1G5C9/FSLc4DPDxwubr+c0FtrnKUQTiiwpwt283SemDbUJ7BPi/6Qi5pWmz/tx4FssiN/QNHTpc0u5MXUzSDfyYb1aNRnz2jFvppRBwKCB7ZG94XvY6uJmXkI5RW4XVpSVcZjXxwDkOgIxOWIFEAy12KlzqaMPa8hsoMiZTSvKY29JDxOa4AgTcfCfSk1oFwp1or1HGD+EkBrpOwvJliqhvvMXtonE6A0+s04vbBUyPyjDhyEkd/e+td/FSnMr/cEJFCtX9UcVXHspnaQqGDz1R8wENNCb/oRqkn1HJWYj27OlrBT89oOEiTw7t19cKE9iU0uaIvWwViTLjLM9Lk82989IBepiVpgbhv/HgysgQe9eWqQ2hsWgiYuIyOkDzlXLOTFPgdnkzWIDF4QXOJeCZQ5A8NdlqgxjIgJFW6LXzTcIUZRpB8EkFLp2doLYrHeNHdInmx5dXR08/MZURnLV6SWLni+MJ+NMq0d+Eei7OlIfv46g3jzi+zHWPjRKSjElyZSTBy1ojD4ohh/TKg7P+cnJvcfcc/F3m0qfOF4j83J5EFtX6orls= 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)(186003)(6666004)(2906002)(31686004)(8676002)(82960400001)(8936002)(38100700002)(53546011)(54906003)(31696002)(66476007)(66556008)(5660300002)(66946007)(26005)(107886003)(2616005)(16576012)(86362001)(36756003)(6486002)(83380400001)(6916009)(956004)(44832011)(4326008)(508600001)(316002)(21314003)(45980500001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?QVFtdFBEcUI4YjNMTVVhNWV1MDVRZEw0Q1hoNXU4ZjZURW16NDdGZnVWb2dZ?= =?utf-8?B?ZndCMFRuQk5xK2Rmbmd6V2tuZTNRbDN5WTZRTFVHMlZZZ1lRdnpZbm1UQ3Jx?= =?utf-8?B?NnA4NXNqTmJRQnRranJQaXAxS3RTU3lyVmJIYUZ6Zlora3o2SWZyU2RYbXFI?= =?utf-8?B?OVZLZkdQUVBsKzRYRHJnZTdJNEZOT2hVQ1VQV3hwT0h4RnFjcHhpbG9yb0xu?= =?utf-8?B?NExCZ3pMWk0ybnpSN1dLeXJKSWQ5dkluMnNmR2kxSWZUYVJwSkpIM0FJaGlu?= =?utf-8?B?dmRLZWlxRjBYTU9ZaTQwNExXQkN5cTJHd2ZjVUZ5NGxRcGQ1anZISTQvNEoz?= =?utf-8?B?L0lUc0hLRnN1dGRiL2lZN3IzNGREVDZ3MjdTRVRZR0RvSFBkUnlwVUEyemR2?= =?utf-8?B?a0NTWTRVK3FPZlJtcDQrLzdzR2N5ZzFUVVpydTJ5QWZtcGF2aWRwaGc1RUho?= =?utf-8?B?dllZY2FHZ293NXhrN1VrMFErdnhxaXM2OGt6cFBkTDRJZmRRYUNRY1VnK1A4?= =?utf-8?B?K0RHVHpIbGFVTDArRnlVaVdXaUQ0S0hwRHB1YmxwakdjN2hhanUrVkYwa0Yz?= =?utf-8?B?Y2JFSmVRZkF0TEhoRFA0OG9JZUpncG9mYTVSVWpuNHhmTExWUEtyNE9ON0ZN?= =?utf-8?B?MnVORFNKUVlIOWpKZTFwZVl3TTZoRXdOaVozU2dkb3E1S3hjYVdmOGFZeG8y?= =?utf-8?B?ZHhDbzlNSVJEcW1ESnQwbm1WYmhGSnMxVTRER1NOK25tMlcyalBlMU1nZ3Vy?= =?utf-8?B?Zy9iRTJNZnc3NmNvMU45Z2NnTzNYb1VpZmZlOUF4ZWltT0E2eHUzR0gzQmRZ?= =?utf-8?B?VWNUNUJOdVJFcmorSkdpazRNRkwzTUI4V1BlVWxMcjVua284bWFjdUtQSzRL?= =?utf-8?B?VWRockhZd2p3TDNCNVJVcU5ZNzdWb2NINUZZV3hWU2t4UkxaemVNNmRmUlRn?= =?utf-8?B?SEdHTzZ1aXVXQ0ltbWJGMHBjOUVETjdKYjZNNlNnTWpuYzBoTWl2bWozV3lX?= =?utf-8?B?VW9hOFNSQlN2bmRHN2xOMElZVEtwZlQzVUFYMy96M3dueUQ1U3M3NDkyUU8z?= =?utf-8?B?RS9jUlZ0MGpYNEdLOUpOdzhabFJBMVhkeWU0Y3FzVU5QWXVnMVpaVUttWm16?= =?utf-8?B?eExsTUw2TjZwcXBwU0FuS0FNOG42TSsyYkh2T3hnK0c0ZmpTNS9XdVZoenhC?= =?utf-8?B?S1JVVlhqOFl4QmxyVW0xdmZjQkRwaW1lSEdwcmFsY1JpdUgvRlZjeHdPVnM3?= =?utf-8?B?a0JpN1BTd2F3b1dobkRyakFwd0tVOTFSaWlnVzF5bC9KelhLN3N2LzVhNmRF?= =?utf-8?B?dVJRNzl0UThoVUt4dnQ0KzFtWGhnTDNJZ0pYdm1CZW5LK2lBZGtZYXRoVXE4?= =?utf-8?B?Q3h6VXJVRTNFbi85MHd3VmVOTDU2UHo5dFJDMHFESFVIeXQ1dE9RVkYvdjds?= =?utf-8?B?VXNkNGRIQ1hNQjdjQWdkUkpzQUtoWXVQTTZyNE1Wc0lxMlc0S0lKVjRTOHlo?= =?utf-8?B?Zkx4TG1HMjJJWk1Oci9qdzF0cGQzd28zYzdLSzBMUDA5YnlRbjJ5RVNIaXFp?= =?utf-8?B?ZlBOTE1ZVTN2cm92QXN0Z0xQeVQvaCtPMTA5Sjl2MmE5ak9xNFlwY2toRzI0?= =?utf-8?B?UUYvb2x6dCtTRlBibkFFUGF1MkViWUtxSUxmeHFZaVNwempLQkE3YjhwQzdV?= =?utf-8?B?dVhPQUgzWnZxbldlWkNQaVkrNGMyMytwYUFDTVZSTUt0MGIwT3hjOUJ3WkMx?= =?utf-8?B?TmN2SmdZK29paFV5MmFCQXZpOHNUaTNob09tQWdsOTR0eVh1c1VsNndZZjdh?= =?utf-8?B?MFFGcjI2K1g4YmpIWjNDOEtwWGtCNGsrRTMzU09IR1JSVW8ydjFSQlRsV3N0?= =?utf-8?B?MmpZVDNtdmphSFAvUUx5WGNxQTlWWFlvRFJ1emlhRGlXK2ZQck82RTNIWTFp?= =?utf-8?B?bjdCeFVRQUVqcWxSN1VPOWY0N3B4cXFFT0QwNVZRSWVtWG5ZZ1JkWHhOWHlT?= =?utf-8?B?WEhRR1hkM3M5WDhpbGFKbmZXYmtueEgreEhERDY2bUhKdG5mbHBjcGxCcDhC?= =?utf-8?B?dlFQMnlqUnlJNmxOZW9vaUJsQmJ0RzIrSFNjeGVGYkIvdHVlTUVCSnNrSVZh?= =?utf-8?B?dHc2R3ZkRXpEejgyTGxXOVFwajVLVjdweEVFNk1uVVhKdmxvS2RZU3JSRVRj?= =?utf-8?Q?xdg0H3c+vh0cqbbyYcHHlFc=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: f806f961-8942-4ab4-0c32-08d9ae6e03d0 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:42:58.6055 (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: 0AhnPR6Aj+/6Jj5Gv0GcS43pTsHArlPzlhZRGd2No+Nk9Axkev60yu8x/d37t1/NLZxM8xZc1dN3wI97XDztiA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5143 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 8/20/2021 1:58 PM, David Marchand wrote: > On Wed, Jun 23, 2021 at 7:32 PM 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. > > Some suggestions on wording below, feel free to ignore if this sounds > like French ;-). > > >> >> 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 `_ > The* KNI kernel module will be moved* (Olivier comment) to ... > >> + repository by the `DPDK technical board decision `_. > repository following* the `...`_. > > I'd move this first part in doc/guides/rel_notes/deprecation.rst Perhaps it is better to clarify the decisions first in the deprecation notice, and document it later referencing it, instead of documenting it first. I will try to separate the decision part from the KNI documentation. > and/or release notes. > Then, reword this as: > >> + Also there is a `long term plan `_ to deprecate the KNI. > > The `long term plan...`_ is* to deprecate KNI, see deprecation notice/release notes>. > > >> + >> + :ref:`virtio_user_as_exceptional_path` alternative is preferred way for > > is one/a* preferred way > ack >> + interfacing with Linux network stack as it is being in-kernel solution and > > interfacing with the* Linux network stack as it is a* in-kernel and > ack >> + similar performance expectations. > > has* similar performance expectations. > ack > >> + >> 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 > > KNI provides* an interface ... > ack >> +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 > > The* main use case of KNI is to* ... > ack >> +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` >> + > > +1 to Olivier comment, for making virtio-user first. > > >> +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: > > Not sure why we need an extra DPDK, KNI alone is enough. > ack > >> + >> +* 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 as in OS vendors, right? ok for me. > > >> + 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. > > of net devices control commands* > ack >> >> The components of an application using the DPDK Kernel NIC Interface are shown in :numref:`figure_kernel_nic_intf`. >> >> -- >> 2.31.1 >> > >