From patchwork Mon Jul 10 08:49:08 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dariusz Sosnowski X-Patchwork-Id: 129417 X-Patchwork-Delegate: rasland@nvidia.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 A0B6A42E3A; Mon, 10 Jul 2023 10:49:45 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 760F240C35; Mon, 10 Jul 2023 10:49:45 +0200 (CEST) Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12on2049.outbound.protection.outlook.com [40.107.244.49]) by mails.dpdk.org (Postfix) with ESMTP id 82E3540698 for ; Mon, 10 Jul 2023 10:49:43 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OvMcP/M8XgNQ10EfO0rM0ROjbO5sDviYOGRCFd9Rz3rM+DzqZuGlMJzIgkCQzqJjDuN2PhBh3r7ZWBDXR7+yIuHyQ3YDBZPjoWE9Gw9gKEE0TbuTlEvOQFjsk2ZalJ6H81wUgNGPv+32mIEfEdejkvYHjuLDRLCtajkmTT3scSkPmciqb2kRv/Wc46PQbiN12lQvw9KxOD5pHTTbDqGXoSeccefe4R3WWTeS+6cKabwxewJxVNgdTMUAuIgBDMT0ayDExAPHci8wvivQlMJZ1xYBIYkLePp3hSza9YXnSQ9TFvpPGnPuN9WKaH1jkxxCpLeMq3KxzzbyI1JGvYWHFg== 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=DoUlOY6fwIGCNQ6+hVTwtd0MKjDw5qoK7XwitOX4abk=; b=gcDGu/wH1ipq/7fwllgdsSburidBUtdZ/YPMFnONWtR/0UKLsTxJCVcvWOeVwY0+e74ctPw3ofVsxxelrtuV1evIRHWooT1//rHPfwsUF8nj/UeN+bPTdrWj0YwVEjgxbUjQIoxXX/KRQZW+yfYwjjBkC3Figwu+3d2jjAgUoJbqpsQ9F3iEk7uQ4pmP/jwYvw2gMB1rA764EiE6UlFtan/xYfZV/M0SYNNE0sSiE7yMugKcciH3Rwn7/FFiUOtzw4GhcTVR0w1T4PwNeu53dvoSz8L1t0XpJdDjbDXZkj10L16EnUnq+b0aCCV/ixPhqp9ehrIwjjxurrm35Z/zBQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=DoUlOY6fwIGCNQ6+hVTwtd0MKjDw5qoK7XwitOX4abk=; b=UyB7F9pzlQcjlT5wEUk192lO8rjJUq0lKPzOSD+19N5ShPi5XKmzPEBw8kKIJTWzhrlmZKImArA21hvkErZO6v8daf+ZMdM85WRZcvi+ZkfmdF/mp/RqhPrmf332UGAeZ9xQWL91xgLagVklFd+iv+X0w/FNPwloqGj1H9pw8XsEDVv6anfBgtPXnvPEVOEaO3q8UFeoKXjsZTV1XaorSVywGEPzIRqRIKasTsjaaCec/7Ev66Wr0zRWMWdSSbp7AHSRJiCGAttR5w8yUNqZie4icqRhNFfFFd+9gddJIoigTu2MTFBpY9OO/9OSUQpaAoT7XRepcatiVc5QYX6RHQ== Received: from BN8PR15CA0065.namprd15.prod.outlook.com (2603:10b6:408:80::42) by DM6PR12MB4041.namprd12.prod.outlook.com (2603:10b6:5:210::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.30; Mon, 10 Jul 2023 08:49:41 +0000 Received: from BN8NAM11FT060.eop-nam11.prod.protection.outlook.com (2603:10b6:408:80:cafe::8b) by BN8PR15CA0065.outlook.office365.com (2603:10b6:408:80::42) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.31 via Frontend Transport; Mon, 10 Jul 2023 08:49:41 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by BN8NAM11FT060.mail.protection.outlook.com (10.13.177.211) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.38 via Frontend Transport; Mon, 10 Jul 2023 08:49:40 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Mon, 10 Jul 2023 01:49:29 -0700 Received: from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Mon, 10 Jul 2023 01:49:27 -0700 From: Dariusz Sosnowski To: Matan Azrad , Viacheslav Ovsiienko , Ori Kam , Suanming Mou CC: Subject: [PATCH] doc: add outer UDP checksum limitations for mlx5 Date: Mon, 10 Jul 2023 11:49:08 +0300 Message-ID: <20230710084908.3503447-1-dsosnowski@nvidia.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT060:EE_|DM6PR12MB4041:EE_ X-MS-Office365-Filtering-Correlation-Id: c3122a9f-4aa2-4e25-08f4-08db812299b1 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: lsfk3VjkhX7YndcIQhDcqiJTcmS1ZOu8EjBPQdY6WCFKF42zjpRqSGOG+xKH1nraheEV/95IMxko5wybbyv55ZzPNHkI2vmSGf3Rz7i5Drw+rDYNDuw1vDLU2fZgmUCziwiPboleo69UnvefaujASg3NxzCit1uUM2qOi/n3kjLYw/qM10ZrIPyaqWuQ6zrlnC8na8Hz5mzh+0X0p8wIn9DD4qFgnu2mT/RU6AKokLecw9zj3310dNCQLiavLHcVh+4rH5JigwJ5Ih7uRL6cAX/oGy+5C65ef5vPB2WOYu5i9glMC185A3+gZYHy3KXS4reXTvDNrH61KzkihcnnztXRSdeLkkfuVLuQkHVJaqC2DHwoPj+G3pD1TSqDbXmy6bWZfYnOHzTkYJYjqmpNe/TC0aR3OKZo6knLZtMWYbntnnpDLAHR0/AdXiL0Jpa0cN9rM1WechUtRjsuBRZ9bqCC8du3sb3gyah/RSqk+s/IDJNoU6QxblFbaHoX2xS/nMaI9JG7rRvfRXo1LfDfq3ztc/0yV6UvH6wPWoqWh0AjFNxO5U05OpgseqvEEyUAvsDrzPxEZGeqCKJ/trt0ikoAywkzMHEAPOq4uGplx+ghukot2825OSQ+tSv9bbycz6LdNkmGv539EQzZyQxnjibIzJa6F5JkI7ylu+yjpfe/jMHIhi3rRJ4GME//0avch7m1I61I6yysDSc/ZNCflSzhLy1WjlPAm8kknW5PAVlI+2K00CrtM530fag1cNHP X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(39860400002)(376002)(136003)(346002)(396003)(451199021)(36840700001)(40470700004)(46966006)(40460700003)(186003)(6286002)(16526019)(26005)(2616005)(1076003)(36860700001)(336012)(426003)(83380400001)(47076005)(41300700001)(4326008)(6636002)(2906002)(316002)(5660300002)(8676002)(8936002)(478600001)(7696005)(6666004)(70586007)(70206006)(110136005)(40480700001)(55016003)(36756003)(7636003)(356005)(82740400003)(86362001)(82310400005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Jul 2023 08:49:40.8569 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: c3122a9f-4aa2-4e25-08f4-08db812299b1 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT060.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR12MB4041 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 Currently available NVIDIA NICs and DPUs do not have a capability to calculate the UDP checksum in the header added using encapsulation flow actions. This limitation was not documented in mlx5 PMD docs. This patch adds this limitation to the docs and describes application requirements. Signed-off-by: Dariusz Sosnowski Acked-by: Ori Kam --- doc/guides/nics/mlx5.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 505873ecfd..43aef669e6 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -480,6 +480,14 @@ Limitations - The input buffer, providing the removal size, is not validated. - The buffer size must match the length of the headers to be removed. +- Outer UDP checksum calculation for encapsulation flow actions: + + - Currently available NVIDIA NICs and DPUs do not have a capability to calculate + the UDP checksum in the header added using encapsulation flow actions. + + Applications are required to use 0 in UDP checksum field in such flow actions. + Resulting packet will have outer UDP checksum equal to 0. + - ICMP(code/type/identifier/sequence number) / ICMP6(code/type/identifier/sequence number) matching, IP-in-IP and MPLS flow matching are all mutually exclusive features which cannot be supported together (see :ref:`mlx5_firmware_config`).