caliper.1 (2010 09)
c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
PLATFORM-SPECIFIC ADDENDA
HP-UX
There are some situations where caliper cannot insert probe code in a program or portions of a pro-
gram 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:
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.
ktrace Traces kernel function calls. Provides a wrapper for the
ktracer and ktracedump
programs. See also the HP Caliper Ktrace Feature Guide and the ktracer (1M) and
ktracedump (1M) manpages.
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 statisti-
cal 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, and fcover 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.
The default is
TRUE (exclude).
Note that this option is not available on Linux and the behavior there is equivalent to a setting of
FALSE (include Caliper).
--exclude-idle=TRUE|FALSE
The option is only valid when -w (--scope=system) is specified. This option is used to
exclude/include the idle task as part of the measurement.
The default is
TRUE (exclude).
Note that this option is not available on Linux and the behavior there is equivalent to a setting of
FALSE (include the idle task).
--kernel-path
The default kernel path used is: /stand/current/vmunix (HP-UX 11i v2 and later).
--kernel-stack=TRUE|FALSE
Specifies whether to extend the callstack samples collection into kernel space. By default, if
caliper is invoked with root permission, both the user-space and kernel-space callstack samples
will be collected.
18 Hewlett-Packard Company − 18 − HP-UX 11i Version 3: September 2010