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.

-s or --sampling-spec

-speriod

-srate [,variation [,cpu_event

[[:threshold=int][:privilege-level-mask=level]]]]

Specifies the sampling period.

-speriod

The -speriod version of this option is used only for two measurements:

cpu

For the cpu measurement, you can use this option in conjunction with the --event-defaultsoption to control how samples are taken. For more information, see “Performing CPU Metrics

Analysis ” (p. 153).

cstack

For more information, see Chapter 11 (page 134).

period Sampling period in seconds or milliseconds or microseconds, measured in CPU cycles (for cpu) or real time (for cstack). For example:

-s 1s (1 second)

-s 100ms (100 milliseconds)

-s 1000us (1000 microseconds)

For the cpu measurement, the default period is 8 milliseconds. See also

“--cpu-aggregation” (p. 57).

For the cstack measurement, the default period is 100 milliseconds.

-srate

The -srate version of this option is used for all other measurements.

rate

Sampling period: specifically, how many sampling events

 

should occur between samples. The smaller the rate, the

 

more chance that HP Caliper will affect your program's

 

performance while collecting information.

variation

Sampling period variation: specifically, how much to vary

 

the number of events between samples. The variation is

 

the number or percentage of cpu_counter events that HP

 

Caliper uses to vary the sampling rate. HP Caliper adds or

 

subtracts this number from the interval to vary the sampling

 

frequency.

 

You can specify the actual number of events by which to

 

vary the sampling rate, or a percentage of the count by

-s or --sampling-spec

53