[ust.git] / README

LTTNG USERSPACE TRACER

Dependencies:

- liburcu
  Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
  http://ltt.polymtl.ca/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary

- libkcompat
  Linux kernel userspace compatibility library.
  http://git.dorsal.polymtl.ca

Installation instruction:

- Download, compile and install liburcu and libkcompat.
- In this package's tree, run ./configure.
- Run make.
- Run make install.
- Run ldconfig.
- See the manual in the doc/ directory for usage instructions.

Package contents:

- libust
  The actual userspace tracing library that must be linked to the
  instrumented programs.

- ustctl
  A program to control the tracing of userspace applications. It can list
  markers, start the tracing, stop the tracing, enable/disable markers, etc.

- ustd
  The daemon that collects trace data and writes it to the disk.

- Documentation

- hello
  An example application that uses the userspace tracer.

- libmallocwrap
  An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
  in any program without need to recompile it.

- libinterfork
  A library that is LD_PRELOAD'ed, and that hijacks calls to several system
  calls in order to trace across these calls.
Commit	Line	Data
	1	LTTNG USERSPACE TRACER
	2
	3	Dependencies:
	4
	5	- liburcu
	6	Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
	7	http://ltt.polymtl.ca/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
	8
	9	- libkcompat
	10	Linux kernel userspace compatibility library.
	11	http://git.dorsal.polymtl.ca
	12
	13	Installation instruction:
	14
	15	- Download, compile and install liburcu and libkcompat.
	16	- In this package's tree, run ./configure.
	17	- Run make.
	18	- Run make install.
	19	- Run ldconfig.
	20	- See the manual in the doc/ directory for usage instructions.
	21
	22	Package contents:
	23
	24	- libust
	25	The actual userspace tracing library that must be linked to the
	26	instrumented programs.
	27
	28	- ustctl
	29	A program to control the tracing of userspace applications. It can list
	30	markers, start the tracing, stop the tracing, enable/disable markers, etc.
	31
	32	- ustd
	33	The daemon that collects trace data and writes it to the disk.
	34
	35	- Documentation
	36
	37	- hello
	38	An example application that uses the userspace tracer.
	39
	40	- libmallocwrap
	41	An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
	42	in any program without need to recompile it.
	43
	44	- libinterfork
	45	A library that is LD_PRELOAD'ed, and that hijacks calls to several system
	46	calls in order to trace across these calls.