caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
• Replace the executable invocation with --scope=system
(or -w)
• Define a measurement duration (
--duration=seconds or -eseconds) or measure until SIGINT
(Ctrl-C) is received.
On HP-UX, the
--scope pset=pset_id[
:pset_id]... option can be used to measure activity on all CPUs
belonging to the specified processor sets. For example,
--scope pset=1:2
measures activity on all CPUs in processor sets 1 and 2. You can use the
psrset command (see
psrset (1)) with the
-i option to find processor assignment for all processor sets in the system.
Metrics for Sorts/Cutoffs
The following report types support the use of the following metrics for sorting and applying cutoffs, where
the default metric for sorting is shown enclosed in [ ]:
alat [sampled-misses
]
branch target, branch-ways,[mispredict],
back-end-only-mispredict
cstack
[samples], samples-running
(HP-UX only), samples-blocked
(HP-UX only)
cycles [samples]
dcache sampled-misses, [
latency], avg-latency
dtlb [sampled-misses]
,l2-fills,hpw-fills,soft-fills
fprof [samples],samples,CPU_EVENT
icache sampled-misses,[
latency],avg-latency
itlb [sampled-misses
],hpw-fills,soft-fills
scgprof [samples},call-count,msecs-per-call
traps [samples]
By default, traps are always sorted on the first trap specified with
--traps-reported
(or
ITLB if
--traps-reported
is not used). Specifying --sort-by=samples sorts based
on values in the Trap Samples column.
The
fprof measurement in simultaneous sampling on multiple PMU events mode, will
report the IP sample hits in individual columns -- for each sampling PMU events specified by
the user.
While reporting, the
--sort-by=sample,
CPU_EVENT option can be used to specify the
metric to be used for sorting. The CPU_EVENT can be any of the sampling event specified
with
-s options. By default, the report is sorted on the sampling event specified with the
first -s option.
Cutoff settings are based on the same metric as the sort, by default. Use
--summary-cutoff or
--detail-cutoff to override the default behavior.
EXTERNAL INFLUENCES
Environment Variables
caliper recognizes the following environment variables:
CALIPER_DATABASES
specifies the databases directory where implicit caliper databases (those not
specified with a --database option) are stored. The default databases directory
is ./.hp_caliper_databases.
CALIPER_OPTS Specifies a set of caliper options which are used for every measurement run. The
contents of CALIPER_OPTS is prepended to the command line before it is pro-
cessed. It is possible to specify all caliper arguments and options via
CALIPER_OPTS.
HP-UX 11i Version 3: September 2010 − 17 − Hewlett-Packard Company 17