### Navigation

- index
- next |
- previous |
- CMake »
- 3.2.1 Documentation »
- cmake-commands(7) »

# ctest_build

Build the project.

    ctest_build([BUILD build_dir] [TARGET target] [RETURN_VALUE res]
                [APPEND][NUMBER_ERRORS val] [NUMBER_WARNINGS val])

Builds the given build directory and stores results in Build.xml. If no BUILD is given, the CTEST_BINARY_DIRECTORY variable is used.

The TARGET variable can be used to specify a build target. If none is specified, the “all” target will be built.

The RETURN_VALUE option specifies a variable in which to store the return value of the native build tool. The NUMBER_ERRORS and NUMBER_WARNINGS options specify variables in which to store the number of build errors and warnings detected.

The APPEND option marks results for append to those previously submitted to a dashboard server since the last ctest_start. Append semantics are defined by the dashboard server in use.

If set, the contents of the variable CTEST_BUILD_FLAGS are passed as additional arguments to the underlying build command. This can e.g. be used to trigger a parallel build using the -j option of make. See `ProcessorCount` for an example.

### Navigation

- index
- next |
- previous |
- CMake »
- 3.2.1 Documentation »
- cmake-commands(7) »