HP-UX Reference (11i v2 07/12) - 1 User Commands A-M (vol 1)

c
caliper(1)
For Integrity Systems Only
caliper(1)
Caliper 4.3 Caliper 4.3
(Requires Optional HP Caliper Software)
(Can also be specified with the
-s option).
Controls the sampling rate and the event that triggers samples.
The first form (
--sampling-spec=
TIME_PERIOD) is used only for the
cpu and cstack meas-
urements.
The second form is used for all other sample-based measurements (
fprog, dcache, icache,etc.).
TIME_PERIOD is a sampling period in seconds, milliseconds, or microseconds (specified as a N
s,
N
ms, Nus, respectively, where N is an integer).
For the
cpu measurement, the default TIME_PERIOD is 8ms of CPU time (see also
--cpu-
aggregation=
COUNT).
For the cstack measurement, the default TIME_PERIOD is 100 miliseconds (wall-clock time). Note
that time is measured in CPU cycles (for
cpu measurement) or real time (for cstack measure-
ment).
EVT_PERIOD specifies how many sampling events should occur between samples.
VARIATION specifies how much to vary the number of events between samples (may be specified as
either an exact count or as a percentage of the sampling rate if followed by
%
).
CPU_EVENT specifies the CPU event to use for sampling. You can list CPU events available (along
with descriptions) by using
caliper info
(see Information Options below).
EVENT_PARAM allows you to change the privilege level (default:
user) and threshold (default: 0) in
effect for the CPU event counter used to trigger samples. See
--event-defaults
above for the
syntax of EVENT_PARAM.
--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_ttrace
, 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 pos-
sible. 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.
--thread=sum-all|all
-t=sum-all
|all
Specifies how thread data should be collected and reported. Specify all to collect and report data per
thread. (The -t option is a shortcut for --thread=all ). Specify sum_all to collect and report
data summed across threads. Default: sum_all.
Note that this option is currently only supported for the following measurements: alat, branch,
cstack, cycles, dcache, dtlb, fprof, icache, itlb, traps.
Reporting Options
The command line options which affect reporting are:
--callpath-cutoff=PERC_CUTOFF[,CUM_PERC_CUTOFF[,MIN_COUNT]]
Valid only for the cstack measurement, this option specifies a cutoff value that limits hot call paths
reported in Hot Call Paths sections.
HP-UX 11i Version 2: December 2007 Update − 7 − Hewlett-Packard Company 97