tests/regression/ust/baddr-statedump/README

   1 UST base address statedump test
   2 -------------------------------
   3
   4 This test verifies that the tracing of base address statedump works
   5 properly. When an application traced with LTTng UST registers to the
   6 session daemon, it should produce a statedump, delimited by `start`
   7 and `end` events. Between those events, the base addresses of the
   8 executable and all the shared objects it has loaded are dumped, along
   9 with extra debug information such as build id or debug link if it
  10 exists.
  11
  12 DESCRIPTION
  13 -----------
  14
  15 The test application simply sleeps for one second to ensure the
  16 statedump has the time to complete fully, and defines a single
  17 userspace tracepoint. The statedump events should be generated when
  18 the application registers with the sessiond. The application is
  19 compiled 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
  22 that `lttng_ust_statedump:debug_link` event will be produced. The
  23 events `start`, `bin_info`, `build_id`, and `end` from the same provider
  24 are also expected in the trace and verified by the test.
  25
  26 DEPENDENCIES
  27 ------------
  28
  29 To run this test, you will need:
  30
  31   - lttng-tools (with python bindings)
  32   - babeltrace
  33   - python 3.0 or later