caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
Specifies how much detail to print in the per-process or per application sections of every
caliper
report (default: target:times:sampling
).
target prints information about the target application or attached process measured.
times reports basic time data about the execution.
sampling reports the sampling parameters and counts.
images lists the load modules that are part of the application measured.
--detail-cutoff=
PERC_CUTOFF[,CUM_PERC_CUTOFF[
,MIN_COUNT]]
Specifies a cutoff value that limits functions reported in function details 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 1.0) 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: 0)
regardless of the settings for PERC_CUTOFF and CUM_PERC_CUTOFF.
Applies to PMU histogram reports only.
--group-by=executable
|module|none
Specifies how data for matching processes and modules (those with matching basenames) is com-
bined in reports.
Specify
executable to have data for matching processes combined whenever possible. This is the
default.
Specify
module to ignore individual processes, and create a "module-centric" report for matching
modules across all measured processes.
Specify
none to combine no data across any processes.
--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 dcache reports (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)
cannot 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.
10 Hewlett-Packard Company − 10 − HP-UX 11i Version 3: September 2010