Table 25 Information in Per-Source-File fcover Measurement Reports

Column

Description

 

 

Reached

“Yes” or “No” indication of whether the named function was ever executed.

 

 

Function

Name of the function. The load module, main executable or shared library, containing

 

the function precedes the function name and is separated from it by “::”.

 

 

Source File [Line]

Base source file name, without path information, and starting line number of the named

 

function. The tilde (“~”) precedes line numbers when they are approximate due to

 

optimization.

 

 

Unknown Source Files

If the source file information for a function has been stripped, which is often done with system libraries, then HP Caliper reports on those functions separately. The report shows an additional line in the Source Directory Summary and Source File Summary tables for Unknown Source Files and the Totals coverage statistic includes them.

At the end of the per-source-file function coverage tables is an optional table for Unknown Source Files. To generate this table, use unknown in addition to the other -roption settings.

-r for Function Coverage Reports

-r [module][:directory][:file][:function][:unknown][none][all]

Default value is module:directory:file:function:unknown.

module

Shows data by load module.

directory

Groups data by source directory.

file

Generates Summary Report by source file.

function

Shows function level detail by source file.

unknown

When used together with the other report options, provides additional information

 

about functions from unknown source files in the summary and detail coverage

 

reports.

fprof Measurement Report Description

With the fprof measurement, produced by the fprof measurement configuration file, HP Caliper measures and reports sampled instruction pointers (IPs). The fprof measurement samples the instruction pointer (IP) at a regular interval (that is, at a particular number of CPU cycles). This provides a statistical identification of where CPU events are occurring.

The report contains two levels of information:

•Exact counts of CPU metrics summed across the entire run of an application

•Sampled IPs that are associated with particular locations in the application

The default for the fprof measurement is to take a sample every 500,000 +/- 25,000 CPU cycles. (CPU_CYCLES is the event.)

You use the -s(--sampling-spec) option to change both the event being sampled and the interval. For example, if you want to keep the same variation and sample event and simply change the interval, you can use the following option: -s 100000. The sampling rate, variation, and event used are listed in the Sampling Specification part of the report.

Command-line options allow you to control the amount of data reported, how the data is sorted, and the number of statements and instructions reported for each sampled program location.

Example Command Line for Text Report

$ caliper fprof -o reports/sample.txt ./wordplay thequickbrownfox

210 Descriptions of Measurement Reports