NAME¶
lttng-ust-dl — LTTng UST 2.x Dynamic Linker Tracing
SYNOPSIS¶
Launch your application with:
- LD_PRELOAD=liblttng-ust-dl.so appname
This LD_PRELOAD library causes all calls to dlopen and dlclose in the
application to be traced with LTTng. In addition to loading this library,
enabling this tracing requires the following two events to be enabled:
"ust_baddr:push" and "ust_baddr:pop".
DESCRIPTION¶
The events have the following detailed definitions:
- ust_baddr:push
- This event is used to trace dlopen calls. The base address (where the
dynamic linker has placed the shared object) is recorded in the
"baddr" field. The path to the shared object gets recorded in
the "sopath" field (as string). The file size of the loaded
object (in bytes) is recorded to the "size" field and its time
of last modification (in seconds since Epoch) is recorded in the
"mtime" field.
- ust_baddr:pop
- This event is used to trace dlclose calls. The base address of the shared
object that got closed is recorded in the "baddr" field.
SEE ALSO¶
lttng-ust(3),
dlopen(3),
lttng(1)
BUGS¶
If you encounter any issues or usability problem, please report it on our
mailing list <lttng-dev@lists.lttng.org> to help improve this project.
CREDITS¶
liblttng-ust is distributed under the GNU Lesser General Public License version
2.1. The headers are distributed under the MIT license.
See
http://lttng.org for more information on the LTTng project.
Mailing list for support and development: <lttng-dev@lists.lttng.org>.
You can find us on IRC server irc.oftc.net (OFTC) in #lttng.
AUTHORS¶
liblttng-ust was originally written by Mathieu Desnoyers, with additional
contributions from various other people. It is currently maintained by Mathieu
Desnoyers <mathieu.desnoyers@efficios.com>.