lttng-metadata(1)

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

NAME

6       lttng-metadata - Manage an LTTng tracing session's metadata generation
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] metadata regenerate [--session=SESSION]
10

DESCRIPTION

12           Warning
13           This command is deprecated; it has been replaced by lttng
14           regenerate metadata (see lttng-regenerate(1)).
15

OPTIONS

17       General options are described in lttng(1).
18
19       -s SESSION, --session=SESSION
20           Manage the metadata generation of the tracing session named SESSION
21           instead of the current tracing session.
22
23   Program information
24       -h, --help
25           Show command help.
26
27           This option, like lttng-help(1), attempts to launch /usr/bin/man to
28           view the command’s man page. The path to the man pager can be
29           overridden by the LTTNG_MAN_BIN_PATH environment variable.
30
31       --list-options
32           List available command options.
33

LIMITATIONS

35       The lttng metadata regenerate command can only be used on kernel and
36       user space tracing sessions (using per-user buffering), in non-live
37       mode.
38
39       See lttng-enable-channel(1) for more information about buffering
40       schemes and lttng-create(1) for more information about the different
41       tracing session modes.
42

ENVIRONMENT VARIABLES

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

FILES

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

EXIT STATUS

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

BUGS

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

RESOURCES

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

COPYRIGHTS

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

THANKS

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

AUTHORS

149       LTTng-tools was originally written by Mathieu Desnoyers, Julien
150       Desfossez, and David Goulet. More people have since contributed to it.
151
152       LTTng-tools is currently maintained by Jérémie Galarneau
153       <mailto:jeremie.galarneau@efficios.com>.
154