X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=README;h=306ef58afb9dfe84ba898c4f0a07f94f2d2ba4f0;hb=c5fdc88852bc232e24fb3941ea5d5719b4490a87;hp=18874e81d8065cd034d42e241ae981ed0bf1b761;hpb=2615de09cbdc7ef9b62db08c182bd75acfad6487;p=ust.git diff --git a/README b/README index 18874e8..306ef58 100644 --- a/README +++ b/README @@ -1,26 +1,29 @@ LTTNG USERSPACE TRACER -NOTE: THIS LIBRARY HAS NOT BEEN RELEASED YET BECAUSE ALTOUGH IT IS LICENCED AS -LGPL, IT CAN ONLY BE USED AS GPL BECAUSE IT DEPENDS ON GPL LIBRARIES. IT WILL BE -RELEASED AS SOON AS THESE ISSUES ARE RESOLVED. - Dependencies: -- liburcu-pmf - Userspace RCU library, pmf patches. - http://git.dorsal.polymtl.ca +- 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. +- 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. -- ust +- ustctl A program to control the tracing of userspace applications. It can list markers, start the tracing, stop the tracing, enable/disable markers, etc. @@ -35,3 +38,7 @@ Package contents: - 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.