Commit | Line | Data |
---|---|---|
c70c42cc AB |
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 |