caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
Applies to PMU histogram reports only.
--stop-functions=
FUNC[,FUNC]...
Valid only for
cstack; specifies kernel functions beyond which frames will not be shown. This is
useful to exclude the obvious sleep functions in the kernel and by default some functions are
specified in
config/cstack.
--summary-cutoff=
PERC_CUTOFF[,CUM_PERC_CUTOFF[
,MIN_COUNT]]
Specifies a cutoff value that limits functions reported in function summary sections.
Reporting of functions stops when, for the given sort metric, a function is encountered whose associ-
ated metric percentage is below PERC_CUTOFF (default 0.1) or when the
CUM_PERCENT_CUTOFF has been met or exceeded (default 100.0).
The MIN_COUNT argument sets the minimum number of functions to be displayed (default: 5)
regardless of the settings for PERC_CUTOFF and CUM_PERC_CUTOFF.
Applies to PMU histogram reports only.
--system-model=
MODEL_NUMBER,NUM_CELLS
Specifies the system model number and number of locality domains for reporting latency buckets
with the
dcache measurement.
This option is necessary if you want HP Caliper to report system-specific latency buckets on Linux.
If you do not use this option, a default set of latency buckets will be used.
On HP-UX, HP Caliper automatically obtains the model number using the
model command (see
model(1)).
--thread=sum-all
|all
Specifies how thread data should be reported. Specify all to report data per thread. Specify
sum-all to report data summed across threads. Default: all.
Note that this option is currently only supported for the following measurements:
alat, branch,
cstack, cycles, dcache, dtlb, fprof, icache, itlb, traps.
--traps-reported=
TRAP_NAME[,TRAP_NAME]...
Specifies which traps, faults, and interrupts (collectively referred to as
traps) caliper should
report.
The traps measurement collects samples for 34 different traps, but only 6 trap types can be shown in
a single report. You can re-report from the same HP Caliper database to see different sets of traps.
TRAP_NAME is is an abbreviation for a trap name. The default TRAP_NAME values and their
associated traps are:
ITLB Instruction TLB fault
DTLB Data TLB fault
UADREF Unaligned Data Reference fault
GEXCP General Exception
FPFLT Floating-Point Fault
FPTRP Floating-Point Trap
For a list of all available values for TRAP_NAME, run the
caliper command:
caliper info -r traps
Advise Options
The command line options which affect advise-only runs are:
--advice-classes=[all]|[[general][:cpu][:memory][:io][:system]]
Specifies which classes of advice to report (default:
all). Every piece of advice is classified by
which performance area it apples to.
Specify one or more of
general for general advice, cpu for advice related to basic instruction exe-
cution, memory for memory-related information, io for input-output performance issues, and/or
system for advice about items such as system calls. Only advice in the selected classes will be
printed.
--advice-cutoff=MIN_INDEX[,MIN_COUNT[,MAX_COUNT]]
Specifies how much advice to report. Each bit of advice has an index value reflecting its relative
importance.
12 Hewlett-Packard Company − 12 − HP-UX 11i Version 3: September 2010