.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "RTLA-TIMERLAT" 1 "" ""
.SH NAME
rtla-timerlat \- Measures the operating system timer latency
.SH SYNOPSIS
.sp
\fBrtla timerlat\fP [\fIMODE\fP] ...
.SH DESCRIPTION
.sp
The \fBrtla timerlat\fP tool is an interface for the \fItimerlat\fP tracer. The
\fItimerlat\fP tracer dispatches a kernel thread per\-cpu. These threads
set a periodic timer to wake themselves up and go back to sleep. After
the wakeup, they collect and generate useful information for the
debugging of operating system timer latency.
.sp
The \fItimerlat\fP tracer outputs information in two ways. It periodically
prints the timer latency at the timer \fIIRQ\fP handler and the \fIThread\fP
handler. It also enable the trace of the most relevant information via
\fBosnoise:\fP tracepoints.
.sp
The \fItimerlat\fP tracer outputs information in two ways. It periodically
prints the timer latency at the timer \fIIRQ\fP handler and the \fIThread\fP handler.
It also provides information for each noise via the \fBosnoise:\fP tracepoints.
The \fBrtla timerlat top\fP mode displays a summary of the periodic output
from the \fItimerlat\fP tracer. The \fBrtla hist hist\fP mode displays a histogram
of each tracer event occurrence. For further details, please refer to the
respective man page.
.SH MODES
.sp
\fBtop\fP
.INDENT 0.0
.INDENT 3.5
Prints the summary from \fItimerlat\fP tracer.
.UNINDENT
.UNINDENT
.sp
\fBhist\fP
.INDENT 0.0
.INDENT 3.5
Prints a histogram of timerlat samples.
.UNINDENT
.UNINDENT
.sp
If no \fIMODE\fP is given, the top mode is called, passing the arguments.
.SH OPTIONS
.sp
\fB\-h\fP, \fB\-\-help\fP
.INDENT 0.0
.INDENT 3.5
Display the help text.
.UNINDENT
.UNINDENT
.sp
For other options, see the man page for the corresponding mode.
.SH SEE ALSO
.sp
\fBrtla\-timerlat\-top\fP(1), \fBrtla\-timerlat\-hist\fP(1)
.sp
\fItimerlat\fP tracer documentation: <\fI\%https://www.kernel.org/doc/html/latest/trace/timerlat\-tracer.html\fP>
.SH AUTHOR
.sp
Written by Daniel Bristot de Oliveira <\fI\%bristot@kernel.org\fP>
.SH REPORTING BUGS
.sp
Report bugs to <\fI\%linux\-kernel@vger.kernel.org\fP>
and <\fI\%linux\-trace\-devel@vger.kernel.org\fP>
.SH LICENSE
.sp
\fBrtla\fP is Free Software licensed under the GNU GPLv2
.SH COPYING
.sp
Copyright (C) 2021 Red Hat, Inc. Free use of this software is granted under
the terms of the GNU Public License (GPL).
.\" Generated by docutils manpage writer.
.