summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHanoh Haim <hhaim@cisco.com>2016-08-24 16:31:23 +0300
committerHanoh Haim <hhaim@cisco.com>2016-08-24 16:31:23 +0300
commit435f94ee118cdfe9715b4580218cf0cd8026614a (patch)
treef13fd892321a2029bad53ec3d2231ac4ec62a5bc
parent6c537c2b281004f7214dbb9cd3f3805678dd5390 (diff)
v2.08
-rwxr-xr-xrelease_notes.asciidoc4
-rwxr-xr-xtrex_stateless.asciidoc31
2 files changed, 32 insertions, 3 deletions
diff --git a/release_notes.asciidoc b/release_notes.asciidoc
index a2537059..7f0d64d6 100755
--- a/release_notes.asciidoc
+++ b/release_notes.asciidoc
@@ -26,7 +26,7 @@ endif::backend-docbook[]
== Release 2.08 ==
* Scapy JSON-RPC server for GUI packet crafting, see link:trex_scapy_rpc_server.html[trex_scapy_rpc_server]
-* Client.start Python API supports Core mask - significantly improve the Stateless performance. link:cp_stl_docs/_modules/trex_stl_lib/trex_stl_client.html#STLClient.start[start API], *TBD*- Itay to update the pointer here
+* Client.start Python API supports Core mask - significantly improve the Stateless performance. link:cp_stl_docs/_modules/trex_stl_lib/trex_stl_client.html#STLClient.start[start API], and link:trex_stateless.html#_core_masking_per_interface[core_masking]
* Upgrade the ./dpdk_setup_ports.py script. It simplifies the way to create first time *optimized* config file (/etc/trex_cfg.yaml). More info at the manual: link:trex_manual.html#_script_for_creating_config_file[Script for creating config file]
[source,bash]
@@ -37,7 +37,7 @@ $sudo ./dpdk_setup_ports.py -i # interactive creation of config file
$sudo ./dpdk_setup_ports.py -c 03:00.0 03:00.1 -o /etc/trex_cfg.yaml # create optimum /etc/trex_cfg.yaml file
----
-* Basic Cisco VIC functionality works now. Advanced Stateless/Stateful functionality is still not supported.
+* Preliminary Cisco VIC support. Advanced Stateless/Stateful functionality is still not supported.
* Enforce latest firmware for XL710/X710 (5.04)
* Add a way to stop/close NICS at TRex termination (link would be down) `-close-at-end`
* IPv6 XL710 ICMP packets are supported now
diff --git a/trex_stateless.asciidoc b/trex_stateless.asciidoc
index c55b6520..8b431604 100755
--- a/trex_stateless.asciidoc
+++ b/trex_stateless.asciidoc
@@ -1767,6 +1767,8 @@ The following example demonstrates varies the packet size randomly, as follows:
==== Tutorial: Field Engine, Significantly improve performance
+anchor:trex_cache_mbuf[]
+
The following example demonstrates a way to significantly improve Field Engine performance in case it is needed.
Field Engine has a cost of CPU instructions and CPU memory bandwidth. There is a way to significantly improve performance by caching the packets and run the Field Engine offline(before sending the packets).
@@ -3680,7 +3682,10 @@ some impact on other areas and in general, might sacrafice one or more propertie
that requires the user to explicitly give up on those.
==== Caching MBUFs
-*<TBD>*
+
+
+see xref:trex_cache_mbuf[here]
+
==== Core masking per interface
By default, TRex will regard any TX command with a **greedy approach**:
@@ -3736,6 +3741,22 @@ trex>
----
+
+.API example to PIN cores
+[source,python]
+----
+ c.start(ports = [port_a, port_b], mult = rate,core_mask=STLClient.CORE_MASK_PIN) <1>
+----
+<1> core_mask = STLClient.CORE_MASK_PIN
+
+.API example to MASK cores
+[source,python]
+----
+ c.start(ports = [port_a, port_b], mult = rate, core_mask=[0x1,0x2])<1>
+----
+<1> DP Core 0 (mask==1) is assign to port 1 and DP core 1 (mask==2) is for port 2
+
+
[source,bash]
----
@@ -3835,6 +3856,14 @@ Starting traffic on port(s) [0, 1]: [SUCCESS]
trex>
----
+[source,python]
+----
+ c.start(ports = [port_a, port_b], mult = rate,core_mask=[0x0xe,0x1]) <1>
+----
+<1> mask of cores per port
+
+
+
The following output is received on the TUI CPU util window:
[source,bash]