X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=README.md;h=f71649b4155d9f02978d3f40b12b5cf832cf9cd9;hb=47fa3e4ed7ab43e034dc61fc1480f919f4ee51d0;hp=3c45c30c190752c5a458adb3a159904cd722c8cd;hpb=a610548a65db6afb389ccef38e684405f76f786c;p=lttng-ust.git diff --git a/README.md b/README.md index 3c45c30c..f71649b4 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + + LTTng-UST ========= @@ -92,11 +98,11 @@ This method links the tracepoint provider with the application, either directly or through a static library (`.a`): 1. Into exactly one unit (C/C++ source file) of your _application_, - define `TRACEPOINT_DEFINE` and include the tracepoint provider + define `LTTNG_UST_TRACEPOINT_DEFINE` and include the tracepoint provider header. 2. Include the tracepoint provider header into all C/C++ files using the provider and insert tracepoints using the `tracepoint()` macro. - 3. Use `-I.` when compiling the unit defining `TRACEPOINT_DEFINE` + 3. Use `-I.` when compiling the unit defining `LTTNG_UST_TRACEPOINT_DEFINE` (e.g., `tp.c`). 4. Link the application with `-ldl` on Linux, or with `-lc` on BSD, and with `-llttng-ust`. @@ -124,7 +130,7 @@ This method decouples the tracepoint provider from the application, making it dynamically loadable. 1. Into exactly one unit of your _application_, define - `TRACEPOINT_DEFINE` _and_ `TRACEPOINT_PROBE_DYNAMIC_LINKAGE`, + `LTTNG_UST_TRACEPOINT_DEFINE` _and_ `LTTNG_UST_TRACEPOINT_PROBE_DYNAMIC_LINKAGE`, then include the tracepoint provider header. 2. Include the tracepoint provider header into all C/C++ files using the provider and insert tracepoints using the `tracepoint()` macro. @@ -171,6 +177,10 @@ human-readable text log. variable `LTTNG_UST_DEBUG` when launching the user application. It can also be enabled at build time by compiling LTTng-UST with `-DLTTNG_UST_DEBUG`. + - `liblttng-ust` abort on critical can be activated by setting the + environment variable `LTTNG_UST_ABORT_ON_CRITICAL` when launching the user + application. It can also be enabled at build time by compiling LTTng-UST with + `-DLTTNG_UST_ABORT_ON_CRITICAL`. - The environment variable `LTTNG_UST_REGISTER_TIMEOUT` can be used to specify how long the applications should wait for the session daemon _registration done_ command before proceeding to execute the @@ -190,7 +200,7 @@ human-readable text log. Since LTTng-UST 2.3, both tracepoints and tracepoint providers can be compiled in C++. To compile tracepoint probes in C++, you need -G++ >= 4.7 or Clang. The C++ compilers need to support C++11. +G++ >= 4.7 or Clang >= 4.0. The C++ compilers need to support C++11. Contact @@ -200,6 +210,7 @@ Maintainer: [Mathieu Desnoyers](mailto:mathieu.desnoyers@efficios.com) Mailing list: [`lttng-dev@lists.lttng.org`](https://lttng.org/cgi-bin/mailman/listinfo/lttng-dev) +Code review: [_lttng-ust_ project](https://review.lttng.org/q/project:lttng-ust) on LTTng Review Package contents ---------------- @@ -231,7 +242,7 @@ This package contains the following elements: JAR library to provide an LTTng-UST logging back-end for Java applications using Java Util Logging or Log4j. (Configure with `--enable-java-agent-jul` or `--enable-java-agent-log4j` or - `--enable-java-agent-all`). + `--enable-java-agent-log4j2` or `--enable-java-agent-all`). - `liblttng-ust-libc-wrapper`: an example library that can be preloaded to instrument some calls to libc (currently `malloc()` and `free()`) and to POSIX threads (mutexes currently instrumented) in