2013-10-15 19:17:36 +04:00
|
|
|
ctest_build
|
|
|
|
-----------
|
|
|
|
|
|
|
|
Build the project.
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
ctest_build([BUILD build_dir] [TARGET target] [RETURN_VALUE res]
|
|
|
|
[APPEND][NUMBER_ERRORS val] [NUMBER_WARNINGS val])
|
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
Builds the given build directory and stores results in Build.xml. If no
|
|
|
|
``BUILD`` is given, the :variable:`CTEST_BINARY_DIRECTORY` variable is used.
|
2013-10-15 19:17:36 +04:00
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
The ``TARGET`` variable can be used to specify a build target. If none is
|
2013-10-15 19:17:36 +04:00
|
|
|
specified, the "all" target will be built.
|
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
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
|
2013-10-15 19:17:36 +04:00
|
|
|
of build errors and warnings detected.
|
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
The ``APPEND`` option marks results for append to those previously
|
|
|
|
submitted to a dashboard server since the last :command:`ctest_start`. Append
|
2013-10-15 19:17:36 +04:00
|
|
|
semantics are defined by the dashboard server in use.
|
2014-05-23 21:45:33 +04:00
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
The ``QUIET`` option suppresses any CTest-specific non-error output
|
2015-02-17 21:41:40 +03:00
|
|
|
that would have been printed to the console otherwise. The summary
|
|
|
|
of warnings / errors, as well as the output from the native build tool
|
|
|
|
is unaffected by this option.
|
|
|
|
|
2015-05-07 20:04:21 +03:00
|
|
|
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
|
2014-05-23 21:45:33 +04:00
|
|
|
:module:`ProcessorCount` for an example.
|