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 B8CDC4590C; Thu, 5 Sep 2024 11:49:23 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8AEF140264; Thu, 5 Sep 2024 11:49:23 +0200 (CEST) Received: from NAM04-MW2-obe.outbound.protection.outlook.com (mail-mw2nam04on2040.outbound.protection.outlook.com [40.107.101.40]) by mails.dpdk.org (Postfix) with ESMTP id 640DF4025C for ; Thu, 5 Sep 2024 11:49:22 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=FCzPjWFVkd82mbTLLKUq7aPDvevn0pmMzpRNtmk+rS63nIZV9JEyRObYpVDDCZkr1bGqKyX6ek0ECuKqYwyAVivB9Oqsv6TeHec9hSrR5pdfgMfodOun6bgLRnCkgGqi3fptSmE7XMCKZPfQzOBUPR0xqWaTuhcAN4ZynlHkJ+HnoTqhIP+U1MEdB5HcBcl+wyi2RUngA7xlYKQbHzQi9s+i+ETAw5PjwoaiNE1ef1/gC9TCLzS44zG0wkRAXebOvRydNy0J1McEn6JWqpE8j7fXyEHVTuC7DgqqbEEoph8IAZoULW60vh9XvbMBrDEevCBsz+7+abbUTABi1pcuOQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=Oaypr8iYcjZHBseB/7BZd9CKiYLXCtQ17e5hMPWb6qk=; b=k6kPc7e0akKp8UbO8Hja2RyctCxWf4SZkTkdiSncDY5Nb7VlVfmsJbeT0mjGCyoUvZiJjGz7BX+XvW9l8+s2g9Lio5oXC/iM9kdOVsV3hGLY/NQv3G0f+ZPqYMEBKRqCCeMOh9Wcs2X4oxIdzPKS/EVRCBx4rmAJAvT3MkQiN+d0OGvzKJ6OnFB3etE2d18FXp1WcB87TqeNTld8W0HNj2kNnGKGUVyv7k43Xpt3voVAfU/SRUyTc+BG+oVcLjjuhRLDHxcl2kCVH2OCHHTmz7f2mvIdYL38vH5hyCz5DhuevtdAPlwDRRW482FYbCVqGHSX0t9kU5nZXLFjp606gw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Oaypr8iYcjZHBseB/7BZd9CKiYLXCtQ17e5hMPWb6qk=; b=1Yub+Nu9QnZKZKAOdoSrlIbBc2vCWlR/CWVOdqRrRN1kVqo2XQfe+tgZkAsj9E0xnYoE2ptSlS8ITjRoupatQR86gNmSVOUOLBumUmwIOC3I/D/Qa4FzCE7/hvDAQeQpqoOvtUxcU52ddE0yuEkuC8DNxOGC4mQun7q4/MXGIdQ= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; Received: from CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) by MW4PR12MB6951.namprd12.prod.outlook.com (2603:10b6:303:209::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7918.25; Thu, 5 Sep 2024 09:49:18 +0000 Received: from CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::ebfb:2f9f:f9ca:82cd]) by CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::ebfb:2f9f:f9ca:82cd%4]) with mapi id 15.20.7918.019; Thu, 5 Sep 2024 09:49:18 +0000 Message-ID: Date: Thu, 5 Sep 2024 10:49:13 +0100 User-Agent: Mozilla Thunderbird Subject: Re: [EXTERNAL] [PATCH v2] doc: add new driver guidelines To: Akhil Goyal , Stephen Hemminger , "dev@dpdk.org" Cc: Nandini Persad , Thomas Monjalon References: <20240814023604.124686-1-stephen@networkplumber.org> <20240814190901.14912-1-stephen@networkplumber.org> Content-Language: en-US From: Ferruh Yigit Autocrypt: addr=ferruh.yigit@amd.com; keydata= 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 8Zk= In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-ClientProxiedBy: LO4P123CA0393.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:18f::20) To CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CH2PR12MB4294:EE_|MW4PR12MB6951:EE_ X-MS-Office365-Filtering-Correlation-Id: 0ea03940-a4e9-49c9-e463-08dccd900259 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|366016; X-Microsoft-Antispam-Message-Info: =?utf-8?B?OEtNbXBsdnNGdXlBNHFYM3ZaN29lUGZZZlAxaG9CQXZtS0xwa3pYR3ljRzR4?= =?utf-8?B?S1JuZU5DaXBQZXF6bU9aa0RDR1llYlRDbmV5bTE1M2VIcENJQk1HR29wTFVL?= =?utf-8?B?c2w1ZmVUbE9uRmNOd1hMV1cxV1MrYXBQSUJub21ZbGJUNTN4QW9ZSDhFMmU2?= =?utf-8?B?V0dyY3FHMEZUZnVpR1NJR0diZVhrSGY5MjlkS2VwZm4yODgrT0NEb3FOTUd3?= =?utf-8?B?Vm50RGljYkRBaFM1MWNUTjVWSUtjYVVKU2lyQlBwakduQTNTLzR4dzF3NG5a?= =?utf-8?B?WHJTa1E5MG5KSGRRbkZITitVSnEydytmQmhzUjRKcGpLdjlLOFJSdFg0MUNT?= =?utf-8?B?UVRhVlBWeGJiSlI5U01OWlNuMURvWDJxcVZEamQ0a1lwczFGZm5DZzg0d1V3?= =?utf-8?B?TlQ3TXlGZXorOUtRdkN3akVYTHhjdlg0TnJWWDlRNUFwWUhybXIvWlpnR0R0?= =?utf-8?B?dnBEaWx6RlpROEpzTUFHOFhYbVA4T29nRFlDMHVZTlZscXRJVk9OZ2Rjd0ti?= =?utf-8?B?a3daby9tQ2ZURFAwWlNMdXJjZlVqV3dJMk53bUhDWjBZT1VCWmF5eEFmL29F?= =?utf-8?B?aGNaVzQyT05pRGU5RjdNekkxN0Zkd2oxVnVuSDNTZWROUlJJN1I2SjFWUHRQ?= =?utf-8?B?RnRnTnpyMVZ2anFpNHdPWVNxTlZibUdlTTRuWXJJN2Y2Y1Z3YzM4K0ZlQlNk?= =?utf-8?B?RVhwNTYyZ3dCSlBwU09EMWYyUXAvVDlFdjYyV3phK0ZzcW1sZkNCZzdnZExp?= =?utf-8?B?YlhKbzcxUGV4T0VmMHo4Q3c0VmlKc3Y0WFhCeGhZaDV2ZGlqSlJabFl2Y2VE?= =?utf-8?B?aHo3dVBKZG92ZmhPRXZHL0ZYZW5WREMwOFNpa1drQlFCK1FuaGhiQzd5cUNS?= =?utf-8?B?QnV4cStsSUdQb3BZMERQalY3RFlWamUwNjAzUUduQU9ZTkpQaFVtSlFjaDB4?= =?utf-8?B?a0o1UllJeFZ0cVVoNkJqaXNMODZmUkNxZmdxWTZRZHpYQklucUpDcVJKOUNG?= =?utf-8?B?Yi9ZbFpqSi9LMmJyWW9oa3lhcXB5WHlyRUZyUlBSTzRDbnB3WCtLVTU0VWI1?= =?utf-8?B?a3N1WmpUcHJDZGpIRDMzTld5dmlRNExqdGxNR1J4UG0zSW5nZ096SEdRK29L?= =?utf-8?B?aWlKdUZTRVBNQklCMHNpL1hPczZVczhHU20ydUJscGFobTk5cW9FSi9JcGJt?= =?utf-8?B?UG5RemdmUmNvOFp1UTM0WTBWaG5EUHpQNTZYalQrc3BCQTRXOEFtS0drNExz?= =?utf-8?B?bllMRG03TGhvbTNvTzVVdDdIMmNVaExVMktKK2dUc1hFd2k5NlRWbElVcE1M?= =?utf-8?B?MFlDcjR1am1QSEo1QWM2SmNxNU9QZXVpMDJHZGJvbW0zZEdGb3hLYWE4d05q?= =?utf-8?B?Ty9yUjJOVVFLVTZtR0IrUjNoL05wVkV5akRTUXpvZm1xMTJjY1djbisxZnBW?= =?utf-8?B?d1U0SXFVek5kcVJiQ3dqRW5CMUhncU93YmFqQXRXdFFtWi83cjRHczUyVEVs?= =?utf-8?B?dlI2SU1TQVRCOHNmS1k1bEx1TDN4Z2NscXhmaUY3bFlwMUJSU1ZLSmUxM1VN?= =?utf-8?B?RUs0NUhMOW5mSHM4NlAzNWRua2ZNZE1rMDdMYUdiejRuUi9lallDQk9FWStW?= =?utf-8?B?T0U0RUV3V051VUZrb2h2VkhuajB6amh5alE2MHc1Q0lGVzZ2aWpmQU8rNjZS?= =?utf-8?B?NS9pVFlaRENHNXh6WDBCOFhLU29nWGhyMmh1cklmQUp2QUdrMVJVR2NyVmk3?= =?utf-8?B?QUFUTXQ0eEVUOWxPZEdnbW5YajdqWU5JY2kwbFMxMUN5YkVHQ1kzV0hiNXJv?= =?utf-8?B?cWpCdUF4RlBlQnZYdFRMQT09?= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CH2PR12MB4294.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230040)(1800799024)(376014)(366016); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?MWlIMDdOaVZjTlhYT0ZXL1JId2tPNGdTTURLWWdWM0tjQzZ1VEN4ZHVzNnRK?= =?utf-8?B?R3NrUDJZeDdWeUhFWTd6UWNGSzlNV0VMbXFBbThXMHo2RXdvY1U2dHdPOVB4?= =?utf-8?B?OGN6dUV2MThvU0IyRkVET1BjQUZ4aFR1ZS96ZVVidGExNzFUQnU3Q2VwL2xP?= =?utf-8?B?K1Q3cDBGQSttaHJIczBhdjY5b2J5WDdpbkZjY3U3UmVTaUpnZVNuTkhldCtw?= =?utf-8?B?V2lkaUJIaHRhcUQrM05Kc1pJMjljZEpMUnZlMWlIcVRVeU55MDhBVkhuK0Yx?= =?utf-8?B?aUw2ZzNyaGt5VTBmdldLZ2RaNzd4WEdTRHpCRE05OWk5dlhKNk9RYjFLa3lo?= =?utf-8?B?TjN3Um5RWS9JNURpQnM5NTRjQlpnNlZBTUdUWGowV21POGlPMEVxT3hETTdT?= =?utf-8?B?U1NpQzkvWVpiVFptTVVoMzBuMFcwbnVZbXRlV0pLVnU5Q0FIKzJYK3RoRzhi?= =?utf-8?B?Q0JJelI0TzhHWGhkSWZUdE5LdCs1Vk9SbitGS1JRNVhDUEYxZjREeXlMNDYr?= =?utf-8?B?ckhuZGFYYWduaUEvUWs3NnpvdEhNRXVOT3hEMXMzT2pZbnhWTmZQMWFsVmIy?= =?utf-8?B?WnRPdTJaMjFLOEV1bE1PSVdSbnMxTG9xaFJWNENzRFpJWUNCcTNJRXhka0dh?= =?utf-8?B?SGFFQWxKa3hIbVR4OEJrTFpzaXpmOUVwK2VyaUdtZ3NKZzBNbEwxci9vUXVK?= =?utf-8?B?dUFTOVZtRE5jZzZsYkpEb0l4K3g4b283a01uUnA2RWVabkNERGFLSU94Q29r?= =?utf-8?B?WC9HQkFqMVUzRG1vN3hodzVrSW94b2R2SDQzWnlXUFp4TVhnV3FvTnh1UkFT?= =?utf-8?B?Y3pxQTBNM25WMGlxSlh1dTF3L3JIVjRObXFzUmt2V2NvdHovaGNvdllsdHpp?= =?utf-8?B?U1BkL1FFZ3hyeTYxWkd2VWEzYkR5aHQ4NEIvSGFBeGNBbFRiRVlpNkw1Qmxt?= =?utf-8?B?a3hGYmJ6dzVURTgwN3d1Rk14NDdlYzE5UUhtT3RZWm0zWmJhRmZpbmF5c3Bw?= =?utf-8?B?Ui9JdEFOZ2dCUVlNT3VLdFpqRWRobnlmZ0laMUNrcjE1SlN3dkp2RnhaVWJR?= =?utf-8?B?Uk1wczhVWHhlVDYwdFlrQ2J4aEYyOWVKSzhRbmpTV1ljNHZlRDJ4MmZ6Q1dX?= =?utf-8?B?azBUMGlwMEtnejN2YysxMWZJc2pTR3NzLzRadTBmYnlSSE9xazdObklrMURL?= =?utf-8?B?R1NSUk1FdTNJaTFobHBlckc2S2dvNjJtejVPcVMzekpoVHlnQXdscy9VUVoz?= =?utf-8?B?SnVXVk1NcXUxQWlNZUdRZzYxQ2c5MVR5UU5rNU54Z3hYWFJENVUyaVBFSFFU?= =?utf-8?B?amtXZE5NSmJTKytvbmhDYmZpNVphdWt2aG5VT0ZLMkxhbnpHNjVIZGRpczJ5?= =?utf-8?B?RkNqRVRGdXB5cktqcXRBWHdvQXUxR05LYm9iRlNKSG5Pa0U4MXVRR25vemww?= =?utf-8?B?R2tuSjNYaUg4aDEybjJDSGZwNXRFWEN1bVNKRDZONXhHVFVncEJzVnBOQTBG?= =?utf-8?B?V2xxalYwUEdCUjhzOHZVTmg0U0EwSmhqcEhuY1F0aU82SWd4VkdqQmprM1pl?= =?utf-8?B?TzR3YS9GYWYzNkF0NGpOOERmdkFIeFZLd1V4U0JOMWcxQkJld254U0dLcnJP?= =?utf-8?B?YWJDd0M1THJtOWJLNlMrTjdoREgrTUFOcnpnMU9HV09IZUpmOW9zWEw4SWY2?= =?utf-8?B?K0ZiYVczbGlXbFhxNXBhWGxsQUtaVVZyU0xzTFA1eTZtU1o3ZUdHcVpKalBz?= =?utf-8?B?cWc0TU8xTEk5RTlUYkpYb05GVXN1OGFhRDVkdWloS3FYMjRHUXRKMEY2NE1o?= =?utf-8?B?bXBYVXBVMnpOOUpFdTJ4WUhYRWlDaVNSZEpabXJ0eTJjOCtOZkQ2OVdWbjJ0?= =?utf-8?B?U3c4STlYV2NuWEdSaXd4Vmc3bzN6WVlyZDZjb1E3STBjNFFMU25Ga3hzSWln?= =?utf-8?B?TjJQT3gwcW1jSUNSZSsvMkhadEx0aXNlSnNESU5BTXIvd3B0emdNYk44MWlR?= =?utf-8?B?TjhqMjFXbFAxcVBXelowTUQrMnNQQWI4WCtza1NmWjhoMElkYVNnSlQzSnBj?= =?utf-8?B?L2ZSL1FvNzhhYXpsYUhQUmNsU2E4WkJ4WHB4QmZORTdaS3B0SnF2M2hkdzNt?= =?utf-8?Q?lONCoJLPMqAWpgmslnBd+G7/J?= X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0ea03940-a4e9-49c9-e463-08dccd900259 X-MS-Exchange-CrossTenant-AuthSource: CH2PR12MB4294.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Sep 2024 09:49:18.0059 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 9WeibQAxHBN1O4OODSEMWTRgNDYFOEm8eEjCXW9QeL+14D1IdLVKVApoz1NCWRnY X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB6951 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 9/5/2024 10:16 AM, Akhil Goyal wrote: > Few crypto specific suggestions. > >> >> v2 - review feedback >> - add co-author and reviewed-by >> >> doc/guides/contributing/index.rst | 1 + >> doc/guides/contributing/new_driver.rst | 202 +++++++++++++++++++++++++ >> 2 files changed, 203 insertions(+) >> create mode 100644 doc/guides/contributing/new_driver.rst >> >> diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst >> index dcb9b1fbf0..7fc6511361 100644 >> --- a/doc/guides/contributing/index.rst >> +++ b/doc/guides/contributing/index.rst >> @@ -15,6 +15,7 @@ Contributor's Guidelines >> documentation >> unit_test >> new_library >> + new_driver >> patches >> vulnerability >> stable >> diff --git a/doc/guides/contributing/new_driver.rst >> b/doc/guides/contributing/new_driver.rst >> new file mode 100644 >> index 0000000000..4aa1fd1d05 >> --- /dev/null >> +++ b/doc/guides/contributing/new_driver.rst >> @@ -0,0 +1,202 @@ >> +.. SPDX-License-Identifier: BSD-3-Clause >> + Copyright 2024 The DPDK contributors >> + >> + >> +Upstreaming New DPDK Drivers Guide >> +================================== >> + >> +The DPDK project continuously grows its ecosystem by adding support for new >> devices. >> +This document is designed to assist contributors in creating DPDK >> +drivers, also known as Poll Mode Drivers (PMD's). >> + >> +By having public support for a device, we can ensure accessibility across various >> +operating systems and guarantee community maintenance in future releases. >> +If a new device is similar to a device already supported by an existing driver, >> +it is more efficient to update the existing driver. >> + >> +Here are our best practice recommendations for creating a new driver. >> + >> + >> +Early Engagement with the Community >> +----------------------------------- >> + >> +When creating a new driver, we highly recommend engaging with the DPDK >> +community early instead of waiting the work to mature. >> + >> +These public discussions help align development of your driver with DPDK >> expectations. >> +You may submit a roadmap before the release to inform the community of >> +your plans. Additionally, sending a Request for Comments (RFC) early in >> +the release cycle, or even during the prior release, is advisable. >> + >> +DPDK is mainly consumed via Long Term Support (LTS) releases. >> +It is common to target a new PMD to a LTS release. For this, it is >> +suggested to start upstreaming at least one release before a LTS release. >> + >> + >> +Progressive Work >> +---------------- >> + >> +To continually progress your work, we recommend planning for incremental >> +upstreaming across multiple patch series or releases. >> + >> +It's important to prioritize quality of the driver over upstreaming >> +in a single release or single patch series. >> + >> + >> +Finalizing >> +---------- >> + >> +Once the driver has been upstreamed, the author has >> +a responsibility to the community to maintain it. >> + >> +This includes the public test report. Authors must send a public >> +test report after the first upstreaming of the PMD. The same >> +public test procedure may be reproduced regularly per release. >> + >> +After the PMD is upstreamed, the author should send a patch >> +to update the website with the name of the new PMD and supported devices >> +via the DPDK mailing list.. >> + >> +For more information about the role of maintainers, see :doc:`patches`. >> + >> + >> + >> +Splitting into Patches >> +---------------------- >> + >> +We recommend that drivers are split into patches, so that each patch represents >> +a single feature. If the driver code is already developed, it may be challenging >> +to split. However, there are many benefits to doing so. >> + >> +Splitting patches makes it easier to understand a feature and clarifies the >> +list of components/files that compose that specific feature. >> + >> +It also enables the ability to track from the source code to the feature >> +it is enabled for and helps users to understand the reasoning and intention >> +of implementation. This kind of tracing is regularly required >> +for defect resolution and refactoring. >> + >> +Another benefit of splitting the codebase per feature is that it highlights >> +unnecessary or irrelevant code, as any code not belonging to any specific >> +feature becomes obvious. >> + >> +Git bisect is also more useful if patches are split per patch. >> + >> +The split should focus on logical features >> +rather than file-based divisions. >> + >> +Each patch in the series must compile without errors >> +and should maintain functionality. >> + >> +Enable the build as early as possible within the series >> +to facilitate continuous integration and testing. >> +This approach ensures a clear and manageable development process. >> + >> +We suggest splitting patches following this approach: >> + >> +* Each patch should be organized logically as a new feature. >> +* Run test tools per patch (See :ref:`tool_list`:). >> +* Update relevant documentation and .ini file with each patch. >> + >> + >> +The following order in the patch series is as suggested below. >> + >> +The first patch should have the driver's skeleton which should include: >> + >> +* Maintainer's file update >> +* Driver documentation >> +* Document must have links to official product documentation web page >> +* The new document should be added into the index (`doc/guides/index.rst`) >> +* Initial .ini file >> +* Release notes announcement for the new driver >> + >> + >> +The next patches should include basic device features. >> +The following is suggested sample list to include in these patches: >> + >> +======================= ======================== >> +Net Crypto >> +======================= ======================== >> +Initialization Initialization >> +Configure queues Configure queues >> +Start queues Start queues >> +Simple Rx / Tx Simple Data Processing >> +Statistics Statistics >> +Device info >> +Link interrupt >> +Burst mode info >> +Promisc all-multicast >> +RSS >> +======================= ======================== > > For crypto, > Initialization > Configure queues > Configure sessions > Add capabilities. > Statistics and device info > Simple data processing > >> + >> + >> +Advanced features should be in the next group of patches. >> +The suggestions for these, listed below, are in no specific order: >> + >> +============================= >> +Net >> +============================= >> +Advanced Rx / Tx >> +Scatter Support >> +Vector Support >> +TSO / LRO >> +Rx / Tx Descriptor Status >> +RX / Tx Queue Info >> +Flow Offload >> +Traffic Management/Metering >> +Extended statistics >> +Secondary Process Support >> +FreeBSD / Windows Support >> +Flow control >> +FEC >> +EEPROM access >> +Register Dump >> +Time Synchronization, PTP >> +Perf documentation >> +============================= >> + > > ============================= > Crypto > ============================= > Chained operations > Scatter Gather > Security protocols - IPsec, MACsec etc. > Asymmetric crypto > >> + >> +After all features are enabled, if there is remaining base code that >> +is not upstreamed, they can be upstreamed at the end of the patch series. >> +However, we recommend these patches are still split into logical groups. >> + >> + >> +Additional Suggestions >> +---------------------- >> + > .ini file shall be updated for each of the new feature added in the same patch as code. > This is mentioned above as: "Update relevant documentation and .ini file with each patch."