X-Git-Url: http://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-start.1.txt;h=f3ee0e785053792c5e11575802b75fb626fc0e22;hb=eaa8ef76a52ba21e42d7d95355af72ff3a85a116;hp=d4f52cbacfbf4ffdca9f9a7af00edda78143be5b;hpb=29545453559d2de44bf3a6ea731c1cc48a6dd97f;p=lttng-tools.git diff --git a/doc/man/lttng-start.1.txt b/doc/man/lttng-start.1.txt index d4f52cbac..f3ee0e785 100644 --- a/doc/man/lttng-start.1.txt +++ b/doc/man/lttng-start.1.txt @@ -1,42 +1,42 @@ lttng-start(1) ============== -:revdate: 17 May 2021 +:revdate: 14 June 2021 NAME ---- -lttng-start - Start an LTTng tracing session +lttng-start - Start an LTTng recording session SYNOPSIS -------- [verse] -*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *start* ['SESSION'] +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *start* [option::--all | option::--glob 'SESSION' | 'SESSION' ] DESCRIPTION ----------- -The `lttng start` command starts a tracing session, that is, it +The `lttng start` command starts a recording session, that is, it activates the LTTng tracers for: With the 'SESSION' argument:: - The tracing session named 'SESSION'. + The recording session named 'SESSION'. Without the 'SESSION' argument:: - 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. +See man:lttng-concepts(7) to learn more about recording sessions. -The selected tracing session must be inactive (stopped). A tracing +The selected recording session must be inactive (stopped). A recording session is inactive on creation (see man:lttng-create(1)). -A `start-session` trigger action can also start a tracing session +A `start-session` trigger action can also start a recording session (see man:lttng-add-trigger(1)). -See the <> section below for usage examples. +See the ``<>'' section below for usage examples. -Stop an active tracing session with the man:lttng-stop(1) command. +Stop an active recording session with the man:lttng-stop(1) command. include::common-lttng-cmd-options-head.txt[] @@ -44,6 +44,11 @@ include::common-lttng-cmd-options-head.txt[] include::common-lttng-cmd-help-options.txt[] +option:-a, option:--all:: + Start all sessions. + +option:-g, option:--glob:: + Interpret SESSION as a globbing pattern. include::common-lttng-cmd-after-options.txt[] @@ -51,7 +56,7 @@ include::common-lttng-cmd-after-options.txt[] [[examples]] EXAMPLES -------- -.Start the current tracing session. +.Start the current recording session. ==== [role="term"] ---- @@ -59,7 +64,7 @@ $ lttng start ---- ==== -.Start a specific tracing session. +.Start a specific recording session. ==== [role="term"] ---- @@ -67,6 +72,26 @@ $ lttng start my-session ---- ==== +.Start all sessions. +==== +See the option::--all option. + +[role="term"] +---- +$ lttng start --all +---- +==== + +.Start all sessions with the suffix foo. +==== +See the option::--glob option. + +[role="term"] +---- +$ lttng start --glob '*foo' +---- +==== + include::common-footer.txt[]