From 4781283ce229c47e1831685b30851a7c3ae6cb9e Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Mon, 17 May 2021 16:19:09 -0400 Subject: [PATCH] lttng-track(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: I21a7906626a09b9964fc51dd083f1c2ea5b855c3 --- doc/man/lttng-track.1.txt | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/doc/man/lttng-track.1.txt b/doc/man/lttng-track.1.txt index 195e07973..2a04eeedc 100644 --- a/doc/man/lttng-track.1.txt +++ b/doc/man/lttng-track.1.txt @@ -1,6 +1,6 @@ lttng-track(1) ============== -:revdate: 1 May 2021 +:revdate: 17 May 2021 NAME @@ -111,6 +111,8 @@ $ lttng track --kernel --pid=2345 $ lttng start ---- +See the <> section below for usage examples. + Remove values from an inclusion set with the man:lttng-untrack(1) command. @@ -294,6 +296,40 @@ include::common-lttng-cmd-help-options.txt[] include::common-lttng-cmd-after-options.txt[] +[[examples]] +EXAMPLES +-------- +.Add the PIDs 1728 and 3775 to the Linux kernel process ID inclusion set of the current tracing session. +==== +See the option:--pid option. + +[role="term"] +---- +$ lttng track --kernel --pid=1728,3775 +---- +==== + +.Add the ID of a specific user to the user space virtual user ID inclusion set of a specific tracing session. +==== +See the option:--vuid and option:--session options. + +[role="term"] +---- +$ lttng track --userspace --session=my-session --vuid=http +---- +==== + +.Add all the possible group IDs to the Linux kernel group ID inclusion set of the current tracing session. +==== +See the option:--all and option:--gid options. + +[role="term"] +---- +$ lttng track --kernel --all --gid +---- +==== + + include::common-footer.txt[] -- 2.34.1