X-Git-Url: https://git.liburcu.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-disable-rotation.1.txt;h=0c23031a6423522ac120be4b77801d43a962c194;hb=26f0c7794376456fcb5b13d4eae91c0ccf0dfe66;hp=d69975ff703e1129a60e1bdd63eaff3b29c642a7;hpb=31099add7a58b2a671f9324aa023a4dc5ae000f1;p=lttng-tools.git diff --git a/doc/man/lttng-disable-rotation.1.txt b/doc/man/lttng-disable-rotation.1.txt index d69975ff7..0c23031a6 100644 --- a/doc/man/lttng-disable-rotation.1.txt +++ b/doc/man/lttng-disable-rotation.1.txt @@ -1,24 +1,34 @@ lttng-disable-rotation(1) ========================= +:revdate: 30 April 2021 NAME ---- -lttng-disable-rotation - Unset a tracing session's rotation schedule +lttng-disable-rotation - Unset an LTTng tracing session rotation schedule SYNOPSIS -------- [verse] -*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-rotation* (option:--timer | option:--size) - [option:--session='SESSION'] +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-rotation* [option:--session='SESSION'] + (option:--timer | option:--size | option:--timer option:--size) DESCRIPTION ----------- -The `lttng disable-rotation` command unsets a rotation schedule for the -current tracing session, or for the tracing session named 'SESSION' if -provided, previously set with the man:lttng-enable-rotation(1) command. +The `lttng disable-rotation` command unsets a rotation schedule, +previously set with the man:lttng-enable-rotation(1) command, for: + +With the option:--session='SESSION' option:: + The tracing session named 'SESSION'. + +Without the option:--session option:: + The current tracing session (see man:lttng-concepts(7) to learn more + about the current tracing session). + +See man:lttng-concepts(7) to learn more about the tracing session +rotation and trace chunk concepts. include::common-cmd-options-head.txt[] @@ -26,8 +36,6 @@ include::common-cmd-options-head.txt[] Rotation schedule condition ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -One of: - option:--size:: Unset the rotation schedule previously set with the nloption:--size option of the man:lttng-enable-rotation(1) command. @@ -37,36 +45,21 @@ option:--timer:: option of the man:lttng-enable-rotation(1) command. -Target -~~~~~~ +Recording target +~~~~~~~~~~~~~~~~ option:-s 'SESSION', option:--session='SESSION':: - Unset a rotation schedule in the tracing session named 'SESSION' + Unset a rotation schedule for the tracing session named 'SESSION' instead of the current tracing session. include::common-cmd-help-options.txt[] -[[limitations]] -LIMITATIONS ------------ -The `lttng enable-rotation` command only works when: - -* The tracing session is created in normal mode or in network streaming - mode (see man:lttng-create(1)). - -* No channel was created with a configured trace file count or size - limit (see the nloption:--tracefile-size and - nloption:--tracefile-count options in man:lttng-enable-channel(1)). - -For a given tracing session, LTTng only performs an automatic rotation -when no other rotation is currently happening. - - include::common-cmd-footer.txt[] SEE ALSO -------- +man:lttng(1), man:lttng-enable-rotation(1), -man:lttng(1) +man:lttng-rotate(1)