tests/regression/ust/ust-dl/README

   1 UST dynamic linker tracing test
   2 -------------------------------
   3
   4 This test verifies that the `liblttng-ust-dl.so` helper works as
   5 intended. Indeed, once preloaded, this helper should produce events
   6 for all calls made by the application to dlopen along with with extra
   7 debug information for the given shared object, such as build id or
   8 debug link if it exists, as well as dlclose.
   9
  10
  11 DESCRIPTION
  12 -----------
  13
  14 The test application is run with the environment variable
  15 LD_PRELOAD="liblttng-ust-dl.so" to preload the helper. It then dlopens
  16 a shared library (`libfoo.so`), calls a function from it, and dlclose
  17 it. This should produce `dlopen` and `dlclose` events, as well as
  18 `build_id` and `debug_link`, because the shared library has been built
  19 to contain all this extra debug information.
  20
  21 DEPENDENCIES
  22 ------------
  23
  24 To run this test, you will need:
  25
  26   - lttng-tools (with python bindings)
  27   - babeltrace
  28   - python 3.0 or later