1LTTNG-METADATA(1) LTTng Manual LTTNG-METADATA(1)
2
3
4
6 lttng-metadata - Manage an LTTng tracing session's metadata generation
7
9 lttng [GENERAL OPTIONS] metadata regenerate [--session=SESSION]
10
12 Warning
13 This command is deprecated; it has been replaced by lttng
14 regenerate metadata (see lttng-regenerate(1)).
15
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
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
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
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
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
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
117 · LTTng project website <https://lttng.org>
118
119 · LTTng documentation <https://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
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
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
149 lttng(1)
150
151
152
153LTTng 2.12.2 28 November 2016 LTTNG-METADATA(1)