caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
--percent-columns={total
|
cumulative|total:cumulative}
Specifies what types of percentages are shown in reports.
Specify
total to have a column showing percentage of samples with respect to total number of
samples taken.
Specify
cumulative to have a column showing cumulative percentage of samples.
Applies to PMU histogram reports only.
--process-cutoff=
PERC_CUTOFF[,CUM_PERC_CUTOFF[
,MIN_COUNT]]
Specifies a cutoff value that limits processes reported in process summary section.
Reporting of processes stops when, for the given sort metric, a process is encountered whose associ-
ated metric percentage is below PERC_CUTOFF (default 2.0) or when the
CUM_PERCENT_CUTOFF has been met or exceeded (default 100.0).
The MIN_COUNT argument sets the minimum number of processes to be displayed (default: 5)
regardless of the settings for PERC_CUTOFF and CUM_PERC_CUTOFF.
Applies to PMU histogram reports only.
--read-init-file=TRUE
|FALSE
Specifies whether or not caliper
should look for and read .caliperinit, the caliper initial-
ization file (default:
TRUE).
Caliper looks for a
.caliperinit file in the current directory; if not found, caliper then looks
in your home directory.
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 cov-
erage reports are produced.
Default:
module:directory:file:function:unknown
.
Specify
module for the load module summary report, directory for the source directory sum-
mary 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 sum-
mary and detail coverage reports.
--report-hotpaths=TRUE|FALSE
Specifies whether or not the hot call paths section should appear in the call graph reports (default:
TRUE). This option can be used only with the cgprof and scgprof measurements.
--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.
HP-UX 11i Version 3: September 2010 − 11 − Hewlett-Packard Company 11