1PERFORMANCE.SH(1)     User Contributed Perl Documentation    PERFORMANCE.SH(1)
2
3
4

NAME

6       BeakerLib - performance - Performance measuring routines
7

DESCRIPTION

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

FUNCTIONS

14   Time Performance
15       rlPerfTime_RunsInTime
16
17       Measures, how many runs of some commands can be done in specified time.
18       This approach is suitable for short-time running tasks (up to few
19       seconds), where averaging few runs is not precise. This is done several
20       times, and the final result is the average of all runs. It prints the
21       number on stdout, so it has to be captured.
22
23           rlPerfTime_RunsInTime command [time] [runs]
24
25       command
26           Command to run.
27
28       time
29           Time in seconds (optional, default=30).
30
31       runs
32           Number of averaged runs (optional, default=3).
33
34       rlPerfTime_AvgFromRuns
35
36       Measures the average time of running some task. This approach is
37       suitable for long-time running tasks (tens of seconds and more), where
38       it is precise enough. Measured runs can be preceded by dry run, which
39       is not measured and it's purpose is to warm up various caches.  It
40       prints the number on stdout, so it has to be captured.  Or, result is
41       then stored in special rl_retval variable.
42
43           rlPerfTime_AvgFromRuns command [count] [warmup]
44
45       command
46           Command to run.
47
48       count
49           Times to run (optional, default=3).
50
51       warmup
52           Warm-up run, run if this option is not "warmup" (optional,
53           default="warmup")
54

AUTHORS

56       •   Petr Muller <pmuller@redhat.com>
57
58
59
60perl v5.34.0                      2022-01-19                 PERFORMANCE.SH(1)