X-Git-Url: http://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Ftracelog.3.txt;h=1281ce7c8d940d5ec35d26055e3ed13d8c2fc3af;hb=636cf2a01500b8bef5a5959b4f1d3a9a7222b39a;hp=e90e91895b7614d95b5f4f93630384d470ca79a1;hpb=8902dadc26f8ed82bb77fc1c7fc4180631a92339;p=lttng-ust.git diff --git a/doc/man/tracelog.3.txt b/doc/man/tracelog.3.txt index e90e9189..1281ce7c 100644 --- a/doc/man/tracelog.3.txt +++ b/doc/man/tracelog.3.txt @@ -51,16 +51,16 @@ The `tracelog()` events contain the following fields: |Field name |Description |`line` -|Line in source file where `tracelog()` was called +|Line in source file where `tracelog()` was called. |`file` -|Source file from which `tracelog()` was called +|Source file from which `tracelog()` was called. |`func` -|Function name from which `tracelog()` was called +|Function name from which `tracelog()` was called. |`msg` -|Formatted string output +|Formatted string output. |=== If you do not need to attach a specific log level to a `tracelog()` @@ -104,43 +104,43 @@ This C source file, saved as `app.c`, can be compiled into a program like this: [role="term"] ---------------------------- -cc -o app app.c -llttng-ust ---------------------------- +---- +$ cc -o app app.c -llttng-ust +---- You can create an LTTng tracing session, enable all the `tracelog()` events, and start the created tracing session like this: [role="term"] ---------------------------------------------------- -lttng create my-session -lttng enable-event --userspace 'lttng_ust_tracelog:*' -lttng start ---------------------------------------------------- +---- +$ lttng create my-session +$ lttng enable-event --userspace 'lttng_ust_tracelog:*' +$ lttng start +---- Or you can enable `tracelog()` events matching a log level at least as severe as a given log level: [role="term"] -------------------------------------------------------- -lttng enable-event --userspace 'lttng_ust_tracelog:*' \ +---- +$ lttng enable-event --userspace 'lttng_ust_tracelog:*' \ --loglevel=TRACE_INFO -------------------------------------------------------- +---- Next, start the program to be traced: [role="term"] ------------------------------------------------- -./app a few arguments passed to this application ------------------------------------------------- +---- +$ ./app a few arguments passed to this application +---- Finally, stop the tracing session, and inspect the recorded events: [role="term"] ----------- -lttng stop -lttng view ----------- +---- +$ lttng stop +$ lttng view +---- [[limitations]]