lttng-status(1)

1LTTNG-STATUS(1)                  LTTng Manual                  LTTNG-STATUS(1)
2
3
4

NAME

6       lttng-status - Get the current LTTng tracing session's status
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] status
10

DESCRIPTION

12       The lttng status command shows the status of the current tracing
13       session.
14
15       This command is the exact equivalent of:
16
17           $ lttng list CURSESSION
18
19       where CURSESSION is the name of the current tracing session. Use lttng-
20       set-session(1) to set the current tracing session.
21

OPTIONS

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

ENVIRONMENT VARIABLES

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

FILES

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

EXIT STATUS

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

BUGS

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

RESOURCES

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

COPYRIGHTS

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

THANKS

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