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 E72D641CE4; Mon, 20 Feb 2023 09:42:25 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BD44542FCC; Mon, 20 Feb 2023 09:42:17 +0100 (CET) Received: from NAM04-BN8-obe.outbound.protection.outlook.com (mail-bn8nam04on2134.outbound.protection.outlook.com [40.107.100.134]) by mails.dpdk.org (Postfix) with ESMTP id 5045042FC0 for ; Mon, 20 Feb 2023 09:42:13 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ob1jiV7jC6DgcbwjU2Ym+Oq7C8HQcTkrUttpfaBgJx8axdphmhCyQsawWCPeolMppO79+QGS2KAphcCFbidq5R83dsgEIFyZ/h6eq1+ZeXan/ECNuMptHTMgrug+dnNv/tAm+7HI2VhXBLRoz2pc/M5bV5uNoY9xy+aurQpFymK+b8aeGqtjNgrq0NmAiHjTc5OtHCBx+/W46mL2vQ1ZufxyWOfiq+PymufBI6yINJJx2Rl38e65YU1kNRqQU9X180BJ3ZXEIS5T5hb8BcKb5Wo6GkLdPWC5HYltL2lGWgjiDGY07J16WkhpBhdhUujNzHLM+hL33qce9BwkAgS+oQ== 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=K+QVkrs0uYV9JeMvy1JGqI1KeXr0czS0NpcVjSN4gHw=; b=ffqwMUWjQ2YABXaLqlLLh7OSe51PXTq7kqjuN7/KSqxyYS8zlgip2y8J9sRaTjWZ2o4X7EQlBZLxgOKCGz75+6bxIgW15n95drU+ZPe9MmGnkccGlwDdqQsLk98E9Xkx83zni5EkFRQFcCN7q2t+q+7bmEubtXiHdS2AQeXYvG9H/V/B/ZuZBh5uHqbCa5Bb6j7UvHwDgQWPjMJizQMQufjjDD1jR+4TAwJaJDamvSGosY9r7SYbwuez1CAdXO/OoDi8ZiWaBMQBb2LcuuMlPtbbeWVfVhhQEFDmWLa1L8gsc+ONPSxk8n7YfR7Pmx3SWdjIrbRNRawW0b4bImY2JQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=corigine.com; dmarc=pass action=none header.from=corigine.com; dkim=pass header.d=corigine.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=corigine.onmicrosoft.com; s=selector2-corigine-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=K+QVkrs0uYV9JeMvy1JGqI1KeXr0czS0NpcVjSN4gHw=; b=boeGs5Tx9zdjK+lqnIphL3zeeLVcjz2f7uWdya+eeGgKoICiOrqkHBCuq0C3ZH8naBdzVG0MJQWM+UqTBRIx8RM4ylr/I2yI8LQ2cy6A6Fy4cs5YRxYEqeAefASP278vCn0aKMdAezyAnXoVKStyVJe4pD97A6Lx6JYcKCr/vSQ= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=corigine.com; Received: from SJ0PR13MB5545.namprd13.prod.outlook.com (2603:10b6:a03:424::5) by SA0PR13MB3966.namprd13.prod.outlook.com (2603:10b6:806:9e::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.20; Mon, 20 Feb 2023 08:42:11 +0000 Received: from SJ0PR13MB5545.namprd13.prod.outlook.com ([fe80::7ea4:e421:5dd5:9f4d]) by SJ0PR13MB5545.namprd13.prod.outlook.com ([fe80::7ea4:e421:5dd5:9f4d%5]) with mapi id 15.20.6111.018; Mon, 20 Feb 2023 08:42:11 +0000 From: Chaoyong He To: dev@dpdk.org Cc: oss-drivers@corigine.com, niklas.soderlund@corigine.com, Walter Heymans , Chaoyong He Subject: [PATCH v2 2/3] doc: update outdated information for the nfp PMD Date: Mon, 20 Feb 2023 16:41:10 +0800 Message-Id: <20230220084111.40531-3-chaoyong.he@corigine.com> X-Mailer: git-send-email 2.29.3 In-Reply-To: <20230220084111.40531-1-chaoyong.he@corigine.com> References: <20230203080845.24126-1-chaoyong.he@corigine.com> <20230220084111.40531-1-chaoyong.he@corigine.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-ClientProxiedBy: SG2PR04CA0158.apcprd04.prod.outlook.com (2603:1096:4::20) To SJ0PR13MB5545.namprd13.prod.outlook.com (2603:10b6:a03:424::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR13MB5545:EE_|SA0PR13MB3966:EE_ X-MS-Office365-Filtering-Correlation-Id: 6ccac762-53d4-4052-ef3b-08db131e5bd7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 8NDirVoYl9VE/HYCge3Hxbx1/1LvQgZM5XnFdbLnUq2fgOF3c8ndsvJwan1TrA50SQJvmmurS4BklpD4DLcdhz+U1JXVz5qP+wvsyWrY102A3Cg++WwiX3dpXj+U6QZIyP24xL9kPtwBt+jCQY3oUGqRCO4eatTuVE1bQSAkg3ztJ4EDw3+LHD+YYbY7aNJJhuvbVvFYeFJK1YnwbFFUxRFlnbwpOcviJPi7omnbyh0Wy7VjMxzqDKPy5V3utolp60jbx/fdQL5CRQhS0GGMbgDMndmFnEUG54yL9+lZF20+1YXLFb4yeoOs83j6E8/GqE/3oNe5dJXetXUIovxEW+irxtD496UMdgimdcZiqS4uG11kxBifO1s3OWF/WykHh9gSVMrNkVLMefLbtfMnjKnG0jhTQMrxu1l4+Yt8pxE0aBz/hsPPzCwAbXIanUNXpA5QnBFRGs+bC7T4Av+84xONx8s0hhE9M+0FgA4XywPSR57KkyVuZ4cYVePQzryKh81lgc8XM2obncmLeQIhIIrjuEZyFLFxGF6k/XYU67y1wT1DSm8pqHPZ9SIQEVNA8p8zgjx+VVB0d/Bau4wMiwilfTX5o8giknaoTIE+Qfd/eO7or1zOThVyyvIf8LbnrutRpjhVJFXm+/dJjz/0Qxiu8KWVn7fs6DplX/nF+uTw5ylPwf1zKr01UXU6jCJe0CocWxsSXkPlL2S6OFl8sQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR13MB5545.namprd13.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230025)(4636009)(346002)(39840400004)(376002)(396003)(366004)(136003)(451199018)(83380400001)(8936002)(5660300002)(66574015)(41300700001)(86362001)(15650500001)(44832011)(2906002)(52116002)(4326008)(6486002)(6512007)(186003)(26005)(1076003)(6506007)(107886003)(316002)(8676002)(66946007)(66476007)(6916009)(66556008)(478600001)(2616005)(54906003)(38350700002)(36756003)(38100700002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?VzA4cnZ5UU5idWtUdjVnZ20wOTFyK0pjYlFBbllDM1FHUXkwUTNNcUpXSW1h?= =?utf-8?B?M3VRbTU1aU1VMUo5ZEdYeXJNcHNDelBRRGhnV2lXQjlXUEtUWjg5c0JVdXpQ?= =?utf-8?B?d1NZMThVa2xGbzd1YU02M1c2Uk9HZzJueGc1WkJsQXdJUmN0cyszU0JETzZF?= =?utf-8?B?dU9EV25FY2cyQ1AwVWNvRW9KU3laRnRtdzFERnY5M1A0UkFKNEZ3Mm5BUnBz?= =?utf-8?B?MzE2UXZsTzN5WCtzUEwxdTdZbGRqY2lDSy8xTGlHaGFHcHgwUTY2NmZZRTNH?= =?utf-8?B?MnV5d3RLSTZoL0VaUkw0UisvdUlJMUU1MWJ0WTA0TkNaNEd1RE56UUg3WXZY?= =?utf-8?B?Q0tmckp4WjJwdEwraHZZZThCU3o2UVQ1VTh0aFpZOURKMHMwWk9qTWJDbzJ5?= =?utf-8?B?L3llVnhOLzlYajZmVXBvQVl0djM3ZjFYYVNRTk8xOWNjVnpTbGJFbzRrOUFQ?= =?utf-8?B?VjlYejhPdDhjc3ZsSVp1eFo2RzMrbDIySHA5Yk5GdUdxcitrVWlFNXgyQnRT?= =?utf-8?B?R3VNdFR2ajNLdnIvMzdEY3IwR0tRMTk1REJtZXBJdWFzMk9lbGVjUXpKYkhE?= =?utf-8?B?d0MvTmVWSThlMVZuaVBBUGVLRWM1TTdzR2ZKcWQwNHVYb3VoQ2hVeWxUQkZK?= =?utf-8?B?QTJuVUZzdTJENGZveEcvTjVOaWduWEFJOGg0TzQ2RlFsaldISHdybHV0TEU2?= =?utf-8?B?MkY1cnhzZ0Zsc01oV1VhWllQSXlFeFNCQ3l5cXAxdmNKbTBwSDRaeFVLenBK?= =?utf-8?B?Q0creHdsUSttOUFOYW05d21oTGQ1YXk0ZktKUE4vRU5XdzlHRHJEemxublZw?= =?utf-8?B?VlNqSnRjemE1Vncyd3l5ajRVLzhFKzc3MUhHS0ptM05NTnJhWHZQS2x3Z3pR?= =?utf-8?B?UkVkNHZKU3Bwb3UvMWE2TFQ2Tm5FWTBULzVwamdOcU9YanlMTWlBb2dDUTJQ?= =?utf-8?B?YVZxMmdxd1JTaStTS3VOZ3FIZjZZM003WW04TGNzR2V0Zk56MmhDUXhyRWxZ?= =?utf-8?B?QVVDRXJIb3FXRGVUVmpCU0hXenJ0Y1RvNWlHeDh5Z3NjaGdFU3dUNks3NUFn?= =?utf-8?B?VzY1SlNyYVRpRFdEOS83NUxFQXE4aCtKT00rTEozS3cxbVorc0grYy9qU2V3?= =?utf-8?B?cXhmSVJwN0dlNzRwdmYzUFlRYTVlTGE2MWJVL2E2TWtKM1BwTE9kRERhaVR3?= =?utf-8?B?cmRuMmRGb1A3c24rWDAvRy9pMFliZXE5NzU5MjZGMzdyYUdZQ0RZZnhFQVhB?= =?utf-8?B?ZDR3SGxpakFHZVVUOVhtaXhGOHZpa1pBZkZubDg0T20wNzJpcEZVRWtlQjVQ?= =?utf-8?B?OWpGVnZwalcvbFlyREZnTmUweFhKNm52ejdNOEo1d040bUVPdEtXWUhrbG5l?= =?utf-8?B?Qkkycll6Rkg0ZkNScU5hVnVWakdoMjFLL3FoSklrdFhEUFFXMW1MMEl4RkZJ?= =?utf-8?B?eW1nUk5ialQ1MDdSWGhtTmFiMlVLdW1kL1hsVmpQTmFWL1doTVl3WGRTMWZZ?= =?utf-8?B?VU1lMVQwVXNsdGhEOFlaSzMxQlV0NVZzaGpseFVhOW5lSEd0RDlvaW43OXcy?= =?utf-8?B?M1ZjL3F5NmFLVDh3SUxrOFFDOFdjOFY4UU1mOVVjNUIwd0dDY1VRRnNBMTBX?= =?utf-8?B?Q0IrVFhrOStDSnlPaUZydFpYdkVRbE42THpRSHlCZytGbmQ4bXh2S1VXZXQw?= =?utf-8?B?VXBGcVNmNjlITElVd0lLVVZ5WklKK0RWbFZhV0l2WW9OY3ltS0RKc21HMk9C?= =?utf-8?B?ais4T29uNDQyRG1YYWY5eUcwbEU4MnhXSkJrenI0NElGRTVBSGhKK2oyRVR2?= =?utf-8?B?emdsNDgvY0IyRFZvL2h0NHZoTnRKZVBtUkVSMUtVUlUxczIvQjVtUElRRnlP?= =?utf-8?B?V1BBM3g4eVlqcmpqOHROd3R0dFI5OStKQjRqeGtxRkFidG9FQ3c3N2pNbXpL?= =?utf-8?B?VUtqNmg5OTgvV1VJZzI3N3RuWHhzMUlMN0dtMjBFYkw2S0lrWVpjS25hNTB1?= =?utf-8?B?dUFmaGtwMU1JcEdQRitnUEd6dHdsSEFoMGxaZ0tzVmJGR2FZeTB2eHJIajlm?= =?utf-8?B?VzdYdnhkbmdYQzdpYjE0Z3dIUzZ3RjNISDlvV3hZVHVRVkhUcEVsQU03QU9M?= =?utf-8?B?d2Z4Q2hjeUljd240V3l1cHdwZlREYlZ2WVFsSWJKNDNCYmFIbjZieVNzNzI5?= =?utf-8?B?dVE9PQ==?= X-OriginatorOrg: corigine.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6ccac762-53d4-4052-ef3b-08db131e5bd7 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR13MB5545.namprd13.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Feb 2023 08:42:11.6732 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: fe128f2c-073b-4c20-818e-7246a585940c X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 44iHgBVaoDM5GYjGk4neh6RSJSRI6uA5kokVwAa/QzDkd5VJSMqqiwb+xydCLw5zovNvoARh0CitXk041+Wq9SrpmTfhLyqGDNtLuU2YT14= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA0PR13MB3966 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 From: Walter Heymans Update nfp documentation with new information and remove outdated information. The most significant changes that are updated include: - Previously the NFP PMD did not support functionality to control VFs, it now does. - Previously the PF had to be bound to the kernel driver to create VFs, then VFs were created and bound to 'vfio-pci'. Currently it is possible to bind the PF to 'vfio-pci' and create VFs bound to 'vfio-pci'. - The name of the Linux kernel driver changed for VFs. Previously the 'nfp_netvf' module was used, but now both PFs and VFs use the 'nfp' module. Signed-off-by: Walter Heymans Reviewed-by: Chaoyong He Reviewed-by: Niklas Söderlund --- doc/guides/nics/nfp.rst | 40 +++++++++++++++++++--------------------- 1 file changed, 19 insertions(+), 21 deletions(-) diff --git a/doc/guides/nics/nfp.rst b/doc/guides/nics/nfp.rst index 36c447a17c..d133b6385c 100644 --- a/doc/guides/nics/nfp.rst +++ b/doc/guides/nics/nfp.rst @@ -63,13 +63,6 @@ Refer to the document Using the PF ------------ -NFP PMD supports using the NFP PF as another DPDK port, but it does not -have any functionality for controlling VFs. In fact, it is not possible to use -the PMD with the VFs if the PF is being used by DPDK, that is, with the NFP PF -bound to ``igb_uio`` or ``vfio-pci`` kernel drivers. Future DPDK versions will -have a PMD able to work with the PF and VFs at the same time and with the PF -implementing VF management along with other PF-only functionalities/offloads. - The PMD PF has extra work to do which will delay the DPDK app initialization like uploading the firmware and configure the Link state properly when starting or stopping a PF port. Since DPDK 18.05 the firmware upload happens when @@ -153,20 +146,25 @@ System configuration #. **Enable SR-IOV on the NFP device:** The current NFP PMD supports the PF and the VFs on a NFP device. However, it is not possible to work with both at - the same time because the VFs require the PF being bound to the NFP PF Linux - netdev driver. Make sure you are working with a kernel with NFP PF support - or get the drivers from the above Github repository and follow the - instructions for building and installing it. + the same time when using the ``nfp`` Linux netdev kernel driver. If the PF + is bound to the ``nfp`` kernel module, and VFs are created, the VFs may be + bound to the ``vfio-pci`` kernel module. It is also possible to bind the PF + to the ``vfio-pci`` kernel module, and create VFs afterwards. This requires + loading the ``vfio-pci`` module with the following parameters: + + .. code-block:: console + + modprobe vfio-pci enable_sriov=1 disable_idle_d3=1 - VFs need to be enabled before they can be used with the PMD. - Before enabling the VFs it is useful to obtain information about the - current NFP PCI device detected by the system: + VFs need to be enabled before they can be used with the PMD. Before enabling + the VFs it is useful to obtain information about the current NFP PCI device + detected by the system. This can be done on Netronome SmartNICs using: .. code-block:: console - lspci -d19ee: + lspci -d 19ee: - Now, for example, configure two virtual functions on a NFP-6xxx device + Now, for example, to configure two virtual functions on a NFP device whose PCI system identity is "0000:03:00.0": .. code-block:: console @@ -177,12 +175,12 @@ System configuration .. code-block:: console - lspci -d19ee: -k + lspci -kd 19ee: Two new PCI devices should appear in the output of the above command. The -k option shows the device driver, if any, that the devices are bound to. - Depending on the modules loaded at this point the new PCI devices may be - bound to nfp_netvf driver. + Depending on the modules loaded, at this point the new PCI devices may be + bound to the ``nfp`` kernel driver or ``vfio-pci``. Flow offload @@ -209,8 +207,8 @@ vNIC service will keep polling packets from the firmware, and multiplex them to the corresponding representor port. In the Tx direction, the representor port will prepend the output port -information into metadata for each packet, and then send it to firmware through -PF vNIC. +information into metadata for each packet, and then send it to the firmware +through the PF vNIC. The ctrl vNIC service handles various control messages, for example, the creation and configuration of representor port, the pattern and action of flow -- 2.29.3