X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=tests%2Fregression%2Fust%2Ffork%2FREADME;fp=tests%2Fregression%2Fust%2Ffork%2FREADME;h=eb36100f71b69029e97174c4d9b1ab69c353d255;hp=0000000000000000000000000000000000000000;hb=37bd6c8e4c4a3d7054d97627e4fb4bef1d4612a6;hpb=ee28adfb4b4f5a6b24f4d23024ed256af37060c6

diff --git a/tests/regression/ust/fork/README b/tests/regression/ust/fork/README
new file mode 100644
index 000000000..eb36100f7
--- /dev/null
+++ b/tests/regression/ust/fork/README
@@ -0,0 +1,26 @@
+Fork tracing test
+-------------------
+
+This test checks if tracing works correctly in a child process created by a
+fork() call, as well as after an exec() call.
+
+DESCRIPTION
+-----------
+
+The test_fork script launches a binary that forks and calls exec() with
+the command provided as the argument. Tracepoints are placed before and
+after these calls to verify tracing remains operational at all times.
+
+The binary loaded as the new process image also logs an event.
+
+The resulting trace is parsed to make sure the every event was logged
+successfully with the correct PIDs.
+
+DEPENDENCIES
+------------
+
+To run this test, you will need:
+
+  - lttng-tools (with python bindings)
+  - babeltrace
+  - python 3.0 or better