lttng-status(1)

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

NAME

6       lttng-status - Show the status of the current LTTng recording session
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] status
10

DESCRIPTION

12       The lttng status command shows the status of the current recording
13       session (see lttng-concepts(7) to learn more about the current
14       recording session).
15
16       This command is equivalent to:
17
18           lttng [GENERAL OPTIONS] list CURSESSION
19
20       where CURSESSION is the name of the current recording session.
21

OPTIONS

23       See lttng(1) for GENERAL OPTIONS.
24
25   Program information
26       -h, --help
27           Show help.
28
29           This option attempts to launch /usr/bin/man to view this manual
30           page. Override the manual pager path with the LTTNG_MAN_BIN_PATH
31           environment variable.
32
33       --list-options
34           List available command options and quit.
35

EXIT STATUS

37       0
38           Success
39
40       1
41           Command error
42
43       2
44           Undefined command
45
46       3
47           Fatal error
48
49       4
50           Command warning (something went wrong during the command)
51

ENVIRONMENT

53       LTTNG_ABORT_ON_ERROR
54           Set to 1 to abort the process after the first error is encountered.
55
56       LTTNG_HOME
57           Path to the LTTng home directory.
58
59           Defaults to $HOME.
60
61           Useful when the Unix user running the commands has a non-writable
62           home directory.
63
64       LTTNG_MAN_BIN_PATH
65           Absolute path to the manual pager to use to read the LTTng
66           command-line help (with lttng-help(1) or with the --help option)
67           instead of /usr/bin/man.
68
69       LTTNG_SESSION_CONFIG_XSD_PATH
70           Path to the directory containing the session.xsd recording session
71           configuration XML schema.
72
73       LTTNG_SESSIOND_PATH
74           Absolute path to the LTTng session daemon binary (see lttng-
75           sessiond(8)) to spawn from the lttng-create(1) command.
76
77           The --sessiond-path general option overrides this environment
78           variable.
79

FILES

81       $LTTNG_HOME/.lttngrc
82           Unix user’s LTTng runtime configuration.
83
84           This is where LTTng stores the name of the Unix user’s current
85           recording session between executions of lttng(1).  lttng-create(1)
86           and lttng-set-session(1) set the current recording session.
87
88       $LTTNG_HOME/lttng-traces
89           Default output directory of LTTng traces in local and snapshot
90           modes.
91
92           Override this path with the --output option of the lttng-create(1)
93           command.
94
95       $LTTNG_HOME/.lttng
96           Unix user’s LTTng runtime and configuration directory.
97
98       $LTTNG_HOME/.lttng/sessions
99           Default directory containing the Unix user’s saved recording
100           session configurations (see lttng-save(1) and lttng-load(1)).
101
102       /usr/local/etc/lttng/sessions
103           Directory containing the system-wide saved recording session
104           configurations (see lttng-save(1) and lttng-load(1)).
105
106       Note
107           $LTTNG_HOME defaults to the value of the HOME environment variable.
108

RESOURCES

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

COPYRIGHT

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

THANKS

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