PERFORMANCE.SH(1)

🦋 NAME 🦋

okay bestie, this is PERFORMANCE.SH(1), from the User Contributed Perl Documentation collection. The actual NAME vibe is BeakerLib - performance - Performance measuring routines.

---

🌈 DESCRIPTION 🌈

This is a library of helpers and shortcut for performance monitoring of applications. It provides various means of measuring time and memory performance of programs.

It’s literally giving “toolbox for timing and memory performance” energy. ✨

---

🔥 FUNCTIONS 🔥

⏱️ Time Performance ⏱️

🏃‍♀️ rlPerfTime_RunsInTime

Measures how many runs of some commands can be done in specified time. This approach is suitable for short-time running tasks (up to few seconds), where averaging few runs is not precise. This is done several times, and the final result is the average of all runs. It prints the number on stdout, so it has to be captured.

rlPerfTime_RunsInTime command [time] [runs]

• command — command to run.
• time — time in seconds (optional, default=30).
• runs — number of averaged runs (optional, default=3).

---

🐢 rlPerfTime_AvgFromRuns

Measures the average time of running some task. This approach is suitable for long-time running tasks (tens of seconds and more), where it is precise enough. Measured runs can be preceded by dry run, which is not measured and its purpose is to warm up various caches. It prints the number on stdout, so it has to be captured. Or, the result is then stored in the special rl_retval variable.

rlPerfTime_AvgFromRuns command [count] [warmup]

• command — command to run.
• count — times to run (optional, default=3).
• warmup — warm-up run; it runs if this option is not "warmup" (optional, default="warmup").

capture that stdout, bestie — it prints the number, so it has to be captured. no cap. 💅

---

👑 AUTHORS 👑

• Petr Muller <pmuller@redhat.com>

---

source/version: perl v5.32.1 · date: 2026-04-07 · page: PERFORMANCE.SH(1) 💖✨