ctest_submit.rst 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  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. )
  10. By default all available parts are submitted if no PARTS or FILES are
  11. specified. The PARTS option lists a subset of parts to be submitted.
  12. Valid part names are:
  13. ::
  14. Start = nothing
  15. Update = ctest_update results, in Update.xml
  16. Configure = ctest_configure results, in Configure.xml
  17. Build = ctest_build results, in Build.xml
  18. Test = ctest_test results, in Test.xml
  19. Coverage = ctest_coverage results, in Coverage.xml
  20. MemCheck = ctest_memcheck results, in DynamicAnalysis.xml
  21. Notes = Files listed by CTEST_NOTES_FILES, in Notes.xml
  22. ExtraFiles = Files listed by CTEST_EXTRA_SUBMIT_FILES
  23. Upload = Files prepared for upload by ctest_upload(), in Upload.xml
  24. Submit = nothing
  25. The FILES option explicitly lists specific files to be submitted.
  26. Each individual file must exist at the time of the call.
  27. The RETRY_DELAY option specifies how long in seconds to wait after a
  28. timed-out submission before attempting to re-submit.
  29. The RETRY_COUNT option specifies how many times to retry a timed-out
  30. submission.
  31. ::
  32. ctest_submit([CDASH_UPLOAD file]
  33. [CDASH_UPLOAD_TYPE type_string])
  34. This second signature is used to upload files to CDash via the CDash
  35. file upload API. The api first sends a request to upload to CDash along
  36. with the md5 sum of the file. If CDash does not already have the file,
  37. then it is uploaded. Along with the file, a CDash type string is specified
  38. to tell CDash which handler to use to process the data.