Web Distributed Authoring and Versioning (WebDAV) SEARCH
RFC 5323
| Document | Type |
RFC - Proposed Standard
(November 2008; No errata)
Was draft-reschke-webdav-search (individual in app area)
|
|
|---|---|---|---|
| Last updated | 2015-10-14 | ||
| Stream | IETF | ||
| Formats | plain text pdf html bibtex | ||
| Reviews | |||
| Stream | WG state | (None) | |
| Document shepherd | No shepherd assigned | ||
| IESG | IESG state | RFC 5323 (Proposed Standard) | |
| Consensus Boilerplate | Unknown | ||
| Telechat date | |||
| Responsible AD | Chris Newman | ||
| Send notices to | (None) | ||
Network Working Group J. Reschke, Ed.
Request for Comments: 5323 greenbytes
Category: Standards Track S. Reddy
Mitrix
J. Davis
A. Babich
IBM
November 2008
Web Distributed Authoring and Versioning (WebDAV) SEARCH
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (c) 2008 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents (http://trustee.ietf.org/
license-info) 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.
Abstract
This document specifies a set of methods, headers, and properties
composing Web Distributed Authoring and Versioning (WebDAV) SEARCH,
an application of the HTTP/1.1 protocol to efficiently search for DAV
resources based upon a set of client-supplied criteria.
Reschke, et al. Standards Track [Page 1]
RFC 5323 WebDAV SEARCH November 2008
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1. DASL . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2. Relationship to DAV . . . . . . . . . . . . . . . . . . . 4
1.3. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4. Notational Conventions . . . . . . . . . . . . . . . . . . 6
1.5. Note on Usage of 'DAV:' XML Namespace . . . . . . . . . . 7
1.6. An Overview of DASL at Work . . . . . . . . . . . . . . . 7
2. The SEARCH Method . . . . . . . . . . . . . . . . . . . . . . 7
2.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2. The Request . . . . . . . . . . . . . . . . . . . . . . . 8
2.2.1. The Request-URI . . . . . . . . . . . . . . . . . . . 8
2.2.2. The Request Body . . . . . . . . . . . . . . . . . . . 8
2.3. The Successful 207 (Multistatus) Response . . . . . . . . 9
2.3.1. Result Set Truncation . . . . . . . . . . . . . . . . 9
2.3.2. Extending the PROPFIND Response . . . . . . . . . . . 10
2.3.3. Example: A Simple Request and Response . . . . . . . . 10
2.3.4. Example: Result Set Truncation . . . . . . . . . . . . 11
2.4. Unsuccessful Responses . . . . . . . . . . . . . . . . . . 12
2.4.1. Example of an Invalid Scope . . . . . . . . . . . . . 12
3. Discovery of Supported Query Grammars . . . . . . . . . . . . 13
3.1. The OPTIONS Method . . . . . . . . . . . . . . . . . . . . 13
3.2. The DASL Response Header . . . . . . . . . . . . . . . . . 14
3.3. DAV:supported-query-grammar-set (Protected) . . . . . . . 14
3.4. Example: Grammar Discovery . . . . . . . . . . . . . . . . 15
4. Query Schema Discovery: QSD . . . . . . . . . . . . . . . . . 17
4.1. Additional SEARCH Semantics . . . . . . . . . . . . . . . 17
4.1.1. Example of Query Schema Discovery . . . . . . . . . . 18
5. The DAV:basicsearch Grammar . . . . . . . . . . . . . . . . . 19
5.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . 19
5.2. The DAV:basicsearch DTD . . . . . . . . . . . . . . . . . 20
5.2.1. Example Query . . . . . . . . . . . . . . . . . . . . 22
5.3. DAV:select . . . . . . . . . . . . . . . . . . . . . . . . 23
5.4. DAV:from . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.4.1. Relationship to the Request-URI . . . . . . . . . . . 23
5.4.2. Scope . . . . . . . . . . . . . . . . . . . . . . . . 24
5.5. DAV:where . . . . . . . . . . . . . . . . . . . . . . . . 24
5.5.1. Use of Three-Valued Logic in Queries . . . . . . . . . 24
5.5.2. Handling Optional Operators . . . . . . . . . . . . . 24
5.5.3. Treatment of NULL Values . . . . . . . . . . . . . . . 24
5.5.4. Treatment of Properties with Mixed/Element Content . . 25
5.5.5. Example: Testing for Equality . . . . . . . . . . . . 25
5.5.6. Example: Relative Comparisons . . . . . . . . . . . . 25
Show full document text