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.
58 A common operation is to create a tracing session (see
59 man:lttng-create(1)), remove all the entries from the PID tracker
60 inclusion set, start tracing, and then manually track PIDs while the
61 tracing session is active.
63 Assume the maximum system PID is 7 for this example.
72 Initial inclusion set:
74 -------------------------------
75 [0] [1] [2] [3] [4] [5] [6] [7]
76 -------------------------------
82 $ lttng untrack --kernel --pid --all
87 -------------------------------
88 [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
89 -------------------------------
95 $ lttng enable-event --kernel ...
98 $ lttng track --kernel --pid=3,5
103 -------------------------------
104 [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]
105 -------------------------------
111 $ lttng track --kernel --pid=2
116 -------------------------------
117 [ ] [ ] [2] [3] [ ] [5] [ ] [ ]
118 -------------------------------
121 include::common-cmd-options-head.txt[]
128 option:-k, option:--kernel::
129 Remove values from one or more Linux kernel inclusion sets.
131 option:-u, option:--userspace::
132 Remove values from one or more user space inclusion sets.
137 option:-s 'SESSION', option:--session='SESSION'::
138 Remove values from one or more inclusion sets of the tracing session
139 named 'SESSION' instead of the current tracing session.
142 Inclusion set selection
143 ~~~~~~~~~~~~~~~~~~~~~~~
144 option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
145 For each 'PID' argument, remove 'PID' from the process ID inclusion
146 set of the selected tracing session and domain.
148 'PID' is the process ID attribute of a process as seen from the root
149 PID namespace (see man:pid_namespaces(7)).
151 Only available with option:--kernel option.
153 option:--vpid[='VPID'[,'VPID']...]::
154 For each 'VPID' argument, remove 'VPID' from the virtual process ID
155 inclusion set of the selected tracing session and domain.
157 'VPID' is the virtual process ID attribute of a process as seen from
158 the PID namespace of the process (see man:pid_namespaces(7)).
160 option:--uid[='USER'[,'USER']...]::
161 For each 'USER' argument, remove 'USER' from the user ID inclusion
162 set of the selected tracing session and domain.
167 * The real user ID (see man:getuid(3)) of a process as seen
168 from the root user namespace (see man:user_namespaces(7)).
172 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
173 the user name resolution on removal from the user ID inclusion set.
176 Only available with option:--kernel option.
178 option:--vuid[='VUSER'[,'VUSER']...]::
179 For each 'VUSER' argument, remove 'VUSER' from the virtual user ID
180 inclusion set of the selected tracing session and domain.
185 * The real user ID (see man:getuid(3)) of a process as seen
186 from the user namespace (see man:user_namespaces(7)).
190 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
191 the user name resolution on removal from the virtual user ID inclusion
195 option:--gid[='GROUP'[,'GROUP']...]::
196 For each 'GROUP' argument, remove 'GROUP' from the group ID
197 inclusion set of the selected tracing session and domain.
202 * The real group ID (see man:getgid(3)) of a process as seen from the
203 root user namespace (see man:user_namespaces(7)).
207 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
208 the group name resolution on removal from the group ID inclusion set.
211 Only available with option:--kernel option.
213 option:--vgid[='VGROUP'[,'VGROUP']...]::
214 For each 'VGROUP' argument, remove 'VGROUP' from the virtual group
215 ID inclusion set of the selected tracing session and domain.
220 * The real group ID (see man:getgid(3)) of a process as seen
221 from the user namespace (see man:user_namespaces(7)).
225 The connected LTTng session daemon (see man:lttng-sessiond(8)) performs
226 the group name resolution on removal from the virtual group ID inclusion
231 Inclusion set operation
232 ~~~~~~~~~~~~~~~~~~~~~~~
233 option:-a, option:--all::
234 With one or more empty option:--pid, option:--vpid, option:--uid,
235 option:--vuid, option:--gid, and option:--vgid options: clear the
236 selected inclusion sets.
239 include::common-cmd-help-options.txt[]
242 include::common-cmd-footer.txt[]
248 man:lttng-concepts(7),