X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-start.1.txt;h=f3ee0e785053792c5e11575802b75fb626fc0e22;hb=HEAD;hp=0ee764e4078a064efbf3a49c03a06885e42554d7;hpb=da39b67ce2828bfc63a02db969048bfe1abd4ca0;p=lttng-tools.git diff --git a/doc/man/lttng-start.1.txt b/doc/man/lttng-start.1.txt index 0ee764e40..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. -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[]