summaryrefslogtreecommitdiffstats
path: root/extras/hs-test/README.rst
diff options
context:
space:
mode:
authorFilip Tehlar <ftehlar@cisco.com>2024-01-24 15:11:27 +0100
committerFlorin Coras <florin.coras@gmail.com>2024-01-29 19:59:02 +0000
commitf34b6800de78d99192dc5757a4845e2668749c40 (patch)
tree9a2334a93ca19a0e66a2b917d7f9817a5fb0706e /extras/hs-test/README.rst
parenta1bd50c7a2c2c2d69d92cef167a64a1a5ddc4af7 (diff)
hs-test: update docs on debugging
Type: docs Change-Id: I3bd89feb53a35532c79283bcdac2c87635c60920 Signed-off-by: Filip Tehlar <ftehlar@cisco.com>
Diffstat (limited to 'extras/hs-test/README.rst')
-rw-r--r--extras/hs-test/README.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/extras/hs-test/README.rst b/extras/hs-test/README.rst
index 2caa65d7a83..6db832b7fbe 100644
--- a/extras/hs-test/README.rst
+++ b/extras/hs-test/README.rst
@@ -195,6 +195,21 @@ test run time it is not advisable to use aforementioned skip methods and instead
func (s *MySuite) SkipTest(){
+**Debugging a test**
+
+It is possible to debug VPP by attaching ``gdb`` before test execution by adding ``DEBUG=true`` like follows:
+
+::
+
+ $ make test TEST=TestVeths/TestLDPreloadIperfVpp DEBUG=true
+ ...
+ run following command in different terminal:
+ docker exec -it server-vpp gdb -ex "attach $(docker exec server-vpp pidof vpp)"
+ Afterwards press CTRL+C to continue
+
+If a test consists of more VPP instances then this is done for each of them.
+
+
**Eternal dependencies**
* Linux tools ``ip``, ``brctl``