lttng-version(1)

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

NAME

6       lttng-version - Get the version of LTTng-tools
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] version
10

DESCRIPTION

12       The lttng version command outputs the version of LTTng-tools.
13
14       The output of lttng version is broken down into the following parts:
15
16       •   Major, minor, and patch numbers
17
18       •   Git commit information, if available
19
20       •   Release name with its description
21
22       •   LTTng project’s website URL
23
24       •   License information
25

OPTIONS

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

ENVIRONMENT VARIABLES

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

FILES

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

EXIT STATUS

94       0
95           Success
96
97       1
98           Command error
99
100       2
101           Undefined command
102
103       3
104           Fatal error
105
106       4
107           Command warning (something went wrong during the command)
108

BUGS

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

RESOURCES

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

COPYRIGHTS

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

THANKS

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