-build

Rebuilds and relinks all files in the specified build configuration(s).

-clean

Removes any intermediate and output files.

-compdb

Generates a JSON compilation database of the project. By default, the output is generated as compile_commands.json. You can specify the filename with the -output option.

-cspybat_cmds

Generates a command line for cspybat based on the content in the .ewp and .ewd file and prints it to stdout. You can specify the file type with the -output_type option. Note that the project .ewd file must be located in the same directory as your project.ewp file.

-cstat_analyze

Analyzes the project using C-STAT and generates information about the number of messages. For more information, see the C-STAT® Static Analysis Guide.

-cstat_clean

Deletes the C-STAT output directory for the project. For more information, see the C-STAT® Static Analysis Guide.

-cstat_cmds

Generates the file cstatcommands.txt and check files with the selected checks for the analysis based on the project, in the C-STAT output directory. cstatcommands.txt contains links to the check files. For more information, see the C-STAT® Static Analysis Guide.

-cstat_report

Generates a full report in HTML format in the C-STAT output directory, based on the analysis. For more information, see the C-STAT® Static Analysis Guide.

-fail_fast

Use together with either the -build or the -make operating mode command to stop the build process at the first error.

-jsondb

Generates a JSON description of the project. The format is based on the compiler database format but also contains the linking, custom, and conversion steps of the build. Optionally, you can specify the -output option to name the output file, and the -tool option to run a tool or set of tools. By default, the output is generated in the file $PROJ_DIR$/config/project_jsondb.json.

The database contains entries on how to build the project on the format:

[
   {
      "arguments" : [ Comma-separated list of arguments],
      "directory" : "The directory in which to perform the 
                     action",
      "file" : "The input file",
      "output" : "The output file",
      "type" : "Name of the tool"
   }
]

In case of multiple inputs or multiple outputs, the "output" or "file" tag is replaced by "outputs" or "files" followed by a comma-separated list of the files:

[
   {
      "arguments" : [ Comma-separated list of arguments],
      "directory" : "The directory in which to perform the 
                     action",
      "files" : [Comma-separated list of files],
      "outputs" : [Comma-separated list of files],
      "type" : "Name of the tool"
   }
]

-make

Brings the specified build configuration(s) up to date by compiling, assembling, and linking only the files that have changed since the last build. This is the default operating mode.

-ninja

Generates a ninja build file based on the project structure. Optionally, you can specify the -tool option to run a tool or set of tools.

-log

Specifies the level of build message logging. Choose between:

-output

-output filename

Use together with the -jsondb operating mode command to specify the name and the location of the output file.

-output_type

-output_type filetype

Use together with the -cspybat_cmds operating mode command to specify the file type for a command line file set. Choose between:

The file set includes a *.driver.xcl, a *.general.xcl, and a master file of the specified file type. The files contain absolute paths and therefore cannot be moved to other computers or placed in a version control system

-parallel

-parallel number

Specifies the number of parallel processes to run the compiler in to make better use of the cores in the CPU.

-tool

-tool type|list

Use together with either the -jsondb or the -ninja operating mode command to run a specific set of tools. Running iarbuild -tool list lists the available tool options.

For example, iarbuild MyProject.ewp -ninja Debug -tool BuildTools will generate a ninja file with all the build tools nodes in the project.

-varfile

-varfile filename

Makes custom-defined argument variables become defined in a workspace scope available to the build engine by specifying the file to use. See Configure Custom Argument Variables dialog box.