[dpdk-dev,2/2] doc: add QinQ flow information to testpmd
Checks
Commit Message
Add information on validating and creating QinQ flow rules to
the flow rules management section of the Testpmd User Guide.
Signed-off-by: Bernard Iremonger <bernard.iremonger@intel.com>
---
doc/guides/testpmd_app_ug/testpmd_funcs.rst | 41 +++++++++++++++++++++++++++++
1 file changed, 41 insertions(+)
Comments
> -----Original Message-----
> From: Iremonger, Bernard
> Sent: Friday, April 7, 2017 4:15 PM
> To: dev@dpdk.org
> Cc: Xing, Beilei <beilei.xing@intel.com>; Lu, Wenzhuo
> <wenzhuo.lu@intel.com>; Mcnamara, John <john.mcnamara@intel.com>;
> Iremonger, Bernard <bernard.iremonger@intel.com>
> Subject: [PATCH 2/2] doc: add QinQ flow information to testpmd
>
> Add information on validating and creating QinQ flow rules to the flow
> rules management section of the Testpmd User Guide.
>
> Signed-off-by: Bernard Iremonger <bernard.iremonger@intel.com>
It is good to see an example as well as the command added to the docs.
Acked-by: John McNamara <john.mcnamara@intel.com>
@@ -2794,3 +2794,44 @@ Output can be limited to specific groups::
5 0 1000 i- ETH IPV6 ICMP => QUEUE
7 63 0 i- ETH IPV6 UDP VXLAN => MARK QUEUE
testpmd>
+
+Sample QinQ flow rules
+~~~~~~~~~~~~~~~~~~~~~~
+
+Validate and create a QinQ rule on port 0 to steer traffic to a VF queue in a VM.
+
+::
+
+ testpmd> flow validate 0 ingress pattern eth / vlan tpid is 0x8100 tci is 4 /
+ vlan tpid is 0x8100 tci is 5 / end actions vf id 1 / queue index 0 / end
+ Flow rule #0 validated
+
+ testpmd> flow create 0 ingress pattern eth / vlan tpid is 0x8100 tci is 4 /
+ vlan tpid is 0x8100 tci is 5 / end actions vf id 1 / queue index 0 / end
+ Flow rule #0 created
+
+ testpmd> flow list 0
+ ID Group Prio Attr Rule
+ 0 0 0 i- ETH VLAN VLAN=>VF QUEUE
+
+Validate and create a QinQ rule on port 0 to steer traffic to a queue on the host.
+
+::
+
+ testpmd> flow validate 0 ingress pattern eth / vlan tpid is 0x8100 tci is 6 /
+ vlan tpid is 0x8100 tci is 7 / end actions pf / queue index 0 / end
+ Flow rule #1 validated
+
+ testpmd> flow create 0 ingress pattern eth / vlan tpid is 0x8100 tci is 6 /
+ vlan tpid is 0x8100 tci is 7 / end actions pf / queue index 1 / end
+ Flow rule #1 created
+
+ testpmd> flow list 0
+ ID Group Prio Attr Rule
+ 0 0 0 i- ETH VLAN VLAN=>VF QUEUE
+ 1 0 0 i- ETH VLAN VLAN=>PF QUEUE
+
+After creating QinQ rule(s) the following command should be issued to enable QinQ::
+
+ testpmd> vlan set qinq on 0
+