X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=2.7%2Flttng-docs-2.7.txt;h=be3fd6ebdb8b7fd7945a890b4f7cb48fb1429516;hb=7a44b9ff51fd7f2e1db4645bf2b1927a802375ed;hp=3210b83645f2306122f46608db8293e2d1324058;hpb=1d80e9f194f131b1736a6ef54ae76e17a1b66f07;p=lttng-docs.git diff --git a/2.7/lttng-docs-2.7.txt b/2.7/lttng-docs-2.7.txt index 3210b83..be3fd6e 100644 --- a/2.7/lttng-docs-2.7.txt +++ b/2.7/lttng-docs-2.7.txt @@ -7,6 +7,9 @@ v2.7, 25 October 2016 include::../common/copyright.txt[] +include::../common/warning-not-maintained.txt[] + + include::../common/welcome.txt[] @@ -286,6 +289,8 @@ becomes inactive or in real-time. [[installing-lttng]] == Installation +include::../common/warning-installation-outdated.txt[] + **LTTng** is a set of software <> which interact to <> the Linux kernel and user applications, and to <> (start and stop @@ -327,8 +332,11 @@ other Ubuntu releases. |Fedora |_Not available_ -|LTTng{nbsp}{revision} for Fedora{nbsp}25 and Fedora{nbsp}26 (not -released yet). +|LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} for +Fedora{nbsp}25 and Fedora{nbsp}26 (both are not released yet). + +<>. <> for other Fedora releases. @@ -347,7 +355,10 @@ other openSUSE releases. |Arch Linux |_Not available_ -|<>. +| +LTTng{nbsp}2.8 on the AUR. + +<>. |Alpine Linux |_Not available_ @@ -382,8 +393,8 @@ other Yocto releases. [[ubuntu]] === [[ubuntu-official-repositories]]Ubuntu -LTTng{nbsp}{revision} is available on Ubuntu 16.04 _Xenial Xerus_. For -previous releases of Ubuntu, <>. To install LTTng{nbsp}{revision} on Ubuntu{nbsp}16.04 _Xenial Xerus_: @@ -411,7 +422,7 @@ sudo apt-get install liblttng-ust-agent-java -- . **If you need to instrument and trace - <>**, install the + <>**, install the LTTng-UST Python agent: + -- @@ -470,7 +481,7 @@ sudo apt-get install liblttng-ust-agent-java -- . **If you need to instrument and trace - <>**, install the + <>**, install the LTTng-UST Python agent: + -- @@ -2543,7 +2554,7 @@ holding more than one tracepoint providers. Once you <>, you can use the `tracepoint()` macro in your application's source code to insert the tracepoints that this header -<> defines. +<>. The `tracepoint()` macro takes at least two parameters: the tracepoint provider name and the tracepoint name. The corresponding tracepoint @@ -2752,10 +2763,11 @@ In the following diagrams, we use the following file names: `libemon.so`:: User library shared object file. -The red star indicates that this object file is instrumented -(contains code which uses the `tracepoint()` macro). The spring -symbol between the application and a library means the application is -linked with the library at build time. +We use the following symbols in the diagrams of table below: + +[role="img-100"] +.Symbols used in the build scenario diagrams. +image::ust-sit-symbols.png[] We assume that path:{.} is part of the env:LD_LIBRARY_PATH environment variable in the following instructions. @@ -3204,7 +3216,7 @@ include::../common/ust-sit-step-tp-so.txt[] To build the instrumented user library: . In path:{emon.c}, before including path:{tpp.h}, add the - following line: + following lines: + -- [source,c] @@ -3291,7 +3303,7 @@ include::../common/ust-sit-step-tp-so.txt[] To build the instrumented user library: . In path:{emon.c}, before including path:{tpp.h}, add the - following line: + following lines: + -- [source,c] @@ -3440,7 +3452,7 @@ include::../common/ust-sit-step-tp-so.txt[] To build the instrumented user library: . In path:{emon.c}, before including path:{tpp.h}, add the - following line: + following lines: + -- [source,c] @@ -3513,7 +3525,7 @@ include::../common/ust-sit-step-tp-so.txt[] To build the instrumented user library: . In path:{emon.c}, before including path:{tpp.h}, add the - following line: + following lines: + -- [source,c] @@ -4238,10 +4250,8 @@ Assuming no event record is lost, having only the function addresses on entry is enough to create a call graph, since an event record always contains the ID of the CPU that generated it. + -You can use a tool like -https://sourceware.org/binutils/docs/binutils/addr2line.html[cmd:addr2line] -to convert function addresses back to source file names and -line numbers. +You can use a tool like man:addr2line(1) to convert function addresses +back to source file names and line numbers. * **path:{liblttng-ust-cyg-profile.so}** is a more robust variant which also works in use cases where event records might get discarded or @@ -6032,7 +6042,7 @@ To use LTTng live: -- [role="term"] ---- -lttng create --live my-session +lttng create my-session --live ---- -- +