caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
To specify multiple sampling specifications, the
--sampling-spec or
-s option can be used mul-
tiple times in the command-line. An user can specify up to 4 sampling events on Itanium 2 systems
and up to 8 sampling events on new quad-core systems.
Note: Specifying multiple
-s options overrides the default
fprof sampling specification.
--scope={process|system|PSET_LIST}[
,attr-mod|,attr-proc|,attr-none]
Defines a measurement’s scope.
PSET_LIST is defined as:
pset=
pset_id[:pset_id]...
Caliper can measure activity on individual processes (
process scope), on all CPUs in the system
(
system scope) or, on HP-UX systems, on all CPUs in selected processor sets (
pset scope).
The
system and pset scopes are supported for all PMU-based measurements (
alat, branch,
cpu, cycles, dcache dtlb, ecount
, fprof, icache, itlb, pmu_trace, traps). The
default scope is
process.
With
system and pset scopes, the qualifiers
attr-mod, attr-proc, and attr-none can be
specified. For measurements involving PMU samples, this determines how such samples are attri-
buted.
attr-mod is the default, and tells
caliper to attribute samples to individual processes
and their load modules, whenever possible.
attr-proc causes attribution simply to processes alone; attr-none specifies no process attribu-
tion at all.
In all three qualifier cases, samples recorded in the kernel will be attributed to kernel modules, if
possible. The
-w option is a shortcut for --scope=system,attr-mod
.
When the scope is
system, the command-line arguments program and program_args should not be
provided. For more information, see System-Wide Measurements below.
--switch-interval=
SECONDS
Controls the
overview measurement switch interval. The overview measurement multiplexes
fprof, dcache, and cstack measurements at a time interval of 1 second. The default switch
interval of 1 second can be changed using this option. After each switch interval, Caliper will switch
from one measurement to the next.
Reporting Options
The command line options which affect reporting are:
--callpath-cutoff=
PERC_CUTOFF[,CUM_PERC_CUTOFF[,MIN_COUNT]]
This option is valid when using the
cstack, scgprof, and cgprof measurements. It specifies a
cutoff value that limits hot call paths reported in Hot Call Paths sections.
Reporting of call paths stops when, for the given sort metric, a call path is encountered whose asso-
ciated metric percentage is below PERC_CUTOFF (default 1.0) or when the
CUM_PERCENT_CUTOFF has been met or exceeded (default 100.0).
The MIN_COUNT argument sets the minimum number of call paths to be displayed (default: 5)
regardless of the settings for PERC_CUTOFF and CUM_PERC_CUTOFF.
--context-lines=COUNT_SOURCE[,COUNT_DISASSEMBLY]
Specifies that function details should show at least count_source source lines (default: 5 for source-
only reports or 0 for reports with disassembly code) before and after reporting a source line entry
with associated performance data.
Set COUNT_SOURCE to
all to report all source lines for reported functions. As with
COUNT_SOURCE , set COUNT_DISASSEMBLY to show context disassembly lines (default: 3).
Applies to PMU histogram reports only.
--csv-file=CSV_FILE[,append|,create][,per-process|,shared][,unique]
Specifies a file in which to write a caliper performance report in Comma-Separated-Values for-
mat (CSV) for use in a spreadsheet or for further processing.
The file can be opened in
append or create mode (default: create). Multi-process reports can
be generated per-process (exec name is appended to each file) or to a single, shared file
(default: shared). Specify unique to have the process ID appended to the report file name.
--description-details={all|none|[target][:processor][:run][:times][:sampling]
[:images][:help]}
HP-UX 11i Version 3: September 2010 − 9 − Hewlett-Packard Company 9