8 lttng-untrack - Disallow specific processes to record LTTng events
13 Disallow specific processes to record Linux kernel events:
16 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--kernel [option:--session='SESSION']
17 (option:--pid=PID[,PID]... | option:--vpid=VPID[,VPID]... |
18 option:--uid=UID[,UID]... | option:--vuid=VUSER[,VUSER]... |
19 option:--gid=GID[,GID]... | option:--vgid=VGROUP[,VGROUP]...)...
22 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--kernel [option:--session='SESSION']
23 option:--all (option:--pid | option:--vpid | option:--uid | option:--vuid | option:--gid | option:--vgid)...
25 Disallow specific processes to record user space events:
28 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--userspace [option:--session='SESSION']
29 (option:--vpid=VPID[,VPID]... | option:--vuid=VUSER[,VUSER]... |
30 option:--vgid=VGROUP[,VGROUP]...)...
33 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--userspace [option:--session='SESSION']
34 option:--all (option:--vpid | option:--vgid | option:--vuid)...
39 The `lttng untrack` command disallows one or more processes to record
40 LTTng events based on their attributes within:
42 With the option:--session='SESSION' option::
43 The tracing session named 'SESSION'.
45 Without the option:--session option::
46 The current tracing session (see man:lttng-concepts(7) to learn more
47 about the current tracing session).
49 See man:lttng-concepts(7) to learn more about tracing sessions and
50 recording event rules.
52 The `untrack` command removes values from _inclusion sets_ of process
53 attributes. See man:lttng-track(1) to learn more about inclusion sets.
55 See the <<examples,EXAMPLES>> section below for usage examples.
60 A common operation is to create a tracing session (see
61 man:lttng-create(1)), remove all the entries from the Linux kernel
62 process ID inclusion set, start tracing, and then manually add PIDs
63 while the tracing session is active.
65 Assume the maximum system PID is 7 for this example.
74 Initial inclusion set:
76 -------------------------------
77 [0] [1] [2] [3] [4] [5] [6] [7]
78 -------------------------------
84 $ lttng untrack --kernel --all --pid
89 -------------------------------
90 [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
91 -------------------------------
97 $ lttng enable-event --kernel ...
100 $ lttng track --kernel --pid=3,5
105 -------------------------------
106 [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]
107 -------------------------------
113 $ lttng track --kernel --pid=2
118 -------------------------------
119 [ ] [ ] [2] [3] [ ] [5] [ ] [ ]
120 -------------------------------
123 include::common-lttng-cmd-options-head.txt[]
130 option:-k, option:--kernel::
131 Remove values from one or more Linux kernel inclusion sets.
133 option:-u, option:--userspace::
134 Remove values from one or more user space inclusion sets.
139 option:-s 'SESSION', option:--session='SESSION'::
140 Remove values from one or more inclusion sets of the tracing session
141 named 'SESSION' instead of the current tracing session.
144 Inclusion set selection
145 ~~~~~~~~~~~~~~~~~~~~~~~
146 option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
147 For each 'PID' argument, remove 'PID' from the process ID inclusion
148 set of the selected tracing session and domain.
150 'PID' is the process ID attribute of a process as seen from the root
151 PID namespace (see man:pid_namespaces(7)).
153 Only available with option:--kernel option.
155 option:--vpid[='VPID'[,'VPID']...]::
156 For each 'VPID' argument, remove 'VPID' from the virtual process ID
157 inclusion set of the selected tracing session and domain.
159 'VPID' is the virtual process ID attribute of a process as seen from
160 the PID namespace of the process (see man:pid_namespaces(7)).
162 option:--uid[='USER'[,'USER']...]::
163 For each 'USER' argument, remove 'USER' from the user ID inclusion
164 set of the selected tracing session and domain.
169 * The real user ID (see man:getuid(3)) of a process as seen
170 from the root user namespace (see man:user_namespaces(7)).
174 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
175 the user name resolution on removal from the user ID inclusion set.
178 Only available with option:--kernel option.
180 option:--vuid[='VUSER'[,'VUSER']...]::
181 For each 'VUSER' argument, remove 'VUSER' from the virtual user ID
182 inclusion set of the selected tracing session and domain.
187 * The real user ID (see man:getuid(3)) of a process as seen
188 from the user namespace (see man:user_namespaces(7)).
192 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
193 the user name resolution on removal from the virtual user ID inclusion
197 option:--gid[='GROUP'[,'GROUP']...]::
198 For each 'GROUP' argument, remove 'GROUP' from the group ID
199 inclusion set of the selected tracing session and domain.
204 * The real group ID (see man:getgid(3)) of a process as seen from the
205 root user namespace (see man:user_namespaces(7)).
209 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
210 the group name resolution on removal from the group ID inclusion set.
213 Only available with option:--kernel option.
215 option:--vgid[='VGROUP'[,'VGROUP']...]::
216 For each 'VGROUP' argument, remove 'VGROUP' from the virtual group
217 ID inclusion set of the selected tracing session and domain.
222 * The real group ID (see man:getgid(3)) of a process as seen
223 from the user namespace (see man:user_namespaces(7)).
227 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
228 the group name resolution on removal from the virtual group ID inclusion
233 Inclusion set operation
234 ~~~~~~~~~~~~~~~~~~~~~~~
235 option:-a, option:--all::
236 With one or more empty option:--pid, option:--vpid, option:--uid,
237 option:--vuid, option:--gid, and option:--vgid options: clear the
238 selected inclusion sets.
241 include::common-lttng-cmd-help-options.txt[]
244 include::common-lttng-cmd-after-options.txt[]
250 .Remove the PIDs 1728 and 3775 from the Linux kernel process ID inclusion set of the current tracing session.
252 See the option:--pid option.
256 $ lttng untrack --kernel --pid=1728,3775
260 .Remove the IDs of a specific groups from the user space virtual group ID inclusion set of a specific tracing session.
262 See the option:--vgid and option:--session options.
266 $ lttng untrack --userspace --session=my-session \
271 .Remove all the user IDs from the Linux kernel user ID inclusion set of the current tracing session.
273 See the option:--all and option:--uid options.
277 $ lttng untrack --kernel --all --uid
282 include::common-footer.txt[]
289 man:lttng-concepts(7)