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 -ofilename [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. 115).

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. 77).

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 --durationoption 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

30 Getting Started with the HP Caliper Command-Line Interface