caliper_options Parameters used to customize the performance analysis.
For more information, see “HP Caliper Options” (p. 48).
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
For more information, see “Configuring HP Caliper ” (p. 92).
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
$ kill
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:
$ kill
CAUTION: If HP Caliper is measuring processes using instrumentation on
For
Showing HP Caliper Options
For HP Caliper short help, including a list of the most commonly used options and measurements, use:
$ caliper
For HP Caliper long help, use:
$ caliper
Creating a Call Graph Profile with HP Caliper
To create a call graph profile with HP Caliper, use either of these commands:
$ caliper scgprof [caliper_options] program [program_arguments]
or
$ caliper cgprof [caliper_options] program [program_arguments]
Basic Tasks: A Quick Reference 29