X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-set-session.1.txt;h=2e97c055b9e46618aff9b6e524a015b767a48387;hb=484b2a0cbefcf0c7072622a5a411ea5ed849da28;hp=6e233e946e457f4f295389e7f495aed56fca935e;hpb=9d4408b888d092f9ddd128e3daeb1725abaf6726;p=lttng-tools.git diff --git a/doc/man/lttng-set-session.1.txt b/doc/man/lttng-set-session.1.txt index 6e233e946..2e97c055b 100644 --- a/doc/man/lttng-set-session.1.txt +++ b/doc/man/lttng-set-session.1.txt @@ -1,5 +1,6 @@ lttng-set-session(1) ==================== +:revdate: 21 April 2021 NAME @@ -10,19 +11,44 @@ lttng-set-session - Set the current LTTng tracing session SYNOPSIS -------- [verse] -*lttng* ['GENERAL OPTIONS'] *set-session* 'SESSION' +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *set-session* 'SESSION' DESCRIPTION ----------- -The `lttng set-session` command sets the current tracing session. - -'SESSION' is the name of an existing tracing session. `lttng list` -outputs all the existing tracing sessions (see linklttng:lttng-list(1)). - -The current tracing session is used by default when a session can be -specified in other commands. See linklttng:lttng-create(1) for more -information about the current tracing session. +The `lttng set-session` command sets the current tracing session of your +Unix user to the tracing session named 'SESSION'. + +See man:lttng-create(1) to learn more about the current tracing session. + +The following man:lttng(1) commands select the current tracing session +if you don't specify one: + +* man:lttng-add-context(1) +* man:lttng-clear(1) +* man:lttng-destroy(1) +* man:lttng-disable-channel(1) +* man:lttng-disable-event(1) +* man:lttng-disable-rotation(1) +* man:lttng-enable-channel(1) +* man:lttng-enable-event(1) +* man:lttng-enable-rotation(1) +* man:lttng-regenerate(1) +* man:lttng-rotate(1) +* man:lttng-save(1) +* man:lttng-snapshot(1) +* man:lttng-start(1) +* man:lttng-status(1) +* man:lttng-stop(1) +* man:lttng-track(1) +* man:lttng-untrack(1) +* man:lttng-view(1) + +The `set-session` command effectively updates the `$LTTNG_HOME/.lttngrc` +file. + +List the tracing sessions of your Unix user with the man:lttng-list(1) +command. include::common-cmd-options-head.txt[] @@ -36,6 +62,6 @@ include::common-cmd-footer.txt[] SEE ALSO -------- -linklttng:lttng-create(1), -linklttng:lttng-destroy(1), -linklttng:lttng(1) +man:lttng-create(1), +man:lttng-destroy(1), +man:lttng(1)