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)
Settings in an initialization file take precedence over measurement configuration file settings.
Command-line options take precedence over settings in an initialization file.
--report-details=
{all|none|statement |instruction
|statement:instruction
}
(Can also be specified with the
-r option). For PMU histogram reports only. Specifies level of pro-
gram detail reported (default:
statement).
Specify statement to have data aggregated by source statement.
Specify instruction to obtain reports at the lowest level of granularity available.
Specify none to disable detail reports entirely. Specify
all to print both source and instruction level
details.
--report-details=
[module][:directory ][:file][
:function][:unknown]
(Can also be specified with the
-r option). For function coverage reports only. Specifies which cover-
age reports are produced.
Default:
module:directory:file:function:unknown
.
Specify
module for the load module summary report,
directory for the source directory summary
report,
file for the source file summary report, and/or function for the function detail report.
Additionally specify
unknown to include functions from unknown source files in the summary and
detail coverage reports.
--skip-functions=
FUNC[,FUNC]...
Valid only for
cstack; specifies functions that are of no interest. Call stacks are not reported if their
leaf routine is one of the specified functions.
--sort-by= METRIC
Specifies that performance data is to be sorted by values of given metric. (Default: See Metrics for
Sorts/Cutoffs below.)
--source-path-map=
PATHMAP[:PATHMAP]...
Specifies the PATHMAP used in finding source files (used for reporting source statements).
PATHMAP entries are separated by a colon (
:) and applied in order until a file match is found.
Simple entries are prepended to file names; comma-separated entries specify to substitute the path to
the left of the comma with the path to the right of the comma. Perl regular expressions are allowed in
the left half of a substitution.
Applies to PMU histogram reports only.
--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
Specifies the system model number 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)).
--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 asso-
ciated traps are:
100 Hewlett-Packard Company − 10 − HP-UX 11i Version 2: December 2007 Update