RFC 6578 - Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV)

<!DOCTYPE html> <html data-bs-theme="auto" lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title> RFC 6578 - Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV) </title> <meta name="viewport" content="width=device-width, initial-scale=1"> <link href="https://static.ietf.org/fonts/inter/import.css" rel="stylesheet"> <link href="https://static.ietf.org/fonts/noto-sans-mono/import.css" rel="stylesheet"> <link rel="stylesheet" href="https://static.ietf.org/dt/12.28.2/ietf/css/document_html_referenced.css"> <script type="module" crossorigin="" src="https://static.ietf.org/dt/12.28.2/assets/embedded-e653257c.js"></script> <link href="https://static.ietf.org/dt/12.28.2/assets/create-pinia-singleton-091c62b7.js" type="text/javascript" crossorigin="anonymous" rel="modulepreload" as="script" /> <link href="https://static.ietf.org/dt/12.28.2/assets/Scrollbar-7de50899.js" type="text/javascript" crossorigin="anonymous" rel="modulepreload" as="script" /> <script src="https://static.ietf.org/dt/12.28.2/ietf/js/document_html.js"></script> <script src="https://static.ietf.org/dt/12.28.2/ietf/js/theme.js"></script> <link rel="alternate" type="application/atom+xml" title="Document changes" href="/feed/document-changes/rfc6578/"> <meta name="description" content="Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV) (RFC 6578, )" > <link rel="apple-touch-icon" sizes="180x180" href="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-180.png"> <link rel="icon" sizes="32x32" href="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-32.png"> <link rel="icon" sizes="16x16" href="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-16.png"> <link rel="manifest" href="/site.webmanifest"> <link rel="mask-icon" href="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-mask.svg" color="#ffffff"> <meta name="msapplication-TileColor" content="#ffffff"> <meta name="theme-color" content="#ffffff"> <meta property="og:title" content="RFC 6578: Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV)"> <meta property="og:url" content="https://datatracker.ietf.org/doc/html/rfc6578"> <link rel="canonical" href="https://datatracker.ietf.org/doc/html/rfc6578"> <meta property="og:site_name" content="IETF Datatracker"> <meta property="og:description" content="This specification defines an extension to Web Distributed Authoring and Versioning (WebDAV) that allows efficient synchronization of the contents of a WebDAV collection. [STANDARDS-TRACK]"> <meta property="og:type" content="article"> <meta property="og:image" content="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-card.png"> <meta property="og:image:alt" content="Logo of the IETF"> <meta property="article:section" content="IETF - Internet Engineering Task Force"> <meta property="og:image:type" content="image/png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="630"> <meta name="twitter:card" content="summary_large_image"> <meta property="article:author" content="Cyrus Daboo"> <meta property="article:author" content="Arnaud Quillaud"> <style> .diff-form .select2-selection__rendered { direction: rtl; text-align: left; } </style> </head> <body> <noscript><iframe class="status" title="Site status" src="/status/latest"></iframe></noscript> <div class="vue-embed" data-component="Status"></div> <div class="btn-toolbar sidebar-toolbar position-fixed top-0 end-0 m-2 m-lg-3 d-print-none"> <div class="dropdown"> <button class="btn btn-outline-secondary btn-sm me-1 dropdown-toggle d-flex align-items-center" id="bd-theme" type="button" aria-expanded="false" data-bs-toggle="dropdown" aria-label="Toggle theme"> <i class="theme-icon-active bi bi-circle-half"></i> </button> <ul class="dropdown-menu" aria-labelledby="bd-theme"> <li> <button type="button" class="dropdown-item d-flex align-items-center" data-bs-theme-value="light" aria-pressed="false"> <i class="me-2 opacity-50 theme-icon bi bi-sun-fill"></i> Light<i class="bi bi-check2 ms-auto d-none"></i> </button> </li> <li> <button type="button" class="dropdown-item d-flex align-items-center" data-bs-theme-value="dark" aria-pressed="false"> <i class="me-2 opacity-50 theme-icon bi bi-moon-stars-fill"></i> Dark<i class="bi bi-check2 ms-auto d-none"></i> </button> </li> <li> <button type="button" class="dropdown-item d-flex align-items-center active" data-bs-theme-value="auto" aria-pressed="true"> <i class="me-2 opacity-50 theme-icon bi bi-circle-half"></i> Auto<i class="bi bi-check2 ms-auto d-none"></i> </button> </li> </ul> </div> <button class="btn btn-outline-secondary btn-sm sidebar-toggle" type="button" data-bs-toggle="collapse" data-bs-target="#sidebar" aria-expanded="true" aria-controls="sidebar" aria-label="Toggle metadata sidebar" title="Toggle metadata sidebar"> <i class="bi bi-arrow-bar-left sidebar-shown"></i> <i class="bi bi-arrow-bar-right sidebar-collapsed"></i> </button> </div> <nav class="navbar bg-light-subtle px-1 fixed-top d-print-none d-md-none"> <a class="nav-link ps-1" href="/doc/rfc6578/"> RFC 6578 <br class="d-sm-none"> <span class="ms-sm-3 badge rounded-pill badge-ps"> Proposed Standard </span> </a> <button class="navbar-toggler p-1" type="button" data-bs-toggle="collapse" data-bs-target="#docinfo-collapse" aria-controls="docinfo-collapse" aria-expanded="false" aria-label="Show document information"> <span class="navbar-toggler-icon small"></span> </button> <div class="navbar-nav navbar-nav-scroll overscroll-none collapse pt-1" id="docinfo-collapse"> <div class="bg-light-subtle p-0"> <table class="table table-sm table-borderless small"> <tbody class="meta align-top"> <tr> <th scope="row"></th> <th scope="row">Title</th> <td class="edit"></td> <td>Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV)</td> </tr> </tbody> <tbody class="meta align-top "> <tr> <th scope="row">Document</th> <th scope="row">Document type</th> <td class="edit"></td> <td> <span class="text-success">RFC - Proposed Standard </span> <br>March 2012 <br> <a class="btn btn-sm btn-warning" title="Click to report an error in the document." href="https://www.rfc-editor.org/errata.php#reportnew" target="_blank"> Report errata </a> <div> Was <a href="/doc/draft-daboo-webdav-sync/08/">draft-daboo-webdav-sync</a> (individual in app area) </div> </td> </tr> <tr> <td></td> <th scope="row">Select version</th> <td class="edit"></td> <td> <ul class="revision-list pagination pagination-sm text-center flex-wrap my-0"> <li class="page-item"> <a class="page-link" href="/doc/html/draft-daboo-webdav-sync-08" rel="nofollow"> 08 </a> </li> <li class="page-item rfc active"> <a class="page-link" href="/doc/html/rfc6578"> RFC 6578 </a> </li> </ul> </td> </tr> <tr> <td></td> <th scope="row">Compare versions</th> <td class="edit"></td> <td> <form class="form-horizontal diff-form" action="https://author-tools.ietf.org/iddiff" method="get" target="_blank"> <select class="form-select form-select-sm mb-1 select2-field" data-max-entries="1" data-width="resolve" data-allow-clear="false" data-minimum-input-length="0" aria-label="From revision" name="url1"> <option value="rfc6578"> RFC 6578 </option> <option value="draft-daboo-webdav-sync-08" selected> draft-daboo-webdav-sync-08 </option> <option value="draft-daboo-webdav-sync-07"> draft-daboo-webdav-sync-07 </option> <option value="draft-daboo-webdav-sync-06"> draft-daboo-webdav-sync-06 </option> <option value="draft-daboo-webdav-sync-05"> draft-daboo-webdav-sync-05 </option> <option value="draft-daboo-webdav-sync-04"> draft-daboo-webdav-sync-04 </option> <option value="draft-daboo-webdav-sync-03"> draft-daboo-webdav-sync-03 </option> <option value="draft-daboo-webdav-sync-02"> draft-daboo-webdav-sync-02 </option> <option value="draft-daboo-webdav-sync-01"> draft-daboo-webdav-sync-01 </option> <option value="draft-daboo-webdav-sync-00"> draft-daboo-webdav-sync-00 </option> </select> <select class="form-select form-select-sm mb-1 select2-field" data-max-entries="1" data-width="resolve" data-allow-clear="false" data-minimum-input-length="0" aria-label="To revision" name="url2"> <option value="rfc6578" selected> RFC 6578 </option> <option value="draft-daboo-webdav-sync-08"> draft-daboo-webdav-sync-08 </option> <option value="draft-daboo-webdav-sync-07"> draft-daboo-webdav-sync-07 </option> <option value="draft-daboo-webdav-sync-06"> draft-daboo-webdav-sync-06 </option> <option value="draft-daboo-webdav-sync-05"> draft-daboo-webdav-sync-05 </option> <option value="draft-daboo-webdav-sync-04"> draft-daboo-webdav-sync-04 </option> <option value="draft-daboo-webdav-sync-03"> draft-daboo-webdav-sync-03 </option> <option value="draft-daboo-webdav-sync-02"> draft-daboo-webdav-sync-02 </option> <option value="draft-daboo-webdav-sync-01"> draft-daboo-webdav-sync-01 </option> <option value="draft-daboo-webdav-sync-00"> draft-daboo-webdav-sync-00 </option> </select> <button type="submit" class="btn btn-primary btn-sm" value="--html" name="difftype"> Side-by-side </button> <button type="submit" class="btn btn-primary btn-sm" value="--hwdiff" name="difftype"> Inline </button> </form> </td> </tr> <tr> <td></td> <th scope="row">Authors</th> <td class="edit"> </td> <td> <span ><a title="Datatracker profile of Cyrus Daboo" href="/person/cyrus@daboo.name" >Cyrus Daboo</a> <a href="mailto:cyrus%40daboo.name" aria-label="Compose email to cyrus@daboo.name" title="Compose email to cyrus@daboo.name"> <i class="bi bi-envelope"></i></a></span>, <span ><a title="Datatracker profile of Arnaud Quillaud" href="/person/arnaud.quillaud@oracle.com" >Arnaud Quillaud</a> <a href="mailto:arnaud.quillaud%40oracle.com" aria-label="Compose email to arnaud.quillaud@oracle.com" title="Compose email to arnaud.quillaud@oracle.com"> <i class="bi bi-envelope"></i></a></span> <br> <a class="btn btn-primary btn-sm mt-1" href="mailto:rfc6578@ietf.org?subject=rfc6578" title="Send email to the document authors">Email authors</a> </td> </tr> <tr> <td></td> <th scope="row"> RFC stream </th> <td class="edit"> </td> <td > <img alt="IETF Logo" class="d-lm-none w-25 mt-1" src="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-white.svg" > <img alt="IETF Logo" class="d-dm-none w-25 mt-1" src="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor.svg" > </td> </tr> <tr> <td></td> <th scope="row"> Other formats </th> <td class="edit"> </td> <td> <div class="buttonlist"> <a class="btn btn-primary btn-sm" target="_blank" href="https://www.rfc-editor.org/rfc/rfc6578.txt"> <i class="bi bi-file-text"></i> txt </a> <a class="btn btn-primary btn-sm" target="_blank" href="https://www.rfc-editor.org/rfc/rfc6578.html"> <i class="bi bi-file-code"></i> html </a> <a class="btn btn-primary btn-sm" download="rfc6578.pdf" target="_blank" href="https://www.rfc-editor.org/rfc/pdfrfc/rfc6578.txt.pdf"> <i class="bi bi-file-pdf"></i> pdf </a> <a class="btn btn-primary btn-sm" target="_blank" href="/doc/rfc6578/bibtex/"> <i class="bi bi-file-ruled"></i> bibtex </a> </div> </td> </tr> </tbody> <tr> <th scope="row"></th> <th scope="row"></th> <td class="edit"></td> <td> <a class="btn btn-sm btn-warning mb-3" target="_blank" href="https://github.com/ietf-tools/datatracker/issues/new/choose"> Report a bug <i class="bi bi-bug"></i> </a> </td> </tr> </table> </div> </div> </nav> <div class="row g-0"> <div class="col-md-9 d-flex justify-content-center lh-sm" data-bs-spy="scroll" data-bs-target="#toc-nav" data-bs-smooth-scroll="true" tabindex="0" id="content"> <div class="rfcmarkup"> <br class="noprint">  <div class="rfcmarkup"><pre>Internet Engineering Task Force (IETF) C. Daboo Request for Comments: 6578 Apple Inc. Category: Standards Track A. Quillaud ISSN: 2070-1721 Oracle March 2012 <span class="h1">Collection Synchronization</span> <span class="h1">for Web Distributed Authoring and Versioning (WebDAV)</span> Abstract This specification defines an extension to Web Distributed Authoring and Versioning (WebDAV) that allows efficient synchronization of the contents of a WebDAV collection. Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in <a href="/doc/html/rfc5741#section-2">Section 2 of RFC 5741</a>. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at <a href="http://www.rfc-editor.org/info/rfc6578">http://www.rfc-editor.org/info/rfc6578</a>. <span class="grey">Daboo & Quillaud Standards Track [Page 1]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-2" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> Copyright Notice Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to <a href="/doc/html/bcp78">BCP 78</a> and the IETF Trust's Legal Provisions Relating to IETF Documents (<a href="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</a>) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English. <span class="grey">Daboo & Quillaud Standards Track [Page 2]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-3" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> Table of Contents <a href="#section-1">1</a>. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-4">4</a> <a href="#section-2">2</a>. Conventions Used in This Document . . . . . . . . . . . . . . <a href="#page-4">4</a> <a href="#section-3">3</a>. WebDAV Synchronization . . . . . . . . . . . . . . . . . . . . <a href="#page-5">5</a> <a href="#section-3.1">3.1</a>. Overview . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-5">5</a> <a href="#section-3.2">3.2</a>. DAV:sync-collection Report . . . . . . . . . . . . . . . . <a href="#page-6">6</a> <a href="#section-3.3">3.3</a>. Depth Behavior . . . . . . . . . . . . . . . . . . . . . . <a href="#page-8">8</a> <a href="#section-3.4">3.4</a>. Types of Changes Reported on Initial Synchronization . . . <a href="#page-9">9</a> 3.5. Types of Changes Reported on Subsequent Synchronizations . . . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a> <a href="#section-3.5.1">3.5.1</a>. Changed Member . . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a> <a href="#section-3.5.2">3.5.2</a>. Removed Member . . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a> <a href="#section-3.6">3.6</a>. Truncation of Results . . . . . . . . . . . . . . . . . . <a href="#page-11">11</a> <a href="#section-3.7">3.7</a>. Limiting Results . . . . . . . . . . . . . . . . . . . . . <a href="#page-12">12</a> <a href="#section-3.8">3.8</a>. Example: Initial DAV:sync-collection Report . . . . . . . <a href="#page-12">12</a> <a href="#section-3.9">3.9</a>. Example: DAV:sync-collection Report with Token . . . . . . <a href="#page-14">14</a> 3.10. Example: Initial DAV:sync-collection Report with Truncation . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-16">16</a> <a href="#section-3.11">3.11</a>. Example: Initial DAV:sync-collection Report with Limit . . <a href="#page-17">17</a> 3.12. Example: DAV:sync-collection Report with Unsupported Limit . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-18">18</a> 3.13. Example: DAV:sync-level Set to Infinite, Initial DAV:sync-collection Report . . . . . . . . . . . . . . . . <a href="#page-19">19</a> <a href="#section-4">4</a>. DAV:sync-token Property . . . . . . . . . . . . . . . . . . . <a href="#page-22">22</a> <a href="#section-5">5</a>. DAV:sync-token Use with If Header . . . . . . . . . . . . . . <a href="#page-22">22</a> <a href="#section-5.1">5.1</a>. Example: If Precondition with PUT . . . . . . . . . . . . <a href="#page-22">22</a> <a href="#section-5.2">5.2</a>. Example: If Precondition with MKCOL . . . . . . . . . . . <a href="#page-23">23</a> <a href="#section-6">6</a>. XML Element Definitions . . . . . . . . . . . . . . . . . . . <a href="#page-24">24</a> <a href="#section-6.1">6.1</a>. DAV:sync-collection XML Element . . . . . . . . . . . . . <a href="#page-24">24</a> <a href="#section-6.2">6.2</a>. DAV:sync-token XML Element . . . . . . . . . . . . . . . . <a href="#page-24">24</a> <a href="#section-6.3">6.3</a>. DAV:sync-level XML Element . . . . . . . . . . . . . . . . <a href="#page-24">24</a> <a href="#section-6.4">6.4</a>. DAV:multistatus XML Element . . . . . . . . . . . . . . . <a href="#page-25">25</a> <a href="#section-7">7</a>. Security Considerations . . . . . . . . . . . . . . . . . . . <a href="#page-25">25</a> <a href="#section-8">8</a>. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-25">25</a> <a href="#section-9">9</a>. References . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-25">25</a> <a href="#section-9.1">9.1</a>. Normative References . . . . . . . . . . . . . . . . . . . <a href="#page-25">25</a> <a href="#section-9.2">9.2</a>. Informative References . . . . . . . . . . . . . . . . . . <a href="#page-26">26</a> <a href="#appendix-A">Appendix A</a>. Backwards-Compatible Handling of Depth . . . . . . . <a href="#page-27">27</a> <a href="#appendix-B">Appendix B</a>. Example of a Client Synchronization Approach . . . . <a href="#page-27">27</a> <span class="grey">Daboo & Quillaud Standards Track [Page 3]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-4" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span> WebDAV [<a href="/doc/html/rfc4918" title=""HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)"">RFC4918</a>] defines the concept of 'collections', which are hierarchical groupings of WebDAV resources on an HTTP [<a href="/doc/html/rfc2616" title=""Hypertext Transfer Protocol -- HTTP/1.1"">RFC2616</a>] server. Collections can be of arbitrary size and depth (i.e., collections within collections). WebDAV clients that cache resource content need a way to synchronize that data with the server (i.e., detect what has changed and update their cache). Currently, this can be done using a WebDAV PROPFIND request on a collection to list all members of a collection along with their DAV:getetag property values, which allows the client to determine which were changed, added, or deleted. However, this does not scale well to large collections, as the XML response to the PROPFIND request will grow with the collection size. This specification defines a new WebDAV report that results in the server returning to the client only information about those member URLs that were added or deleted, or whose mapped resources were changed, since a previous execution of the report on the collection. Additionally, a new property is added to collection resources that is used to convey a "synchronization token" that is guaranteed to change when the collection's member URLs or their mapped resources have changed. <span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. Conventions Used in This Document</span> The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [<a href="/doc/html/rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>]. This document uses XML DTD fragments ([<a href="#ref-W3C.REC-xml-20081126">W3C.REC-xml-20081126</a>], <a href="#section-3.2">Section</a> <a href="#section-3.2">3.2</a>) as a purely notational convention. WebDAV request and response bodies cannot be validated by a DTD due to the specific extensibility rules defined in <a href="/doc/html/rfc4918#section-17">Section 17 of [RFC4918]</a> and due to the fact that all XML elements defined by this specification use the XML namespace name "DAV:". In particular: 1. Element names use the "DAV:" namespace. 2. Element ordering is irrelevant unless explicitly stated otherwise. 3. Extension elements (elements not already defined as valid child elements) may be added anywhere, except when explicitly stated otherwise. <span class="grey">Daboo & Quillaud Standards Track [Page 4]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-5" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> 4. Extension attributes (attributes not already defined as valid for this element) may be added anywhere, except when explicitly stated otherwise. When an XML element type in the "DAV:" namespace is referenced in this document outside of the context of an XML fragment, the string "DAV:" will be prefixed to the element type. This document inherits, and sometimes extends, DTD productions from <a href="/doc/html/rfc4918#section-14">Section 14 of [RFC4918]</a>. <span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. WebDAV Synchronization</span> <span class="h3"><a class="selflink" id="section-3.1" href="#section-3.1">3.1</a>. Overview</span> One way to synchronize data between two entities is to use some form of synchronization token. The token defines the state of the data being synchronized at a particular point in time. It can then be used to determine what has changed between one point in time and another. This specification defines a new WebDAV report that is used to enable client-server collection synchronization based on such a token. In order to synchronize the contents of a collection between a server and client, the server provides the client with a synchronization token each time the synchronization report is executed. That token represents the state of the data being synchronized at that point in time. The client can then present that same token back to the server at some later time, and the server will return only those items that are new, have changed, or were deleted since that token was generated. The server also returns a new token representing the new state at the time the report was run. Typically, the first time a client connects to the server it will need to be informed of the entire state of the collection (i.e., a full list of all member URLs that are currently in the collection). That is done by the client sending an empty token value to the server. This indicates to the server that a full listing is required. As an alternative, the client might choose to do its first synchronization using some other mechanism on the collection (e.g., some other form of batch resource information retrieval such as PROPFIND, SEARCH [<a href="/doc/html/rfc5323" title=""Web Distributed Authoring and Versioning (WebDAV) SEARCH"">RFC5323</a>], or specialized REPORTs such as those defined in CalDAV [<a href="/doc/html/rfc4791" title=""Calendaring Extensions to WebDAV (CalDAV)"">RFC4791</a>] and CardDAV [<a href="/doc/html/rfc6352" title=""CardDAV: vCard Extensions to Web Distributed Authoring and Versioning (WebDAV)"">RFC6352</a>]) and ask for the <span class="grey">Daboo & Quillaud Standards Track [Page 5]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-6" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> DAV:sync-token property to be returned. This property (defined in <a href="#section-4">Section 4</a>) contains the same token that can be used later to issue a DAV:sync-collection report. In some cases, a server might only wish to maintain a limited amount of history about changes to a collection. In that situation, it will return an error to the client when the client presents a token that is "out of date". At that point, the client has to fall back to synchronizing the entire collection by re-running the report request using an empty token value. Typically, a client will use the synchronization report to retrieve the list of changes and will follow that with requests to retrieve the content of changed resources. It is possible that additional changes to the collection could occur between the time of the synchronization report and resource content retrieval, which could result in an inconsistent view of the collection. When clients use this method of synchronization, they need to be aware that such additional changes could occur and track them, e.g., by differences between the ETag values returned in the synchronization report and those returned when actually fetching resource content, by using conditional requests as described in <a href="#section-5">Section 5</a>, or by repeating the synchronization process until no changes are returned. <span class="h3"><a class="selflink" id="section-3.2" href="#section-3.2">3.2</a>. DAV:sync-collection Report</span> If the DAV:sync-collection report is implemented by a WebDAV server, then the server MUST list the report in the "DAV:supported-report-set" property on any collection that supports synchronization. To implement the behavior for this report, a server needs to keep track of changes to any member URLs and their mapped resources in a collection (as defined in <a href="/doc/html/rfc4918#section-3">Section 3 of [RFC4918]</a>). This includes noting the addition of new member URLs, the changes to the mapped resources of existing member URLs, and the removal of member URLs. The server will track each change and provide a synchronization "token" to the client that describes the state of the server at a specific point in time. This "token" is returned as part of the response to the "sync-collection" report. Clients include the last token they got from the server in the next "sync-collection" report that they execute, and the server provides the changes from the previous state (represented by the token) to the current state (represented by the new token returned). The synchronization token itself MUST be treated as an "opaque" string by the client, i.e., the actual string data has no specific meaning or syntax. However, the token MUST be a valid URI to allow <span class="grey">Daboo & Quillaud Standards Track [Page 6]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-7" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> its use in an If precondition request header (see <a href="#section-5">Section 5</a>). For example, a simple implementation of such a token could be a numeric counter that counts each change as it occurs and relates that change to the specific object that changed. The numeric value could be appended to a "base" URI to form the valid sync-token. Marshalling: The request-URI MUST identify a collection. The request body MUST be a DAV:sync-collection XML element (see <a href="#section-6.1">Section 6.1</a>), which MUST contain one DAV:sync-token XML element, one DAV:sync-level element, and one DAV:prop XML element, and MAY contain a DAV:limit XML element. This report is only defined when the Depth header has value "0"; other values result in a 400 (Bad Request) error response. Note that <a href="/doc/html/rfc3253#section-3.6">[RFC3253], Section 3.6</a>, states that if the Depth header is not present, it defaults to a value of "0". The response body for a successful request MUST be a DAV:multistatus XML element, which MUST contain one DAV:sync-token element in addition to one DAV:response element for each member URL that was added, has had its mapped resource changed, or was deleted since the last synchronization operation as specified by the DAV:sync-token provided in the request. A given member URL MUST appear only once in the response. In the case where multiple member URLs of the request-URI are mapped to the same resource, if the resource is changed, each member URL MUST be returned in the response. The content of each DAV:response element differs depending on how the member was altered: For members that have changed (i.e., are new or have had their mapped resource modified), the DAV:response MUST contain at least one DAV:propstat element and MUST NOT contain any DAV:status element. For members that have been removed, the DAV:response MUST contain one DAV:status with a value set to '404 Not Found' and MUST NOT contain any DAV:propstat element. For members that are collections and are unable to support the DAV:sync-collection report, the DAV:response MUST contain one DAV:status with a value set to '403 Forbidden', a DAV:error containing DAV:supported-report or DAV:sync-traversal-supported (see <a href="#section-3.3">Section 3.3</a> for which is appropriate) and MUST NOT contain any DAV:propstat element. <span class="grey">Daboo & Quillaud Standards Track [Page 7]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-8" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> The conditions under which each type of change can occur are further described in <a href="#section-3.5">Section 3.5</a>. Preconditions: (DAV:valid-sync-token): The DAV:sync-token element value MUST be a valid token previously returned by the server for the collection targeted by the request-URI. Servers might need to invalidate tokens previously returned to clients. Doing so will cause the clients to fall back to doing full synchronization using the report, though that will not require clients to download resources that are already cached and have not changed. Even so, servers MUST limit themselves to invalidating tokens only when absolutely necessary. Specific reasons include: * Servers might be unable to maintain all of the change data for a collection due to storage or performance reasons, e.g., servers might only be able to maintain up to 3 weeks worth of changes to a collection, or only up to 10,000 total changes, or not wish to maintain changes for a deleted collection. * Change to server implementation: servers might be upgraded to a new implementation that tracks the history in a different manner, and thus previous synchronization history is no longer valid. Postconditions: (DAV:number-of-matches-within-limits): The number of changes reported in the response must fall within the client-specified limit. This condition might be triggered if a client requests a limit on the number of responses (as per <a href="#section-3.7">Section 3.7</a>), but the server is unable to truncate the result set at or below that limit. <span class="h3"><a class="selflink" id="section-3.3" href="#section-3.3">3.3</a>. Depth Behavior</span> Servers MUST support only Depth:0 behavior with the DAV:sync-collection report, i.e., the report targets only the collection being synchronized in a single request. However, clients do need to "scope" the synchronization to different levels within that collection -- specifically, immediate children (level "1") and all children at any depth (level "infinite"). To specify which level to use, clients MUST include a DAV:sync-level XML element in the request. <span class="grey">Daboo & Quillaud Standards Track [Page 8]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-9" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> o When the client specifies the DAV:sync-level XML element with a value of "1", only appropriate internal member URLs (immediate children) of the collection specified as the request-URI are reported. o When the client specifies the DAV:sync-level XML element with a value of "infinite", all appropriate member URLs of the collection specified as the request-URI are reported, provided child collections themselves also support the DAV:sync-collection report. o DAV:sync-token values returned by the server are not specific to the value of the DAV:sync-level XML element used in the request. As such, clients MAY use a DAV:sync-token value from a request with one DAV:sync-level XML element value for a similar request with a different DAV:sync-level XML element value; however, the utility of this is limited. Note that when a server supports a DAV:sync-level XML element with a value of "infinite", it might not be possible to synchronize some child collections within the collection targeted by the report. When this occurs, the server MUST include a DAV:response element for the child collection with status 403 (Forbidden). The 403 response MUST be sent once, when the collection is first reported to the client. In addition, the server MUST include a DAV:error element in the DAV:response element, indicating one of two possible causes for this: The DAV:sync-collection report is not supported at all on the child collection. The DAV:error element MUST contain the DAV:supported-report element. The server is unwilling to report results for the child collection when a DAV:sync-collection report with the DAV:sync-level XML element set to "infinite" is executed on a parent resource. This might happen when, for example, the synchronization state of the collection resource is controlled by another subsystem. In such cases clients can perform the DAV:sync-collection report directly on the child collection instead. The DAV:error element MUST contain the DAV:sync-traversal-supported element. <span class="h3"><a class="selflink" id="section-3.4" href="#section-3.4">3.4</a>. Types of Changes Reported on Initial Synchronization</span> When the DAV:sync-collection request contains an empty DAV:sync-token element, the server MUST return all member URLs of the collection (taking account of the DAV:sync-level XML element value as per <a href="#section-3.3">Section 3.3</a>, and optional truncation of the result set as per <a href="#section-3.6">Section 3.6</a>) and it MUST NOT return any removed member URLs. All types of member (collection or non-collection) MUST be reported. <span class="grey">Daboo & Quillaud Standards Track [Page 9]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-10" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <span class="h3"><a class="selflink" id="section-3.5" href="#section-3.5">3.5</a>. Types of Changes Reported on Subsequent Synchronizations</span> When the DAV:sync-collection request contains a valid value for the DAV:sync-token element, two types of member URL state changes can be returned (changed or removed). This section defines what triggers each of these to be returned. It also clarifies the case where a member URL might have undergone multiple changes between two synchronization report requests. In all cases, the DAV:sync-level XML element value (as per <a href="#section-3.3">Section 3.3</a>) and optional truncation of the result set (as per <a href="#section-3.6">Section 3.6</a>) are taken into account by the server. <span class="h4"><a class="selflink" id="section-3.5.1" href="#section-3.5.1">3.5.1</a>. Changed Member</span> A member URL MUST be reported as changed if it has been newly mapped as a member of the target collection since the request sync-token was generated (e.g., when a new resource has been created as a child of the collection). For example, this includes member URLs that have been newly mapped as the result of a COPY, MOVE, BIND [<a href="/doc/html/rfc5842" title=""Binding Extensions to Web Distributed Authoring and Versioning (WebDAV)"">RFC5842</a>], or REBIND [<a href="/doc/html/rfc5842" title=""Binding Extensions to Web Distributed Authoring and Versioning (WebDAV)"">RFC5842</a>] request. All types of member URL (collection or non-collection) MUST be reported. In the case where a mapping between a member URL and the target collection was removed, then a new mapping with the same URI was created, the member URL MUST be reported as changed and MUST NOT be reported as removed. A member URL MUST be reported as changed if its mapped resource's entity tag value (defined in <a href="/doc/html/rfc2616#section-3.11">Section 3.11 of [RFC2616]</a>) has changed since the request sync-token was generated. A member URL MAY be reported as changed if the user issuing the request was granted access to this member URL, due to access control changes. Collection member URLs MUST be returned as changed if they are mapped to an underlying resource (i.e., entity body) and if the entity tag associated with that resource changes. There is no guarantee that changes to members of a collection will result in a change in any entity tag of that collection, so clients cannot rely on a series of reports using the DAV:sync-level XML element value set to "1" at multiple levels to track all changes within a collection. Instead, a DAV:sync-level XML element with a value of "infinite" has to be used. <span class="h4"><a class="selflink" id="section-3.5.2" href="#section-3.5.2">3.5.2</a>. Removed Member</span> A member MUST be reported as removed if its mapping under the target collection has been removed since the request sync-token was generated, and it has not been remapped since it was removed. For <span class="grey">Daboo & Quillaud Standards Track [Page 10]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-11" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> example, this includes members that have been unmapped as the result of a MOVE, UNBIND [<a href="/doc/html/rfc5842" title=""Binding Extensions to Web Distributed Authoring and Versioning (WebDAV)"">RFC5842</a>], or REBIND [<a href="/doc/html/rfc5842" title=""Binding Extensions to Web Distributed Authoring and Versioning (WebDAV)"">RFC5842</a>] operation. This also includes collection members that have been removed, including ones that themselves do not support the DAV:sync-collection report. If a member was added (and its mapped resource possibly modified), then removed between two synchronization report requests, it MUST be reported as removed. This ensures that a client that adds a member is informed of the removal of the member, if the removal occurs before the client has had a chance to execute a synchronization report. A member MAY be reported as removed if the user issuing the request no longer has access to this member, due to access control changes. For a report with the DAV:sync-level XML element value set to "infinite", where a collection is removed, the server MUST NOT report the removal of any members of the removed collection. Clients MUST assume that if a collection is reported as being removed, then all members of that collection have also been removed. <span class="h3"><a class="selflink" id="section-3.6" href="#section-3.6">3.6</a>. Truncation of Results</span> A server MAY limit the number of member URLs in a response, for example, to limit the amount of work expended in processing a request, or as the result of an explicit limit set by the client. If the result set is truncated, the response MUST use status code 207 (Multi-Status), return a DAV:multistatus response body, and indicate a status of 507 (Insufficient Storage) for the request-URI. That DAV:response element SHOULD include a DAV:error element with the DAV:number-of-matches-within-limits precondition, as defined in [<a href="/doc/html/rfc3744" title=""Web Distributed Authoring and Versioning (WebDAV) Access Control Protocol"">RFC3744</a>] (<a href="#section-9.2">Section 9.2</a>). DAV:response elements for all the changes being reported are also included. When truncation occurs, the DAV:sync-token value returned in the response MUST represent the correct state for the partial set of changes returned. That allows the client to use the returned DAV:sync-token to fetch the next set of changes. In this way, the client can effectively "page" through the entire set of changes in a consistent manner. Clients MUST handle the 507 status on the request-URI in the response to the report. For example, consider a server that records changes using a strictly increasing integer to represent a "revision number" and uses that quantity as the DAV:sync-token value (appropriately encoded as a URI). Assume the last DAV:sync-token used by the client was <span class="grey">Daboo & Quillaud Standards Track [Page 11]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-12" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> "http://example.com/sync/10", and since then 15 additional changes to different resources have occurred. If the client executes a DAV:sync-collection request with a DAV:sync-token of "http://example.com/sync/10", without a limit, the server would return 15 DAV:response elements and a DAV:sync-token with value "http://example.com/sync/25". But if the server chooses to limit responses to at most 10 changes, then it would return only 10 DAV:response elements and a DAV:sync-token with value "http://example.com/sync/20", together with an additional DAV:response element for the request-URI with a status code of 507. Subsequently, the client can reissue the request with the DAV:sync-token value returned from the server and fetch the remaining 5 changes. <span class="h3"><a class="selflink" id="section-3.7" href="#section-3.7">3.7</a>. Limiting Results</span> A client can limit the number of results returned by the server through use of the DAV:limit element (<a href="/doc/html/rfc5323#section-5.17">[RFC5323], Section 5.17</a>) in the request body. This is useful when clients have limited space or bandwidth for the results. If a server is unable to truncate the result at or below the requested number, then it MUST fail the request with a DAV:number-of-matches-within-limits postcondition error. When the results can be correctly limited by the server, the server MUST follow the rules above for indicating a result set truncation to the client. <span class="h3"><a class="selflink" id="section-3.8" href="#section-3.8">3.8</a>. Example: Initial DAV:sync-collection Report</span> In this example, the client is making its first synchronization request to the server, so the DAV:sync-token element in the request is empty. It also asks for the DAV:getetag property and for a proprietary property. The server responds with the items currently in the targeted collection. The current synchronization token is also returned. >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Depth: 0 Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token/> <D:sync-level>1</D:sync-level> <span class="grey">Daboo & Quillaud Standards Track [Page 12]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-13" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <D:prop xmlns:R="urn:ns.example.com:boxschema"> <D:getetag/> <R:bigbox/> </D:prop> </D:sync-collection> >> Response << HTTP/1.1 207 Multi-Status Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:multistatus xmlns:D="DAV:"> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/test.doc</D:href> <D:propstat> <D:prop> <D:getetag>"00001-abcd1"</D:getetag> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"> <R:BoxType>Box type A</R:BoxType> </R:bigbox> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/vcard.vcf</D:href> <D:propstat> <D:prop> <D:getetag>"00002-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/calendar.ics</D:href> <span class="grey">Daboo & Quillaud Standards Track [Page 13]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-14" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <D:propstat> <D:prop> <D:getetag>"00003-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:sync-token>http://example.com/ns/sync/1234</D:sync-token> </D:multistatus> <span class="h3"><a class="selflink" id="section-3.9" href="#section-3.9">3.9</a>. Example: DAV:sync-collection Report with Token</span> In this example, the client is making a synchronization request to the server and is using the DAV:sync-token element returned from the last report it ran on this collection. The server responds, listing the items that have been added, changed, or removed. The (new) current synchronization token is also returned. >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token>http://example.com/ns/sync/1234</D:sync-token> <D:sync-level>1</D:sync-level> <D:prop xmlns:R="urn:ns.example.com:boxschema"> <D:getetag/> <R:bigbox/> </D:prop> </D:sync-collection> <span class="grey">Daboo & Quillaud Standards Track [Page 14]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-15" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> >> Response << HTTP/1.1 207 Multi-Status Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:multistatus xmlns:D="DAV:"> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/file.xml</D:href> <D:propstat> <D:prop> <D:getetag>"00004-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/vcard.vcf</D:href> <D:propstat> <D:prop> <D:getetag>"00002-abcd2"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/test.doc</D:href> <D:status>HTTP/1.1 404 Not Found</D:status> </D:response> <D:sync-token>http://example.com/ns/sync/1238</D:sync-token> </D:multistatus> <span class="grey">Daboo & Quillaud Standards Track [Page 15]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-16" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <span class="h3"><a class="selflink" id="section-3.10" href="#section-3.10">3.10</a>. Example: Initial DAV:sync-collection Report with Truncation</span> In this example, the client is making its first synchronization request to the server, so the DAV:sync-token element in the request is empty. It also asks for the DAV:getetag property. The server responds with the items currently in the targeted collection but truncated at two items. The synchronization token for the truncated result set is returned. >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Depth: 0 Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token/> <D:sync-level>1</D:sync-level> <D:prop> <D:getetag/> </D:prop> </D:sync-collection> >> Response << HTTP/1.1 207 Multi-Status Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:multistatus xmlns:D="DAV:"> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/test.doc</D:href> <D:propstat> <D:prop> <D:getetag>"00001-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <span class="grey">Daboo & Quillaud Standards Track [Page 16]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-17" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <D:href >http://webdav.example.com/home/cyrusdaboo/vcard.vcf</D:href> <D:propstat> <D:prop> <D:getetag>"00002-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/</D:href> <D:status>HTTP/1.1 507 Insufficient Storage</D:status> <D:error><D:number-of-matches-within-limits/></D:error> </D:response> <D:sync-token>http://example.com/ns/sync/1233</D:sync-token> </D:multistatus> <span class="h3"><a class="selflink" id="section-3.11" href="#section-3.11">3.11</a>. Example: Initial DAV:sync-collection Report with Limit</span> In this example, the client is making its first synchronization request to the server, so the DAV:sync-token element in the request is empty. It requests a limit of 1 for the responses returned by the server. It also asks for the DAV:getetag property. The server responds with the items currently in the targeted collection, but truncated at one item. The synchronization token for the truncated result set is returned. >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Depth: 0 Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token/> <D:sync-level>1</D:sync-level> <D:limit> <D:nresults>1</D:nresults> </D:limit> <D:prop> <D:getetag/> </D:prop> </D:sync-collection> <span class="grey">Daboo & Quillaud Standards Track [Page 17]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-18" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> >> Response << HTTP/1.1 207 Multi-Status Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:multistatus xmlns:D="DAV:"> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/test.doc</D:href> <D:propstat> <D:prop> <D:getetag>"00001-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <D:href >http://webdav.example.com/home/cyrusdaboo/</D:href> <D:status>HTTP/1.1 507 Insufficient Storage</D:status> <D:error><D:number-of-matches-within-limits/></D:error> </D:response> <D:sync-token>http://example.com/ns/sync/1232</D:sync-token> </D:multistatus> <span class="h3"><a class="selflink" id="section-3.12" href="#section-3.12">3.12</a>. Example: DAV:sync-collection Report with Unsupported Limit</span> In this example, the client is making a synchronization request to the server with a valid DAV:sync-token element value. It requests a limit of 100 for the responses returned by the server. It also asks for the DAV:getetag property. The server is unable to limit the results to the maximum specified by the client, so it responds with a 507 status code and appropriate postcondition error code. >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Depth: 0 Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <span class="grey">Daboo & Quillaud Standards Track [Page 18]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-19" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token>http://example.com/ns/sync/1232</D:sync-token> <D:sync-level>1</D:sync-level> <D:limit> <D:nresults>100</D:nresults> </D:limit> <D:prop> <D:getetag/> </D:prop> </D:sync-collection> >> Response << HTTP/1.1 507 Insufficient Storage Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:error xmlns:D="DAV:"> <D:number-of-matches-within-limits/> </D:error> <span class="h3"><a class="selflink" id="section-3.13" href="#section-3.13">3.13</a>. Example: DAV:sync-level Set to Infinite, Initial</span> <span class="h3"> DAV:sync-collection Report</span> In this example, the client is making its first synchronization request to the server, so the DAV:sync-token element in the request is empty, and it is using DAV:sync-level set to "infinite". It also asks for the DAV:getetag property and for a proprietary property. The server responds with the items currently in the targeted collection. The current synchronization token is also returned. The collection /home/cyrusdaboo/collection1/ exists and has one child resource that is also reported. The collection /home/cyrusdaboo/ collection2/ exists but has no child resources. The collection /home/cyrusdaboo/shared/ is returned with a 403 status indicating that a collection exists, but it is unable to report on changes within it in the scope of the current DAV:sync-level "infinite" report. Instead, the client can try a DAV:sync-collection report directly on the collection URI. <span class="grey">Daboo & Quillaud Standards Track [Page 19]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-20" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> >> Request << REPORT /home/cyrusdaboo/ HTTP/1.1 Host: webdav.example.com Depth: 0 Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:sync-collection xmlns:D="DAV:"> <D:sync-token/> <D:sync-level>infinite</D:sync-level> <D:prop xmlns:R="urn:ns.example.com:boxschema"> <D:getetag/> <R:bigbox/> </D:prop> </D:sync-collection> >> Response << HTTP/1.1 207 Multi-Status Content-Type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:multistatus xmlns:D="DAV:"> <D:response> <D:href>/home/cyrusdaboo/collection1/</D:href> <D:propstat> <D:prop> <D:getetag>"00001-abcd1"</D:getetag> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"> <R:BoxType>Box type A</R:BoxType> </R:bigbox> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <D:href>/home/cyrusdaboo/collection1/test.doc</D:href> <D:propstat> <D:prop> <D:getetag>"00001-abcd1"</D:getetag> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"> <R:BoxType>Box type A</R:BoxType> <span class="grey">Daboo & Quillaud Standards Track [Page 20]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-21" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> </R:bigbox> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> </D:response> <D:response> <D:href>/home/cyrusdaboo/collection2/</D:href> <D:propstat> <D:prop> <D:getetag/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:response> <D:href>/home/cyrusdaboo/calendar.ics</D:href> <D:propstat> <D:prop> <D:getetag>"00003-abcd1"</D:getetag> </D:prop> <D:status>HTTP/1.1 200 OK</D:status> </D:propstat> <D:propstat> <D:prop> <R:bigbox xmlns:R="urn:ns.example.com:boxschema"/> </D:prop> <D:status>HTTP/1.1 404 Not Found</D:status> </D:propstat> </D:response> <D:response> <D:href>/home/cyrusdaboo/shared/</D:href> <D:status>HTTP/1.1 403 Forbidden</D:status> <D:error><D:sync-traversal-supported/></D:error> </D:response> <D:sync-token>http://example.com/ns/sync/1234</D:sync-token> </D:multistatus> <span class="grey">Daboo & Quillaud Standards Track [Page 21]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-22" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. DAV:sync-token Property</span> Name: sync-token Namespace: DAV: Purpose: Contains the value of the synchronization token as it would be returned by a DAV:sync-collection report. Value: Any valid URI. Protected: MUST be protected because this value is created and controlled by the server. COPY/MOVE behavior: This property value is dependent on the final state of the destination resource, not the value of the property on the source resource. Description: The DAV:sync-token property MUST be defined on all resources that support the DAV:sync-collection report. It contains the value of the synchronization token as it would be returned by a DAV:sync-collection report on that resource at the same point in time. It SHOULD NOT be returned by a PROPFIND DAV:allprop request (as defined in <a href="/doc/html/rfc4918#section-14.2">Section 14.2 of [RFC4918]</a>). Definition: <!ELEMENT sync-token #PCDATA>  <span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. DAV:sync-token Use with If Header</span> WebDAV provides an If precondition header that allows for "state tokens" to be used as preconditions on HTTP requests (as defined in <a href="/doc/html/rfc4918#section-10.4">Section 10.4 of [RFC4918]</a>). This specification allows the DAV:sync-token value to be used as one such token in an If header. By using this, clients can ensure requests only complete when there have been no changes to the content of a collection, by virtue of an unchanged DAV:sync-token value. Servers MUST support use of DAV:sync-token values in If request headers. <span class="h3"><a class="selflink" id="section-5.1" href="#section-5.1">5.1</a>. Example: If Precondition with PUT</span> In this example, the client has already used the DAV:sync-collection report to synchronize the collection /home/cyrusdaboo/collection/. Now it wants to add a new resource to the collection, but only if there have been no other changes since the last synchronization. <span class="grey">Daboo & Quillaud Standards Track [Page 22]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-23" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> Note that because the DAV:sync-token is defined on the collection and not on the resource targeted by the request, the If header value needs to use the "Resource_Tag" construct for the header syntax to correctly identify that the supplied state token refers to the collection resource. >> Request << PUT /home/cyrusdaboo/collection/newresource.txt HTTP/1.1 Host: webdav.example.com If: </home/cyrusdaboo/collection/> (<http://example.com/ns/sync/12345>) Content-Type: text/plain; charset="utf-8" Content-Length: xxxx Some content here... >> Response << HTTP/1.1 201 Created <span class="h3"><a class="selflink" id="section-5.2" href="#section-5.2">5.2</a>. Example: If Precondition with MKCOL</span> In this example, the client has already used the DAV:sync-collection report to synchronize the collection /home/cyrusdaboo/collection/. Now, it wants to add a new collection to the collection, but only if there have been no other changes since the last synchronization. Note that because the DAV:sync-token is defined on the collection and not on the resource targeted by the request, the If header value needs to use the "Resource_Tag" construct for the header syntax to correctly identify that the supplied state token refers to the collection resource. In this case, the request fails as another change has occurred to the collection corresponding to the supplied DAV:sync-token. >> Request << MKCOL /home/cyrusdaboo/collection/child/ HTTP/1.1 Host: webdav.example.com If: </home/cyrusdaboo/collection/> (<http://example.com/ns/sync/12346>) <span class="grey">Daboo & Quillaud Standards Track [Page 23]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-24" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> >> Response << HTTP/1.1 412 Precondition Failed <span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. XML Element Definitions</span> <span class="h3"><a class="selflink" id="section-6.1" href="#section-6.1">6.1</a>. DAV:sync-collection XML Element</span> Name: sync-collection Namespace: DAV: Purpose: WebDAV report used to synchronize data between client and server. Description: See <a href="#section-3">Section 3</a>. <!ELEMENT sync-collection (sync-token, sync-level, limit?, prop)>   <span class="h3"><a class="selflink" id="section-6.2" href="#section-6.2">6.2</a>. DAV:sync-token XML Element</span> Name: sync-token Namespace: DAV: Purpose: The synchronization token provided by the server and returned by the client. Description: See <a href="#section-3">Section 3</a>. <!ELEMENT sync-token CDATA>  <span class="h3"><a class="selflink" id="section-6.3" href="#section-6.3">6.3</a>. DAV:sync-level XML Element</span> Name: sync-level Namespace: DAV: Purpose: Indicates the "scope" of the synchronization report request. Description: See <a href="#section-3.3">Section 3.3</a>. <span class="grey">Daboo & Quillaud Standards Track [Page 24]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-25" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <!ELEMENT sync-level CDATA>  <span class="h3"><a class="selflink" id="section-6.4" href="#section-6.4">6.4</a>. DAV:multistatus XML Element</span> Name: multistatus Namespace: DAV: Purpose: Extends the DAV:multistatus element to include synchronization details. Description: See <a href="#section-3">Section 3</a>. <!ELEMENT multistatus (response*, responsedescription?, sync-token?) >    <span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>. Security Considerations</span> This extension does not introduce any new security concerns beyond those already described in HTTP and WebDAV. <span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>. Acknowledgments</span> The following individuals contributed their ideas and support for writing this specification: Bernard Desruisseaux, Werner Donne, Mike Douglass, Ciny Joy, Andrew McMillan, Julian Reschke, and Wilfredo Sanchez. We would like to thank the Calendaring and Scheduling Consortium for facilitating interoperability testing for early implementations of this specification. <span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>. References</span> <span class="h3"><a class="selflink" id="section-9.1" href="#section-9.1">9.1</a>. Normative References</span> [<a id="ref-RFC2119">RFC2119</a>] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", <a href="/doc/html/bcp14">BCP 14</a>, <a href="/doc/html/rfc2119">RFC 2119</a>, March 1997. [<a id="ref-RFC2616">RFC2616</a>] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", <a href="/doc/html/rfc2616">RFC 2616</a>, June 1999. <span class="grey">Daboo & Quillaud Standards Track [Page 25]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-26" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> [<a id="ref-RFC3253">RFC3253</a>] Clemm, G., Amsden, J., Ellison, T., Kaler, C., and J. Whitehead, "Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning)", <a href="/doc/html/rfc3253">RFC 3253</a>, March 2002. [<a id="ref-RFC3744">RFC3744</a>] Clemm, G., Reschke, J., Sedlar, E., and J. Whitehead, "Web Distributed Authoring and Versioning (WebDAV) Access Control Protocol", <a href="/doc/html/rfc3744">RFC 3744</a>, May 2004. [<a id="ref-RFC4918">RFC4918</a>] Dusseault, L., "HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)", <a href="/doc/html/rfc4918">RFC 4918</a>, June 2007. [<a id="ref-RFC5323">RFC5323</a>] Reschke, J., Reddy, S., Davis, J., and A. Babich, "Web Distributed Authoring and Versioning (WebDAV) SEARCH", <a href="/doc/html/rfc5323">RFC 5323</a>, November 2008. [<a id="ref-W3C.REC-xml-20081126">W3C.REC-xml-20081126</a>] Sperberg-McQueen, C., Yergeau, F., Paoli, J., Maler, E., and T. Bray, "Extensible Markup Language (XML) 1.0 (Fifth Edition)", World Wide Web Consortium Recommendation REC-xml-20081126, November 2008, <<a href="http://www.w3.org/TR/2008/REC-xml-20081126">http://www.w3.org/TR/2008/REC-xml-20081126</a>>. <span class="h3"><a class="selflink" id="section-9.2" href="#section-9.2">9.2</a>. Informative References</span> [<a id="ref-RFC4791">RFC4791</a>] Daboo, C., Desruisseaux, B., and L. Dusseault, "Calendaring Extensions to WebDAV (CalDAV)", <a href="/doc/html/rfc4791">RFC 4791</a>, March 2007. [<a id="ref-RFC5842">RFC5842</a>] Clemm, G., Crawford, J., Reschke, J., and J. Whitehead, "Binding Extensions to Web Distributed Authoring and Versioning (WebDAV)", <a href="/doc/html/rfc5842">RFC 5842</a>, April 2010. [<a id="ref-RFC6352">RFC6352</a>] Daboo, C., "CardDAV: vCard Extensions to Web Distributed Authoring and Versioning (WebDAV)", <a href="/doc/html/rfc6352">RFC 6352</a>, August 2011. <span class="grey">Daboo & Quillaud Standards Track [Page 26]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-27" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> <span class="h2"><a class="selflink" id="appendix-A" href="#appendix-A">Appendix A</a>. Backwards-Compatible Handling of Depth</span> In prior draft versions of this specification, the Depth request header was used instead of the DAV:sync-level element to indicate the "scope" of the synchronization request. Servers that wish to be backwards compatible with clients conforming to the older specification should do the following: if a DAV:sync-level element is not present in the request body, use the Depth header value as the equivalent value for the missing DAV:sync-level element. <span class="h2"><a class="selflink" id="appendix-B" href="#appendix-B">Appendix B</a>. Example of a Client Synchronization Approach</span> This appendix gives an example of how a client might accomplish collection synchronization using the WebDAV sync report defined in this specification. Note that this is provided purely as an example, and is not meant to be treated as a normative "algorithm" for client synchronization. This example assumes a WebDAV client interacting with a WebDAV server supporting the sync report. The client keeps a local cache of resources in a targeted collection, "/collection/". Local changes are assumed to not occur. The client is only tracking changes to the immediate children of the collection resource. ** Initial State ** The client starts out with an empty local cache. The client starts out with no DAV:sync-token stored for "/collection/". ** Initial Synchronization ** The client issues a sync report request to the server with an empty DAV:sync-token element, and DAV:sync-level set to "1". The request asks for the server to return the DAV:getetag WebDAV property for each resource it reports. <span class="grey">Daboo & Quillaud Standards Track [Page 27]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-28" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> The server returns a response containing the list of current resources (with their associated DAV:getetag properties) as well as a new DAV:sync-token value. The client associates the new DAV:sync-token value with the collection. For each reported resource, the client creates a set of (resource path, DAV:getetag) tuples. For each tuple, the client issues an HTTP GET request to the server to retrieve its content, and updates the (resource path, DAV:getetag) entry in its local cache for that resource with the ETag response header value returned in the GET request. ** Routine Synchronization ** The client issues a sync report request to the server with the DAV:sync-token set to the current cached value from the last sync, and DAV:sync-level set to "1". The request asks for the server to return the DAV:getetag WebDAV property for each resource it reports. The server returns a response containing the list of changes as well as a new DAV:sync-token value. The client associates the new DAV:sync-token value with the collection. * Process Removed Resources * For each resource reported with a 404 response status, the client removes the corresponding resource from its local cache. * Process Resources * For each remaining reported resource, the client creates a new set of (resource path, DAV:getetag) tuples. The client then determines which resources are in the new set but not in the current cache, and which resources are in the new set and the current cache but have a different DAV:getetag value. For each of those, the client issues an HTTP GET request to the server to retrieve the resource content, and updates the (resource path, DAV:getetag) entry in its local cache for that resource with the ETag response header value returned in the GET request. <span class="grey">Daboo & Quillaud Standards Track [Page 28]</span></pre> <hr class='noprint'/><pre class='newpage'><span id="page-29" ></span> <span class="grey"><a href="/doc/html/rfc6578">RFC 6578</a> WebDAV Sync March 2012</span> Authors' Addresses Cyrus Daboo Apple Inc. 1 Infinite Loop Cupertino, CA 95014 USA EMail: cyrus@daboo.name URI: <a href="http://www.apple.com/">http://www.apple.com/</a> Arnaud Quillaud Oracle Corporation 180, Avenue de l'Europe Saint Ismier cedex 38334 France EMail: arnaud.quillaud@oracle.com URI: <a href="http://www.oracle.com/">http://www.oracle.com/</a> Daboo & Quillaud Standards Track [Page 29] </pre></div> </div> </div> <div class="d-print-none col-md-3 bg-light-subtle collapse show" id="sidebar"> <div class="position-fixed border-start sidebar overflow-scroll overscroll-none no-scrollbar"> <div class="d-flex flex-column vh-100 pt-2 pt-lg-3 ps-3 pl-md-2 pl-lg-3"> <div> <a class="btn btn-primary btn-sm" href="/doc/rfc6578/">Datatracker</a> <p class="fw-bold pt-2"> RFC 6578 <br> <span class="text-success">RFC - Proposed Standard </span> </p> </div> <ul class="nav nav-tabs nav-fill small me-2" role="tablist"> <li class="nav-item" role="presentation" title="Document information"> <button class="nav-link px-2" id="docinfo-tab" data-bs-toggle="tab" data-bs-target="#docinfo-tab-pane" type="button" role="tab" aria-controls="docinfo-tab-pane" aria-selected="true"> <i class="bi bi-info-circle"></i><span class="d-none d-md-block d-xl-inline ms-xl-1">Info</span> </button> </li> <li class="nav-item" role="presentation" title="Table of contents"> <button class="nav-link px-2" id="toc-tab" data-bs-toggle="tab" data-bs-target="#toc-tab-pane" type="button" role="tab" aria-controls="toc-tab-pane" aria-selected="false"> <i class="bi bi-list-ol"></i><span class="d-none d-md-block d-xl-inline ms-xl-1">Contents</span> </button> </li> <li class="nav-item" role="presentation" title="Preferences"> <button class="nav-link px-2" id="pref-tab" data-bs-toggle="tab" data-bs-target="#pref-tab-pane" type="button" role="tab" aria-controls="pref-tab-pane" aria-selected="false"> <i class="bi bi-gear"></i><span class="d-none d-md-block d-xl-inline ms-xl-1">Prefs</span> </button> </li> </ul> <div class="overflow-auto tab-content pt-2 me-2"> <div class="tab-pane" id="docinfo-tab-pane" role="tabpanel" aria-labelledby="docinfo-tab" tabindex="0"> <table class="table table-sm table-borderless"> <tbody class="meta align-top "> <tr> <th scope="row">Document</th> <th scope="row">Document type</th> <td class="edit"></td> <td> <span class="text-success">RFC - Proposed Standard </span> <br>March 2012 <br> <a class="btn btn-sm btn-warning" title="Click to report an error in the document." href="https://www.rfc-editor.org/errata.php#reportnew" target="_blank"> Report errata </a> <div> Was <a href="/doc/draft-daboo-webdav-sync/08/">draft-daboo-webdav-sync</a> (individual in app area) </div> </td> </tr> <tr> <td></td> <th scope="row">Select version</th> <td class="edit"></td> <td> <ul class="revision-list pagination pagination-sm text-center flex-wrap my-0"> <li class="page-item"> <a class="page-link" href="/doc/html/draft-daboo-webdav-sync-08" rel="nofollow"> 08 </a> </li> <li class="page-item rfc active"> <a class="page-link" href="/doc/html/rfc6578"> RFC 6578 </a> </li> </ul> </td> </tr> <tr> <td></td> <th scope="row">Compare versions</th> <td class="edit"></td> <td> <form class="form-horizontal diff-form" action="https://author-tools.ietf.org/iddiff" method="get" target="_blank"> <select class="form-select form-select-sm mb-1 select2-field" data-max-entries="1" data-width="resolve" data-allow-clear="false" data-minimum-input-length="0" aria-label="From revision" name="url1"> <option value="rfc6578"> RFC 6578 </option> <option value="draft-daboo-webdav-sync-08" selected> draft-daboo-webdav-sync-08 </option> <option value="draft-daboo-webdav-sync-07"> draft-daboo-webdav-sync-07 </option> <option value="draft-daboo-webdav-sync-06"> draft-daboo-webdav-sync-06 </option> <option value="draft-daboo-webdav-sync-05"> draft-daboo-webdav-sync-05 </option> <option value="draft-daboo-webdav-sync-04"> draft-daboo-webdav-sync-04 </option> <option value="draft-daboo-webdav-sync-03"> draft-daboo-webdav-sync-03 </option> <option value="draft-daboo-webdav-sync-02"> draft-daboo-webdav-sync-02 </option> <option value="draft-daboo-webdav-sync-01"> draft-daboo-webdav-sync-01 </option> <option value="draft-daboo-webdav-sync-00"> draft-daboo-webdav-sync-00 </option> </select> <select class="form-select form-select-sm mb-1 select2-field" data-max-entries="1" data-width="resolve" data-allow-clear="false" data-minimum-input-length="0" aria-label="To revision" name="url2"> <option value="rfc6578" selected> RFC 6578 </option> <option value="draft-daboo-webdav-sync-08"> draft-daboo-webdav-sync-08 </option> <option value="draft-daboo-webdav-sync-07"> draft-daboo-webdav-sync-07 </option> <option value="draft-daboo-webdav-sync-06"> draft-daboo-webdav-sync-06 </option> <option value="draft-daboo-webdav-sync-05"> draft-daboo-webdav-sync-05 </option> <option value="draft-daboo-webdav-sync-04"> draft-daboo-webdav-sync-04 </option> <option value="draft-daboo-webdav-sync-03"> draft-daboo-webdav-sync-03 </option> <option value="draft-daboo-webdav-sync-02"> draft-daboo-webdav-sync-02 </option> <option value="draft-daboo-webdav-sync-01"> draft-daboo-webdav-sync-01 </option> <option value="draft-daboo-webdav-sync-00"> draft-daboo-webdav-sync-00 </option> </select> <button type="submit" class="btn btn-primary btn-sm" value="--html" name="difftype"> Side-by-side </button> <button type="submit" class="btn btn-primary btn-sm" value="--hwdiff" name="difftype"> Inline </button> </form> </td> </tr> <tr> <td></td> <th scope="row">Authors</th> <td class="edit"> </td> <td> <span ><a title="Datatracker profile of Cyrus Daboo" href="/person/cyrus@daboo.name" >Cyrus Daboo</a> <a href="mailto:cyrus%40daboo.name" aria-label="Compose email to cyrus@daboo.name" title="Compose email to cyrus@daboo.name"> <i class="bi bi-envelope"></i></a></span>, <span ><a title="Datatracker profile of Arnaud Quillaud" href="/person/arnaud.quillaud@oracle.com" >Arnaud Quillaud</a> <a href="mailto:arnaud.quillaud%40oracle.com" aria-label="Compose email to arnaud.quillaud@oracle.com" title="Compose email to arnaud.quillaud@oracle.com"> <i class="bi bi-envelope"></i></a></span> <br> <a class="btn btn-primary btn-sm mt-1" href="mailto:rfc6578@ietf.org?subject=rfc6578" title="Send email to the document authors">Email authors</a> </td> </tr> <tr> <td></td> <th scope="row"> RFC stream </th> <td class="edit"> </td> <td > <img alt="IETF Logo" class="d-lm-none w-25 mt-1" src="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor-white.svg" > <img alt="IETF Logo" class="d-dm-none w-25 mt-1" src="https://static.ietf.org/dt/12.28.2/ietf/images/ietf-logo-nor.svg" > </td> </tr> <tr> <td></td> <th scope="row"> Other formats </th> <td class="edit"> </td> <td> <div class="buttonlist"> <a class="btn btn-primary btn-sm" target="_blank" href="https://www.rfc-editor.org/rfc/rfc6578.txt"> <i class="bi bi-file-text"></i> txt </a> <a class="btn btn-primary btn-sm" target="_blank" href="https://www.rfc-editor.org/rfc/rfc6578.html"> <i class="bi bi-file-code"></i> html </a> <a class="btn btn-primary btn-sm" download="rfc6578.pdf" target="_blank" href="https://www.rfc-editor.org/rfc/pdfrfc/rfc6578.txt.pdf"> <i class="bi bi-file-pdf"></i> pdf </a> <a class="btn btn-primary btn-sm" target="_blank" href="/doc/rfc6578/bibtex/"> <i class="bi bi-file-ruled"></i> bibtex </a> </div> </td> </tr> </tbody> </table> <a class="btn btn-sm btn-warning mb-3" target="_blank" href="https://github.com/ietf-tools/datatracker/issues/new/choose"> Report a datatracker bug <i class="bi bi-bug"></i> </a> </div> <div class="tab-pane mb-5" id="toc-tab-pane" role="tabpanel" aria-labelledby="toc-tab" tabindex="0"> <nav class="nav nav-pills flex-column small" id="toc-nav"> </nav> </div> <div class="tab-pane mb-5 small" id="pref-tab-pane" role="tabpanel" aria-labelledby="pref-tab" tabindex="0"> <label class="form-label fw-bold mb-2">Show sidebar by default</label> <div class="btn-group-vertical btn-group-sm d-flex" role="group"> <input type="radio" class="btn-check" name="sidebar" id="on-radio"> <label class="btn btn-outline-primary" for="on-radio">Yes</label> <input type="radio" class="btn-check" name="sidebar" id="off-radio"> <label class="btn btn-outline-primary" for="off-radio">No</label> </div> <label class="form-label fw-bold mt-4 mb-2">Tab to show by default</label> <div class="btn-group-vertical btn-group-sm d-flex" role="group"> <input type="radio" class="btn-check" name="deftab" id="docinfo-radio"> <label class="btn btn-outline-primary" for="docinfo-radio"> <i class="bi bi-info-circle me-1"></i>Info </label> <input type="radio" class="btn-check" name="deftab" id="toc-radio"> <label class="btn btn-outline-primary" for="toc-radio"> <i class="bi bi-list-ol me-1"></i>Contents </label> </div> <label class="form-label fw-bold mt-4 mb-2">HTMLization configuration</label> <div class="btn-group-vertical btn-group-sm d-flex" role="group"> <input type="radio" class="btn-check" name="htmlconf" id="txt-radio"> <label class="btn btn-outline-primary" for="txt-radio" title="This is the traditional HTMLization method."> <i class="bi bi-badge-sd me-1"></i>HTMLize the plaintext </label> <input type="radio" class="btn-check" name="htmlconf" id="html-radio"> <label class="btn btn-outline-primary" for="html-radio" title="This is the modern HTMLization method."> <i class="bi bi-badge-hd me-1"></i>Plaintextify the HTML </label> </div> <label class="form-label fw-bold mt-4 mb-2" for="ptsize">Maximum font size</label> <input type="range" class="form-range" min="7" max="16" id="ptsize" oninput="ptdemo.value = ptsize.value"> <label class="form-label fw-bold mt-4 mb-2">Page dependencies</label> <div class="btn-group-vertical btn-group-sm d-flex" role="group"> <input type="radio" class="btn-check" name="pagedeps" id="inline-radio"> <label class="btn btn-outline-primary" for="inline-radio" title="Generate larger, standalone web pages that do not require network access to render."> <i class="bi bi-box me-1"></i>Inline </label> <input type="radio" class="btn-check" name="pagedeps" id="reference-radio"> <label class="btn btn-outline-primary" for="reference-radio" title="Generate regular web pages that require network access to render."> <i class="bi bi-link-45deg me-1"></i>Reference </label> </div> <label class="form-label fw-bold mt-4 mb-2">Citation links</label> <div class="btn-group-vertical btn-group-sm d-flex" role="group"> <input type="radio" class="btn-check" name="reflinks" id="refsection-radio"> <label class="btn btn-outline-primary" for="refsection-radio" title="Citation links go to the reference section."> <i class="bi bi-arrow-clockwise"></i> Go to reference section </label> <input type="radio" class="btn-check" name="reflinks" id="citation-radio"> <label class="btn btn-outline-primary" for="citation-radio" title="Citation links go directly to the cited document."> <i class="bi bi-link-45deg me-1"></i>Go to linked document </label> </div> </div> </div> </div> </div> </div> </div> <script type="text/javascript"> var _paq = window._paq || []; _paq.push(['disableCookies']); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="//analytics.ietf.org/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', 7]); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script> <noscript><p><img src="//analytics.ietf.org/piwik.php?idsite=7" style="border:0;" alt="" /></p></noscript> <script>(function(){function c(){var b=a.contentDocument||a.contentWindow.document;if(b){var d=b.createElement('script');d.innerHTML="window.__CF$cv$params={r:'8e7248707a62833d',t:'MTczMjM3NjY5MS4wMDAwMDA='};var a=document.createElement('script');a.nonce='';a.src='/cdn-cgi/challenge-platform/scripts/jsd/main.js';document.getElementsByTagName('head')[0].appendChild(a);";b.getElementsByTagName('head')[0].appendChild(d)}}if(document.body){var a=document.createElement('iframe');a.height=1;a.width=1;a.style.position='absolute';a.style.top=0;a.style.left=0;a.style.border='none';a.style.visibility='hidden';document.body.appendChild(a);if('loading'!==document.readyState)c();else if(window.addEventListener)document.addEventListener('DOMContentLoaded',c);else{var e=document.onreadystatechange||function(){};document.onreadystatechange=function(b){e(b);'loading'!==document.readyState&&(document.onreadystatechange=e,c())}}}})();</script></body> </html>

CINXE.COM

RFC 6578 - Collection Synchronization for Web Distributed Authoring and Versioning (WebDAV)