1LTTNG-DISABLE-ROTA(1) LTTng Manual LTTNG-DISABLE-ROTA(1)
2
3
4
6 lttng-disable-rotation - Unset an LTTng recording session rotation
7 schedule
8
10 lttng [GENERAL OPTIONS] disable-rotation [--session=SESSION]
11 (--timer | --size | --timer --size)
12
14 The lttng disable-rotation command unsets a rotation schedule,
15 previously set with the lttng-enable-rotation(1) command, for:
16
17 With the --session=SESSION option
18 The recording session named SESSION.
19
20 Without the --session option
21 The current recording session (see lttng-concepts(7) to learn more
22 about the current recording session).
23
24 See lttng-concepts(7) to learn more about the recording session
25 rotation and trace chunk concepts.
26
27 See the “EXAMPLES” section below for usage examples.
28
30 See lttng(1) for GENERAL OPTIONS.
31
32 Rotation schedule condition
33 --size
34 Unset the rotation schedule previously set with the --size option
35 of the lttng-enable-rotation(1) command.
36
37 --timer
38 Unset the rotation schedule previously set with the --timer option
39 of the lttng-enable-rotation(1) command.
40
41 Recording target
42 -s SESSION, --session=SESSION
43 Unset a rotation schedule for the recording session named SESSION
44 instead of the current recording session.
45
46 Program information
47 -h, --help
48 Show help.
49
50 This option attempts to launch /usr/bin/man to view this manual
51 page. Override the manual pager path with the LTTNG_MAN_BIN_PATH
52 environment variable.
53
54 --list-options
55 List available command options and quit.
56
58 0
59 Success
60
61 1
62 Command error
63
64 2
65 Undefined command
66
67 3
68 Fatal error
69
70 4
71 Command warning (something went wrong during the command)
72
74 LTTNG_ABORT_ON_ERROR
75 Set to 1 to abort the process after the first error is encountered.
76
77 LTTNG_HOME
78 Path to the LTTng home directory.
79
80 Defaults to $HOME.
81
82 Useful when the Unix user running the commands has a non-writable
83 home directory.
84
85 LTTNG_MAN_BIN_PATH
86 Absolute path to the manual pager to use to read the LTTng
87 command-line help (with lttng-help(1) or with the --help option)
88 instead of /usr/bin/man.
89
90 LTTNG_SESSION_CONFIG_XSD_PATH
91 Path to the directory containing the session.xsd recording session
92 configuration XML schema.
93
94 LTTNG_SESSIOND_PATH
95 Absolute path to the LTTng session daemon binary (see lttng-
96 sessiond(8)) to spawn from the lttng-create(1) command.
97
98 The --sessiond-path general option overrides this environment
99 variable.
100
102 $LTTNG_HOME/.lttngrc
103 Unix user’s LTTng runtime configuration.
104
105 This is where LTTng stores the name of the Unix user’s current
106 recording session between executions of lttng(1). lttng-create(1)
107 and lttng-set-session(1) set the current recording session.
108
109 $LTTNG_HOME/lttng-traces
110 Default output directory of LTTng traces in local and snapshot
111 modes.
112
113 Override this path with the --output option of the lttng-create(1)
114 command.
115
116 $LTTNG_HOME/.lttng
117 Unix user’s LTTng runtime and configuration directory.
118
119 $LTTNG_HOME/.lttng/sessions
120 Default directory containing the Unix user’s saved recording
121 session configurations (see lttng-save(1) and lttng-load(1)).
122
123 /usr/local/etc/lttng/sessions
124 Directory containing the system-wide saved recording session
125 configurations (see lttng-save(1) and lttng-load(1)).
126
127 Note
128 $LTTNG_HOME defaults to the value of the HOME environment variable.
129
131 Example 1. Unset the size-based rotation schedule of the current
132 recording session.
133
134 See the --size option.
135
136 $ lttng disable-rotation --size
137
138 Example 2. Unset the periodic rotation schedule of a specific recording
139 session.
140
141 See the --timer and --session options.
142
143 $ lttng disable-rotation --session=my-session --timer
144
146 • LTTng project website <https://lttng.org>
147
148 • LTTng documentation <https://lttng.org/docs>
149
150 • LTTng bug tracker <https://bugs.lttng.org>
151
152 • Git repositories <https://git.lttng.org>
153
154 • GitHub organization <https://github.com/lttng>
155
156 • Continuous integration <https://ci.lttng.org/>
157
158 • Mailing list <https://lists.lttng.org/> for support and
159 development: lttng-dev@lists.lttng.org
160
161 • IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
162
164 This program is part of the LTTng-tools project.
165
166 LTTng-tools is distributed under the GNU General Public License
167 version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>.
168 See the LICENSE <https://github.com/lttng/lttng-
169 tools/blob/master/LICENSE> file for details.
170
172 Special thanks to Michel Dagenais and the DORSAL laboratory
173 <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
174 the LTTng journey.
175
176 Also thanks to the Ericsson teams working on tracing which helped us
177 greatly with detailed bug reports and unusual test cases.
178
180 lttng(1), lttng-enable-rotation(1), lttng-rotate(1), lttng-concepts(7)
181
182
183
184LTTng 2.13.10 14 June 2021 LTTNG-DISABLE-ROTA(1)