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 A15C4A0032; Tue, 16 Nov 2021 15:52:10 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3D4F841233; Tue, 16 Nov 2021 15:52:10 +0100 (CET) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2068.outbound.protection.outlook.com [40.107.237.68]) by mails.dpdk.org (Postfix) with ESMTP id 364894115F for ; Tue, 16 Nov 2021 15:52:09 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OxmOk2Ap8h7p8nTjwdaGBiYg+r7y1ahIhH26j+QbqLXMQMhn/Z511FE0z+MoP5rITgMh+I9AwOGgmJBsGx+L9Y38bsPbFvmp54f68diWMaiBkViPomgntFmid9Zj6JzhX40yc+7RUb6sB1P7DfEQE8+YK2CHI1wJyPJeVLV2D4xqxh7H55w1CtrieYKV2sYLf/RoPwXbAK3HDXeEJQlqfkGr2FZYpN4o9+7Vem3eNI4MhjJqI8ur6yYFcwUF4szFkMCyKPrSxa+FYbiyD/pwiFxkYT1Of/hCnKFLT9LN6Xa+3oTJmTtTMlK8OC5jT4lS2qHeJJ/zuHwiF/oh1CMMoA== 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=zs2poY6/WCKp95Y5ssfdWeixqS0ytJzy6ZsB05vfcwI=; b=gNGfAY1Vq369G8fw8k5mcPRaHGGc8FPSkrjYVHXaS3OB/WVQP7ItxZpY0tymC3RNispstJ2rmoE4FIjaVRVyn8ZR0KYn/dND0n9WCqdA32fBcD9s5Q3Z0bA83K4udkQaBoKr86maYlNihVfcDBunQ44L4sf+aClmPsQw/hpy/Rd92cyuVfaThY6WgN8EvanqmL+ZbzS/WpQ7GYeFREuQ+UwRHEbenoD8k7dmbqjr7VwX0A5LpQKNrFLaNBeCsAj1/LL56wDigOUZn6Ea7TgPP9u2MbF9faCkSJeEW+4pRvrYQAQ5HjxtvMy5VxAR8OrJQSxXfcXdwHEbEbi+cWmJXw== 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=zs2poY6/WCKp95Y5ssfdWeixqS0ytJzy6ZsB05vfcwI=; b=OQVTiBDo0Tg2d3ZOe0HN90mrwFY7LlW0ngS/3F+uxRr69mEPBFJL1ygd/chRDd6q5Me4oHD0iwmLfNPakktg7Fpm5dkOklPXayVG144RNu1Iyxf5Li8xeE1UyGwy1jaroovKZRxtJf9B0SatzIKZfExOkDkw5Z/X9OQEgACn0EVF/XliTSJDUNt8WDXBW1+yoAqMjothpAB4nyJYt00XWCA2zUq/V+Jj8PbDPlP3Y+b4woZi7u52QFFqtlz+Lz52DumJr0IJmIPZmJhvwKG9ePpg5V3DIDMDPM/7VwVz0teQuTKZIcwgJ4h65hZbqYy00dJL4GYEEFJhwY0yE+Kc0A== Received: from BN9PR03CA0347.namprd03.prod.outlook.com (2603:10b6:408:f6::22) by DM6PR12MB4106.namprd12.prod.outlook.com (2603:10b6:5:221::7) 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 14:52:08 +0000 Received: from BN8NAM11FT022.eop-nam11.prod.protection.outlook.com (2603:10b6:408:f6:cafe::ef) by BN9PR03CA0347.outlook.office365.com (2603:10b6:408:f6::22) 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 14:52:08 +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 BN8NAM11FT022.mail.protection.outlook.com (10.13.176.112) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.4690.15 via Frontend Transport; Tue, 16 Nov 2021 14:52:07 +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 14:52:01 +0000 From: Gregory Etelson To: , CC: , , , Subject: [PATCH] doc: add mlx5 PMD flex item documentation Date: Tue, 16 Nov 2021 16:51:39 +0200 Message-ID: <20211116145139.837-1-getelson@nvidia.com> X-Mailer: git-send-email 2.33.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [172.20.187.5] X-ClientProxiedBy: HQMAIL105.nvidia.com (172.20.187.12) To HQMAIL107.nvidia.com (172.20.187.13) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 48738ad2-05c4-4c78-0d1c-08d9a910a989 X-MS-TrafficTypeDiagnostic: DM6PR12MB4106: 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: pWJYv/IZEFsr9IttIKA3pScNsCtCq8hJcMKmm0Box9KxjVRy47qefIE9U+NYUadrbbpJwrOz/1e2feV2dJWnmitlIt4KdV4faLv7mmhJ/esUuIXRTlZiFBlOVFX6n7HA0zVwOVLbhrXQ0qw5e7d3H+2VJiDNu5ZFpCbNG1jgYQ4y34f8e3DGbRSy5YFG+lef+YRM1ME6lmJSY19z0OM/tAZTVg+TzRAchhibtVguftaWf9XEon9NCGwL0yMCzkv+bF4MMOhCfxZU58NS9sXXorBrPqf2Ml22HVwU3mZxiK3Sgsi+A+fU33gQ6TaDRhhJTqZH+ZUqzCuDY9udg1HQF8kMvX9PFvVOs+eg/nzXAXoeRJ4bsSW7zzxZlhqtlSBD2Uh9WxsBg9hCgq9WI53ibgLJs4Pho3I4BvGC/HLBQH3Jqc3S2xSGsketQ5hgiR529YLJSAOr0y6vVu3POBrJ8z846eA8Ae4Z8nYJPDLoiC/SkgyfFaMIWzgFMlOylnUut4M4DOXAuJSPYpQ0hLJPKsrj4iN2amiGZ1MawKNUzS0jmVGa7qcl3BTBmzvE3gSlPHtxlVSe1RhfXTz7hVb+LdWZ9Zoem0c/9AOJutj0kvSfYBO4hKS825sAVxvgS7+URMSb4M2kcd9r8JaoTzTfxS7OdPPKLimIo36uDz4mQFLc53ZzJ7u0CH8WzCKNpAIuLtgY2hjZXu5AgC9rILQXpg== 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)(46966006)(36840700001)(4326008)(6666004)(186003)(54906003)(2906002)(16526019)(82310400003)(70206006)(8676002)(2616005)(55016002)(316002)(8936002)(26005)(83380400001)(426003)(47076005)(70586007)(36906005)(6286002)(36756003)(86362001)(7049001)(5660300002)(36860700001)(356005)(110136005)(508600001)(1076003)(7696005)(336012)(7636003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Nov 2021 14:52:07.6888 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 48738ad2-05c4-4c78-0d1c-08d9a910a989 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: BN8NAM11FT022.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR12MB4106 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 --- 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..bbeeb1a3d4 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: + + - Firmware configuration: ``FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1``. + - 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 IN arc - ``eth`` or ``udp`` and up to 2 OUT arcs - ``ipv4`` or ``ipv6``. + - Flex item fields (next_header, next_protocol, samples) do not participate in RSS hash functions. + - In RTE 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 RTE flex item:: + + FLEX_PARSER_PROFILE_ENABLE=4 + PROG_PARSE_GRAPH=1 + Linux Prerequisites ------------------- -- 2.33.1