From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <pdelarax@ecsmtp.ir.intel.com>
Received: from mga14.intel.com (mga14.intel.com [192.55.52.115])
by dpdk.org (Postfix) with ESMTP id 5F514B789
for <dev@dpdk.org>; Sat, 21 Feb 2015 02:53:16 +0100 (CET)
Received: from fmsmga002.fm.intel.com ([10.253.24.26])
by fmsmga103.fm.intel.com with ESMTP; 20 Feb 2015 17:45:32 -0800
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.09,618,1418112000"; d="scan'208";a="681159573"
Received: from irvmail001.ir.intel.com ([163.33.26.43])
by fmsmga002.fm.intel.com with ESMTP; 20 Feb 2015 17:53:14 -0800
Received: from sivswdev02.ir.intel.com (sivswdev02.ir.intel.com
[10.237.217.46])
by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id
t1L1rD6n029678; Sat, 21 Feb 2015 01:53:13 GMT
Received: from sivswdev02.ir.intel.com (localhost [127.0.0.1])
by sivswdev02.ir.intel.com with ESMTP id t1L1rDxE026034;
Sat, 21 Feb 2015 01:53:13 GMT
Received: (from pdelarax@localhost)
by sivswdev02.ir.intel.com with id t1L1rDG8026030;
Sat, 21 Feb 2015 01:53:13 GMT
From: Pablo de Lara <pablo.de.lara.guarch@intel.com>
To: dev@dpdk.org
Date: Sat, 21 Feb 2015 01:53:11 +0000
Message-Id: <1424483591-25944-6-git-send-email-pablo.de.lara.guarch@intel.com>
X-Mailer: git-send-email 1.7.4.1
In-Reply-To: <1424483591-25944-1-git-send-email-pablo.de.lara.guarch@intel.com>
References: <1423973254-605-1-git-send-email-jingjing.wu@intel.com>
<1424483591-25944-1-git-send-email-pablo.de.lara.guarch@intel.com>
Subject: [dpdk-dev] [PATCH v3 5/5] doc: commands changed in testpmd_funcs
for flex filter
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: patches and discussions about DPDK <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Sat, 21 Feb 2015 01:53:16 -0000
From: Jingjing Wu <jingjing.wu@intel.com>
document of new command:
- flex_filter (port_id) (add|del) len (len_value) bytes (bytes_value)
mask (mask_value) priority (prio_value) queue (queue_id)
Signed-off-by: Jingjing Wu <jingjing.wu@intel.com>
Signed-off-by: Pablo de Lara <pablo.de.lara.guarch@intel.com>
---
doc/guides/testpmd_app_ug/testpmd_funcs.rst | 64 ++++++---------------------
1 files changed, 14 insertions(+), 50 deletions(-)
diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
index 218835a..a0cdad7 100644
--- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst
+++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
@@ -1595,71 +1595,35 @@ Example:
syn filter: on, priority: high, queue: 3
-add_flex_filter
-~~~~~~~~~~~~~~~
+flex_filter
+~~~~~~~~~~~
-Add a Flex filter,
-which recognizes any arbitrary pattern within the first 128 bytes of the packet
+With flex filter, packets can be recognized by any arbitrary pattern within the first 128 bytes of the packet
and routes packets into one of the receive queues.
-add_flex_filter (port_id) len (len_value) bytes (bytes_string) mask (mask_value)
-priority (prio_value) queue (queue_id) index (idx)
+flex_filter (port_id) (add|del) len (len_value) bytes (bytes_value)
+mask (mask_value) priority (prio_value) queue (queue_id)
The available information parameters are:
-* port_id: the port which the Flex filter assigned on.
+* port_id: the port which the Flex filter is assigned on.
-* len_value: filter length in byte, no greater than 128.
+* len_value: filter length in bytes, no greater than 128.
-* bytes_string: a sting in format of octal, means the value the flex filter need to match.
+* bytes_value: a string in hexadecimal, means the value the flex filter needs to match.
-* mask_value: a sting in format of octal, bit 1 means corresponding byte in DWORD participates in the match.
+* mask_value: a string in hexadecimal, bit 1 means corresponding byte participates in the match.
* prio_value: the priority of this filter.
-* queue_id: The receive queue associated with this Flex filter.
-
-* index: the index of this Flex filter
+* queue_id: the receive queue associated with this Flex filter.
Example:
.. code-block:: console
- testpmd> add_flex_filter 0 len 16 bytes 0x00000000000000000000000008060000 mask 000C priority 3 queue 3 index 0
-
-Assign a packet whose 13th and 14th bytes are 0x0806 to queue 3.
-
-remove_flex_filter
-~~~~~~~~~~~~~~~~~~
-
-Remove a Flex filter
-
-remove_flex_filter (port_id) index (idx)
-
-get_flex_filter
-~~~~~~~~~~~~~~~
-
-Get and display a Flex filter
-
-get_flex_filter (port_id) index (idx)
+ testpmd> flex_filter 0 add len 16 bytes 0x00000000000000000000000008060000
+ mask 000C priority 3 queue 3
-Example:
-
-.. code-block:: console
-
- testpmd> get_flex_filter 0 index 0
-
- filter[0]:
-
- length: 16
-
- dword[]: 0x00000000 00000000 00000000 08060000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000
-
- mask[]:
- 0b0000000000001100000000000000000000000000000000000000000000000000000000
- 0000000000000000000000000000000000000000000000000000000000
-
- priority: 3 queue: 3
+ testpmd> flex_filter 0 del len 16 bytes 0x00000000000000000000000008060000
+ mask 000C priority 3 queue 3
--
1.7.4.1