lttng-untrack(1)
================
+:revdate: 14 March 2017
NAME
The `lttng untrack` commands removes one or more entries from a
resource tracker.
-See linklttng:lttng-track(1) to learn more about LTTng trackers.
+See man:lttng-track(1) to learn more about LTTng trackers.
The untrack command removes specific resources from a tracker. The
resources to remove must have been precedently added by
-linklttng:lttng-track(1). It is also possible to remove all the
+man:lttng-track(1). It is also possible to remove all the
resources from the whitelist using the option:--all option.
As of this version, the only available tracker is the PID tracker.
Example
~~~~~~~
One common operation is to create a tracing session
-(see linklttng:lttng-create(1)), remove all the entries from the PID
+(see man:lttng-create(1)), remove all the entries from the PID
tracker whitelist, start tracing, and then manually track PIDs
while tracing is active.
Command:
[role="term"]
-------------
-lttng create
-------------
+----
+$ lttng create
+----
Initial whitelist:
Command:
[role="term"]
--------------------------------------
-lttng untrack --userspace --pid --all
--------------------------------------
+----
+$ lttng untrack --userspace --pid --all
+----
Whitelist:
Commands:
[role="term"]
-----------------------------------
-lttng enable-event --userspace ...
-lttng start
-# ...
-lttng track --userspace --pid=3,5
-----------------------------------
+----
+$ lttng enable-event --userspace ...
+$ lttng start
+$ # ...
+$ lttng track --userspace --pid=3,5
+----
Whitelist:
Command:
[role="term"]
--------------------------------
-lttng track --userspace --pid=2
--------------------------------
+----
+$ lttng track --userspace --pid=2
+----
Whitelist:
Used in conjunction with an empty option:--pid option: untrack _all_
process IDs (clear the whitelist).
-option:-p, option:--pid[='PID'[,'PID']...]::
+option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
Untrack process IDs 'PID' (remove them from the current whitelist).
+
The 'PID' argument must be omitted when also using the option:--all
SEE ALSO
--------
-linklttng:lttng-track(1),
-linklttng:lttng(1)
+man:lttng-track(1),
+man:lttng(1)