X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=tests%2Fregression%2Fust%2Fust-dl%2FREADME;fp=tests%2Fregression%2Fust%2Fust-dl%2FREADME;h=1db35a6ba4b78ae42d758b950fe7a13d5a5a59d3;hb=c70c42cca32058806a5c7d96d7cf2fae4d4fb75f;hp=0000000000000000000000000000000000000000;hpb=d4f53cc3de1217c965c2285709b784ff66a8033c;p=lttng-tools.git

diff --git a/tests/regression/ust/ust-dl/README b/tests/regression/ust/ust-dl/README
new file mode 100644
index 000000000..1db35a6ba
--- /dev/null
+++ b/tests/regression/ust/ust-dl/README
@@ -0,0 +1,28 @@
+UST dynamic linker tracing test
+-------------------------------
+
+This test verifies that the `liblttng-ust-dl.so` helper works as
+intended. Indeed, once preloaded, this helper should produce events
+for all calls made by the application to dlopen along with with extra
+debug information for the given shared object, such as build id or
+debug link if it exists, as well as dlclose.
+
+
+DESCRIPTION
+-----------
+
+The test application is run with the environment variable
+LD_PRELOAD="liblttng-ust-dl.so" to preload the helper. It then dlopens
+a shared library (`libfoo.so`), calls a function from it, and dlclose
+it. This should produce `dlopen` and `dlclose` events, as well as
+`build_id` and `debug_link`, because the shared library has been built
+to contain all this extra debug information.
+
+DEPENDENCIES
+------------
+
+To run this test, you will need:
+
+  - lttng-tools (with python bindings)
+  - babeltrace
+  - python 3.0 or later