lttng-track(1)
==============
-:revdate: 17 May 2021
+:revdate: 14 June 2021
NAME
events based on their attributes within:
With the option:--session='SESSION' option::
- The tracing session named 'SESSION'.
+ The recording session named 'SESSION'.
Without the option:--session option::
- The current tracing session (see man:lttng-concepts(7) to learn more
- about the current tracing session).
+ The current recording session (see man:lttng-concepts(7) to learn
+ more about the current recording session).
-See man:lttng-concepts(7) to learn more about tracing sessions and
+See man:lttng-concepts(7) to learn more about recording sessions and
recording event rules.
The `track` command adds values to _inclusion sets_ of process
-attributes. The available inclusion sets are, for a given tracing
+attributes. The available inclusion sets are, for a given recording
session:
With the option:--kernel option::
When an event{nbsp}__E__ satisfies all the other explicit and implicit
conditions of an event rule{nbsp}__ER__, __ER__ matches{nbsp}__E__ if
the attributes of the process for which LTTng creates{nbsp}__E__ are
-*all* part of the inclusion sets of the tracing session and domain
+*all* part of the inclusion sets of the recording session and domain
of{nbsp}__ER__.
-By default, on tracing session creation (see man:lttng-create(1)),
+By default, on recording session creation (see man:lttng-create(1)),
all processes are allowed to record events. In other words, all the
-inclusion sets of the tracing session contain all the possible
+inclusion sets of the recording session contain all the possible
process attribute values.
If a given inclusion set{nbsp}__IS__ contains all the possible values
$ lttng start
----
-See the <<examples,EXAMPLES>> section below for usage examples.
+See the ``<<examples,EXAMPLES>>'' section below for usage examples.
Remove values from an inclusion set with the man:lttng-untrack(1)
command.
Inclusion set example
~~~~~~~~~~~~~~~~~~~~~
This example operates on the Linux kernel process ID (PID) inclusion set
-of the current tracing session to show how an inclusion set works.
+of the current recording session to show how an inclusion set works.
Assume the maximum system PID is 7 for this example.
Recording target
~~~~~~~~~~~~~~~~
option:-s 'SESSION', option:--session='SESSION'::
- Add values to one or more inclusion sets of the tracing session
- named 'SESSION' instead of the current tracing session.
+ Add values to one or more inclusion sets of the recording session
+ named 'SESSION' instead of the current recording session.
Inclusion set selection
~~~~~~~~~~~~~~~~~~~~~~~
option:-p ['PID'[,'PID']...], option:--pid[='PID'[,'PID']...]::
For each 'PID' argument, add 'PID' to the process ID inclusion set
- of the selected tracing session and domain.
+ of the selected recording session and domain.
+
'PID' is the process ID attribute of a process as seen from the root
PID namespace (see man:pid_namespaces(7)).
option:--vpid[='VPID'[,'VPID']...]::
For each 'VPID' argument, add 'VPID' to the virtual process ID
- inclusion set of the selected tracing session and domain.
+ inclusion set of the selected recording session and domain.
+
'VPID' is the virtual process ID attribute of a process as seen from
the PID namespace of the process (see man:pid_namespaces(7)).
option:--uid[='USER'[,'USER']...]::
For each 'USER' argument, add 'USER' to the user ID inclusion set of
- the selected tracing session and domain.
+ the selected recording session and domain.
+
'USER' is either:
+
option:--vuid[='VUSER'[,'VUSER']...]::
For each 'VUSER' argument, add 'VUSER' to the virtual user ID
- inclusion set of the selected tracing session and domain.
+ inclusion set of the selected recording session and domain.
+
'VUSER' is either:
+
option:--gid[='GROUP'[,'GROUP']...]::
For each 'GROUP' argument, add 'GROUP' to the group ID
- inclusion set of the selected tracing session and domain.
+ inclusion set of the selected recording session and domain.
+
'GROUP' is either:
+
option:--vgid[='VGROUP'[,'VGROUP']...]::
For each 'VGROUP' argument, add 'VGROUP' to the virtual group ID
- inclusion set of the selected tracing session and domain.
+ inclusion set of the selected recording session and domain.
+
'VGROUP' is either:
+
[[examples]]
EXAMPLES
--------
-.Add the PIDs 1728 and 3775 to the Linux kernel process ID inclusion set of the current tracing session.
+.Add the PIDs 1728 and 3775 to the Linux kernel process ID inclusion set of the current recording session.
====
See the option:--pid option.
----
====
-.Add the ID of a specific user to the user space virtual user ID inclusion set of a specific tracing session.
+.Add the ID of a specific user to the user space virtual user ID inclusion set of a specific recording session.
====
See the option:--vuid and option:--session options.
----
====
-.Add all the possible group IDs to the Linux kernel group ID inclusion set of the current tracing session.
+.Add all the possible group IDs to the Linux kernel group ID inclusion set of the current recording session.
====
See the option:--all and option:--gid options.