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:
--------------------------------------------
-lttng enable-event --kernel --all --syscall
-lttng track --kernel --pid=2345
-lttng start
--------------------------------------------
+[role="term"]
+----
+# lttng enable-event --kernel --all --syscall
+# lttng track --kernel --pid=2345
+# lttng start
+----
If all the PIDs are tracked (i.e. `lttng track --pid --all`, which is
the default state of all domains when creating a tracing session), then
Command:
------------------------------------
-lttng track --userspace --pid=3,6,7
------------------------------------
+[role="term"]
+----
+$ lttng track --userspace --pid=3,6,7
+----
Whitelist:
Command:
----------------------------------
-lttng untrack --userspace --pid=7
----------------------------------
+[role="term"]
+----
+$ lttng untrack --userspace --pid=7
+----
Whitelist:
Command:
----------------------------------
-lttng track --userspace --pid=1,5
----------------------------------
+[role="term"]
+----
+$ lttng track --userspace --pid=1,5
+----
Whitelist:
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.
Target
~~~~~~
-option:-s, option:--session='SESSION'::
+option:-s 'SESSION', option:--session='SESSION'::
Track resources in the tracing session named 'SESSION' instead of
the current tracing session.
Used in conjunction with an empty option:--pid option: track _all_
process IDs (add all entries to the whitelist).
-option:-p, option:--pid[='PID'[,'PID']...]::
+option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
Track process IDs 'PID' (add them to the current whitelist).
+
The 'PID' argument must be omitted when also using the option:--all
SEE ALSO
--------
-linklttng:lttng-untrack(1),
-linklttng:lttng(1)
+man:lttng-untrack(1),
+man:lttng(1)