HP UX Caliper Software manual Or --sampling-spec, For Function Coverage Reports, Rate, Variation

-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.

-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. 151).

•cstack

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

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. 56).

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

52 HP Caliper Options