vpp/extras/vcl-ldpreload
Nathan Skrzypczak a2c9509a4a docs: convert extras doc md->rst
Type: improvement

Change-Id: Ie3b25a86b99098d2b3a21a11fc73234c8ed589d6
Signed-off-by: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
2021-10-13 15:32:22 +00:00
..
2020-04-03 19:52:31 +00:00
2021-10-13 15:32:22 +00:00

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. _vcl_ldpreload_doc:

LD_PRELOAD the VCL
==================

vcl-ldpreload is a LD_PRELOAD library that uses the VPP Communications Library (VCL).

User can LD_PRELOAD any application that uses POSIX socket API.

NOTE: The sources have been moved to ``vpp/src/vcl`` and ``libvcl_ldpreload.so`` is built with VPP and can be found in
``vpp/build-root/install-vpp[_debug]-native/vpp/lib``

1. Running the demo
-------------------

Run test script without parameters to see help menu:

::

    export WS_ROOT= (e.g. /scratch/my_name/vpp)
    $WS_ROOT/test/scripts/socket_test.sh


2. Docker iPerf examples
------------------------

These launch xterms. To quit, close xterms and run following docker kill cmd (WARNING: This will kill all docker containers!) docker kill $(docker ps -q)

Docker iPerf using default Linux Bridge

::

    $WS_ROOT/test/scripts/socket_test.sh -bi docker-kernel


Docker iPerf using VPP

::

    $WS_ROOT/test/scripts/socket_test.sh -bi docker-preload