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)
Reporting of call paths stops when, for the given sort metric, a call path 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 call paths to be displayed (default: 5)
regardless of the settings for PERC_CUTOFF and CUM_PERC_CUTOFF.
--context-lines=
COUNT_SOURCE[,COUNT_DISASSEMBLY]
Specifies that function details should show at least count_source source lines (default: 5 for source-only
reports or 0 for reports with disassembly code) before and after reporting a source line entry with
associated performance data.
Set COUNT_SOURCE to
all to report all source lines for reported functions. As with
COUNT_SOURCE, set COUNT_DISASSEMBLY to show context disassembly lines (default: 3).
Applies to PMU histogram reports only.
--csv-file= CSV_FILE[,append|,create][
,per-process |,shared][,unique]
Specifies a file in which to write a
caliper performance report in Comma-Separated-Values format
(CSV) for use in a spreadsheet or for further processing.
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.
--description-details=
{all|none|[target][:processor][:run][:times]
[
:sampling][:images][:help]}
Controls which subsections are included in the description section at the top of each report.
The default: target:processor:times:sampling
.
Specify
all to include all subsections, none to exclude all subsections, or specify a list of the subsec-
tions you want included. The list can include one or more of the following subsection identifiers
(shown with their associated subsection title):
target Target Application
processor Processor Information
run Run Information
times Target Execution Time
sampling Sampling Specification
images Load Modules Included
help Report Help
--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.
--html=[OUTPUT_DIR[,STYLE[,ENTRIES_PER_PAGE]]]
Writes performance data as an HTML-formatted report in directory OUTPUT_DIR (default:
./Caliper_HTML).
STYLE specifies the color theme of the report. STYLE can be set to black, gold,orwhite
(default: white).
98 Hewlett-Packard Company − 8 − HP-UX 11i Version 2: December 2007 Update