HP Caliper User's Guide

measurement
The name of a measurement that contains information about
what you want HP Caliper to measure and report.
For more information, see “HP Caliper Measurement
Configuration Files” (p. 57).
caliper_options
Parameters used to customize the performance analysis.
For more information, see “HP Caliper Options” (p. 63).
program
The name of the executable program you want HP Caliper
to measure.
program_arguments
Any number of arguments expected by your executable.
You can use an options file to specify command-line information, including the
measurement, options, program, and program arguments. See “-f or --options-file”
(p. 65) for details.
For more information, see “Configuring HP Caliper ” (p. 121).
Basic Tasks: A Quick Reference
Here is a list of basic tasks and the HP Caliper commands you can use to perform them.
Starting HP Caliper
Once installed, the easiest way to access HP Caliper is to type caliper. For example:
$ caliper myprog
This runs the default measurement, scgprof, on your program in your current directory
and produces a text report to stdout. To run another measurement, just type it:
$ caliper fcount myprog
Stopping HP Caliper
To stop HP Caliper before it finishes measuring your program, enter Ctrl-C, or from
another process use this command:
$ kill -s INT caliper_process_ID
Either of these methods stops the measurement run. HP Caliper then processes the
data collected up to the point where it was stopped and generates a report. There could
be a significant delay before the HP Caliper process terminates.
To stop HP Caliper immediately, without generating data, use this command:
38 Getting Started with the HP Caliper Command-Line Interface