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

Fork tracing test
-------------------

This test checks if tracing works correctly in a child process created by a
fork() call, as well as after an exec() call.

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

The test_fork script launches a binary that forks and calls exec() with
the command provided as the argument. Tracepoints are placed before and
after these calls to verify tracing remains operational at all times.

The binary loaded as the new process image also logs an event.

The resulting trace is parsed to make sure the every event was logged
successfully with the correct PIDs.

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

To run this test, you will need:

  - lttng-tools (with python bindings)
  - babeltrace
  - python 3.0 or better
Commit	Line	Data
37bd6c8e JG	1	Fork tracing test
	2	-------------------
	3
	4	This test checks if tracing works correctly in a child process created by a
	5	fork() call, as well as after an exec() call.
	6
	7	DESCRIPTION
	8	-----------
	9
	10	The test_fork script launches a binary that forks and calls exec() with
	11	the command provided as the argument. Tracepoints are placed before and
	12	after these calls to verify tracing remains operational at all times.
	13
	14	The binary loaded as the new process image also logs an event.
	15
	16	The resulting trace is parsed to make sure the every event was logged
	17	successfully with the correct PIDs.
	18
	19	DEPENDENCIES
	20	------------
	21
	22	To run this test, you will need:
	23
	24	- lttng-tools (with python bindings)
	25	- babeltrace
	26	- python 3.0 or better