HP Caliper User's Guide
$ kill -s TERM caliper_process_ID
CAUTION: If HP Caliper is measuring processes using instrumentation on HP-UX
(that is, generating a precise measurement), stopping HP Caliper will cause it to forcibly
terminate all processes that are being measured. Any resources used by the processes,
such as shared memory segments, temporary files, and so forth, will not be cleaned
up.
For PMU-only measurements, HP Caliper will simply detach from the processes and
stop. The processes will continue normally.
Showing HP Caliper Options
For HP Caliper short help, including a list of the most commonly used options and
measurements, use:
$ caliper -h
For HP Caliper long help, use:
$ caliper -H
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]
The first command produces a call graph by sampling. The second command (on
HP-UX only) produces an exact call graph. They both produce an enhanced gprof-like
output.
Creating a Text Report for Analysis
To save the report produced by HP Caliper to a file, specify an output file name:
$ caliper measurement -o filename [caliper_options] program [program_arguments]
Creating a Report Based on Your Collected Data
By default, HP Caliper saves the results of a measurement to a database. This allows
you to generate reports with different settings without having to re-run your application.
To create reports based on the database, specify the caliper report command and
the report options you want to use. For example, the following command creates a
report based on the last database you created:
$ caliper report [caliper_report_options]
For more information, see “How HP Caliper Saves Data in Databases” (p. 147).
Basic Tasks: A Quick Reference 39