Skip to content

Commit 6a12581

Browse files
committed
Addressed comment
1 parent 2a934e8 commit 6a12581

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

IETF-RFC.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -763,8 +763,10 @@ To create a Share, the Sending Server SHOULD make a HTTP POST request
763763
by the Receiving Server.
764764
* OPTIONAL expiration (integer)
765765
The expiration time for the OCM share, in seconds
766-
of UTC time since Unix epoch. If omitted, it is assumed
767-
that the share does not expire.
766+
of UTC time since Unix epoch. If omitted, it is assumed that the
767+
share does not expire. A sender server MAY use it to signal that
768+
the resource represents a cached copy of a dataset that was made
769+
available for an efficient data transfer to the destination server.
768770
* REQUIRED protocol (object)
769771
JSON object with specific options for each protocol.
770772
The supported protocols are: - `webdav`, to access the data -
@@ -801,9 +803,13 @@ To create a Share, the Sending Server SHOULD make a HTTP POST request
801803
being granted to the remote resource. If omitted, it defaults to
802804
`['remote']`. A subset of: - `remote` signals the recipient that
803805
the resource is available for remote access and interactive
804-
browsing. - `datatx` signals the recipient to transfer the
805-
resource from the given URI. The recipient MAY delegate a
806-
third-party service to execute the data transfer on their behalf.
806+
browsing. - `datatx` signals the recipient that the resource is
807+
available for data transfer. If no expiration is given, the share
808+
is suitable e.g. for sync use-cases, whereas if an expiration date
809+
is set, the above clause MAY apply and the recipient SHOULD notify
810+
the sender upon completing the data transfer, in order to ease
811+
cache operations on the Sending Server. The recipient MAY delegate
812+
a third-party service to execute the data transfer on their behalf.
807813
- REQUIRED uri (string)
808814
A URI to access the Remote Resource. The URI
809815
SHOULD be relative, in which case the prefix

0 commit comments

Comments
 (0)