lttng [GENERAL OPTIONS] view [--viewer=CMD] [--trace-path=PATH | SESSION]
The lttng view command launches an external trace viewer to view the current trace of a tracing session.
If SESSION is omitted, the viewer is launched for the current tracing session (see lttng-create(1) for more information about the current tracing session). Otherwise, it is launched for the existing tracing session named SESSION. lttng list outputs all the existing tracing sessions (see lttng-list(1)).
By default, the babeltrace(1) trace viewer is launched. Another trace viewer command can be specified using the --viewer option.
By default, the trace path of the chosen tracing session is given as the first positional argument to the trace viewer. This path can be overridden using the --trace-path option.
General options are described in lttng(1).
- View trace at path PATH instead of using the chosen tracing session's trace path.
- Use CMD as the trace viewer.
Show command help.
This option, like lttng-help(1), attempts to launch /usr/bin/man to view the command's man page. The path to the man pager can be overridden by the LTTNG_MAN_BIN_PATH environment variable.
- List available command options.
- Set to 1 to abort the process after the first error is encountered.
- Overrides the $HOME environment variable. Useful when the user running the commands has a non-writable home directory.
- Absolute path to the man pager to use for viewing help information about LTTng commands (using lttng-help(1) or lttng COMMAND --help).
- Path in which the session.xsd session configuration XML schema may be found.
Full session daemon binary path.
The --sessiond-path option has precedence over this environment variable.
Note that the lttng-create(1) command can spawn an LTTng session daemon automatically if none is running. See lttng-sessiond(8) for the environment variables influencing the execution of the session daemon.
User LTTng runtime configuration.
This is where the per-user current tracing session is stored between executions of lttng(1). The current tracing session can be set with lttng-set-session(1). See lttng-create(1) for more information about tracing sessions.
- Default output directory of LTTng traces. This can be overridden with the --output option of the lttng-create(1) command.
- User LTTng runtime and configuration directory.
- Default location of saved user tracing sessions (see lttng-save(1) and lttng-load(1)).
- System-wide location of saved tracing sessions (see lttng-save(1) and lttng-load(1)).
$LTTNG_HOME defaults to $HOME when not explicitly set.
- Command error
- Undefined command
- Fatal error
- Command warning (something went wrong during the command)
If you encounter any issue or usability problem, please report it on the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-tools>.
- • LTTng project website <http://lttng.org>
- • LTTng documentation <http://lttng.org/docs>
- • Git repositories <http://git.lttng.org>
- • GitHub organization <http://github.com/lttng>
- • Continuous integration <http://ci.lttng.org/>
- • Mailing list <http://lists.lttng.org> for support and development: [email protected]
- • IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
This program is part of the LTTng-tools project.
LTTng-tools is distributed under the GNU General Public License version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. See the LICENSE <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file for details.
Special thanks to Michel Dagenais and the DORSAL laboratory <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for the LTTng journey.
Also thanks to the Ericsson teams working on tracing which helped us greatly with detailed bug reports and unusual test cases.
LTTng-tools was originally written by Mathieu Desnoyers, Julien Desfossez, and David Goulet. More people have since contributed to it.
LTTng-tools is currently maintained by Jérémie Galarneau <mailto:[email protected]>.