From ec86f8766398cf6c78096bcc5c96c6e7df61701a Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Mon, 17 May 2021 16:20:08 -0400 Subject: [PATCH] lttng-untrack(1): add usage examples MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau Change-Id: Ibafe1662e37110962ae3c7fdef9d450b75f2c0a5 --- doc/man/lttng-untrack.1.txt | 38 ++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) 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[] -- 2.34.1