From: Anurag Mandal <anurag.mandal@intel.com>
To: dev@dpdk.org
Cc: bruce.richardson@intel.com, Anurag Mandal <anurag.mandal@intel.com>
Subject: [PATCH] doc: update QinQ strip & VLAN filter notes
Date: Tue, 2 Dec 2025 20:55:53 +0000 [thread overview]
Message-ID: <20251202205554.24405-1-anurag.mandal@intel.com> (raw)
Tested QinQ stripping with TPIDs 0x88A8 and 0x8100.
Removed QinQ related obsolete notes for FW version >= 8.4.
Added new "QinQ strip" section under "Sample Application Notes".
Added VLAN filter enable command to its notes as, VLAN cannot
be added to port without it.
Signed-off-by: Anurag Mandal <anurag.mandal@intel.com>
---
doc/guides/nics/i40e.rst | 37 +++++++++++++++++++++++++++++++++----
1 file changed, 33 insertions(+), 4 deletions(-)
diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index 165798fb94..45dc083c94 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -357,9 +357,41 @@ To start ``testpmd``, and add vlan 10 to port 0:
...
testpmd> set promisc 0 off
+ testpmd> vlan set filter on 0
testpmd> rx_vlan add 10 0
+QinQ strip
+~~~~~~~~~~~
+
+QinQ TPID is set as 0x8100 IEEE 802.1Q by default.
+For QinQ strip with TPID 0x88A8 IEEE 802.1ad, extend VLAN is enabled and VLAN outer tpid is set to 0x88A8.
+Vlan filter steps can be added before or after.
+
+To start ``testpmd``, and enable QinQ strip for TPID 0x88A8 on port 0:
+
+.. code-block:: console
+
+ ./<build_dir>/app/dpdk-testpmd -l 0-15 -- -i --forward-mode=mac
+ ...
+
+ testpmd> vlan set extend on 0
+ testpmd> vlan set outer tpid 0x88A8 0
+ testpmd> vlan set qinq_strip on 0
+
+For QinQ strip with TPID 0x8100, extend VLAN is enabled only.
+
+To start ``testpmd``, and enable QinQ strip for default TPID on port 0:
+
+.. code-block:: console
+
+ ./<build_dir>/app/dpdk-testpmd -l 0-15 -- -i --forward-mode=mac
+ ...
+
+ testpmd> vlan set extend on 0
+ testpmd> vlan set qinq_strip on 0
+
+
Flow Director
~~~~~~~~~~~~~
@@ -919,10 +951,7 @@ Vlan related Features miss when FW >= 8.4
If FW version >= 8.4, there'll be some Vlan related issues:
-#. TCI input set for QinQ is invalid.
-#. Fail to configure TPID for QinQ.
-#. Need to enable QinQ before enabling Vlan filter.
-#. Fail to strip outer Vlan.
+#. TCI input set for QinQ is invalid.
Example of getting best performance with l3fwd example
------------------------------------------------------
--
2.43.0
reply other threads:[~2025-12-02 21:42 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20251202205554.24405-1-anurag.mandal@intel.com \
--to=anurag.mandal@intel.com \
--cc=bruce.richardson@intel.com \
--cc=dev@dpdk.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).