RTLA-TIMERLAT(1)

📦
version 6.12.115 · 2 versions
, in debian trixie

okay bestie, pull up a chair 🎀 this is the manual page for rtla-timerlat, straight out of the General Commands Manual (that's the section 1 club, iykyk). It measures the operating system timer latency and honestly it's giving main character energy for anyone debugging timing stuff. let's go 💅

✨ NAME ✨

rtla-timerlat — measures the operating system timer latency 🕐✨

🌸 SYNOPSIS 🌸

rtla timerlat [MODE] ...

🦋 DESCRIPTION 🦋

So the rtla timerlat tool is basically an interface for the timerlat tracer. And that tracer? It dispatches a kernel thread per-cpu. These threads set a periodic timer to wake themselves up and then go right back to sleep 😴 — like a nap with a purpose. After the wakeup, they collect and generate useful information for the debugging of operating system timer latency. No cap, that's the whole job.

The timerlat tracer outputs information in two ways:

  • It periodically prints the timer latency at the timer IRQ handler and the Thread handler.
  • It also enable the trace of the most relevant information via osnoise: tracepoints.

(yes bestie, the original says this twice with slightly different wording — so here's the second telling, and it's not me being extra, it's the page being extra 💀)

The timerlat tracer outputs information in two ways. It periodically prints the timer latency at the timer IRQ handler and the Thread handler. It also provides information for each noise via the osnoise: tracepoints.

So here's the tea on the modes:

  • The rtla timerlat top mode displays a summary of the periodic output from the timerlat tracer.
  • The rtla hist hist mode displays a histogram of each tracer event occurrence.

For further details, please refer to the respective man page 🫶

👑 MODES 👑

  • top — Prints the summary from timerlat tracer. 📊
  • hist — Prints a histogram of timerlat samples. 📈
If no MODE is given, the top mode is called, passing the arguments. periodt.

💖 OPTIONS 💖

  • -h, --help — Display the help text. the classic, the icon, the "help me help you" ✨

For other options, see the man page for the corresponding mode 👀

🌈 SEE ALSO 🌈

timerlat tracer documentation:

<https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html>

🫶 AUTHOR 🫶

Written by Daniel Bristot de Oliveira <bristot@kernel.org> 💜

😭 REPORTING BUGS 😭

Report bugs to <linux-kernel@vger.kernel.org> and <linux-trace-devel@vger.kernel.org> — they wanna hear from you fr fr 🐛

⭐ LICENSE ⭐

rtla is Free Software licensed under the GNU GPLv2 💅

🎀 COPYING 🎀

Copyright (C) 2021 Red Hat, Inc. Free use of this software is granted under the terms of the GNU Public License (GPL).

and that's the whole page bestie, you ate it 🍓 this was rtla-timerlat(1) from the General Commands Manual, and it's literally the last line so we're done here 💖✨ bye mwah 💅

📦 where this page comes from