X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-set-session.1.txt;h=2e97c055b9e46618aff9b6e524a015b767a48387;hb=65750bcdda3dd71b72683573d35a662c0b467a8f;hp=998266affb5b1a243197988b5e0894a54c5af019;hpb=ce19b9ed9bd9591bd0c4d1998780082a490991fd;p=lttng-tools.git diff --git a/doc/man/lttng-set-session.1.txt b/doc/man/lttng-set-session.1.txt index 998266aff..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 @@ -15,14 +16,39 @@ SYNOPSIS 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)