2015-11-06 22:55:41 +01:00
|
|
|
---
|
|
|
|
set: 2
|
|
|
|
code: 208
|
|
|
|
title: Already Reported
|
|
|
|
---
|
|
|
|
|
2015-11-09 01:28:54 +01:00
|
|
|
Used inside a DAV: propstat response element to avoid enumerating the internal
|
|
|
|
members of multiple bindings to the same collection repeatedly.
|
2015-11-07 06:31:20 +01:00
|
|
|
|
|
|
|
For each binding to a collection inside the request's scope, only one will be
|
|
|
|
reported with a 200 status, while subsequent DAV:response elements for all other
|
|
|
|
bindings will use the 208 status, and no DAV:response elements for their
|
|
|
|
descendants are included.
|
2015-11-07 02:41:41 +01:00
|
|
|
|
|
|
|
Note that the 208 status will only occur for "Depth: infinity" requests, and
|
|
|
|
that it is of particular importance when the multiple collection bindings cause
|
2015-11-09 19:23:21 +01:00
|
|
|
a bind loop<sup>[1](#ref-1)</sup>.
|
2015-11-07 02:41:41 +01:00
|
|
|
|
|
|
|
A client can request the DAV:resource-id property in a PROPFIND request to
|
|
|
|
guarantee that they can accurately reconstruct the binding structure of a
|
|
|
|
collection with multiple bindings to a single resource.
|
|
|
|
|
|
|
|
For backward compatibility with clients not aware of the 208 status code
|
|
|
|
appearing in multistatus response bodies, it SHOULD NOT be used unless the
|
|
|
|
client has signaled support for this specification using the "DAV" request
|
2015-11-09 19:23:21 +01:00
|
|
|
header<sup>[2](#ref-2)</sup>. Instead, a [508 Loop Detected](/508) status should
|
2015-11-09 01:28:54 +01:00
|
|
|
be returned when a binding loop is discovered. This allows the server to return
|
|
|
|
the 508 as the top-level return status, if it discovers it before it started the
|
2015-11-07 02:41:41 +01:00
|
|
|
response, or in the middle of a multistatus, if it discovers it in the middle of
|
|
|
|
streaming out a multistatus response.
|
|
|
|
|
2015-11-09 01:28:54 +01:00
|
|
|
---
|
|
|
|
|
2015-11-09 19:23:21 +01:00
|
|
|
* <span id="ref-1"><sup>1</sup> URI Mappings Created by a New Binding
|
|
|
|
[RFC5842 Section 2.2][2]</span>
|
|
|
|
* <span id="ref-2"><sup>2</sup> 'DAV' Request Header
|
|
|
|
[RFC5842 Section 8.2][3]</span>
|
2015-11-09 01:28:54 +01:00
|
|
|
* Source: [RFC5842 Section 7.1][1]
|
2015-11-07 02:41:41 +01:00
|
|
|
|
2015-11-07 04:03:35 +01:00
|
|
|
[1]: <http://tools.ietf.org/html/rfc5842#section-7.1>
|
|
|
|
[2]: <http://tools.ietf.org/html/rfc5842#section-2.2>
|
|
|
|
[3]: <http://tools.ietf.org/html/rfc5842#section-8.2>
|