From patchwork Fri Nov 10 12:14:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kevin Traynor X-Patchwork-Id: 134105 X-Patchwork-Delegate: qi.z.zhang@intel.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 03E15432E6; Fri, 10 Nov 2023 13:14:22 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C5C804064C; Fri, 10 Nov 2023 13:14:21 +0100 (CET) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id B9BEB40291 for ; Fri, 10 Nov 2023 13:14:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1699618460; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=WBR8ndHxKnlt5807EmtBuQ3zb3KrN/29kRiLqed/9lg=; b=SWRKyawd45gE8Fx4K9s1CbQOruze9DtTyPvMUQhCElRDa/RM+0UziFvzig37kauDSIkpLO wFBqcUYwiTVdB42Ht8KOW0UBjtq8UKvNGFHK7M9JF25O0N/6wBRAPPRcrrLDNbZFtHynPR oF/D49qdS37a1s2Q+zRExrVOka0z8fc= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-48-X0XIYfNRNH6qNIdyaB93Iw-1; Fri, 10 Nov 2023 07:14:17 -0500 X-MC-Unique: X0XIYfNRNH6qNIdyaB93Iw-1 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id AE88D185A781; Fri, 10 Nov 2023 12:14:16 +0000 (UTC) Received: from rh.Home (unknown [10.39.194.9]) by smtp.corp.redhat.com (Postfix) with ESMTP id DF4B01121306; Fri, 10 Nov 2023 12:14:13 +0000 (UTC) From: Kevin Traynor To: Yuying Zhang , Beilei Xing , Qiming Yang , Qi Zhang Cc: dev@dpdk.org, Kevin Traynor , stable@dpdk.org Subject: [PATCH] doc: update matching list recommendations Date: Fri, 10 Nov 2023 12:14:07 +0000 Message-ID: <20231110121407.444282-1-ktraynor@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.3 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.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 Update documentation to stop recommending that out-of-tree Linux Kernel drivers are used for i40e and ice. Cc: stable@dpdk.org Signed-off-by: Kevin Traynor Acked-by: Qi Zhang --- Sent mail explaining background here: http://inbox.dpdk.org/dev/d212cb6e-53fd-b017-0d93-ff0b014768c4@redhat.com/ --- doc/guides/nics/i40e.rst | 13 ++++++++----- doc/guides/nics/ice.rst | 15 +++++++++------ 2 files changed, 17 insertions(+), 11 deletions(-) diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index 791e9553bc..8b2a94060c 100644 --- a/doc/guides/nics/i40e.rst +++ b/doc/guides/nics/i40e.rst @@ -89,11 +89,14 @@ Windows Prerequisites `_. -Recommended Matching List -------------------------- +Kernel driver and Firmware Matching List +---------------------------------------- It is highly recommended to upgrade the i40e kernel driver and firmware to -avoid the compatibility issues with i40e PMD. Here is the suggested matching -list which has been tested and verified. The detailed information can refer -to chapter Tested Platforms/Tested NICs in release notes. +avoid the compatibility issues with i40e PMD. The table below shows a +summary of the DPDK versions with corresponding out-of-tree Linux kernel +drivers and Firmware. The full list of in-tree and out-of-tree Linux kernel +drivers from kernel.org and Linux distributions that were tested and verified +are listed in the Tested Platforms section of the Release notes for each +release. For X710/XL710/XXV710, diff --git a/doc/guides/nics/ice.rst b/doc/guides/nics/ice.rst index 6e71aac3c2..0f7a797ad5 100644 --- a/doc/guides/nics/ice.rst +++ b/doc/guides/nics/ice.rst @@ -42,11 +42,14 @@ Windows Prerequisites -Recommended Matching List -------------------------- +Kernel driver, DDP and Firmware Matching List +--------------------------------------------- -It is highly recommended to upgrade the ice kernel driver, firmware and DDP package -to avoid the compatibility issues with ice PMD. -Here is the suggested matching list which has been tested and verified. -The detailed information can refer to chapter Tested Platforms/Tested NICs in release notes. +It is highly recommended to upgrade the ice kernel driver, firmware and DDP +package to avoid the compatibility issues with ice PMD. The table below shows +a summary of the DPDK versions with corresponding out-of-tree Linux kernel +drivers, DDP package and Firmware. The full list of in-tree and out-of-tree +Linux kernel drivers from kernel.org and Linux distributions that were tested +and verified are listed in the Tested Platforms section of the Release notes +for each release. +-----------+---------------+-----------------+-----------+--------------+-----------+