-f or --options-file

-fileoptions_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 -foption 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 -?

-h or -?

Displays the short version of the help text.

For the long version of the help text, use -Hor --help.

-H or --help

-H or --help

Displays the long version of the help text.

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

-m or --metrics

This option has two forms: -mcpu_event and -mevent_set

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