1LTTNG-STATUS(1) LTTng Manual LTTNG-STATUS(1)
2
3
4
6 lttng-status - Show the status of the current LTTng recording session
7
9 lttng [GENERAL OPTIONS] status
10
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
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
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
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
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
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
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
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
144 lttng(1), lttng-create(1), lttng-list(1), lttng-set-session(1), lttng-
145 concepts(7)
146
147
148
149LTTng 2.13.10 14 June 2021 LTTNG-STATUS(1)