caliper.1 (2010 09)
c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
--output-file=
OUT_FILE[,append|,create]
(Can also be specified with the
-o option.)
Specifies the file in which to write the
caliper information report (default is stdout).
The file can be opened in
append
or create mode (default: create).
--report=all|REPORT_TYPE
(Can also be specified with the
-r option.)
Specifies that information about the report types which match the given (partial) REPORT_TYPE
name be output. This is the same information which is include in measurement reports when the
--info option is used.
Report types are
alat, branch, dcache
, dtlb, ecount, fprof, icache, itlb, pmu_trace,
or
scgprof.
Use
all to report on all report types.
The
--cpu-counter and --report
options are mutually exclusive.
--search={all|[name][:abbreviation
][:category][:title][
:description]}
(Can also be specified with the
-s option.)
Specifies which information fields are to be searched for cpu counter reports. It can be any combina-
tion of
name, abbreviation, category, title,ordescription; separated by colons or
all.
Default:
name:abbreviation
.
Help and Version Options
The following general options can be used to get syntax help or print the
caliper version:
-h or -? Prints the quick help text. When used, must be used alone on the
caliper com-
mand line.
--help or -H Prints the long help text. When used, must be used alone on the
caliper com-
mand line.
--version or -v Prints the caliper version identification. When used, must be used alone on
the caliper command line.
Specifying Settings with an Initialization File
You can save settings in a file, named
.caliperinit, that HP Caliper automatically uses at start-up.
Putting the options in an initialization file simplifies the command line you use to launch HP Caliper.
For example, you can specify global settings for all of your reports, such as system libraries to exclude
and output file locations. With your preferences in the initialization file, you can then simply type:
$ caliper fprof
The resulting report would use your predefined preferences. Using this approach you could, for example,
change your preferences without having to change the HP Caliper command line in a Makefile.
Note: Any option specified on the command line overrides the corresponding setting in an initialization
file.
There are a number of reporting options not available from the command line that you can set in an
option file. These are:
disasm_target_name_limit=LIMIT
Specifies the maximum number of characters to print for branch target symbols in disassembly.
Default: 30
use_parens_for_statement_data=TRUE|FALSE
If TRUE, statement-level data in reports is placed in parentheses.
Default: True
suppress_statement_data=TRUE|FALSE
If TRUE, no statement-level data will be reported.
Default: False
14 Hewlett-Packard Company − 14 − HP-UX 11i Version 3: September 2010