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 6FEF646B28 for ; Tue, 8 Jul 2025 13:49:31 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 697C84028C; Tue, 8 Jul 2025 13:49:31 +0200 (CEST) Received: from mail-pj1-f52.google.com (mail-pj1-f52.google.com [209.85.216.52]) by mails.dpdk.org (Postfix) with ESMTP id 64ED74028C for ; Tue, 8 Jul 2025 13:49:30 +0200 (CEST) Received: by mail-pj1-f52.google.com with SMTP id 98e67ed59e1d1-315c1b0623cso4848457a91.1 for ; Tue, 08 Jul 2025 04:49:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=uetpeshawar-edu-pk.20230601.gappssmtp.com; s=20230601; t=1751975369; x=1752580169; darn=dpdk.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=dBUAlr520GEIaF43eeHj5UpS+kiJScniCzzyNQYgw7E=; b=h3cDre+lTTkthWe1IN+/scsi6ZKdSLcAHytYn7I7/D1EefL0GYUuqF9qxgMxJVtn1M Yx8G0FW3TS42wIZGMg5Zr2nMOKrX4jgtTuKIkninLYG+xXMf7LqXBlpZOx8/vD56BtEc IQV1x111W8xz2tF9azjOjgvjtG1GJ8TWE2aUA6VGDWPno5fOL+mYvFZc0/U1NuGDKU0a AlVwsVsrf84l4qHYqXUO/8grnztSsfRrTZ0Yi4in9u2TGK0MvD8QxNK0pm56phEDUaUc ytYMeRQe5Cs79k22bhW1Coo2jxyvs39qTua+wozs2QDYu1BbZz10xPA6IIVGX02q+a// jdfA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1751975369; x=1752580169; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=dBUAlr520GEIaF43eeHj5UpS+kiJScniCzzyNQYgw7E=; b=PzIJPtDy+zlMPgeNS88xUzzzxrBet+w3YMDQ8IleNIBL6L73uBb/HAURhcBOu4sA1V JmSmXrtTHAZ/1gdAQXp3X7c3FN87Gpxi3LZPkPZ6lQ0ybV8bzxSaD202D49z0BeNcZyl rITdaQqyUT6bWatMyg5Cj3q/nzfVM4ldNsMaicWPON5XSVTSE3HttIvXkYrBLWKu3eXY rq+vl6cS1mqLWPSInOzYyPt1fS/0kSM+I3thiIdf5MseY/PKao0Lj2FdkJK0wnlFsxDv 715i744eTaaJ/VrOXHeGKh2sqcTFn7KkW4ChIqXNqzkcaiCQkzC9eR0Rfnbqwt7uUZui wXfg== X-Forwarded-Encrypted: i=1; AJvYcCUFdm0S3TwSoBsm/U0XbbsoW3UXgvyimQ/L7XwIPoORRJB/wQGfprQ9Jh/LNEH1Gt4sY+UZL3M=@dpdk.org X-Gm-Message-State: AOJu0YxesIFDZOKN5MgS6xJH5bSV773CT+LrUN8Yv5/Gok37MJkaxT5r ykapWH1KsSQjU8GR7NSgO6YtHKB6QUk6uWo5EK65Wko64zQdRX0PTqwKTQh9A2jdFDA= X-Gm-Gg: ASbGncuBRiEUMtvBsXkdQahykl6PlGXYkKTHn+BLYe+a4gavImB4ylpAEMrHMV/sBI5 kLmEYIbnCYGmDS/w7thKE0icsg4awZR8UQGGXOBzONdzEuYps7Del84k9IZzc5A5UeohUhLq5BE 8We59U2NFKVrXafgFKZ8s6uxzX4Lm635wBNVgNM/uyqAu1iXrNTtFp/zHm/1AtadKn40Nv8YyfP N+jBJ2WEDOmYSamBv3GsA3bojx98gESMgRybkNTH6yqfqOlY5BhJgeRGu8BoX/X4Ngok4ReyfUQ mk8tCPP2wtSrul7DSh5d0AArm7IkZ4ZJEro+iLemMNyIuOGgxWbMPs0euHSw33G+V5iYL5H+LA9 EXEk= X-Google-Smtp-Source: AGHT+IEEIgRZWW+6onKhuu+8JatyTbuaWDLiYQVaerGvdxPIOL6UncQPihhhK/5UZxUyEgt90Hn3mA== X-Received: by 2002:a17:90b:52cc:b0:311:ffe8:20e2 with SMTP id 98e67ed59e1d1-31aadcf47f3mr23276597a91.4.1751975369398; Tue, 08 Jul 2025 04:49:29 -0700 (PDT) Received: from localhost.localdomain ([64.62.143.197]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-31c21d67c46sm2147192a91.19.2025.07.08.04.49.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Jul 2025 04:49:29 -0700 (PDT) From: Khadem Ullah <14pwcse1224@uetpeshawar.edu.pk> X-Google-Original-From: Khadem Ullah To: dev@dpdk.org Cc: rasland@nvidia.com, stable@dpdk.org, Khadem Ullah , Khadem Ullah <14pwcse1224@uetpeshawar.edu.pk> Subject: [PATCH] doc/mlx5: document firmware requirement for flex item Date: Tue, 8 Jul 2025 07:49:21 -0400 Message-ID: <20250708114921.1031027-1-khadem@dreambigsemi.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Some BlueField firmware versions (e.g. 24.30.1004) do not support flex item definitions using FIELD_MODE_FIXED with size set to 0, such as in 'next_header'. Attempting to use this configuration may result in the following error: 'unsupported header length field mode (FIXED)' This is resolved starting from firmware version 24.38.1002. The patch adds a note to the mlx5 guide explaining the firmware requirement for such flex item configurations. Fixes: 16508bfd0816 ('net/mlx5: doc: add flex item specifications in mlx5 guide') Cc: stable@dpdk.org Signed-off-by: Khadem Ullah <14pwcse1224@uetpeshawar.edu.pk> --- doc/guides/nics/mlx5.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index c3a350d24e..1b0e3efc41 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -476,6 +476,10 @@ Limitations - In flex item configuration, ``next_header.field_base`` value must be byte aligned (multiple of 8). - Modify field with flex item, the offset must be byte aligned (multiple of 8). + .. note:: + Some firmware versions (e.g. 24.30.1004) do not support + ``next_header`` with ``field_mode = FIELD_MODE_FIXED`` and zero size. + A newer firmware (e.g. >= 24.38.1002) is required to support this configuration. - Match on random value: -- 2.43.0