| |||
| Home > Using the Command Line > Command line options | |||
Every one of the table reports available in the ARM Workbench IDE is also available from the command line. This mode of operation makes it easy to script the analysis process, so you can create fully automated comparisons of reports for a variety of ARM microprocessors. You can also test against a variety of data samples and generate any of the resulting reports.
All of the options shown can be called using the short one-letter call, or using the more verbose '--' call. A '/' also works in calling single letter options in DOS in place of the '-'. Every option is called using the same basic syntax: armprorep [options] [file_list]
-h, -?, --help-
Provides the version information and a short description of each command
line option available with armprorep.
-v, --version - Provides copyright
information and the current version number of the ARM Profiler.
-o, --output - Sends all output
text into the specified file.
-m, --merge - Merges multiple
analysis files into a single file. For this option, the first name
in the [file_list] is the name of the newly
merged output file. For example: armprorep -m output_file
analysis_file_1 analysis_file_2 analysis_file_3. The --merge takes
precedence over the other options in this list. If --merge is
called on the command line, all other options are ignored. See chapter ten
for more information on merging analysis files.
-a, --all - Produces every
table report and the code view report and outputs it to your shell.
The syntax for this and all of the reporting command line options
is as follows: armprorep -a analysis_file. If
more than one analysis file is listed, all of the reports are provided
for each analysis file given.
-n, --callchain - Provides
the call chains report for the specified analysis files.
-s, --codeview - Provides the
disassembly section of the code view report for the specified analysis
files.
-c, --classes - Provides the
classes report for the specified analysis files. As a standard C
file does not have an associated classes report, this option is
only available if the analysis file was created using C++.
-f, --files - Provides the
files report for the specified analysis files.
-p, --functions - Provides
the functions report for the specified analysis files.
-t, --tabs - To be used in
conjunction with the command line reporting options, this command
changes the formatting of the command line output to tab-delimited.
By default, the command line reports are output to your shell using spaces
so that the columns line up neatly. If you want to output data to
a file easily digested by a spreadsheet application, use the -t
option and the > command line output command
to produce a tab-delimited file, for example: armprorep
-p -t analysis_file > output_file.tab
-e, --csv - This option, used
in the same manner as --tabs, produces output separated
by commas. Use in conjunction with the output command to create
csv files from the command line.
--call_chain - This option
enables you to specify clock speed if you have the sample rate set
to Estimated Cycles. This option is only
available for hardware profiling. Do no use this option when profiling
with an RTSM.