8 lttng-untrack - Remove one or more values from an LTTng process attribute tracker
13 Remove specific process attribute values from a Linux kernel domain tracker:
16 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--kernel
17 (option:--pid=PID[,PID]... | option:--vpid=VPID[,VPID]... |
18 option:--uid=UID[,UID]... | option:--vuid=VUID[,VUID]... |
19 option:--gid=GID[,GID]... | option:--vgid=VGID[,VGID]... )...
21 Remove all possible process attribute values from a Linux kernel domain tracker:
24 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--kernel
25 option:--all (option:--pid | option:--vpid | option:--uid |
26 option:--vuid | option:--gid | option:--vgid )...
28 Remove specific process attribute values from a user space domain tracker:
31 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--userspace
32 (option:--vpid=VPID[,VPID]... | option:--vuid=VUID[,VUID]... | option:--vgid=VGID[,VGID]...)...
34 Remove all possible process attribute values from a user space domain tracker:
37 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* option:--userspace
38 option:--all (option:--vpid | option:--vgid | option:--vuid)...
43 The `lttng untrack` commands removes one or more values from a
44 process attribute tracker.
46 See man:lttng-track(1) to learn more about LTTng trackers.
48 The untrack command removes specific process attribute values from a
49 tracker's inclusion set. The attributes to remove must have been
50 precedently added by man:lttng-track(1). It is also possible to remove
51 all the possible values of a process attribute from the inclusion set
52 using the option:--all option.
57 One common operation is to create a tracing session
58 (see man:lttng-create(1)), remove all the entries from the PID
59 tracker inclusion set, start tracing, and then manually track PIDs
60 while tracing is active.
62 Assume the maximum system PID is 7 for this example.
71 Initial inclusion set:
73 -------------------------------
74 [0] [1] [2] [3] [4] [5] [6] [7]
75 -------------------------------
81 $ lttng untrack --kernel --pid --all
86 -------------------------------
87 [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
88 -------------------------------
94 $ lttng enable-event --kernel ...
97 $ lttng track --kernel --pid=3,5
102 -------------------------------
103 [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]
104 -------------------------------
110 $ lttng track --kernel --pid=2
115 -------------------------------
116 [ ] [ ] [2] [3] [ ] [5] [ ] [ ]
117 -------------------------------
120 include::common-cmd-options-head.txt[]
127 option:-k, option:--kernel::
128 Track process attributes in the Linux kernel domain.
130 option:-u, option:--userspace::
131 Track process attributes in the user space domain.
136 option:-s 'SESSION', option:--session='SESSION'::
137 Untrack process attributes in the tracing session named 'SESSION'
138 instead of the current tracing session.
143 option:-a, option:--all::
144 Used in conjunction with a single, empty option:--pid,
145 option:--vpid, option:--uid, option:--vuid, option:--gid,
146 or option:--vgid option: untrack _all_ possible process attribute
147 values (remove all values from the inclusion set).
149 option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
150 Untrack process ID values 'PID' (remove them from the process ID
153 'PID' is the process ID attribute of a process as seen from the _root
154 PID namespace_ (see man:pid_namespaces(7)). It can only be used with
155 the option:--kernel domain option.
157 The 'PID' argument must be omitted when also using the option:--all
160 option:--vpid[='VPID'[,'VPID']...]::
161 Untrack virtual process ID values 'VPID' (remove them from the
162 virtual process ID inclusion set).
164 'VPID' is the virtual process ID attribute of a process as seen from
165 the _PID namespace_ of the process (see man:pid_namespaces(7)).
167 The 'VPID' argument must be omitted when also using the option:--all
170 option:--uid[='USER'[,'USER']...]::
171 Untrack user ID process attribute values 'USER' (remove them from
172 the user ID inclusion set).
174 'USER' is the real user ID (see man:getuid(3)) of a process as seen
175 from the _root user namespace_ (see man:user_namespaces(7)). It can
176 only be used with the option:--kernel domain option.
178 'USER' can also be a user name. No name resolution is performed;
179 'USER' will be matched against the names in the inclusion set.
181 The 'USER' argument must be omitted when also using the option:--all
184 option:--vuid[='USER'[,'USER']...]::
185 Untrack virtual user ID process attribute values 'USER' (remove
186 them from the virtual user ID inclusion set).
188 'USER' is the real user ID (see man:getuid(3)) of a process as seen
189 from the _user namespace_ of the process (see man:user_namespaces(7)).
191 'USER' can also be a user name. No name resolution is performed;
192 'USER' will be matched against the names in the inclusion set.
194 The 'USER' argument must be omitted when also using the option:--all
197 option:--gid[='GROUP'[,'GROUP']...]::
198 Untrack group ID process attribute values 'GROUP' (remove them
199 from the group ID inclusion set).
201 'GROUP' is the real group ID (see man:getgid(3)) of a process as seen
202 from the _root user namespace_ (see man:user_namespaces(7)). It can
203 only be used with the option:--kernel domain option.
205 'GROUP' can also be a group name. No name resolution is performed;
206 'GROUP' will be matched against the names in the inclusion set.
208 The 'GROUP' argument must be omitted when also using the option:--all
211 option:--vgid[='GROUP'[,'GROUP']...]::
212 Untrack virtual group ID process attribute values 'GROUP'(remove
213 them from the virtual group ID inclusion set).
215 'GROUP' is the real group ID (see man:getgid(3)) of a process as seen
216 from the _user namespace_ of the process (see man:user_namespaces(7)).
218 'GROUP' can also be a group name. No name resolution is performed;
219 'GROUP' will be matched against the names in the inclusion set.
221 The 'GROUP' argument must be omitted when also using the option:--all
225 include::common-cmd-help-options.txt[]
228 include::common-cmd-footer.txt[]