summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2014-12-11 15:32:42 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2014-12-11 15:33:42 -0400
commitc4ff79b1a460a3526c6772ab754cb34e5f7f3dd2 (patch)
tree80bea71f1d453348cb2d0a92ce10e463aab9259e /doc
parent4e88f7e9af6a776347649047f2473e470a729ed9 (diff)
Expand checkurl to support recommended filename, and multi-file-urls
This commit was sponsored by an anonymous bitcoiner.
Diffstat (limited to 'doc')
-rw-r--r--doc/design/external_special_remote_protocol.mdwn16
1 files changed, 11 insertions, 5 deletions
diff --git a/doc/design/external_special_remote_protocol.mdwn b/doc/design/external_special_remote_protocol.mdwn
index 072c5a1a2..76d25bf08 100644
--- a/doc/design/external_special_remote_protocol.mdwn
+++ b/doc/design/external_special_remote_protocol.mdwn
@@ -181,12 +181,18 @@ while it's handling a request.
Indicates that the CLAIMURL url will be handled by this remote.
* `CLAIMURL-FAILURE`
Indicates that the CLAIMURL url wil not be handled by this remote.
-* `CHECKURL-SIZE Size`
+* `CHECKURL-CONTENTS Size|UNKNOWN Filename`
+ Indicates that the requested url has been verified to exist.
+ The Size is the size in bytes, or use "UNKNOWN" if the size could not be
+ determined.
+ The Filename can be empty (in which case a default is used),
+ or can specify a filename that is suggested to be used for this url.
+* `CHECKURL-MULTI Url Size|UNKNOWN Filename ...`
Indicates that the requested url has been verified to exist,
- and its size is known. The size is in bytes.
-* `CHECKURL-SIZEUNKNOWN`
- Indicates that the requested url has been verified to exist,
- but its size could not be determined.
+ and contains multiple files, which can each be accessed using
+ their own url.
+ Note that since a list is returned, neither the Url nor the Filename
+ can contain spaces.
* `CHECKURL-FAILURE`
Indicates that the requested url could not be accessed.
* `UNSUPPORTED-REQUEST`