7 lttng-untrack - Remove one or more entries from an LTTng resource tracker
13 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* (option:--kernel | option:--userspace)
14 [option:--session='SESSION'] (option:--pid='PID'[,'PID']... | option:--all option:--pid)
19 The `lttng untrack` commands removes one or more entries from a
22 See man:lttng-track(1) to learn more about LTTng trackers.
24 The untrack command removes specific resources from a tracker. The
25 resources to remove must have been precedently added by
26 man:lttng-track(1). It is also possible to remove all the
27 resources from the whitelist using the option:--all option.
29 As of this version, the only available tracker is the PID tracker.
34 One common operation is to create a tracing session
35 (see man:lttng-create(1)), remove all the entries from the PID
36 tracker whitelist, start tracing, and then manually track PIDs
37 while tracing is active.
39 Assume the maximum system PID is 7 for this example.
50 -------------------------------
51 [0] [1] [2] [3] [4] [5] [6] [7]
52 -------------------------------
58 $ lttng untrack --userspace --pid --all
63 -------------------------------
64 [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
65 -------------------------------
71 $ lttng enable-event --userspace ...
74 $ lttng track --userspace --pid=3,5
79 -------------------------------
80 [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]
81 -------------------------------
87 $ lttng track --userspace --pid=2
92 -------------------------------
93 [ ] [ ] [2] [3] [ ] [5] [ ] [ ]
94 -------------------------------
97 include::common-cmd-options-head.txt[]
104 option:-k, option:--kernel::
105 Untrack resources tracked in the Linux kernel domain.
107 option:-u, option:--userspace::
108 Untrack resources tracked in the user space domain.
113 option:-s, option:--session='SESSION'::
114 Untrack resources in the tracing session named 'SESSION' instead of
115 the current tracing session.
120 option:-a, option:--all::
121 Used in conjunction with an empty option:--pid option: untrack _all_
122 process IDs (clear the whitelist).
124 option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
125 Untrack process IDs 'PID' (remove them from the current whitelist).
127 The 'PID' argument must be omitted when also using the option:--all
131 include::common-cmd-help-options.txt[]
134 include::common-cmd-footer.txt[]