summaryrefslogtreecommitdiffstats
path: root/Help/command/ctest_submit.rst
blob: 6fa119193cddef498256598b3890f044649badcf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
ctest_submit
------------

Submit results to a dashboard server.

::

  ctest_submit([PARTS ...] [FILES ...]
               [RETRY_COUNT count]
               [RETRY_DELAY delay]
               [RETURN_VALUE res]
               [QUIET]
               )

By default all available parts are submitted if no PARTS or FILES are
specified.  The PARTS option lists a subset of parts to be submitted.
Valid part names are:

::

  Start      = nothing
  Update     = ctest_update results, in Update.xml
  Configure  = ctest_configure results, in Configure.xml
  Build      = ctest_build results, in Build.xml
  Test       = ctest_test results, in Test.xml
  Coverage   = ctest_coverage results, in Coverage.xml
  MemCheck   = ctest_memcheck results, in DynamicAnalysis.xml
  Notes      = Files listed by CTEST_NOTES_FILES, in Notes.xml
  ExtraFiles = Files listed by CTEST_EXTRA_SUBMIT_FILES
  Upload     = Files prepared for upload by ctest_upload(), in Upload.xml
  Submit     = nothing

The FILES option explicitly lists specific files to be submitted.
Each individual file must exist at the time of the call.

The RETRY_DELAY option specifies how long in seconds to wait after a
timed-out submission before attempting to re-submit.

The RETRY_COUNT option specifies how many times to retry a timed-out
submission.

The QUIET option suppresses all non-error messages that would have
otherwise been printed by this call to ctest_submit().

Submit to CDash Upload API
^^^^^^^^^^^^^^^^^^^^^^^^^^

::

  ctest_submit(CDASH_UPLOAD <file> [CDASH_UPLOAD_TYPE <type>])

This second signature is used to upload files to CDash via the CDash
file upload API. The api first sends a request to upload to CDash along
with a content hash of the file. If CDash does not already have the file,
then it is uploaded. Along with the file, a CDash type string is specified
to tell CDash which handler to use to process the data.