doc/man/lttng-ust-dl.3.txt

   1 lttng-ust-dl(3)
   2 ===============
   3 :object-type: library
   4
   5
   6 NAME
   7 ----
   8 lttng-ust-dl - Dynamic linker tracing (LTTng-UST helper)
   9
  10
  11 SYNOPSIS
  12 --------
  13 Launch your application by preloading `liblttng-ust-dl.so`:
  14
  15 [role="term"]
  16 [verse]
  17 *LD_PRELOAD=liblttng-ust-dl.so* my-app
  18
  19
  20 DESCRIPTION
  21 -----------
  22 When the `liblttng-ust-dl.so` library is preloaded before a given
  23 application starts, it causes all calls to man:dlopen(3) and
  24 man:dlclose(3) in said application to be traced with LTTng-UST (see
  25 man:lttng-ust(3)).
  26
  27 See man:lttng(1) to learn more about how to control LTTng tracing
  28 sessions.
  29
  30 The following LTTng-UST events are available when using this library:
  31
  32 `lttng_ust_dl:dlopen`::
  33     Emitted when man:dlopen(3) is called.
  34 +
  35 Fields:
  36 +
  37 [options="header"]
  38 |===
  39 |Field name |Description
  40
  41 |`baddr`
  42 |Base address of loaded library.
  43
  44 |`memsz`
  45 |Size of loaded library in memory.
  46
  47 |`path`
  48 |Path to loaded library file.
  49 |===
  50
  51 `lttng_ust_dl:dlclose`::
  52     Emitted when man:dlclose(3) is called.
  53 +
  54 Fields:
  55 +
  56 [options="header"]
  57 |===
  58 |Field name |Description
  59
  60 |`baddr`
  61 |Base address of loaded library.
  62 |===
  63
  64 `lttng_ust_dl:debug_link`::
  65     Emitted when debug link information is found when loading a library
  66     with man:dlopen(3). See
  67     https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
  68     for more information about debug links.
  69 +
  70 Fields:
  71 +
  72 [options="header"]
  73 |===
  74 |Field name |Description
  75
  76 |`baddr`
  77 |Base address of loaded library.
  78
  79 |`filename`
  80 |Debug link file name.
  81
  82 |`crc`
  83 |Debug link file's CRC.
  84 |===
  85
  86 `lttng_ust_dl:build_id`::
  87     Emitted when a build ID is found when loading a library
  88     with man:dlopen(3). See
  89     https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
  90     for more information about build IDs.
  91 +
  92 Fields:
  93 +
  94 [options="header"]
  95 |===
  96 |Field name |Description
  97
  98 |`baddr`
  99 |Base address of loaded library.
 100
 101 |`build_id`
 102 |Build ID.
 103 |===
 104
 105
 106 include::common-footer.txt[]
 107
 108 include::common-copyrights.txt[]
 109
 110 include::common-authors.txt[]
 111
 112
 113 SEE ALSO
 114 --------
 115 man:lttng-ust(3),
 116 man:dlopen(3),
 117 man:lttng(1)