lr_prof_report(1)

NAME

lr_prof_report - Profile a report configuration.

SYNOPSIS

lr_prof_report superservice report_cfg_file dlffile

DESCRIPTION

lr_prof_report can be used to profile reports for a superservice to determine which reports are taking the most memory. It will run lr_dlf2xml with report_cfg_file, with an empty configuration file and one time for each report present in report_cfg_file. It will collect performance statistics (time and memory) and print a statistical report at the end.

PROFILING REPORT

lr_prof_report will output a column formatted report. Each row represent the statistics of generating a report from that report specification. The reports are sorted by physical memory used. The different columns are :

NAME: The name of the report. This is the content of the ID attribute in the report specification. This is also the value used in the report configuration file. There are two special names. lr_all which is used for the run using the complete report configuration and lr_none which is used for the empty configuration file run.

RECORDS: The number of DLF records processed.

VSIZE: (This will only be available on Linux). Virtual memory used by the program. This is the size of the virtual memory map. This isn't the size of the physical memory used by the report.

RSS: (This will only be available on Linux). The resident set size of the process. This is the maximum amount of physical memory used by the report.

DIFF%

(This will only be available on Linux). This is the percentage of the physical memory used by the report which isn't used by libraries or the perl interpreter. The formula used is :

  (RSS - RSS for lr_none) * 100 / (RSS for lr_all - RSS for lr_none)

This means that the value will be 0 for lr_none and 100 for lr_all and in between values for the other reports. This is useful to find the report specifications that used huge amount of memory.

REAL: The number of wall clock seconds used to generate the report. This value has a granularity of 1sec.

USER: The nuber of CPU time in user space used to generate the report. This usually has subsecond granularity.

SYSTEM: The nuber of CPU time in kernel space used to generate the report. This usually has subsecond granularity.

AUTHOR

Francis J. Lacoste <[email protected]>

VERSION

$Id: lr_prof_report.in,v 1.3 2001/10/18 19:13:17 flacoste Exp $

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html or write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.