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)
ENTRIES_PER_PAGE specifies the number of entries on each web page (default: 20). The
--html
option is supported for the following reports: alat
, branch, cgprof, cycles, dcache, dtlb,
fprof, icache, itlb, scgprof, and
traps.
--info
Causes HP Caliper to append help information to the end of textual reports.
--kernel-path=
PATH
Specifies the path to the kernel file you want HP Caliper to use for symbol lookup and disassembly.
This option only applies when kernel profiling is involved, typically when the sampling specification
for the measurement has a privilege level mask of
kernel or all.
--latency-buckets=TRUE
|FALSE
Specifies whether or not the latency bucket information should appear in
dcachereports (default:
TRUE).
This option is used only with the
dcache measurement.
--module-search-path=
DIRECTORY[:DIRECTORY]...
Specifies a list of directories to be searched when a load module file (executable or shared library) can-
not be found.
A load module file may not be found if the load module is not available from the location recorded at
data collection time.
--output-file=OUTFILE[,append
|,create][,per-process |,shared][,unique]
(Can also be specified with the
-o option.)
Specifies the file caliper writes its report to (default is stdout). The file can be opened in
append
or create mode (default: create).
Multi-process reports can be generated per-process (exec name is appended to each file) or to a
single, shared file (default: shared).
Specify unique to have the process ID appended to the report file name.
--per-module-data=TRUE
|FALSE
Specifies whether or not caliper should report functions in one list (default: --per-module-
data=FALSE
), or report functions grouped by load module (--per-module-data=TRUE
).
The following measurements support
--per-module-data=TRUE
: alat, branch, cycles,
dcache, dtlb, fprof, icache, itlb, and traps.
--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 sam-
ples 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 initiali-
zation file (default: TRUE).
Caliper looks for a .caliperinit file in the current directory; if not found, caliper then looks
in your home directory.
HP-UX 11i Version 2: December 2007 Update − 9 − Hewlett-Packard Company 99