doc/man/lttng-ust-dl.3

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