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)
By default, traps are always sorted on the first trap specified with
--traps-reported
(or
ITLB if
--traps-reported
is not used). Specifying --sort-by=samples
sorts based
on values in the "Trap Samples" column.
Cutoff settings are based on the same metric as the sort, by default. Use
--summary-cutoff
or
--detail-cutoff
to override the default behavior.
EXTERNAL INFLUENCES
Environment Variables
caliper recognizes the following environment variables:
CALIPER_DATABASES
specifies the databases directory where implicit
caliper databases (those not
specified with a
--database
option) are stored. The default databases directory is
./.hp_caliper_databases
.
CALIPER_OPTS Specifies a set of
caliper options which are used for every measurement run. The
contents of
CALIPER_OPTS is prepended to the command line before it is processed.
It is possible to specify all caliper
arguements and options via CALIPER_OPTS .
PLATFORM-SPECIFIC ADDENDA
HP-UX
There are some situations where
caliper cannot insert probe code in a program or portions of a program
due to non-standard or unusual conditions, such as when an assembly routine violates standard runtime
conventions. In such situations, caliper will issue warning messages and proceed to measure as much of
the program as it can.
The following additional measurements are supplied with caliper on HP-UX:
acount Measures basic block arc counts.
cgprof Measures call graph profile. (This is an enhanced version of the gprof command.)
cpu Measures per-process metrics based on sampled CPU events.
fcount Measures function counts.
fcover Measures function coverage.
The following additional options, option arguments, or option features are available on HP-UX:
--bus-speed= MHZ
Specifies the bus speed in MHz for the sysbus event set. If you specify the sysbus event set, you
must use the --bus-speed option to provide bus speed.
--inlines|--noinlines
The --inlines option specifies that caliper should record and report inline functions, if data is
available in the binary to discover such inlines.
--cpu-aggregation=
COUNT
This option is valid only when using the cpu measurement. Specifies how many samples (sampling
period specified using
--sampling-spec=
TIME_PERIOD option) will be aggregated into one
aggregated sample.
If COUNT is 0 or 1, the samples will not be aggregated. By default 125 low-level samples will be
aggregated into one user-reported sample.
--cpu-details=[statistics |means][:samples]
This option is valid only when using the cpu measurement. Specifies whether to print all 7 statistical
metrics (statistics ) or just the mean and standard deviation (means). samples controls the
printing of each sample in addition to reporting the summary statistics.
The default is means (report only the mean and standard deviation values).
--duration
This option is not supported for cgprof, fcount, fcover, and acount runs.
--exclude-caliper=TRUE|FALSE
The option is only valid when -w (--scope=system ) is specified. This option is used to
exclude/include the Caliper process activity as part of the measurement.
106 Hewlett-Packard Company − 16 − HP-UX 11i Version 2: December 2007 Update