HP Caliper 5.3 User Guide (5900-1558, February 2011)

-f or --options-file

-file options_file

Specifies a text file containing a list of HP Caliper command-line options separated by spaces or

line breaks.

You can also use an options file to specify an HP Caliper measurement as well as the application

to be profiled and its arguments.

Any option you specify on the command line overrides the corresponding setting in the options

file.

HP Caliper places the contents of the options file in the position occupied by the -f option in the

command line. HP Caliper displays an error if the contents of the options file create an invalid

condition.

For example, if you place the application to be profiled and its arguments in an options file called

myopts, then HP Caliper reports an error given this command line:

$ caliper -f myopts fprof -o out.text

The command succeeds if reordered this way:

$ caliper fprof -o out.text -f myopts

-h or -?

Displays the short version of the help text.

For the long version of the help text, use -H or --help.

-H or --help

Displays the long version of the help text.

For the short version of the help text, use -h or -?.

-m or --metrics

This option has two forms: -m cpu_event and -m event_set

-m cpu_event

This form is used to specify one or more CPU events to measure:

-m cpu_event[[:threshold=int][:privilege-level-mask=level]][,cpu_event[:...]]

You can change the default CPU events recorded for any of the following measurements:

• alat

• branch

• cycles

• dcache

• dtlb

• ecount

• fprof

• icache

• itlb

• pmu_trace

-f or --options-file 49