| 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 |
| 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". |
| 15 | |
| 16 | .SH "DESCRIPTION" |
| 17 | The events have the following detailed definitions: |
| 18 | .PP |
| 19 | .IP "ust_baddr:push" |
| 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. |
| 26 | .IP "ust_baddr:pop" |
| 27 | This event is used to trace dlclose calls. The base address of the shared |
| 28 | object that got closed is recorded in the "baddr" field. |
| 29 | .PP |
| 30 | |
| 31 | .SH "SEE ALSO" |
| 32 | lttng-ust(3), dlopen(3), lttng(1) |
| 33 | |
| 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. |
| 38 | |
| 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. |
| 48 | |
| 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>. |