ctest_submit.rst 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  1. ctest_submit
  2. ------------
  3. Submit results to a dashboard server.
  4. ::
  5. ctest_submit([PARTS ...] [FILES ...]
  6. [RETRY_COUNT count]
  7. [RETRY_DELAY delay]
  8. [RETURN_VALUE res]
  9. [QUIET]
  10. )
  11. By default all available parts are submitted if no PARTS or FILES are
  12. specified. The PARTS option lists a subset of parts to be submitted.
  13. Valid part names are:
  14. ::
  15. Start = nothing
  16. Update = ctest_update results, in Update.xml
  17. Configure = ctest_configure results, in Configure.xml
  18. Build = ctest_build results, in Build.xml
  19. Test = ctest_test results, in Test.xml
  20. Coverage = ctest_coverage results, in Coverage.xml
  21. MemCheck = ctest_memcheck results, in DynamicAnalysis.xml
  22. Notes = Files listed by CTEST_NOTES_FILES, in Notes.xml
  23. ExtraFiles = Files listed by CTEST_EXTRA_SUBMIT_FILES
  24. Upload = Files prepared for upload by ctest_upload(), in Upload.xml
  25. Submit = nothing
  26. The FILES option explicitly lists specific files to be submitted.
  27. Each individual file must exist at the time of the call.
  28. The RETRY_DELAY option specifies how long in seconds to wait after a
  29. timed-out submission before attempting to re-submit.
  30. The RETRY_COUNT option specifies how many times to retry a timed-out
  31. submission.
  32. The QUIET option suppresses all non-error messages that would have
  33. otherwise been printed by this call to ctest_submit().
  34. Submit to CDash Upload API
  35. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  36. ::
  37. ctest_submit(CDASH_UPLOAD <file> [CDASH_UPLOAD_TYPE <type>])
  38. This second signature is used to upload files to CDash via the CDash
  39. file upload API. The api first sends a request to upload to CDash along
  40. with a content hash of the file. If CDash does not already have the file,
  41. then it is uploaded. Along with the file, a CDash type string is specified
  42. to tell CDash which handler to use to process the data.