HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

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. 114).
Using the HP Caliper Advisor
One way to get started using HP Caliper quickly is to use the HP Caliper Advisor. See “Using the
HP Caliper Advisor” (p. 76).
Restrictions on Using HP Caliper
Some restrictions are:
• When HP Caliper detaches from a process, it can affect the I/O relationship between the user
and that process. An example is an application that reads stdin from the user; e.g., caliper
ecount top If HP Caliper is sent a SIGINT (or the --duration option is given), it will
detach from the 'top' process, which will break the I/O between the user and 'top'. Text typed
into the terminal window will no longer be sent to the 'top' process, and the curses library
used by 'top' will break the stty settings in the terminal window.
• Shared library support does not include instrumented measurements ( cgprof, and fcount
measurements) of the dld.so and uld.so system libraries.
• It is not possible to debug an application while it is being measured by HP Caliper.
• These measurements measure and report only aggregated results of multithreaded programs:
ecount•
• fcount
• fcover
• HP Caliper only measures native Integrity servers programs, not PA-RISC programs running
in emulation mode.
• HP Caliper might not be able to measure handwritten assembly code that performs address
arithmetic or does not follow the standard run-time conventions.
• HP Caliper cannot make measurements for dynamically generated code with these
measurements:
• cgprof
• fcount
• fcover
Using the HP Caliper Advisor 29