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)
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
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
Command:
+[role="term"]
-----------------------------------
lttng track --userspace --pid=3,6,7
-----------------------------------
Command:
+[role="term"]
---------------------------------
lttng untrack --userspace --pid=7
---------------------------------
Command:
+[role="term"]
---------------------------------
lttng track --userspace --pid=1,5
---------------------------------
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.
SEE ALSO
--------
-linklttng:lttng-untrack(1),
-linklttng:lttng(1)
+man:lttng-untrack(1),
+man:lttng(1)