X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-track.1.txt;h=739093d723aca09745fcab75ac2f5a67746241ca;hp=899a6c4eadd9b2ef0da5b242a0c32d519f7f0a7f;hb=77c44a1d884e139000a22f1b5f35243ac44017e4;hpb=65226554a1fee74f1528058539b96ed3e77e5159 diff --git a/doc/man/lttng-track.1.txt b/doc/man/lttng-track.1.txt index 899a6c4ea..739093d72 100644 --- a/doc/man/lttng-track.1.txt +++ b/doc/man/lttng-track.1.txt @@ -10,7 +10,7 @@ lttng-track - Add one or more entries to an LTTng resource tracker SYNOPSIS -------- [verse] -*lttng* ['GENERAL OPTIONS'] *track* (option:--kernel | option:--userspace) +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *track* (option:--kernel | option:--userspace) [option:--session='SESSION'] (option:--pid='PID'[,'PID']... | option:--all option:--pid) @@ -21,10 +21,10 @@ resource tracker. A resource tracker is a _whitelist_ of resources. Tracked resources are allowed to emit events, provided those events are targeted by enabled -event rules (see linklttng:lttng-enable-event(1)). +event rules (see man:lttng-enable-event(1)). Tracker entries can be removed from the whitelist with -linklttng:lttng-untrack(1). +man:lttng-untrack(1). As of this version, the only available tracker is the *PID tracker*. The process ID (PID) tracker follows one or more process IDs; only the @@ -35,6 +35,7 @@ events (equivalent of `lttng track --pid --all` for all domains). With the PID tracker, it is possible, for example, to record all system calls called by a given process: +[role="term"] ------------------------------------------- lttng enable-event --kernel --all --syscall lttng track --kernel --pid=2345 @@ -60,6 +61,7 @@ Initial whitelist: Command: +[role="term"] ----------------------------------- lttng track --userspace --pid=3,6,7 ----------------------------------- @@ -72,6 +74,7 @@ Whitelist: Command: +[role="term"] --------------------------------- lttng untrack --userspace --pid=7 --------------------------------- @@ -84,6 +87,7 @@ Whitelist: Command: +[role="term"] --------------------------------- lttng track --userspace --pid=1,5 --------------------------------- @@ -98,7 +102,7 @@ It should be noted that the PID tracker tracks the numeric process IDs. Should a process with a given ID exit and another process be given this ID, then the latter would also be allowed to emit events. -See the linklttng:lttng-untrack(1) for more details about removing +See the man:lttng-untrack(1) for more details about removing entries. @@ -144,5 +148,5 @@ include::common-cmd-footer.txt[] SEE ALSO -------- -linklttng:lttng-untrack(1), -linklttng:lttng(1) +man:lttng-untrack(1), +man:lttng(1)