lttng-disable-rotation(1)

1LTTNG-DISABLE-ROTA(1)            LTTng Manual            LTTNG-DISABLE-ROTA(1)
2
3
4

NAME

6       lttng-disable-rotation - Unset an LTTng recording session rotation
7       schedule
8

SYNOPSIS

10       lttng [GENERAL OPTIONS] disable-rotation [--session=SESSION]
11             (--timer | --size | --timer --size)
12

DESCRIPTION

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

OPTIONS

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

EXIT STATUS

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

ENVIRONMENT

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

FILES

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

EXAMPLES

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

RESOURCES

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

COPYRIGHT

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

THANKS

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