[lttng-tools.git] / tests / regression / ust / ust-dl / README

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