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 84379427FC; Wed, 22 Mar 2023 01:00:23 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4E13042BDA; Wed, 22 Mar 2023 01:00:04 +0100 (CET) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2087.outbound.protection.outlook.com [40.107.94.87]) by mails.dpdk.org (Postfix) with ESMTP id D6F3E410DD for ; Wed, 22 Mar 2023 00:59:59 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QYThUA3CPeqZ2C4Kb81yk4y61JVSSS7FcgtwXizQXODEi3Omh+yzL715ncEvMt/d5+HGK74RDA0wYcndxGlrXH5kzLGg13v/QC9L2EfPuKyq3+j8kwolK07A6DBBzNzJ6YXwkzZ+7Ln+n35gn/9kXczFPwuH8Ddd94K9gV9oZpwVz6yDFh0bWTXgrciNU4Pr+5nTMQjn8T9dVyGp8wl5+ta9MCfPyZW+ueLHaHXobgzERqZK6EC1aJFiAPrvE8QkRJat+GA+418g0S+N8i81BKPOpocBHgfXPc2OlfRHEvDuG7NVUE6n6iKY5iQy4fFAt46kqUFJdwA9yN6qeSvKww== 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=GsYMWTdpoNre0P++OWkZnYo3xTCC79LCZAHLT/uIMXc=; b=dVN1fvJcZjVCXQi83FgPGH0YF3rJpGWCtbVfta7G1obysEhF2XDFTG6O3WysImXBlJyY5MjFHIgSEdDuW7gVs9RpR5FplrWV/UQXNGvg0YHLk3AOOn2jOc69DfNfLocEHew2byTWpaGU4ngl8R/7/40993t62tW11kGlNRRLD889OTmRfLqlVi+PlHVcTfjQPCvucBQFW+NSSZi/kW/ATRyTae4lx9DKggZMr+xdKLdODRZOJ7rafXseei+FHSUfU3TEi3pQqok0N3nmUFzr3Q/GCBRdVGil9ubo53t9SPBKPP6fqA2xynkrW+f11rEXjh6X+iij/q2dRBMpfcDVqA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=intel.com smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); 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=GsYMWTdpoNre0P++OWkZnYo3xTCC79LCZAHLT/uIMXc=; b=k7/zt1S+QZYQlOKUSJS0MiF8wynUwlosyOFKaI0vyni735wtd7jRCoXeeeP9KGnt7Z2vVYPyZD9LGR5RMwgdelFw9oMa6QcrGq1cryD0IqjYe+vFkZe+t0GEAXrzXaDQLF84p+rdzXvNFkAtPJEn4mh0OTiCi9UamqLtq8qaTlA= Received: from MN2PR14CA0001.namprd14.prod.outlook.com (2603:10b6:208:23e::6) by SN7PR12MB7883.namprd12.prod.outlook.com (2603:10b6:806:32b::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37; Tue, 21 Mar 2023 23:59:57 +0000 Received: from BL02EPF000100D2.namprd05.prod.outlook.com (2603:10b6:208:23e:cafe::93) by MN2PR14CA0001.outlook.office365.com (2603:10b6:208:23e::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37 via Frontend Transport; Tue, 21 Mar 2023 23:59:57 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by BL02EPF000100D2.mail.protection.outlook.com (10.167.241.206) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6178.30 via Frontend Transport; Tue, 21 Mar 2023 23:59:57 +0000 Received: from telcodpdk.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Tue, 21 Mar 2023 18:59:53 -0500 From: Ferruh Yigit To: John McNamara , Rahul Lakkireddy CC: Thomas Monjalon , Andrew Rybchenko , Subject: [PATCH 03/33] doc: update cxgbe guide Date: Tue, 21 Mar 2023 23:59:11 +0000 Message-ID: <20230321235941.2169068-4-ferruh.yigit@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230321235941.2169068-1-ferruh.yigit@amd.com> References: <20230321235941.2169068-1-ferruh.yigit@amd.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB03.amd.com (10.181.40.144) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BL02EPF000100D2:EE_|SN7PR12MB7883:EE_ X-MS-Office365-Filtering-Correlation-Id: dd7e9775-e406-4177-7f17-08db2a685fd4 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 2xEKdcByUDbihLrASSxe6bFNM8NYFCBaMsvdp7S+iJphoN1AbuQx3KqCBV9CMvTXOC8S6tlVojLamY+m9xXEFK2wS7uHRVGjz/yvRgxl/RyLSI44ZqtL/YOZXlJHMyuUTfmvvJatTq0U3r6SsFoV7cGvnEvm+o++AxBUn27k66asY1E+V9j9aPkIzCuppyXGjW2yuC7zZnNRmtEkFzyfXu19DGhdqtrTp4WYCK4xRgmlj8PDczcbSR9TWC9cVFlmfiSYwpUAfCO4aYCAPFlHeX5SCwTk1eb7KYLxxiluziR+1tCWzDFKIcM9QTrxH/hH0gmoZ11Lyt9Hvzt7fCzZaT1TZ/BmjTTANUViy3BftQnXIu91sR2EYy5Ql5A/8950qFSKfTKt1IRh7qKaZfJjr4SpK4T+iUWWKIGcUbzR6YH5kmGm0HdquNO27NTytv1qIIC07RRYgzSQAEvoSvgNyfYx0ZumVmJQWqjCrtbFILK7aa6VXxzs2BDx3g3I4885Vet1J0sTZftmrfBJTKnHdF7VHugf/wy/6iFyXtBWNQ+P8+o1cjFeiBrYwg6uRVEwJLB6MrOmgHSZIMODV8FkHd23Eq1J3w9A7DbeKK9VZ30liU3Xi2/s8giaa2J6SeJdBhP8kkY5AxCVAyzxi8WEsfjeC7j5kHQ5d4qMJsLmKD+vSzqo0o42X7tasvnPwM5NMHUOyTvv+p1M9dhwc4H/RUWmqUZfoEgl2VEpYcr/FCA= X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230025)(4636009)(376002)(346002)(39860400002)(136003)(396003)(451199018)(40470700004)(36840700001)(46966006)(47076005)(2616005)(426003)(83380400001)(82310400005)(54906003)(110136005)(26005)(6666004)(316002)(1076003)(5660300002)(186003)(44832011)(478600001)(81166007)(356005)(336012)(16526019)(36860700001)(7696005)(40460700003)(86362001)(2906002)(82740400003)(70206006)(8676002)(40480700001)(8936002)(36756003)(70586007)(4326008)(41300700001)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Mar 2023 23:59:57.5471 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: dd7e9775-e406-4177-7f17-08db2a685fd4 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BL02EPF000100D2.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR12MB7883 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 - Move supported device list up - Rename "Runtime Options" section to "Runtime Configuration" - Move "Limitations" section down Signed-off-by: Ferruh Yigit --- doc/guides/nics/cxgbe.rst | 61 ++++++++++++++++++++------------------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst index 6d20384b70ed..1f0b848ede11 100644 --- a/doc/guides/nics/cxgbe.rst +++ b/doc/guides/nics/cxgbe.rst @@ -15,34 +15,6 @@ and has support for the latest Linux operating systems. More information can be found at `Chelsio Communications Official Website `_. -Features --------- - -CXGBE and CXGBEVF PMD has support for: - -- Multiple queues for TX and RX -- Receiver Side Steering (RSS) - Receiver Side Steering (RSS) on IPv4, IPv6, IPv4-TCP/UDP, IPv6-TCP/UDP. - For 4-tuple, enabling 'RSS on TCP' and 'RSS on TCP + UDP' is supported. -- VLAN filtering -- Checksum offload -- Promiscuous mode -- All multicast mode -- Port hardware statistics -- Jumbo frames -- Flow API - Support for both Wildcard (LE-TCAM) and Exact (HASH) match filters. - -Limitations ------------ - -The Chelsio Terminator series of devices provide two/four ports but -expose a single PCI bus address, thus, librte_net_cxgbe registers -itself as a PCI driver that allocates one Ethernet device per detected -port. - -For this reason, one cannot allow/block a single port without -allowing/blocking the other ports on the same device. - .. _t5-nics: Supported Chelsio T5 NICs @@ -67,6 +39,23 @@ Supported SR-IOV Chelsio NICs SR-IOV virtual functions are supported on all the Chelsio NICs listed in :ref:`t5-nics` and :ref:`t6-nics`. +Features +-------- + +CXGBE and CXGBEVF PMD has support for: + +- Multiple queues for TX and RX +- Receiver Side Steering (RSS) + Receiver Side Steering (RSS) on IPv4, IPv6, IPv4-TCP/UDP, IPv6-TCP/UDP. + For 4-tuple, enabling 'RSS on TCP' and 'RSS on TCP + UDP' is supported. +- VLAN filtering +- Checksum offload +- Promiscuous mode +- All multicast mode +- Port hardware statistics +- Jumbo frames +- Flow API - Support for both Wildcard (LE-TCAM) and Exact (HASH) match filters. + Prerequisites ------------- @@ -88,8 +77,8 @@ Prerequisites for FreeBSD. -Runtime Options ---------------- +Runtime Configuration +--------------------- The following ``devargs`` options can be enabled at runtime. They must be passed as part of EAL arguments. For example, @@ -886,3 +875,15 @@ during the Chelsio NIC probe, in following order. level details that is specific to the Chelsio NIC. Hence, the firmware configuration file must not be modified without expert guidance from Chelsio support team. + +Limitations +----------- + +The Chelsio Terminator series of devices provide two/four ports but +expose a single PCI bus address, thus, librte_net_cxgbe registers +itself as a PCI driver that allocates one Ethernet device per detected +port. + +For this reason, one cannot allow/block a single port without +allowing/blocking the other ports on the same device. + -- 2.34.1