Test: add UST baddr statedump test
[lttng-tools.git] / tests / regression / ust / baddr-statedump / README
CommitLineData
d4f53cc3
AB
1UST base address statedump test
2-------------------------------
3
4This test verifies that the tracing of base address statedump works
5properly. When an application traced with LTTng UST registers to the
6session daemon, it should produce a statedump, delimited by `start`
7and `end` events. Between those events, the base addresses of the
8executable and all the shared objects it has loaded are dumped, along
9with extra debug information such as build id or debug link if it
10exists.
11
12DESCRIPTION
13-----------
14
15The test application simply sleeps for one second to ensure the
16statedump has the time to complete fully, and defines a single
17userspace tracepoint. The statedump events should be generated when
18the application registers with the sessiond. The application is
19compiled with debug information, which is then copied into a separate
20`prog.debug` file, and a debug link section is added to the original
21`prog` executable, now stripped of debug information. This ensures
22that `lttng_ust_statedump:debug_link` event will be produced. The
23events `start`, `soinfo`, `build_id`, and `end` from the same provider
24are also expected in the trace and verified by the test.
25
26DEPENDENCIES
27------------
28
29To run this test, you will need:
30
31 - lttng-tools (with python bindings)
32 - babeltrace
33 - python 3.0 or later
This page took 0.0234 seconds and 4 git commands to generate.