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>.

                                        December 19, 2013                         LTTNG-UST-DL(3)