Specify Perf metrics using a file

The --perf-metrics argument can also take the name of a plain text file:

/path/to/forge/bin/map --profile --target-host={hostname} \
      --perf-metrics=./myevents.txt mpirun ...

myevents.txt lists the events to track on separate lines, such as:

cpu-cycles
bus-cycles
instructions

--perf-metrics=template outputs a more complex template that lists all possible events with accompanying descriptions. Redirect this output to a file and uncomment the events to track, for example:

/path/to/forge/bin/map --target-host={hostname} --perf-metrics=template > myevents.txt

vim myevents.txt

/path/to/forge/bin/map --profile --perf-metrics=myevents.txt mpirun ...