LR_PROF_REPORT.IN(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.

SEE ALSO
lr_dlf2xml(1)

AUTHOR
Francis J. Lacoste <flacoste@logreport.org>

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

COPYRIGHT
Copyright (C) 2001 Stichting LogReport Foundation LogReport@LogReport.org

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.