aboutsummaryrefslogtreecommitdiffstats
path: root/docs/report/introduction/methodology_gso.rst
diff options
context:
space:
mode:
authorTibor Frank <tifrank@cisco.com>2023-05-03 13:53:27 +0000
committerTibor Frank <tifrank@cisco.com>2023-05-09 05:56:22 +0000
commit374954b9d648f503f6783325a1266457953a998d (patch)
tree5514dee6af2a2e069189efe39d4e929dd25721f7 /docs/report/introduction/methodology_gso.rst
parent46eac7bb697e8261dba5b439a15f5a6125f31760 (diff)
C-Docs: New structure
Change-Id: I73d107f94b28b138f3350a9e1eedb0555583a9ca Signed-off-by: Tibor Frank <tifrank@cisco.com>
Diffstat (limited to 'docs/report/introduction/methodology_gso.rst')
-rw-r--r--docs/report/introduction/methodology_gso.rst136
1 files changed, 0 insertions, 136 deletions
diff --git a/docs/report/introduction/methodology_gso.rst b/docs/report/introduction/methodology_gso.rst
deleted file mode 100644
index b33b3aefbd..0000000000
--- a/docs/report/introduction/methodology_gso.rst
+++ /dev/null
@@ -1,136 +0,0 @@
-.. _gso_methodology:
-
-Generic Segmentation Offload Tests
-----------------------------------
-
-Overview
-~~~~~~~~
-
-Generic Segmentation Offload (GSO) reduces per-packet processing
-overhead by enabling applications to pass a multi-packet buffer to
-(v)NIC and process a smaller number of large packets (e.g. frame size of
-64 KB), instead of processing higher numbers of small packets (e.g.
-frame size of 1500 B), thus reducing per-packet overhead.
-
-|csit-release| introduced GSO tests for VPP vhostuser and tapv2
-interfaces. All tests cases use iPerf3 client and server applications
-running TCP/IP as a traffic generator. For performance comparison the
-same tests are run without GSO enabled.
-
-GSO Test Topologies
-~~~~~~~~~~~~~~~~~~~
-
-Two VPP GSO test topologies are implemented in |csit-release|:
-
-1. iPerfC_GSOvirtio_LinuxVM --- GSOvhost_VPP_GSOvhost --- iPerfS_GSOvirtio_LinuxVM
-
- - Tests VPP GSO on vhostuser interfaces and interaction with Linux
- virtio with GSO enabled.
-
-1. iPerfC_GSOtap_LinuxNspace --- GSOtapv2_VPP_GSOtapv2 --- iPerfS_GSOtap_LinuxNspace
-
- - Tests VPP GSO on tapv2 interfaces and interaction with Linux tap
- with GSO enabled.
-
-Common configuration:
-
-- iPerfC (client) and iPerfS (server) run in TCP/IP mode without upper
- bandwidth limit.
-- Trial duration is set to 30 sec.
-- iPerfC, iPerfS and VPP run in the single SUT node.
-
-
-VPP GSOtap Topology
-~~~~~~~~~~~~~~~~~~~
-
-VPP Configuration
-_________________
-
-VPP GSOtap tests in |csit-release| are executed without using
-hyperthreading. VPP worker runs on a single core. Multi-core tests are
-not executed. Each interface belongs to separate namespace. Following core
-pinning scheme is used:
-
-- 1t1c (rxq=1, rx_qsz=4096, tx_qsz=4096)
-
- - system isolated: 0,28,56,84
- - vpp mt: 1
- - vpp wt: 2
- - vhost: 3-5
- - iperf-s: 6
- - iperf-c: 7
-
-
-iPerf3 Server Configuration
-___________________________
-
-iPerf3 version used 3.7
-
-::
-
- $ sudo -E -S ip netns exec tap1_namespace iperf3 \
- --server --daemon --pidfile /tmp/iperf3_server.pid --logfile /tmp/iperf3.log --port 5201 --affinity <X>
-
-For the full iPerf3 reference please see:
-`iPerf3 docs <https://github.com/esnet/iperf/blob/master/docs/invoking.rst>`_.
-
-
-iPerf3 Client Configuration
-___________________________
-
-iPerf3 version used 3.7
-
-::
-
- $ sudo -E -S ip netns exec tap1_namespace iperf3 \
- --client 2.2.2.2 --bind 1.1.1.1 --port 5201 --parallel <Y> --time 30.0 --affinity <X> --zerocopy
-
-For the full iPerf3 reference please see:
-`iPerf3 docs <https://github.com/esnet/iperf/blob/master/docs/invoking.rst>`_.
-
-
-VPP GSOvhost Topology
-~~~~~~~~~~~~~~~~~~~~~
-
-VPP Configuration
-_________________
-
-VPP GSOvhost tests in |csit-release| are executed without using
-hyperthreading. VPP worker runs on a single core. Multi-core tests are
-not executed. Following core pinning scheme is used:
-
-- 1t1c (rxq=1, rx_qsz=1024, tx_qsz=1024)
- - system isolated: 0,28,56,84
- - vpp mt: 1
- - vpp wt: 2
- - vm-iperf-s: 3,4,5,6,7
- - vm-iperf-c: 8,9,10,11,12
- - iperf-s: 1
- - iperf-c: 1
-
-iPerf3 Server Configuration
-___________________________
-
-iPerf3 version used 3.7
-
-::
-
- $ sudo iperf3 \
- --server --daemon --pidfile /tmp/iperf3_server.pid --logfile /tmp/iperf3.log --port 5201 --affinity X
-
-For the full iPerf3 reference please see:
-`iPerf3 docs <https://github.com/esnet/iperf/blob/master/docs/invoking.rst>`_.
-
-
-iPerf3 Client Configuration
-___________________________
-
-iPerf3 version used 3.7
-
-::
-
- $ sudo iperf3 \
- --client 2.2.2.2 --bind 1.1.1.1 --port 5201 --parallel <Y> --time 30.0 --affinity X --zerocopy
-
-For the full iPerf3 reference please see:
-`iPerf3 docs <https://github.com/esnet/iperf/blob/master/docs/invoking.rst>`_. \ No newline at end of file