summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rwxr-xr-xtrex_book.asciidoc25
-rwxr-xr-xtrex_book_basic.asciidoc4
2 files changed, 15 insertions, 14 deletions
diff --git a/trex_book.asciidoc b/trex_book.asciidoc
index 0f938bbd..63ab7294 100755
--- a/trex_book.asciidoc
+++ b/trex_book.asciidoc
@@ -126,7 +126,7 @@ VMXNET3 (read notes) | VMware paravirtualize | connect using vmWare vSwitch
** > sudo yum update kernel-devel
** > sudo yum update kernel-headers
* For Intel XL710 NICs there is a need to verify the NVM is v4.42 or v4.53 see xref:xl710-firmware[here] for more info
-** > sudo ./t-rex-64 -f cap2/dns.yaml -d 0 --no-flow-control *-v 6* --nc | grep NVM +
+** > sudo ./t-rex-64 -f cap2/dns.yaml -d 0 *-v 6* --nc | grep NVM +
PMD: FW 4.22 API 1.2 *NVM 04.04.02* eetrack 800013fc +
PMD: FW 4.22 API 1.2 *NVM 04.04.02* eetrack 800013fc +
PMD: FW 4.22 API 1.2 *NVM 04.04.02* eetrack 800013fc +
@@ -716,9 +716,8 @@ TRex(0) -| |-TRex(1)
=== NAT support
-TRex can learn dynamic NAT/PAT translation. To enable this feature add `--learn` to the command line.
-//TBD: maybe... add the '--learn' option on the command line.
-This is done by adding an IPv4 option header with TRex info (8 bytes long 0x10 id) to the first packet of the flow.
+TRex can learn dynamic NAT/PAT translation. To enable this feature add `--learn-mode <val>` to the command line.
+In mode 2, this is done by adding an IPv4 option header with TRex info (8 bytes long 0x10 id) to the first packet of the flow. In mode 2, this is done by embedding NAT info in the ACK of the first TCP SYN.
*Example:*::
@@ -726,14 +725,14 @@ This is done by adding an IPv4 option header with TRex info (8 bytes long 0x10 i
[source,bash]
----
-$sudo ./t-rex-64 -f cap2/http_simple.yaml -c 4 -l 1000 -d 100000 -m 30 --learn
+$sudo ./t-rex-64 -f cap2/http_simple.yaml -c 4 -l 1000 -d 100000 -m 30 --learn-mode 1
----
*SFR traffic without bundeling/ALG support*
[source,bash]
----
-$sudo ./t-rex-64 -f avl/sfr_delay_10_1g_no_bundeling.yaml -c 4 -l 1000 -d 100000 -m 10 --learn
+$sudo ./t-rex-64 -f avl/sfr_delay_10_1g_no_bundeling.yaml -c 4 -l 1000 -d 100000 -m 10 --learn-mode 2
----
*New terminal counters:*::
@@ -1165,10 +1164,12 @@ This gave best results: with *\~98 Gb/s* TX BW and c=7, CPU utilization became *
*--ipv6*::
Convert template to IPv6 mode.
-*--learn*::
- Learn the dynamic NAT translation and ALG.
-
-*--learn-verify*::
+*--learn-mode <mode (1-2)>*::
+ Learn the dynamic NAT translation. +
+ 1 - Use TCP ACK in first SYN to pass NAT translation information. Will work only for TCP streams. Initial SYN packet must be present in stream. +
+ 2 - Add special IP option to pass NAT translation information. Will not work on certain firewalls if they drop packets with IP options.
+
+*--learn-verify*::
Learn the translation. This feature is intended for verification of the mechanism in cases where there is no NAT.
*-p*::
@@ -1230,8 +1231,8 @@ This gave best results: with *\~98 Gb/s* TX BW and c=7, CPU utilization became *
*--iom=MODE*::
I/O mode for interactive mode. Possible values: 0 (silent), 1 (normal), 2 (short)
-*--no-flow-control*::
- Prevents TRex from changing flow control. In default TRex operation, flow control is disabled at startup.
+*--no-flow-control-change*::
+ Prevents TRex from changing flow control. By default (without this option), TRex disables flow control at startup for all cards, except for the Intel XL710 40G card.
*--mac-spread*::
Spread the destination mac by this this factor. e.g 2 will generate the traffic to 2 devices DEST-MAC ,DEST-MAC+1. The maximum is up to 128 devices.
diff --git a/trex_book_basic.asciidoc b/trex_book_basic.asciidoc
index c3f489a8..6e679114 100755
--- a/trex_book_basic.asciidoc
+++ b/trex_book_basic.asciidoc
@@ -2683,7 +2683,7 @@ $.sudo /t-rex-64 -f avl/sfr_delay_10_1g_no_bundeling.yaml -c 4 -m 20 -d 100 -l 1
.Simple HTTP 1Gb/sec with NAT translation support
[source,bash]
----
-$.sudo /t-rex-64 -f cap2/simple_http.yaml -c 4 -m 100 -d 100 -l 1000 --learn
+$.sudo /t-rex-64 -f cap2/simple_http.yaml -c 4 -m 100 -d 100 -l 1000 --learn-mode 1
----
.IMIX 1G/sec ,1600 flows
@@ -2712,7 +2712,7 @@ $.sudo /t-rex-64 -f cap2/imix_64.yaml -c 4 -m 1 -d 100 -l 1000
| name | description
| cap2/dns.yaml | simple dns pcap file
| cap2/http_simple.yaml | simple http cap file
-| avl/sfr_delay_10_1g_no_bundeling.yaml | sfr traffic profile capture from Avalanche - Spirent without bundeling support with RTT=10msec ( a delay machine), this can be used with --ipv6 and --learn mode
+| avl/sfr_delay_10_1g_no_bundeling.yaml | sfr traffic profile capture from Avalanche - Spirent without bundeling support with RTT=10msec ( a delay machine), this can be used with --ipv6 and --learn-mode
| avl/sfr_delay_10_1g.yaml | head-end sfr traffic profile capture from Avalanche - Spirent with bundeling support with RTT=10msec ( a delay machine), it is normalized to 1Gb/sec for m=1
| avl/sfr_branch_profile_delay_10.yaml | branch sfr profile capture from Avalanche - Spirent with bundeling support with RTT=10msec it, is normalized to 1Gb/sec for m=1
| cap2/imix_fast_1g.yaml | imix profile with 1600 flows normalized to 1Gb/sec.