8 lttng-ust-dl - Dynamic linker tracing (LTTng-UST helper)
13 Launch your application by preloading `liblttng-ust-dl.so`:
17 *LD_PRELOAD=liblttng-ust-dl.so* my-app
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
27 See man:lttng(1) to learn more about how to control LTTng tracing
30 The following LTTng-UST events are available when using this library:
32 `lttng_ust_dl:dlopen`::
33 Emitted when man:dlopen(3) is called.
38 |==============================================================
39 | Field name | Description
40 | `baddr` | Base address of loaded library
41 | `memsz` | Size of loaded library in memory
42 | `path` | Path to loaded library file
43 |==============================================================
45 `lttng_ust_dl:dlclose`::
46 Emitted when man:dlclose(3) is called.
51 |==============================================================
52 | Field name | Description
53 | `baddr` | Base address of loaded library
54 |==============================================================
56 `lttng_ust_dl:debug_link`::
57 Emitted when debug link information is found when loading a library
58 with man:dlopen(3). See
59 https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
60 for more information about debug links.
65 |==============================================================
66 | Field name | Description
67 | `baddr` | Base address of loaded library
68 | `filename` | Debug link file name
69 | `crc` | Debug link file's CRC
70 |==============================================================
72 `lttng_ust_dl:build_id`::
73 Emitted when a build ID is found when loading a library
74 with man:dlopen(3). See
75 https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
76 for more information about build IDs.
81 |==============================================================
82 | Field name | Description
83 | `baddr` | Base address of loaded library
84 | `build_id` | Build ID
85 |==============================================================
88 include::common-footer.txt[]
90 include::common-copyrights.txt[]
92 include::common-authors.txt[]