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)
For keyword families measure|
track|ignore, glob|regexp and file|arg0|arg1, only
the last keyword used in each family is considered. For the keyword family
root|fork|exec, mul-
tiple keywords will be considered as specifying a logical OR operation between the keywords.
The prefix
some: is only necessary when no option is provided and the PATTERN could be mistaken
for one of the simple options (
root
, root-forks , all, default).
--process=custom:
FUNCTION
Allows you to specify a Python function to be used as a filter for processes.
System-Wide Measurements
Only PMU-based measurements are available in system-wide mode (across all CPUs in the system, instead
of selected processes).
Measurements involving dynamic instrumentation see Measurement Categories) and
cstack are not sup-
ported in system-wide mode. The measurement can occur at any privilege level; the default privilege level
for system-wide mode is
all: user and kernel space.
By default, samples are attributed to both a process and a load module, whenever possible. Alternatively,
you can specify (via --scope) that samples be attributed to processes only or neither processes nor load
modules. Both alternatives reduce the overhead of collecting and reporting performance data.
(Note that attribution settings to --scope do not affect attribution to samples in the kernel.)
In pmu_trace, addresses referring to user-space modules will not get resolved regardless of the sample
attribution requested.
HP Caliper cannot locate an executable or a shared library on HP-UX if it is invoked using a relative path.
In addition, at certain times, executables and shared libraries cannot be located even if they are specified
with complete paths. If this problem occurs, the result can be a large number of samples reported as "unat-
tributed". The workaround is to use the --module-search-path
option to specify a list of directories
where the executables and shared libraries are located.
Usage model:
• 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]
icache sampled-misses,[latency], avg-latency
itlb
[sampled-misses], hpw-fills, soft-fills
scgprof
[samples}, call-count , msecs-per-call
traps
[samples]
HP-UX 11i Version 2: December 2007 Update − 15 − Hewlett-Packard Company 105