aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2018-07-27 14:01:18 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2018-07-27 14:01:18 +0200
commit3a2ddd883fe1b92c63794897b407280fa166be3b (patch)
treea078d8648ff30e22f94d52aeeed924e83cdc9ddf /doc
parentdfa77ad7a2b7bbbd5ca836bbea4050dc524ff220 (diff)
Document submission simulation
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 1aa01b6..0a798bb 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -126,6 +126,18 @@ mentioned above are always reported with the submission result manifest. Other
errors (for example, internal server errors) might be reported with
unformatted text, including HTML.
+If the submission request contains the \c{simulate} parameter, then the
+submission service simulates the specified outcome of the submission process
+without actually performing any externally visible actions (e.g., publishing
+the package, notifying the submitter, etc). Note that the package submission
+email (\c{submit-email}) is not sent for simulated submissions.
+
+Pre-defined simulation outcome values are \c{internal-error-text},
+\c{internal-error-html}, \c{duplicate-archive}, and \c{success}. The
+simulation outcome is included into the submission request manifest and the
+handler program must at least handle \c{success} but may recognize additional
+outcomes.
+
\h#submit-request-manifest|Submission Request Manifest|
@@ -137,6 +149,7 @@ corresponding to the custom request parameters.
archive: <name>
sha256sum: <sum>
timestamp: <datetime>
+[simulate]: <outcome>
[client-ip]: <string>
[user-agent]: <string>
\