lttng-set-session(1)

1LTTNG-SET-SESSION(1)             LTTng Manual             LTTNG-SET-SESSION(1)
2
3
4

NAME

6       lttng-set-session - Set the current LTTng tracing session
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] set-session SESSION
10

DESCRIPTION

12       The lttng set-session command sets the current tracing session.
13
14       SESSION is the name of an existing tracing session. lttng list outputs
15       all the existing tracing sessions (see lttng-list(1)).
16
17       The current tracing session is used by default when a session can be
18       specified in other commands. See lttng-create(1) for more information
19       about the current tracing session.
20

OPTIONS

22       General options are described in lttng(1).
23
24   Program information
25       -h, --help
26           Show command help.
27
28           This option, like lttng-help(1), attempts to launch /usr/bin/man to
29           view the command’s man page. The path to the man pager can be
30           overridden by the LTTNG_MAN_BIN_PATH environment variable.
31
32       --list-options
33           List available command options.
34

ENVIRONMENT VARIABLES

36       LTTNG_ABORT_ON_ERROR
37           Set to 1 to abort the process after the first error is encountered.
38
39       LTTNG_HOME
40           Overrides the $HOME environment variable. Useful when the user
41           running the commands has a non-writable home directory.
42
43       LTTNG_MAN_BIN_PATH
44           Absolute path to the man pager to use for viewing help information
45           about LTTng commands (using lttng-help(1) or lttng COMMAND --help).
46
47       LTTNG_SESSION_CONFIG_XSD_PATH
48           Path in which the session.xsd session configuration XML schema may
49           be found.
50
51       LTTNG_SESSIOND_PATH
52           Full session daemon binary path.
53
54           The --sessiond-path option has precedence over this environment
55           variable.
56
57       Note that the lttng-create(1) command can spawn an LTTng session daemon
58       automatically if none is running. See lttng-sessiond(8) for the
59       environment variables influencing the execution of the session daemon.
60

FILES

62       $LTTNG_HOME/.lttngrc
63           User LTTng runtime configuration.
64
65           This is where the per-user current tracing session is stored
66           between executions of lttng(1). The current tracing session can be
67           set with lttng-set-session(1). See lttng-create(1) for more
68           information about tracing sessions.
69
70       $LTTNG_HOME/lttng-traces
71           Default output directory of LTTng traces. This can be overridden
72           with the --output option of the lttng-create(1) command.
73
74       $LTTNG_HOME/.lttng
75           User LTTng runtime and configuration directory.
76
77       $LTTNG_HOME/.lttng/sessions
78           Default location of saved user tracing sessions (see lttng-save(1)
79           and lttng-load(1)).
80
81       /usr/local/etc/lttng/sessions
82           System-wide location of saved tracing sessions (see lttng-save(1)
83           and lttng-load(1)).
84
85           Note
86           $LTTNG_HOME defaults to $HOME when not explicitly set.
87

EXIT STATUS

89       0
90           Success
91
92       1
93           Command error
94
95       2
96           Undefined command
97
98       3
99           Fatal error
100
101       4
102           Command warning (something went wrong during the command)
103

BUGS

105       If you encounter any issue or usability problem, please report it on
106       the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-tools>.
107

RESOURCES

109       •   LTTng project website <https://lttng.org>
110
111       •   LTTng documentation <https://lttng.org/docs>
112
113       •   Git repositories <http://git.lttng.org>
114
115       •   GitHub organization <http://github.com/lttng>
116
117       •   Continuous integration <http://ci.lttng.org/>
118
119       •   Mailing list <http://lists.lttng.org> for support and development:
120           lttng-dev@lists.lttng.org
121
122       •   IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
123

COPYRIGHTS

125       This program is part of the LTTng-tools project.
126
127       LTTng-tools is distributed under the GNU General Public License version
128       2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. See the
129       LICENSE <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file
130       for details.
131

THANKS

133       Special thanks to Michel Dagenais and the DORSAL laboratory
134       <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
135       the LTTng journey.
136
137       Also thanks to the Ericsson teams working on tracing which helped us
138       greatly with detailed bug reports and unusual test cases.
139