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

Generates a manifest file that contains the C-STAT checks that you want to perform. Use this file as input to the icstat tool. By default, the filename will be cstat_checks.txt. Use the -output option to specify a different name. For more information, see the C-STAT® Static Analysis Guide.

-cstat_clean

Deletes the C-STAT database file 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_config

Generates a C-STAT configuration file based on the contents of the project file. By default, the filename will be cstat_config.yaml. Use the -output option to specify a different name. For more information, see The C-STAT configuration file.

-cstat_config_file

Uses a C-STAT configuration file for the C-STAT analysis, overriding any previously specified options in the project. For more information, see The C-STAT configuration file. This option can only be used together with -cstat_analyze or -cstat_cmds.

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

-launch_json

Exports the current debug configuration as a JSON file, to be reused in the future or shared with a colleague or IAR Technical Support. By default, the filename will be launch.json and the file will be saved in the project directory. Use the -output option to specify a different name or location.

-log

Specifies the level of build message logging. Choose between:

-output

-output filename

Use together with some other commands to specify the name and the location of the output file.

-output_type

-output_type {bat|ps|sh}

Use together with the -cspybat_cmds operating mode command to specify the file type for a command line file set. The file type is one of:

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.

clangd_compile_commands

Invokes an external utility to generate a clangd compatible JSON compilation database of a CMake build directory. By default, the output is generated as compile_commands.json. You can specify the filename with the -output option.

This command invokes an external utility and must be specified using the -E option. See the invocation syntax above.

cstat_analyze

Invokes C-STAT to analyze a project that is not based on an Embedded Workbench project file (.ewp)—a CMake build directory or a JSON compilation database (compile_commands.json)—and generates information about the number of messages. For more information, see the C-STAT® Static Analysis Guide.

This command invokes an external utility and must be specified using the -E option. See the invocation syntax above.