release_notes.asciidoc revision df1e9dba
1:author: hhaim 
2:email: <hhaim@cisco.com> 
3
4
5ifndef::backend-docbook[]
6++++++++++++++
7<div id="header-pic"   style="padding:50px;margin-top:0px;position:absolute;left:0px;width:100%;">
8    <img src="images/trex_logo.png" alt="Smiley face" height="80" width="270"/>
9</div>
10<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
11++++++++++++++
12
13include::trex_ga.asciidoc[]
14
15
16== TRex release notes ==
17endif::backend-docbook[]
18
19ifdef::backend-docbook[]
20
21== TRex release notes  ==
22:numbered:
23
24endif::backend-docbook[]
25
26== Release 2.16 ==
27
28* IPv6 console basic support:
29** scan6 function to search for IPv6-enabled neighbors
30** ping can be used with IPv6 addresses to ping nearby devices
31
32== Release 2.15 ==
33
34* XL710/X710 VF (SR-IOV) mode works better 
35* 599 VF mode is *not* supported 
36
37=== fix issues: ===
38
39* link:https://trex-tgn.cisco.com/youtrack/issue/trex-333[trex-333]
40* link:https://trex-tgn.cisco.com/youtrack/issue/trex-331[trex-331]
41
42
43== Release 2.14 ==
44
45* Another performance improvement in Stateful case with high active flows. There is less burstiness 
46* Scapy server - warning in case of permissions errors 
47* Maximum supported ports are 16 (instead of 12)
48* ConnectX-4 DPDK driver is based on 16.11 (from 16.07) - better performance is some cases
49* Early support for Intel XL710/X710/599 VF support [TBD add pointer for more info]
50* Fix Cluster mode breakage (v2.12-v2.13)
51* Stateless GUI v3.0 works with this version
52
53=== fix issues: ===
54
55* link:https://trex-tgn.cisco.com/youtrack/issue/trex-319[trex-319]
56* link:https://trex-tgn.cisco.com/youtrack/issue/trex-322[trex-322]
57* link:https://trex-tgn.cisco.com/youtrack/issue/trex-326[trex-326]
58* link:https://trex-tgn.cisco.com/youtrack/issue/trex-330[trex-330]
59* link:https://trex-tgn.cisco.com/youtrack/issue/trex-329[trex-329]
60
61
62== Release 2.13 ==
63
64* Significantly improve performance and scale for stateful case with high active flows (70%-300% better)  see here link:trex_manual.html#_more_active_flows[More active flows]
65* Stateful with low active repeatable flows - an optimization was removed, for example `cap2/imix_fast_1g.yaml`. users that want to get this in high performance are adviced to move to Stateles mode. Removing this support improved the common case.
66* Support NAT without IPv4.option and UDP flows- for ASA  link:https://trex-tgn.cisco.com/youtrack/issue/trex-274[trex-274]
67* Scapy server is restart automatically - for future Stateless GUI link:https://trex-tgn.cisco.com/youtrack/issue/trex-291[trex-291]
68* Add minimum ipg for remote pcap link:https://trex-tgn.cisco.com/youtrack/issue/trex-281[trex-281]
69* Console port commands works on VIC and ConnectX-4
70* RPC API version is 3.0 - New stateless GUI is required
71
72
73=== fix issues: ===
74
75* link:https://trex-tgn.cisco.com/youtrack/issue/trex-317[trex-317]
76* link:https://trex-tgn.cisco.com/youtrack/issue/trex-282[trex-282]
77* link:https://trex-tgn.cisco.com/youtrack/issue/trex-190[trex-190]
78* link:https://trex-tgn.cisco.com/youtrack/issue/trex-279[trex-279]
79* link:https://trex-tgn.cisco.com/youtrack/issue/trex-313[trex-313]
80* link:https://trex-tgn.cisco.com/youtrack/issue/trex-312[trex-312]
81* link:https://trex-tgn.cisco.com/youtrack/issue/trex-310[trex-310]
82* link:https://trex-tgn.cisco.com/youtrack/issue/trex-191[trex-191]
83* link:https://trex-tgn.cisco.com/youtrack/issue/trex-306[trex-306]
84* link:https://trex-tgn.cisco.com/youtrack/issue/trex-234[trex-234]
85* link:https://trex-tgn.cisco.com/youtrack/issue/trex-308[trex-308]
86* link:https://trex-tgn.cisco.com/youtrack/issue/trex-283[trex-283]
87
88
89== Release 2.12 ==
90
91* Improve support for Mellanox ConnectX-4 cards (100/50/25GbE) 
92** Only CentOs/RedHat 7.2 and up is supported due to OFED issues
93** Improve 64Byte Stateleess performance 
94* Cisco VIC is fully supported 
95* Stateless L2/L3 configuration mode for ports - link:trex_stateless.html#_port_layer_mode_configuration[Port Layer Mode Configuration]
96* Stateless neighboring protocols infra and first protocols support/Python API - link:trex_stateless.html#_neighboring_protocols[Neighboring Protocols]
97* Stateful - ARP support for Client clustering mode (a.k.a APIC-EM) see here link:trex_manual.html#_client_clustering_configuration[Client Clustering]
98* Added Stateless performance trend document link:trex_analytics.html[trex performance trend]
99
100
101[IMPORTANT]
102=====================================
103Change of behavior - trex config file (/trex/cfg.yaml) should include a distinct MAC address or distinct IP address. 
104Not setting the port information :
105  before v2.12  :  src MAC addr == 00:00:00:01:00:00 
106  v2.12 and up  :  src MAC addr == HW MAC address 
107===========================
108
109
110=== fix issues: ===
111
112* link:https://trex-tgn.cisco.com/youtrack/issue/trex-257[trex-257]
113* link:https://trex-tgn.cisco.com/youtrack/issue/trex-265[trex-265]
114* link:https://trex-tgn.cisco.com/youtrack/issue/trex-280[trex-280]
115* link:https://trex-tgn.cisco.com/youtrack/issue/trex-277[trex-277]
116* link:https://trex-tgn.cisco.com/youtrack/issue/trex-278[trex-278]
117* link:https://trex-tgn.cisco.com/youtrack/issue/trex-199[trex-199]
118
119
120== Release 2.11 ==
121
122* Early support for Mellanox ConnectX-4 cards (100/50/25GbE) - based on contributions from Mellanox DPDK team see here for more info link:trex_manual.html#_mellanox_connectx_4_support[Mellanox ConnectX-4 Support]
123* Add support for Cisco VIC 1300 series adapter (40GbE)-  based on Cisco VIC DPDK team see link:trex_manual.html#_cisco_vic_support[Cisco VIC Support]
124
125=== fix issues: ===
126
127* link:https://trex-tgn.cisco.com/youtrack/issue/trex-268[trex-268]
128* link:https://trex-tgn.cisco.com/youtrack/issue/trex-267[trex-267]
129* link:https://trex-tgn.cisco.com/youtrack/issue/trex-195[trex-195]
130* link:https://trex-tgn.cisco.com/youtrack/issue/trex-271[trex-271]
131* link:https://trex-tgn.cisco.com/youtrack/issue/trex-255[trex-255]
132* link:https://trex-tgn.cisco.com/youtrack/issue/trex-249[trex-249]
133
134
135== Release 2.10 ==
136
137* Added support for IP based configuration files (As opposed to MAC based used until now), with the ability of TRex to send
138ARP requests for default gateway, and gratitues ARP for its own addresses.
139See link:trex_manual.html#_configuration_yaml_parameter_of_cfg_option[here] and link:trex_config_guide.html[here] for details.
140* Added commands/API to Stateless client/console:
141** Getting extended counters of port for improved debug purposes. See example: link:trex_stateless.html#_stats[stats]
142** Changing of port attributes and getting async feedback on the changed status. See example: link:trex_stateless.html#_portattr[portattr]
143* For developers - added/updated RPC commands (which can be used for GUI etc.):
144** Getting system info added new options, for example description of interface: link:trex_rpc_server_spec.html#_get_system_info[get_system_info]
145** Setting port attributes added new options: link:trex_rpc_server_spec.html#_setting_port_attributes[set_port_attr]
146** Getting xstats names (can be polled once and then combined with updated values): link:trex_rpc_server_spec.html#_get_xstat_names[get_port_xstats_names]
147** Getting xstats values: link:trex_rpc_server_spec.html#_get_xstat_values[get_port_xstats_values]
148
149=== fix issues: ===
150
151* link:https://trex-tgn.cisco.com/youtrack/issue/trex-253[trex-253]
152* link:https://trex-tgn.cisco.com/youtrack/issue/trex-212[trex-212]
153* link:https://trex-tgn.cisco.com/youtrack/issue/trex-251[trex-251]
154
155== Release 2.09 ==
156
157* Stateless, split to core algorithm is more accurate and simple see link:trex_stateless.html#_tutorial_field_engine_split_to_core[split_to_core] 
158* Add repeatable random instruction see an example link:https://github.com/cisco-system-traffic-generator/trex-core/tree/master/scripts/stl/udp_1pkt_repeat_random.py[stl/udp_1pkt_repeat_random.py] link:cp_stl_docs/api/field_engine.html#stlvmflowvarrepetablerandom[repetable_random] and link:trex_rpc_server_spec.html#_repetable_random[repetable_random_spec]
159* Add TCP/UDP checksum fix instruction see an example link:https://github.com/cisco-system-traffic-generator/trex-core/tree/master/scripts/stl/syn_attack_fix_cs_hw.py[stl/syn_attack_fix_cs_hw.py] link:cp_stl_docs/api/field_engine.html#stlvmfixchecksumhw[fix checksum] and link:trex_rpc_server_spec.html#_fix_checksum_hw[fix_checksum_hw_spec]
160* Improve Stateless Field Engine (FE) performance
161* Support dual mode for push pcap/remote Python API. see here link:cp_stl_docs/api/client_code.html#trex_stl_lib.trex_stl_client.STLClient.push_remote[push_remote] and link:cp_stl_docs/api/client_code.html#trex_stl_lib.trex_stl_client.STLClient.push_pcap[push_pcap] Using this feature pcap can be splited to client/server ports
162* Add infra for L2 emulation support 
163
164=== fix issues: ===
165
166* link:http://trex-tgn.cisco.com/youtrack/issue/trex-243[trex-243] 
167* link:http://trex-tgn.cisco.com/youtrack/issue/trex-247[trex-247] 
168* link:http://trex-tgn.cisco.com/youtrack/issue/trex-244[trex-244] 
169* link:http://trex-tgn.cisco.com/youtrack/issue/trex-249[trex-249] 
170
171== Release 2.08  ==
172
173* Scapy JSON-RPC server for GUI packet crafting, see  link:trex_scapy_rpc_server.html[trex_scapy_rpc_server]
174* 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]
175* 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]
176
177[source,bash]
178----
179$sudo ./dpdk_setup_ports.py -t            # show the list of ports
180$sudo ./dpdk_setup_ports.py -l            # return DPDK interfaces to Linux (if there is proper Linux driver)
181$sudo ./dpdk_setup_ports.py -i            # interactive creation of config file
182$sudo ./dpdk_setup_ports.py -c 03:00.0 03:00.1 -o /etc/trex_cfg.yaml # create optimum /etc/trex_cfg.yaml file
183----
184
185* Preliminary Cisco VIC support. Advanced Stateless/Stateful functionality is still not supported.
186* Enforce latest firmware for XL710/X710 (5.04)
187* Add a way to stop/close NICS at TRex termination (link would be down) `-close-at-end`
188* IPv6 XL710 ICMP packets are supported now
189
190=== fix issues: ===
191
192* link:http://trex-tgn.cisco.com/youtrack/issue/trex-240[trex-240] 
193* link:http://trex-tgn.cisco.com/youtrack/issue/trex-242[trex-242]
194* link:http://trex-tgn.cisco.com/youtrack/issue/trex-246[trex-246] 
195
196== Release 2.07  ==
197
198* DPDK 16.07 
199* ASYNC ZMQ is compressed by default. It improves response time see link:http://trex-tgn.cisco.com/youtrack/issue/trex-232[trex-232] 
200** You will need to update the GUI
201* Support Ubuntu 16.01 - Stateful serverr is Python 3.0 and Python 3.5 for ZMQ library 
202* XL710/X710 low latency was improved -  see link:http://trex-tgn.cisco.com/youtrack/issue/trex-214[trex-214] 
203* Support graceful shutdown command 
204* Console -  support L1 BPS  using `-m 10bpsl1` see link:http://trex-tgn.cisco.com/youtrack/issue/trex-230[trex-230] 
205* Improve TUI refresh time 
206* Support IPV6 latency streams (support is available for all interface types except 82599) see link:trex_stateless.html#_tutorial_per_stream_latency_jitter_packet_errors[IPV6 latency]
207
208[IMPORTANT]
209=====================================
210For XL710/X710 there is a need to upgrade the firmware to 5.04 (or later)
211=====================================
212
213=== fix issues: ===
214
215* link:http://trex-tgn.cisco.com/youtrack/issue/trex-214[trex-214] 
216* link:http://trex-tgn.cisco.com/youtrack/issue/trex-223[trex-223] 
217* link:http://trex-tgn.cisco.com/youtrack/issue/trex-226[trex-226] 
218* link:http://trex-tgn.cisco.com/youtrack/issue/trex-224[trex-224] 
219* link:http://trex-tgn.cisco.com/youtrack/issue/trex-235[trex-235] 
220* link:http://trex-tgn.cisco.com/youtrack/issue/trex-236[trex-236] 
221* link:http://trex-tgn.cisco.com/youtrack/issue/trex-238[trex-238] 
222* link:http://trex-tgn.cisco.com/youtrack/issue/trex-233[trex-233] 
223* link:http://trex-tgn.cisco.com/youtrack/issue/trex-231[trex-231] 
224
225
226== Release 2.06  ==
227
228* Support APIC-EM scale Stateful VLAN/IP/MAC mapping.
229* TCP SYN Randomization learning support for advanced ASA stateful testing - link:trex_manual.html#_nat_support[here] and link:trex_manual.html#_trex_with_asa_5585[here]
230* Advanced to latest DPDK 16.07RC3 - fix some XL710 driver performance issues
231
232=== fix issues: ===
233
234* link:http://trex-tgn.cisco.com/youtrack/issue/trex-229[trex-229] 
235* link:http://trex-tgn.cisco.com/youtrack/issue/trex-227[trex-227] 
236
237
238== Release 2.05  ==
239
240
241=== fix issues: ===
242
243* link:http://trex-tgn.cisco.com/youtrack/issue/trex-221[trex-221] 
244* link:http://trex-tgn.cisco.com/youtrack/issue/trex-220[trex-220] 
245* link:http://trex-tgn.cisco.com/youtrack/issue/trex-219[trex-219] 
246* link:http://trex-tgn.cisco.com/youtrack/issue/trex-218[trex-218] 
247* link:http://trex-tgn.cisco.com/youtrack/issue/trex-217[trex-217] 
248* link:http://trex-tgn.cisco.com/youtrack/issue/trex-216[trex-216] 
249
250
251== Release 2.04  ==
252
253* Watchdog support
254* Ability to export core file 
255* Optimized the case of Latency stream, Field Engine and 9K template packets 
256
257=== fix issues: ===
258
259* XL710/X710 present high latency with 9K packets  link:http://trex-tgn.cisco.com/youtrack/issue/trex-214[trex-214] 
260* The latency seq number gets out of sync link:http://trex-tgn.cisco.com/youtrack/issue/trex-215[trex-215]
261* Port/Latency stats should be with FCS  link:http://trex-tgn.cisco.com/youtrack/issue/trex-213[trex-213]
262* Stateless Unicode is not accepted for multiplier API see  link:https://github.com/cisco-system-traffic-generator/trex-core/issues/15[github-issue15]
263
264
265== Release 2.03  ==
266
267* More accurate stateless latency/more TUI support
268* Speedup DPDK XL710 fdir driver
269
270=== fix issues: ===
271
272* Disconnect issue link:http://trex-tgn.cisco.com/youtrack/issue/trex-210[trex-210]
273
274
275== Release 2.02  ==
276
277* The python latency statistic is compatible to JSON for easy manipulation 
278* Add latency minimum value Python API taken from histogram 
279
280=== fix issues: ===
281
282* Fix corruption of mbuf in case of with high rate latency stream. 
283
284== Release 2.01  ==
285
286* First release of latency/jitter per stream see link:trex_stateless.html#_tutorial_per_stream_latency_jitter_packet_errors[here] 
287* Ability to send server side pcap file - unlimited pcap file size see link:/cp_stl_docs/_modules/trex_stl_lib/trex_stl_client.html#STLClient.push_remote[here] and link:trex_stateless.html#_pcap_based_traffic_tutorials[PCAP tutorial]
288* Significatly improve performance for both Stateful and Stateless - in some cases up to x2 due to Scheduler/CPU utilization rewrite 
289* CPU utilization estimation is done differently 
290* Ability to significatly improve performance for Stateless profile with Field engine (up to x5, 22MPPS) see link:trex_stateless.html#_tutorial_field_engine_significantly_improve_performance[here]
291* Add documentation index link:index.html[index]
292* Fix documentation Table of Content javascript 
293* Update Stateless presentation link:http://www.slideshare.net/HanochHaim/trex-realistic-traffic-generator-stateless-support[Statelss presenation]
294* Stateful Python server API - Add support for iterator of remote file for Stateful GUI
295
296=== fix issues: ===
297
298* Performance issue, link:http://trex-tgn.cisco.com/youtrack/issue/trex-207[trex-207]
299* Sporadic timeout on wait_on_traffic() API see link:http://trex-tgn.cisco.com/youtrack/issue/trex-209[trex-209] 
300
301== Release 2.00  ==
302
303* Console 
304** Support partial port acquire using new CLI switch `-a ACQUIRE` (first phase)
305** Add tx/rx graphs 
306* Python API: add an API for reading events as warning/errors
307* HLTAPI support for per stream stats  
308* support VALN mode for per stream stats for 82599 using `--vlan` switch at server invocation
309* A peek into TRex stateless GUI version for evaluation still without many features like packet builder, advance packet builder, per stream stats link:https://www.dropbox.com/s/vs9gojtdc5ewv05/setupCiscoTrex1.96-SNAPSHOT.exe?dl=0[TRex Stateless GUI Download]
310** Only pcap file packet builder is supported in this version 
311
312image::images/trex_stl_gui.png[title="TRex Stateless GUI",align="left",width=600, link="images/trex_stl_gui.png"]
313
314=== fix issues: ===
315
316* X710/XL710 per stream hardware stats 
317** link:http://trex-tgn.cisco.com/youtrack/issue/trex-199[trex-199]
318** Fix issue of RX bytes 
319** Fix issue with mbuf leak
320* Packet Memory shortage fix link:http://trex-tgn.cisco.com/youtrack/issue/trex-197[trex-197]
321* Python Examples - move all examples to be 16.0.0.x/48.0.0.x for some refactor 
322
323
324== Release 1.99  ==
325
326
327* The Client package includes Console/examples 
328* Client API verification mechanism. The client should match the server version range 
329
330=== fix issues: ===
331
332* link:http://trex-tgn.cisco.com/youtrack/issue/trex-193[trex-193]
333* Python2/Python3 client API hardening 
334* Per stream statistics in software hardening - add support for wait on rx packets
335
336
337== Release 1.98  ==
338
339* Minor Console issue 
340* [red]*Image is broken* see link:http://trex-tgn.cisco.com/youtrack/issue/trex-193[trex-193]  
341
342== Release 1.97  ==
343
344* Support pyATS with Python 3/32bit
345* Per stream statistic supported by software for I350/82559/VXNET3 
346* [red]*Image is broken* see link:http://trex-tgn.cisco.com/youtrack/issue/trex-193[trex-193]  
347
348== Release 1.96  ==
349
350* Support pyATS/32bit/Python2.x for TCL 
351* Traffic profile direction/port directive works see link:draft_trex_stateless.html#_tutorial_advance_traffic_profile[here]
352* Documentation 
353** Add Python API documentation link:cp_stl_docs/index.html[here]
354** Add pyATS2.0 support link:cp_stl_docs/index.html[here]
355** Update per stream statistic documentation see link:draft_trex_stateless.html#_tutorial_per_stream_statistics[per stream statistic] 
356** Update HLTAPI arguments link:draft_trex_stateless.html#_hlt_supported_arguments_a_id_altapi_support_a[HLTAPI] 
357
358=== fix issues: ===
359
360* Per stream statistic - Fix High speed of start/stop of  giving zero in statistics
361* Fix E1000 DPDK driver prints with ESXi
362
363
364== Release 1.95  ==
365
366* TUI support per stream stats (press s to get to this window)
367* per stream statistic API examples 
368* Add Python API automatic documentation scripts 
369* Fix issue with a packet smaller than 64 bytes
370
371=== Known issue 
372
373* High speed of start/stop of per stream stats give zero in statistics
374 
375
376== Release 1.94  ==
377
378* Fix Python API stop/sync issue. Now TX counters are synced in case of stop API 
379* Improve performance of Python API, ~2000 cycles/sec of load/start/stop
380* Add per stream Tx/Rx statistics for XL710/X710 NICS work in flow-director hardware
381
382[source,python]
383----
384class STLS1(object):
385
386    def get_streams (self, direction = 0):
387        return [STLStream(packet = 
388                          STLPktBuilder(
389                          pkt ="stl/yaml/udp_64B_no_crc.pcap"), 
390                          mode = STLTXCont(pps=10),
391                          rx_stats = STLRxStats(user_id = 7))   <1> 
392               ]
393----
394<1> Configure this stream to be count on all RX ports as user_id=7
395
396* Add HTLAPI full example (examples `examples/hlt_udp_simple.py`)
397* Add user manual draft for Stateless functionality link:draft_trex_stateless.html[here]
398
399
400== Release 1.93  ==
401
402* Support port attribute API and Console command.  See `$portattr -a --prom`
403* Support random seed per Stream attribute - see specification for more info
404* Add more sample/profiles (stl/hlt) from real use cases
405* Enhance Field Engine with new instructions
406* TUI now shows L1 and L2 bandwidth. Console support L1 and L2 and %%
407* Stream rate can be configured with PPS/bps_L1/bps_L2/port_percentage 
408* Update Stateless JSON-RPC specification  
409* HLT fixes and support split_by variable 
410* First phase of per stream rx/tx statistic - XL710/X710 hardware support
411
412=== fix issues: ===
413
414* Fix some typo in Python API stl/example folder 
415* Fix Field Engine IPv4 checksum issue with big packet size  
416* Fix Field Engine issue with random variables 
417* Fix `streams -a` crash 
418* Fix X710 issue. Now return speed of 10gb instead of 40gb for Stateless port speed 
419
420
421== Release 1.92  ==
422
423** Stream can set static Source/Destination MAC-Address as oppose to the default (TRex port from /etc/trex_config.yaml)
424
425[source,python]
426----
427def create_stream (self):
428 base_pkt =  Ether(src="00:00:dd:dd:00:01")/IP()/UDP() 
429 pad = max(0, size - len(base_pkt)) * 'x'
430----
431
432** Stream support action_count. Loop of streams can end after action_count number. The push command uses this new feature to import pcap to streams and stop after x iteration. 
433
434[source,python]
435----
436STLStream(  self_start = False, 
437            name   ='S2',
438            packet = STLPktBuilder(pkt = base_pkt2/pad),
439            mode = STLTXSingleBurst( pps = 10, total_pkts = 3 ),
440            action_count = 2, # loop 2 times 
441            next    = 'S0' 
442           )
443----
444
445** Support new Field-Engine instructions (variable with step and write with mask). See new sample folder and specification for more info
446
447[source,python]
448----
449def create_stream (self):
450
451    # 2 MPLS label the internal with  s=1 (last one)
452    pkt =  Ether()/MPLS(label=17,cos=1,s=0,ttl=255)/MPLS(label=0,cos=1,s=1,ttl=12)/IP()/UDP()/('x'*20)
453
454    vm = CTRexScRaw( [ STLVmFlowVar(name="mlabel", min_value=1, max_value=2000, size=2, op="inc"), 
455                       STLVmWrMaskFlowVar(fv_name="mlabel", pkt_offset= "MPLS:1.label",pkt_cast_size=4, mask=0xFFFFF000,shift=12) # write mask
456                      ]
457                   )
458----
459
460[source,python]
461----
462 vm = CTRexScRaw( [ STLVmFlowVar(name="mac_src", min_value=1, max_value=30, size=1, op="dec",step=7), # step 
463                STLVmWrFlowVar(fv_name="mac_src", pkt_offset= 11) 
464               ]
465            )
466----
467
468** More profile samples (native/hlt)
469
470
471== Release 1.91  ==
472
473* Convert Stateless traffic profile to Scapy see `stl/*.py` sample folder
474* Add HLTAPI tests and profile `stl/hlt/*.py`
475* Fix simulator path issue fix
476* The Stateless python library is not self-contained.  in `automation/trex_control_plane/stl/` library is `automation/trex_control_plane/stl/trex_stl_lib/` (import trex_stl_lib)
477
478How to run the simulator 
479[source,bash]
480----
481./stl-sim -f stl/udp_1pkt_range_clients_split.py -o b.pcap -l 100 -c 2
482----
483
484* Add push command to convert pcap to streams 
485
486-------------------
487TRex > push --help
488usage: push [-h] -f FILE [--port PORTS [PORTS ...] | -a] [-d TIME]
489            [-i IPG_USEC] [-s SPEEDUP] [--force]
490
491optional arguments:
492  -h, --help            show this help message and exit
493  -f FILE               File path to load
494  --port PORTS [PORTS ...]
495                        A list of ports on which to apply the command
496  -a                    Set this flag to apply the command on all available
497                        ports
498  -d TIME               Set duration time for job.
499  -i IPG_USEC, --ipg IPG_USEC
500                        IPG value in usec between packets. default will be
501                        from the pcap
502  -s SPEEDUP, --speedup SPEEDUP
503                        Factor to accelerate the injection. effectively means
504                        IPG = IPG / SPEEDUP
505  --force               Set if you want to stop active ports before appyling
506                        command.
507TRex >push -f cap2/dns.pcap  --port 0 -i 10  
508-------------------
509
510
511
512== Release 1.90  ==
513
514* Missing file in the pkg
515
516== Release 1.89  ==
517
518* Integrate Scapy as a packet builder see `stl/profiles` folder 
519* Improve Python API, samples can be seen link:https://github.com/cisco-system-traffic-generator/trex-core/tree/master/scripts/api/stl/examples[here] 
520* Add Stateless simulator into the package 
521
522Example how to run 
523[source,bash]
524----
525./stl-sim -f stl/profiles/udp_1pkt.py -l 10 -o a.pcap            #<1>
526./stl-sim -f stl/profiles/udp_1pkt_tuple_gen.py -l 20 -o a.pcap  #<2>
527./stl-sim -f stl/profiles/imix.py -l 100 -o a.pcap  --json       #<3>
528----
529<1> Limit the number of packets to 10 
530<2> Tuple generator example 
531<3> imix 
532
533The simulator takes Stateless profile,YAML or Py and output pcap file or json  
534
535* Console can load the new Python profile 
536
537[source,bash]
538----
539TRex > start -f stl/profiles/udp_1pkt.py -a -m 1mbps 
540----
541
542* Basic Python HLTAPI support 
543
544=== fix issues: ===
545
546* Dependent streams (e.g. `stl/burst_1000_pkt.yaml`) can be loaded 
547
548== Release 1.88  ==
549
550* Add the Python API to the package 
551* Remove mock support 
552
553== Release 1.87  ==
554
555* Fix some 82599 ierror in case of high rate 
556* First Stateless API examples under api folder (not part of the package)
557
558
559== Release 1.86  ==
560
561* NAT Cisco ASA support 
562** Add support for learning using TCP-ACK field see more here link:trex_manual.html#_nat_support[here] and link:trex_manual.html#_trex_with_asa_5585[here]
563* More stateless support 
564
565== Release 1.85  ==
566
567* Upgrade to DPDK 2.2.0  
568** Some XL710/X710 NIC phy issues solved
569** VMXNET3 driver is optimized 
570** Cisco VIC should be supported, not tested yet
571* Jumbo packet size is supported for 1/10/40 Intel NIC  up to 9K for both stateless and stateful 
572* youTrack is public now, can be seen here link:http://trex-tgn.cisco.com/youtrack[here] 
573* More stateless support 
574** Support random packet size trim instruction - see stl/udp_rand_size_9k.yaml for an example
575** Move Python Regression to trex-core 
576** Add Coverity scripts 
577** Console/Python API can be call from Cisco CEL now (ZMQ Python library is compiled to an old glibc)
578** Add simulator for stateless 
579
580=== fix issues: ===
581
582* The infamous DPDK error is not seen in case of a wrong core argument see here link:http://trex-tgn.cisco.com/youtrack/issue/trex-147[trex-147] 
583
584== Release 1.84  ==
585
586* more stateless support
587** Add splitter range support see "split_by_var" in style/imix_1pkt_vm. yaml
588** Add more samples see stl/syn_attack_sample.yaml. Improve random performance 
589** more improvement with TUI window
590
591
592== Release 1.83  ==
593
594* more stateless support
595** Add basic Packet Field engine see stl/imin_1pkt_vm.yaml
596** some improvement with TUI window. Can be run in parallel with --tui option
597
598== Release 1.82  ==
599
600* more stateless support
601** console stats/tui function works now 
602** R/W support. only one client has R/W capability 
603* XL710/X710 support ICMP filter 
604
605=== fix issues: ===
606
607* link:http://trex-tgn.cisco.com/youtrack/trex-110[trex-110]
608
609
610== Release 1.81  ==
611
612* more stateless support and fixes 
613** change the JSON-RPC result format 
614* Support for specifying different modes for the packets used for latency measurement. Details link:trex_manual.html#_measure_jitter_latency[here].
615
616=== fix issues: ===
617
618* link:http://trex-tgn.cisco.com/youtrack/issue/trex-149[trex-149]
619
620== Release 1.80  ==
621
622* more stateless support
623** All type of streams are supported (Continues/Burst/Multi-burst)
624** Stream can call to other streams
625** start/stop/pause/resume work from the Console
626** -m[rate] is supported for example -m10gbps or -m10kpps from console 
627** update XL710 installation support 
628
629== Release 1.79  ==
630
631* Initial support for stateless 
632** Only continues streams are supported 
633** more info how to enable the interactive shell link:trex_console.html[here]
634
635== Release 1.78  ==
636
637* some clean up in tuple generator 
638* trex stateles console works with trex-mock
639
640=== fix issues: ===
641
642Python API fixup see here  
643
644* link:http://trex-tgn.cisco.com/youtrack/issue/trex-126[trex-126] 
645* link:http://trex-tgn.cisco.com/youtrack/issue/trex-123[trex-122] 
646
647Check for 64bit Kernel
648
649* link:http://trex-tgn.cisco.com/youtrack/issue/trex-123[trex-123] 
650
651== Release 1.77  ==
652
653* improve tuple generator capability now it is more flexiable see more link:trex_manual.html#_clients_servers_ip_allocation_scheme[here]
654
655== Release 1.76  ==
656
657=== fix issues: ===
658
659* minor pcap loader issues  
660* plugin cleanup 
661                 
662
663== Release 1.75  ==
664
665=== fix issues: ===
666
667* First version that works from GitHub/Git - init script are in the output package 
668
669== Release 1.72  ==
670
671
672