ctest_start.rst 1.1 KB

12345678910111213141516171819202122232425
  1. ctest_start
  2. -----------
  3. Starts the testing for a given model
  4. ::
  5. ctest_start(Model [TRACK <track>] [APPEND] [source [binary]] [QUIET])
  6. Starts the testing for a given model. The command should be called
  7. after the binary directory is initialized. If the 'source' and
  8. 'binary' directory are not specified, it reads the
  9. :variable:`CTEST_SOURCE_DIRECTORY` and :variable:`CTEST_BINARY_DIRECTORY`.
  10. If the track is
  11. specified, the submissions will go to the specified track. If APPEND
  12. is used, the existing TAG is used rather than creating a new one based
  13. on the current time stamp. If ``QUIET`` is used, CTest will suppress any
  14. non-error messages that it otherwise would have printed to the console.
  15. If the :variable:`CTEST_CHECKOUT_COMMAND` variable
  16. (or the :variable:`CTEST_CVS_CHECKOUT` variable)
  17. is set, its content is treated as command-line. The command is
  18. invoked with the current working directory set to the parent of the source
  19. directory, even if the source directory already exists. This can be used
  20. to create the source tree from a version control repository.