HP Caliper User's Guide

append
Adds the report results to the end of an existing file that has the specified
name.
create
Creates a file with the specified name and writes the report results to the
file. Replaces any existing file with the specified name.
Default value is create.
When you generate multiprocess reports, you can specify whether results are combined
in a single report file or in individual files by process:
per-process
Creates individual report files for each process with program name
appended to each file.
shared
Creates a single file containing the results for all processes. This is
the default setting.
unique
Appends the process ID to the data file name.
When saving information per process, you can specify a nonexistent directory for the
file name and HP Caliper will create the directory and put all the files in the new
directory. For example:
-o newdir/outfile,p
This approach creates the newdir directory, which contains the output files for each
process measured.
NOTE: The -o option is also used with the caliper info command and with the
caliper advise command. See “How to Display Reference Information About CPU
Counters or HP Caliper Report Types” (p. 133) and “Command Line to Invoke the
Advisor” (p. 104).
-p or --process
-p default|all|root|root-forks|[some:][(OPT1 ,...)]PATTERN
Specifies which processes in the process tree should be measured.
root
Measures only the root process.
root-forks
Measures the root process and processes forked from it.
The default setting is the same as all.
For more information, see “Specifying Processes to Measure” (p. 127).
-r or --report-details
Specifies the level of program detail in reports.
This option has two forms, depending on how it is used:
• For the Function Details section of a PMU histogram report
• For the fcover report
68 HP Caliper Options