beakerlib-performance

Langue: en

Version: 2010-05-12 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

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.

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 it's purpose is to warm up various caches. It prints the number on stdout, so it has to be captured. Or, result is then stored in special rl_retval variable.

     rlPerfTime_AvgFromRuns command [count] [warmup]
 
 
command
Command to run.
count
Times to run (optional, default=3).
warmup
Warm-up run, run if this option is not ``warmup'' (optional, default=``warmup'')

AUTHORS

*
Petr Muller <pmuller@redhat.com>