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 5065BA0032; Tue, 16 Nov 2021 16:45:51 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 322ED41C3D; Tue, 16 Nov 2021 16:45:51 +0100 (CET) Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2054.outbound.protection.outlook.com [40.107.223.54]) by mails.dpdk.org (Postfix) with ESMTP id 398BE41C27 for ; Tue, 16 Nov 2021 16:45:49 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=hawkgzpttesG5Gn2vqNpCT114uoeQ+urdaKUxjdNJujqbJmbdAjz9k8Deaqf6C8hrB360pDMbIFFYQjBIQ+NzNsnxyyNiz1stNSiBfCwzS3dNjTebtE/gFo6+WSMRlXvHOI0VztHvBNhEQJZLJGSOvsUICtQOcx7KqD0UBVVh2lzJ1viOrXLU1XKABadcwyej08KqlhfaXnleOtJOZ+zYw5pwuojwUqwyvbm5Z4sFp/XOCJTrz6FG1KoHTTt5NSoIk5vRHyptrC+DxBK7ihui0j9oQfxGBv4OfJwFznDLyDyv8KC7ivFTI7PjgpWcCtIuAoNCtdr+CE1k1Xfnp49tw== 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=UD3g0W2nyQvh61era3OsrX9vKIHc458X6f+SL+OFYxE=; b=Z0p7SpPMx05w0SdBn0Qofw4Mi+XaNSaMfXczM9o5w9cY7Hk1wp/vXaXcloBrSgKWDdPxgDXlrXcRpgCRr+ZA6jMQYirCwy9MDMRKIfZo37HHXRU+V58qe3u5kRhCt7bc+Aun6wcfWb6zCLAEcRNzDYIu63YpIUIPdz/kAjvddIgS4Ez4pq6W+b+NDDz2nwcFRrz65s41Me605gbqiiFHIXkm5j+eKfq6/euwReT4bWTR7K9/PXJKVHCHlVDafwrmQEp5qOpkn/GUIgSVu2GOlXgCh319rK4gmBt4+L7doSdTwdq8AU2mFK5SPc5W27TSJsMRIPIsqORhndHAlB1e5g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.112.34) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=quarantine sp=quarantine 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=UD3g0W2nyQvh61era3OsrX9vKIHc458X6f+SL+OFYxE=; b=MRTLOsMS5hbqd9DGohSh9OUiL5hdCnT8pqZ0GaDBXvKHAjmOGsUJzq2qMKMCsTQCyFNQvHUwOczBpmirLlmKXiKc8v8vMpoUvFykYBqv7muHFVh/ba+1p0fXiGAGqx8BcqW9JD8TXwdSF5Xp/vY/icGgB/71THfkaPYKZuA9GWzUmBGGD+cMJNo0EzTEbNEokfReqEyPuIAUYsKMvY8pQV6J0/lHxZTut0g/vFasXWp/MaXZwu336GmjgrMG6aqVdLgC4lBkosu3fBHmO6wgkSAbgQn9WLsVm5U9n2vToYOyR5aQ+TOWkyxIfzg1nYg0LXl3fizs/LJfd2hCYRjKpQ== Received: from MW4PR04CA0363.namprd04.prod.outlook.com (2603:10b6:303:81::8) by BYAPR12MB3638.namprd12.prod.outlook.com (2603:10b6:a03:dc::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4690.26; Tue, 16 Nov 2021 15:45:43 +0000 Received: from CO1NAM11FT033.eop-nam11.prod.protection.outlook.com (2603:10b6:303:81:cafe::2c) by MW4PR04CA0363.outlook.office365.com (2603:10b6:303:81::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4690.26 via Frontend Transport; Tue, 16 Nov 2021 15:45:43 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.112.34) 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.112.34 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.112.34; helo=mail.nvidia.com; Received: from mail.nvidia.com (216.228.112.34) by CO1NAM11FT033.mail.protection.outlook.com (10.13.174.247) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.4690.19 via Frontend Transport; Tue, 16 Nov 2021 15:45:42 +0000 Received: from nvidia.com (172.20.187.5) by HQMAIL107.nvidia.com (172.20.187.13) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Tue, 16 Nov 2021 15:45:26 +0000 From: Gregory Etelson To: , CC: , , Matan Azrad , Viacheslav Ovsiienko Subject: [PATCH v2] doc: add mlx5 PMD flex item documentation Date: Tue, 16 Nov 2021 17:45:14 +0200 Message-ID: <20211116154514.4029-1-getelson@nvidia.com> X-Mailer: git-send-email 2.33.1 In-Reply-To: <20211116145139.837-1-getelson@nvidia.com> References: <20211116145139.837-1-getelson@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [172.20.187.5] X-ClientProxiedBy: HQMAIL111.nvidia.com (172.20.187.18) To HQMAIL107.nvidia.com (172.20.187.13) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 79f3a6d2-9de1-42c4-d0b3-08d9a91825df X-MS-TrafficTypeDiagnostic: BYAPR12MB3638: X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: FaZNJ3Sg9NirRcY/1C86H6iqOKIkyHE9OsyV0TbzOKQAB58AK+bOJouNKenL7ED6qUFk3i9u1lOptGTyWWnMTRXNG5vF3HdrKXQV60231llkwXGrqqUQlwkGKOkEPEr1eSA9T2xHCLdUBlA7AEUUb9IBoK4lAcV9sm9b+NUupHitfIjjRZtYfbQqNzhNOvfAtBZMT7R54Y2BBuHosZTOUrgcOXttYHGujJFnqSXK2zNsI/0/XZ48YvzEvlIDSYmOUvet9gYSqGUlpbSS3I5OQzFElfr10UjJ8ce0U3eUWJPd306LNRP2ZGkf5aIxkGSwm1+QsO8EPYqdxPgnVIg/GIPSQBMEBVq2ZEU8vaPbG6gw3BshisDewJvqzxLb4pJhVJOekocRVAIi4mOKS2WsKNM1hkpcum07wXt1LsYWvk5gzDmwYbOucx7yxL+PPQ+47ysrbF2xfPqVLbPsffFlXLODjbal8nrXkj1d0vqoIZSXl87syY4JXAiXWnAoaxp12MsO1Amvs8nZhIJO1Wv+5WhuAYM1muanzSjh6/PRYVyDMbh6F4HtkfbP/gpNnc9Xyt6mOmCH4Ta34AaUnDYa1Kf7froQVHuoxvGKs74svPzR35O6Q8hWw1cBVTG7L8i5aVsHtCA1MUM3s3dcO0e2GtyJfXUqkBLljYKOiBJMIJuW9IE+grQ+dLkgipl3CNyHxkMLjauqYK0WZIMc5u4KLQ== X-Forefront-Antispam-Report: CIP:216.228.112.34; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:schybrid03.nvidia.com; CAT:NONE; SFS:(4636009)(36840700001)(46966006)(336012)(508600001)(426003)(316002)(7049001)(6666004)(7696005)(86362001)(8676002)(36860700001)(2906002)(47076005)(1076003)(107886003)(6286002)(356005)(70586007)(70206006)(54906003)(4326008)(55016002)(16526019)(36756003)(36906005)(82310400003)(26005)(8936002)(2616005)(83380400001)(7636003)(5660300002)(110136005)(186003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Nov 2021 15:45:42.8210 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 79f3a6d2-9de1-42c4-d0b3-08d9a91825df X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.112.34]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT033.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR12MB3638 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 Describe firmware configuration requirements. List mlx5 hardware and PMD limitations. Signed-off-by: Gregory Etelson --- v2: Style fixes. --- doc/guides/nics/mlx5.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 552e06c0db..855ee9a119 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -494,6 +494,17 @@ Limitations from the reference "Clock Queue" completions, the scheduled send timestamps should not be specified with non-zero MSB. +- Flex item API: + + - Hardware support: BlueField 2. + - Flex item is supported on PF only. + - Hardware limits ``header_length_mask_width`` up to 6 bits. + - Firmware supports 8 global sample fields. + Each flex item allocates non-shared sample fields from that pool. + - Supported flex item can have 1 input link - ``eth`` or ``udp`` and up to 2 output links - ``ipv4`` or ``ipv6``. + - Flex item fields (``next_header``, ``next_protocol``, ``samples``) do not participate in RSS hash functions. + - In flex item configuration, ``next_header.field_base`` value must be byte aligned (multiple of 8). + Statistics ---------- @@ -1260,6 +1271,11 @@ Below are some firmware configurations listed. REAL_TIME_CLOCK_ENABLE=1 +- enable dynamic flex parser for flex item:: + + FLEX_PARSER_PROFILE_ENABLE=4 + PROG_PARSE_GRAPH=1 + Linux Prerequisites ------------------- -- 2.33.1