X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=README;h=b29ca013772cd5ab2bfab6fef5c2c1983cc855fc;hb=41157ed730c602a813f993ab255edced2935cbdb;hp=18874e81d8065cd034d42e241ae981ed0bf1b761;hpb=2615de09cbdc7ef9b62db08c182bd75acfad6487;p=ust.git diff --git a/README b/README index 18874e8..b29ca01 100644 --- a/README +++ b/README @@ -1,26 +1,31 @@ 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. +- 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. -- 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 +40,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.