Running the HP Caliper Sampled Call Graph Profile

You can start HP Caliper from the command line, a shell script, or your program's Makefile to produce a sampled call graph profile.

The syntax is:

caliper scgprof [caliper_options] program [program_arguments]

This measurement uses the --branch-sampling-specoption to control the sampling of the branch trace buffer (BTB)/execution trace buffer (ETB), which produces the statistical call graph. For more information, see “--branch-sampling-spec” (p. 55).

The following command creates a summary call graph profile report in the file named results.save when profiling the program wordplay. The string “abcdefghi” is an argument to the wordplay program.

$ caliper scgprof -o results.save --descr all -r state:instr wordplay abcdefghi

Sampled Call Graph Text Report Example

An example report is shown in Figure 25 (page 124). This report is the result of this command line:

$ caliper scgprof -o results.save --descr all -r state:instr wordplay abcdefghi

Running the HP Caliper Sampled Call Graph Profile 123