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