PANC−PROFILING.PL

NAME
SYNOPSIS
DESCRIPTION
AUTHOR

---

NAME

panc-profiling.pl − generate profiling information from panc log file

SYNOPSIS

panc−profiling.pl [−−help] [−−usefunctions] {logfile}

DESCRIPTION

The panc−profiling.pl script will analyze a panc log file and report profiling information. The script takes the name of the log file as its first argument. The second argument determines if function call information will be included (flag=1) or not (flag=0). By default, the function call information is not included. If no argument is given or the −−help option is used, a short usage message is printed. The log file must have been created with "call" logging enabled. Two files are created for each object template: one with ´top−down´ profile information and the other with ´bottom−up´ information. The top−down file contains a text representation of the call tree with each entry giving the total time spent in that template and any templates called from that template. At each level, one can use this to understand the relative time spent in a node and each direct descendant. The bottom−up file provides how much time is spent directly in each template (or function), ignoring any time spent in templates called from it. This allows one to see how much time is spent in each template regardless of how the template (or function) was called. All of the timing information is the "wall−clock" time, so other activity on the machine and the logging itself can influence the output. Nonetheless, the profiling information should be adequate to understand inefficient parts of a particular build.

AUTHOR

Charles Loomis