v2.08
authorHanoh Haim <[email protected]>
Wed, 24 Aug 2016 13:31:23 +0000 (16:31 +0300)
committerHanoh Haim <[email protected]>
Wed, 24 Aug 2016 13:31:23 +0000 (16:31 +0300)
release_notes.asciidoc
trex_stateless.asciidoc

index a253705..7f0d64d 100755 (executable)
@@ -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
index c55b652..8b43160 100755 (executable)
@@ -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]