caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
This option is used only with the
cstack measurement.
--ktrace-path=PATH
Specifies the location of the
ktracer and ktracedump commands to be invoked from Caliper.
The default is caliper_root
/lbin.
--ktracer-log=PATH
Specifies the logfile where
ktracer output will be redirected.
--ktracedump-args="ktracedump_arguments"
Specifies the arguments to be passed to the
ktracedump command. See ktracedump (1M) for the
arguments that
ktracedump expects.
--ktracer-args="ktracer_arguments"
Specifies the arguments to be passed to the
ktracer command. See ktracer (1M) for the arguments
that
ktracer expects.
--ktracer-no-halt
This option can be used so that
ktracer is not halted (with -h) before reporting the data with
ktracedump.
--ktracer-no-wait
This option can be used so that Caliper will proceed with a
ktracedump run and would not set a
timer or wait for an interrupt from the user.
--measure-on-interrupts=on
|off|only
This option controls whether the Itanium PMU is enabled while processing interrupts/traps.
on means that the PMU is enabled all the time (during regular processing as well as interrupt
processing).
off means that the PMU is only enabled during regular processing and disabled during inter-
rupt processing.
only means that the PMU is enabled during interrupt processing and disabled during regular
processing.
The default is
on for --scope=system and cpu measurements.
The default is
off or the following measurements when the measurement scope is process
(--scope=process):
alat, branch, cycles, cache, dtlb, ecount, fprof, icache,
itlb, pmu_trace, scgprof, traps.
Note that this option is not available on Linux and the behavior there is equivalent to a setting of
on (PMU is enabled during regular processing as well as interrupt processing).
--memory-usage={
all|[begin][:timed][:end][:PERIOD[s|m|h]]}
Controls the collection and reporting of memory usage data. Current memory use can be measured
at any or all (
all) of:
• the beginning (
begin) of the run,
• periodically (timed) throughout the run, or
• at the end (end) of the run.
When making timed measurements, current memory use is sampled every PERIOD number of
seconds (default if no qualifier is given), minutes, or hours.
Only samples which show a difference in memory utilization from the previous sample are saved
and reported to reduce the volume of data. No memory usage data is collected or reported unless
the option is used.
This measurement can be made in conjunction with any Caliper measurement. This option is only
available on HP-UX 11i v2 or later and with
--scope=process measurement runs.
--pbo-data-type=arc-stride|dcache
Controls the type of data collected when you use the HP compilers’ +Oprofile=collect option.
Choose
arc-stride to collect arc counts, stride data, or both (depending on which have been
enabled at compile time).
Choose
dcache to collect data cache miss data.
Default:
arc-stride.
HP-UX 11i Version 3: September 2010 − 19 − Hewlett-Packard Company 19