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

UST linking test
----------------

Tests userspace tracing with directly, statically and dynamically linked
providers.

DESCRIPTION
-----------

This test checks that tracepoints can be enabled by using LD_PRELOAD inside a
launcher script. The test application is also compiled with tracepoint
providers linked directly and statically. The same test suite is executed
for every version of the binary.

The resulting trace is verified to make sure it is valid and contains the
expected valuess. This test also verifies that the execution of the demo test
without LD_PRELOAD has not produced any logged events.

Also serves as an example of building and tracing an application with all types
of provider linking.

DEPENDENCIES
------------

To run this test, you will need:

  - lttng-tools
  - babeltrace
  - python 3.0 or better
Commit	Line	Data
91c75285 JG	1	UST linking test
	2	----------------
	3
	4	Tests userspace tracing with directly, statically and dynamically linked
	5	providers.
	6
	7	DESCRIPTION
	8	-----------
	9
	10	This test checks that tracepoints can be enabled by using LD_PRELOAD inside a
	11	launcher script. The test application is also compiled with tracepoint
	12	providers linked directly and statically. The same test suite is executed
	13	for every version of the binary.
	14
	15	The resulting trace is verified to make sure it is valid and contains the
	16	expected valuess. This test also verifies that the execution of the demo test
	17	without LD_PRELOAD has not produced any logged events.
	18
	19	Also serves as an example of building and tracing an application with all types
	20	of provider linking.
	21
	22	DEPENDENCIES
	23	------------
	24
	25	To run this test, you will need:
	26
	27	- lttng-tools
	28	- babeltrace
	29	- python 3.0 or better