From 675c4ced1618ab073011aa1a30c5ab87971c3496 Mon Sep 17 00:00:00 2001 From: Jingjing Wu Date: Thu, 22 Jan 2015 09:09:16 +0800 Subject: [PATCH] doc: update testpmd commands for ethertype filter new commands for ethertype filter - ethertype_filter (port_id) (add|del) (mac_addr|mac_ignr) (mac_address) ethertype (ether_type) (drop|fwd) queue (queue_id) Signed-off-by: Jingjing Wu --- doc/guides/testpmd_app_ug/testpmd_funcs.rst | 51 +++++---------------- 1 file changed, 12 insertions(+), 39 deletions(-) diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index be935c2f93..218835a83b 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -1392,61 +1392,34 @@ Filter Functions This section details the available filter functions that are available. -add_ethertype_filter +ethertype_filter ~~~~~~~~~~~~~~~~~~~~ -Add a L2 Ethertype filter, which identify packets by their L2 Ethertype mainly assign them to a receive queue. +Add or delete a L2 Ethertype filter, which identify packets by their L2 Ethertype mainly assign them to a receive queue. -add_ethertype_filter (port_id) ethertype (eth_value) priority (enable|disable) (pri_value) queue (queue_id) index (idx) +ethertype_filter (port_id) (add|del) (mac_addr|mac_ignr) (mac_address) ethertype (ether_type) (drop|fwd) queue (queue_id) The available information parameters are: * port_id: the port which the Ethertype filter assigned on. -* eth_value: the EtherType value want to match, - for example 0x0806 for ARP packet. 0x0800 (IPv4) and 0x86DD (IPv6) are invalid. - -* enable: user priority participates in the match. - -* disable: user priority doesn't participate in the match. - -* pri_value: user priority value that want to match. - -* queue_id : The receive queue associated with this EtherType filter +* mac_addr: compare destination mac address. -* index: the index of this EtherType filter +* mac_ignr: ignore destination mac address match. -Example: - -.. code-block:: console +* mac_address: destination mac address to match. - testpmd> add_ethertype_filter 0 ethertype 0x0806 priority disable 0 queue 3 index 0 - Assign ARP packet to receive queue 3 - -remove_ethertype_filter -~~~~~~~~~~~~~~~~~~~~~~~ - -Remove a L2 Ethertype filter - -remove_ethertype_filter (port_id) index (idx) - -get_ethertype_filter -~~~~~~~~~~~~~~~~~~~~ - -Get and display a L2 Ethertype filter +* ether_type: the EtherType value want to match, + for example 0x0806 for ARP packet. 0x0800 (IPv4) and 0x86DD (IPv6) are invalid. -get_ethertype_filter (port_id) index (idx) +* queue_id : The receive queue associated with this EtherType filter. It is meaningless when deleting or dropping. -Example: +Example, to add/remove an ethertype filter rule: .. code-block:: console - testpmd> get_ethertype_filter 0 index 0 - - filter[0]: - ethertype: 0x0806 - priority: disable, 0 - queue: 3 + testpmd> ethertype_filter 0 add mac_ignr ethertype 0x0806 fwd queue 3 + testpmd> ethertype_filter 0 del mac_ignr ethertype 0x0806 fwd queue 3 add_2tuple_filter ~~~~~~~~~~~~~~~~~ -- 2.20.1