From patchwork Thu Jan 22 01:09:16 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jingjing Wu X-Patchwork-Id: 2456 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 8A2615A31; Thu, 22 Jan 2015 02:09:28 +0100 (CET) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 22D365424 for ; Thu, 22 Jan 2015 02:09:24 +0100 (CET) Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga101.fm.intel.com with ESMTP; 21 Jan 2015 17:09:23 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.97,862,1389772800"; d="scan'208";a="443438484" Received: from shvmail01.sh.intel.com ([10.239.29.42]) by FMSMGA003.fm.intel.com with ESMTP; 21 Jan 2015 16:56:01 -0800 Received: from shecgisg004.sh.intel.com (shecgisg004.sh.intel.com [10.239.29.89]) by shvmail01.sh.intel.com with ESMTP id t0M19LTR005306; Thu, 22 Jan 2015 09:09:21 +0800 Received: from shecgisg004.sh.intel.com (localhost [127.0.0.1]) by shecgisg004.sh.intel.com (8.13.6/8.13.6/SuSE Linux 0.8) with ESMTP id t0M19HSE003054; Thu, 22 Jan 2015 09:09:19 +0800 Received: (from wujingji@localhost) by shecgisg004.sh.intel.com (8.13.6/8.13.6/Submit) id t0M19HOW003050; Thu, 22 Jan 2015 09:09:17 +0800 From: Jingjing Wu To: dev@dpdk.org Date: Thu, 22 Jan 2015 09:09:16 +0800 Message-Id: <1421888956-3020-1-git-send-email-jingjing.wu@intel.com> X-Mailer: git-send-email 1.7.4.1 Subject: [dpdk-dev] [PATCH] doc: commands changed in testpmd_funcs for ethertype filter X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 be935c2..218835a 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 ~~~~~~~~~~~~~~~~~