X-Git-Url: http://git.efficios.com/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-untrack.1.txt;fp=doc%2Fman%2Flttng-untrack.1.txt;h=771c5e69cb49fe6c36481f83caeb1cb22274cc9c;hp=28cb1bfcfe0429e9a997b85f285c416544c9d2a5;hb=ec86f8766398cf6c78096bcc5c96c6e7df61701a;hpb=0e9929b4073b888da93ea3f1af2bb323b5d8fb8f diff --git a/doc/man/lttng-untrack.1.txt b/doc/man/lttng-untrack.1.txt index 28cb1bfcf..771c5e69c 100644 --- a/doc/man/lttng-untrack.1.txt +++ b/doc/man/lttng-untrack.1.txt @@ -1,6 +1,6 @@ lttng-untrack(1) ================ -:revdate: 1 May 2021 +:revdate: 17 May 2021 NAME @@ -52,6 +52,7 @@ recording event rules. The `untrack` command removes values from _inclusion sets_ of process attributes. See man:lttng-track(1) to learn more about inclusion sets. +See the <> section below for usage examples. Inclusion set example @@ -243,6 +244,41 @@ include::common-lttng-cmd-help-options.txt[] include::common-lttng-cmd-after-options.txt[] +[[examples]] +EXAMPLES +-------- +.Remove the PIDs 1728 and 3775 from the Linux kernel process ID inclusion set of the current tracing session. +==== +See the option:--pid option. + +[role="term"] +---- +$ lttng untrack --kernel --pid=1728,3775 +---- +==== + +.Remove the IDs of a specific groups from the user space virtual group ID inclusion set of a specific tracing session. +==== +See the option:--vgid and option:--session options. + +[role="term"] +---- +$ lttng untrack --userspace --session=my-session \ + --vgid=docker,mysql +---- +==== + +.Remove all the user IDs from the Linux kernel user ID inclusion set of the current tracing session. +==== +See the option:--all and option:--uid options. + +[role="term"] +---- +$ lttng untrack --kernel --all --uid +---- +==== + + include::common-footer.txt[]