HP UX Caliper Software manual Cgprof Report Description, How branch Metrics Are Obtained

Table 10 Information in branch Measurement Reports (continued)

Column	Description
Load Module	Shared library or the main executable.
Function	Routine from your application.
File	Source file associated with a function.
Line	The column contains one of these:
Slot	• A source-code line number for rows showing statements
Col,Offset
	• An instruction slot number for rows showing instructions not on a bundle boundary
	• A source-code column number followed by an offset from the beginning address of a function
	for rows showing instructions on a bundle boundary
	Column and line numbers are preceded by “~” when they are approximate due to optimization.
>Statement	The column contains either a source statement preceded by “>” or a disassembled instruction.
Instruction	Statements that are out of order due to optimization are preceded by “*>”.

How branch Metrics Are Obtained

HP Caliper obtains branch metrics from the processor's performance monitoring unit (PMU).

Exact counts are obtained from the PMU's set of performance monitor configuration (PMC)/performance monitor data (PMD) register pairs. Sampled branch prediction metrics are obtained from the PMU's branch trace buffer (BTB)/execution trace buffer (ETB).

HP Caliper takes samples every Nth branch event, where N is defined in the branch measurement configuration file in the HP Caliper home directory config subdirectory. At each sample point, HP Caliper records branch metrics from the BTB/ETB. You can override the value in the measurement configuration file by using the -soption.

HP Caliper reports each branch prediction metric at the lowest granularity available from the BTB/ETB. The branch direction outcome and branch prediction information is available at the granularity of each of the four possible branch ways (taking the branch in slot 0, slot 1, or slot 2, or falling through to the next bundle). The property of being a branch target is only relevant at the granularity of a bundle.

cgprof Report Description

Available only on HP-UX.

With the cgprof measurement, produced by the cgprof measurement configuration file, HP Caliper measures and reports both flat and call graph profiles (much like standard gprof).

The HP Caliper gprof-like report includes these results:

•Total execution times for each function in the program

•Call counts for each function in the program

•Cycle information, member functions, time and call counts

•Most likely hot call paths in the program

Example Command Line for Text Report

$ caliper cgprof -o reports/cgprof.txt ./wordplay thequickbrownfox

Example Command Line for CSV Report

$ caliper cgprof --csv csvout ./wordplay thequickbrownfox

cgprof Report Description 175