3 :revdate: 14 March 2017
8 lttng-untrack - Remove one or more entries from an LTTng resource tracker
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* (option:--kernel | option:--userspace)
15 [option:--session='SESSION'] (option:--pid='PID'[,'PID']... | option:--all option:--pid)
20 The `lttng untrack` commands removes one or more entries from a
23 See man:lttng-track(1) to learn more about LTTng trackers.
25 The untrack command removes specific resources from a tracker. The
26 resources to remove must have been precedently added by
27 man:lttng-track(1). It is also possible to remove all the
28 resources from the whitelist using the option:--all option.
30 As of this version, the only available tracker is the PID tracker.
35 One common operation is to create a tracing session
36 (see man:lttng-create(1)), remove all the entries from the PID
37 tracker whitelist, start tracing, and then manually track PIDs
38 while tracing is active.
40 Assume the maximum system PID is 7 for this example.
51 -------------------------------
52 [0] [1] [2] [3] [4] [5] [6] [7]
53 -------------------------------
59 $ lttng untrack --userspace --pid --all
64 -------------------------------
65 [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
66 -------------------------------
72 $ lttng enable-event --userspace ...
75 $ lttng track --userspace --pid=3,5
80 -------------------------------
81 [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]
82 -------------------------------
88 $ lttng track --userspace --pid=2
93 -------------------------------
94 [ ] [ ] [2] [3] [ ] [5] [ ] [ ]
95 -------------------------------
98 include::common-cmd-options-head.txt[]
105 option:-k, option:--kernel::
106 Untrack resources tracked in the Linux kernel domain.
108 option:-u, option:--userspace::
109 Untrack resources tracked in the user space domain.
114 option:-s, option:--session='SESSION'::
115 Untrack resources in the tracing session named 'SESSION' instead of
116 the current tracing session.
121 option:-a, option:--all::
122 Used in conjunction with an empty option:--pid option: untrack _all_
123 process IDs (clear the whitelist).
125 option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
126 Untrack process IDs 'PID' (remove them from the current whitelist).
128 The 'PID' argument must be omitted when also using the option:--all
132 include::common-cmd-help-options.txt[]
135 include::common-cmd-footer.txt[]