doc/man: reorganize source for tables

[lttng-ust.git] / doc / man / lttng-ust-dl.3.txt

lttng-ust-dl(3)
===============
:object-type: library


NAME
----
lttng-ust-dl - Dynamic linker tracing (LTTng-UST helper)


SYNOPSIS
--------
Launch your application by preloading `liblttng-ust-dl.so`:

[role="term"]
[verse]
*LD_PRELOAD=liblttng-ust-dl.so* my-app


DESCRIPTION
-----------
When the `liblttng-ust-dl.so` library is preloaded before a given
application starts, it causes all calls to man:dlopen(3) and
man:dlclose(3) in said application to be traced with LTTng-UST (see
man:lttng-ust(3)).

See man:lttng(1) to learn more about how to control LTTng tracing
sessions.

The following LTTng-UST events are available when using this library:

`lttng_ust_dl:dlopen`::
    Emitted when man:dlopen(3) is called.
+
Fields:
+
[options="header"]
|===
|Field name |Description

|`baddr`
|Base address of loaded library

|`memsz`
|Size of loaded library in memory

|`path`
|Path to loaded library file
|===

`lttng_ust_dl:dlclose`::
    Emitted when man:dlclose(3) is called.
+
Fields:
+
[options="header"]
|===
|Field name |Description

|`baddr`
|Base address of loaded library
|===

`lttng_ust_dl:debug_link`::
    Emitted when debug link information is found when loading a library
    with man:dlopen(3). See
    https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
    for more information about debug links.
+
Fields:
+
[options="header"]
|===
|Field name |Description

|`baddr`
|Base address of loaded library

|`filename`
|Debug link file name

|`crc`
|Debug link file's CRC
|===

`lttng_ust_dl:build_id`::
    Emitted when a build ID is found when loading a library
    with man:dlopen(3). See
    https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html[Debugging Information in Separate Files]
    for more information about build IDs.
+
Fields:
+
[options="header"]
|===
|Field name |Description

|`baddr`
|Base address of loaded library

|`build_id`
|Build ID
|===


include::common-footer.txt[]

include::common-copyrights.txt[]

include::common-authors.txt[]


SEE ALSO
--------
man:lttng-ust(3),
man:dlopen(3),
man:lttng(1)