Commit | Line | Data |
---|---|---|
f6df8626 PW |
1 | .TH "LTTNG-UST-DL" "3" "December 19, 2013" "" "" |
2 | ||
3 | .SH "NAME" | |
4 | lttng-ust-dl \(em LTTng UST 2.x Dynamic Linker Tracing | |
5 | ||
6 | .SH "SYNOPSIS" | |
7 | Launch your application with: | |
8 | .TP | |
9 | \fBLD_PRELOAD=liblttng-ust-dl.so\fP appname | |
10 | .PP | |
11 | This LD_PRELOAD library causes all calls to dlopen and dlclose in the | |
6d262185 MD |
12 | application to be traced with LTTng. In addition to loading this |
13 | library, enabling this tracing requires the following two events to be | |
14 | enabled: "ust_baddr:push" and "ust_baddr:pop". | |
f6df8626 PW |
15 | |
16 | .SH "DESCRIPTION" | |
17 | The events have the following detailed definitions: | |
18 | .PP | |
19 | .IP "ust_baddr:push" | |
6d262185 MD |
20 | This event is used to trace dlopen calls. The base address (where the |
21 | dynamic linker has placed the shared object) is recorded in the "baddr" | |
22 | field. The path to the shared object gets recorded in the "sopath" field | |
23 | (as string). The file size of the loaded object (in bytes) is recorded | |
24 | to the "size" field and its time of last modification (in seconds since | |
25 | Epoch) is recorded in the "mtime" field. | |
f6df8626 PW |
26 | .IP "ust_baddr:pop" |
27 | This event is used to trace dlclose calls. The base address of the shared | |
6d262185 | 28 | object that got closed is recorded in the "baddr" field. |
f6df8626 PW |
29 | .PP |
30 | ||
31 | .SH "SEE ALSO" | |
32 | lttng-ust(3), dlopen(3), lttng(1) | |
6d262185 | 33 | |
f6df8626 PW |
34 | .SH "BUGS" |
35 | If you encounter any issues or usability problem, please report it on | |
36 | our mailing list <lttng-dev@lists.lttng.org> to help improve this | |
37 | project. | |
6d262185 | 38 | |
f6df8626 PW |
39 | .SH "CREDITS" |
40 | liblttng-ust is distributed under the GNU Lesser General Public License | |
41 | version 2.1. The headers are distributed under the MIT license. | |
42 | ||
43 | See http://lttng.org for more information on the LTTng project. | |
44 | ||
45 | Mailing list for support and development: <lttng-dev@lists.lttng.org>. | |
46 | ||
47 | You can find us on IRC server irc.oftc.net (OFTC) in #lttng. | |
6d262185 | 48 | |
f6df8626 PW |
49 | .SH "AUTHORS" |
50 | liblttng-ust was originally written by Mathieu Desnoyers, with additional | |
51 | contributions from various other people. It is currently maintained by | |
52 | Mathieu Desnoyers <mathieu.desnoyers@efficios.com>. |