| 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 |