| draft-ietf-httpbis-p4-conditional-17.txt | draft-ietf-httpbis-p4-conditional-18.txt | |||
|---|---|---|---|---|
| HTTPbis Working Group R. Fielding, Ed. | HTTPbis Working Group R. Fielding, Ed. | |||
| Internet-Draft Adobe | Internet-Draft Adobe | |||
| Obsoletes: 2616 (if approved) J. Gettys | Obsoletes: 2616 (if approved) J. Gettys | |||
| Intended status: Standards Track Alcatel-Lucent | Intended status: Standards Track Alcatel-Lucent | |||
| Expires: May 3, 2012 J. Mogul | Expires: July 7, 2012 J. Mogul | |||
| HP | HP | |||
| H. Frystyk | H. Frystyk | |||
| Microsoft | Microsoft | |||
| L. Masinter | L. Masinter | |||
| Adobe | Adobe | |||
| P. Leach | P. Leach | |||
| Microsoft | Microsoft | |||
| T. Berners-Lee | T. Berners-Lee | |||
| W3C/MIT | W3C/MIT | |||
| Y. Lafon, Ed. | Y. Lafon, Ed. | |||
| W3C | W3C | |||
| J. Reschke, Ed. | J. Reschke, Ed. | |||
| greenbytes | greenbytes | |||
| October 31, 2011 | January 4, 2012 | |||
| HTTP/1.1, part 4: Conditional Requests | HTTP/1.1, part 4: Conditional Requests | |||
| draft-ietf-httpbis-p4-conditional-17 | draft-ietf-httpbis-p4-conditional-18 | |||
| Abstract | Abstract | |||
| The Hypertext Transfer Protocol (HTTP) is an application-level | The Hypertext Transfer Protocol (HTTP) is an application-level | |||
| protocol for distributed, collaborative, hypertext information | protocol for distributed, collaborative, hypertext information | |||
| systems. HTTP has been in use by the World Wide Web global | systems. HTTP has been in use by the World Wide Web global | |||
| information initiative since 1990. This document is Part 4 of the | information initiative since 1990. This document is Part 4 of the | |||
| seven-part specification that defines the protocol referred to as | seven-part specification that defines the protocol referred to as | |||
| "HTTP/1.1" and, taken together, obsoletes RFC 2616. | "HTTP/1.1" and, taken together, obsoletes RFC 2616. | |||
| skipping to change at page 1, line 49 | skipping to change at page 1, line 49 | |||
| Discussion of this draft should take place on the HTTPBIS working | Discussion of this draft should take place on the HTTPBIS working | |||
| group mailing list (ietf-http-wg@w3.org), which is archived at | group mailing list (ietf-http-wg@w3.org), which is archived at | |||
| <http://lists.w3.org/Archives/Public/ietf-http-wg/>. | <http://lists.w3.org/Archives/Public/ietf-http-wg/>. | |||
| The current issues list is at | The current issues list is at | |||
| <http://tools.ietf.org/wg/httpbis/trac/report/3> and related | <http://tools.ietf.org/wg/httpbis/trac/report/3> and related | |||
| documents (including fancy diffs) can be found at | documents (including fancy diffs) can be found at | |||
| <http://tools.ietf.org/wg/httpbis/>. | <http://tools.ietf.org/wg/httpbis/>. | |||
| The changes in this draft are summarized in Appendix C.18. | The changes in this draft are summarized in Appendix C.19. | |||
| Status of This Memo | Status of This Memo | |||
| This Internet-Draft is submitted in full conformance with the | This Internet-Draft is submitted in full conformance with the | |||
| provisions of BCP 78 and BCP 79. | provisions of BCP 78 and BCP 79. | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
| working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
| Drafts is at http://datatracker.ietf.org/drafts/current/. | Drafts is at http://datatracker.ietf.org/drafts/current/. | |||
| Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| This Internet-Draft will expire on May 3, 2012. | This Internet-Draft will expire on July 7, 2012. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2011 IETF Trust and the persons identified as the | Copyright (c) 2012 IETF Trust and the persons identified as the | |||
| document authors. All rights reserved. | document authors. All rights reserved. | |||
| This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
| Provisions Relating to IETF Documents | Provisions Relating to IETF Documents | |||
| (http://trustee.ietf.org/license-info) in effect on the date of | (http://trustee.ietf.org/license-info) in effect on the date of | |||
| publication of this document. Please review these documents | publication of this document. Please review these documents | |||
| carefully, as they describe your rights and restrictions with respect | carefully, as they describe your rights and restrictions with respect | |||
| to this document. Code Components extracted from this document must | to this document. Code Components extracted from this document must | |||
| include Simplified BSD License text as described in Section 4.e of | include Simplified BSD License text as described in Section 4.e of | |||
| the Trust Legal Provisions and are provided without warranty as | the Trust Legal Provisions and are provided without warranty as | |||
| skipping to change at page 3, line 12 | skipping to change at page 3, line 12 | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.1. Conformance and Error Handling . . . . . . . . . . . . . . 5 | 1.1. Conformance and Error Handling . . . . . . . . . . . . . . 5 | |||
| 1.2. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 6 | 1.2. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 2. Validators . . . . . . . . . . . . . . . . . . . . . . . . . . 6 | 2. Validators . . . . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 2.1. Weak versus Strong . . . . . . . . . . . . . . . . . . . . 6 | 2.1. Weak versus Strong . . . . . . . . . . . . . . . . . . . . 6 | |||
| 2.2. Last-Modified . . . . . . . . . . . . . . . . . . . . . . 8 | 2.2. Last-Modified . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 2.2.1. Generation . . . . . . . . . . . . . . . . . . . . . . 8 | 2.2.1. Generation . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 2.2.2. Comparison . . . . . . . . . . . . . . . . . . . . . . 9 | 2.2.2. Comparison . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 2.3. ETag . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | 2.3. ETag . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | |||
| 2.3.1. Generation . . . . . . . . . . . . . . . . . . . . . . 11 | 2.3.1. Generation . . . . . . . . . . . . . . . . . . . . . . 11 | |||
| 2.3.2. Comparison . . . . . . . . . . . . . . . . . . . . . . 11 | 2.3.2. Comparison . . . . . . . . . . . . . . . . . . . . . . 12 | |||
| 2.3.3. Example: Entity-tags varying on Content-Negotiated | 2.3.3. Example: Entity-tags varying on Content-Negotiated | |||
| Resources . . . . . . . . . . . . . . . . . . . . . . 12 | Resources . . . . . . . . . . . . . . . . . . . . . . 12 | |||
| 2.4. Rules for When to Use Entity-tags and Last-Modified | 2.4. Rules for When to Use Entity-tags and Last-Modified | |||
| Dates . . . . . . . . . . . . . . . . . . . . . . . . . . 13 | Dates . . . . . . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 3. Precondition Header Fields . . . . . . . . . . . . . . . . . . 14 | 3. Precondition Header Fields . . . . . . . . . . . . . . . . . . 15 | |||
| 3.1. If-Match . . . . . . . . . . . . . . . . . . . . . . . . . 15 | 3.1. If-Match . . . . . . . . . . . . . . . . . . . . . . . . . 15 | |||
| 3.2. If-None-Match . . . . . . . . . . . . . . . . . . . . . . 15 | 3.2. If-None-Match . . . . . . . . . . . . . . . . . . . . . . 16 | |||
| 3.3. If-Modified-Since . . . . . . . . . . . . . . . . . . . . 17 | 3.3. If-Modified-Since . . . . . . . . . . . . . . . . . . . . 17 | |||
| 3.4. If-Unmodified-Since . . . . . . . . . . . . . . . . . . . 18 | 3.4. If-Unmodified-Since . . . . . . . . . . . . . . . . . . . 18 | |||
| 3.5. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 19 | 3.5. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 19 | |||
| 4. Status Code Definitions . . . . . . . . . . . . . . . . . . . 19 | 4. Status Code Definitions . . . . . . . . . . . . . . . . . . . 19 | |||
| 4.1. 304 Not Modified . . . . . . . . . . . . . . . . . . . . . 19 | 4.1. 304 Not Modified . . . . . . . . . . . . . . . . . . . . . 19 | |||
| 4.2. 412 Precondition Failed . . . . . . . . . . . . . . . . . 20 | 4.2. 412 Precondition Failed . . . . . . . . . . . . . . . . . 20 | |||
| 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 | 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 | |||
| 5.1. Status Code Registration . . . . . . . . . . . . . . . . . 20 | 5.1. Status Code Registration . . . . . . . . . . . . . . . . . 20 | |||
| 5.2. Header Field Registration . . . . . . . . . . . . . . . . 20 | 5.2. Header Field Registration . . . . . . . . . . . . . . . . 20 | |||
| 6. Security Considerations . . . . . . . . . . . . . . . . . . . 20 | 6. Security Considerations . . . . . . . . . . . . . . . . . . . 21 | |||
| 7. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 21 | 7. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 21 | |||
| 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 21 | 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 21 | |||
| 8.1. Normative References . . . . . . . . . . . . . . . . . . . 21 | 8.1. Normative References . . . . . . . . . . . . . . . . . . . 21 | |||
| 8.2. Informative References . . . . . . . . . . . . . . . . . . 21 | 8.2. Informative References . . . . . . . . . . . . . . . . . . 22 | |||
| Appendix A. Changes from RFC 2616 . . . . . . . . . . . . . . . . 22 | Appendix A. Changes from RFC 2616 . . . . . . . . . . . . . . . . 22 | |||
| Appendix B. Collected ABNF . . . . . . . . . . . . . . . . . . . 22 | Appendix B. Collected ABNF . . . . . . . . . . . . . . . . . . . 23 | |||
| Appendix C. Change Log (to be removed by RFC Editor before | Appendix C. Change Log (to be removed by RFC Editor before | |||
| publication) . . . . . . . . . . . . . . . . . . . . 23 | publication) . . . . . . . . . . . . . . . . . . . . 23 | |||
| C.1. Since RFC 2616 . . . . . . . . . . . . . . . . . . . . . . 23 | C.1. Since RFC 2616 . . . . . . . . . . . . . . . . . . . . . . 23 | |||
| C.2. Since draft-ietf-httpbis-p4-conditional-00 . . . . . . . . 23 | C.2. Since draft-ietf-httpbis-p4-conditional-00 . . . . . . . . 23 | |||
| C.3. Since draft-ietf-httpbis-p4-conditional-01 . . . . . . . . 23 | C.3. Since draft-ietf-httpbis-p4-conditional-01 . . . . . . . . 24 | |||
| C.4. Since draft-ietf-httpbis-p4-conditional-02 . . . . . . . . 23 | C.4. Since draft-ietf-httpbis-p4-conditional-02 . . . . . . . . 24 | |||
| C.5. Since draft-ietf-httpbis-p4-conditional-03 . . . . . . . . 24 | C.5. Since draft-ietf-httpbis-p4-conditional-03 . . . . . . . . 24 | |||
| C.6. Since draft-ietf-httpbis-p4-conditional-04 . . . . . . . . 24 | C.6. Since draft-ietf-httpbis-p4-conditional-04 . . . . . . . . 24 | |||
| C.7. Since draft-ietf-httpbis-p4-conditional-05 . . . . . . . . 24 | C.7. Since draft-ietf-httpbis-p4-conditional-05 . . . . . . . . 25 | |||
| C.8. Since draft-ietf-httpbis-p4-conditional-06 . . . . . . . . 24 | C.8. Since draft-ietf-httpbis-p4-conditional-06 . . . . . . . . 25 | |||
| C.9. Since draft-ietf-httpbis-p4-conditional-07 . . . . . . . . 24 | C.9. Since draft-ietf-httpbis-p4-conditional-07 . . . . . . . . 25 | |||
| C.10. Since draft-ietf-httpbis-p4-conditional-08 . . . . . . . . 25 | C.10. Since draft-ietf-httpbis-p4-conditional-08 . . . . . . . . 25 | |||
| C.11. Since draft-ietf-httpbis-p4-conditional-09 . . . . . . . . 25 | C.11. Since draft-ietf-httpbis-p4-conditional-09 . . . . . . . . 25 | |||
| C.12. Since draft-ietf-httpbis-p4-conditional-10 . . . . . . . . 25 | C.12. Since draft-ietf-httpbis-p4-conditional-10 . . . . . . . . 25 | |||
| C.13. Since draft-ietf-httpbis-p4-conditional-11 . . . . . . . . 25 | C.13. Since draft-ietf-httpbis-p4-conditional-11 . . . . . . . . 26 | |||
| C.14. Since draft-ietf-httpbis-p4-conditional-12 . . . . . . . . 25 | C.14. Since draft-ietf-httpbis-p4-conditional-12 . . . . . . . . 26 | |||
| C.15. Since draft-ietf-httpbis-p4-conditional-13 . . . . . . . . 25 | C.15. Since draft-ietf-httpbis-p4-conditional-13 . . . . . . . . 26 | |||
| C.16. Since draft-ietf-httpbis-p4-conditional-14 . . . . . . . . 26 | C.16. Since draft-ietf-httpbis-p4-conditional-14 . . . . . . . . 26 | |||
| C.17. Since draft-ietf-httpbis-p4-conditional-15 . . . . . . . . 26 | C.17. Since draft-ietf-httpbis-p4-conditional-15 . . . . . . . . 26 | |||
| C.18. Since draft-ietf-httpbis-p4-conditional-16 . . . . . . . . 26 | C.18. Since draft-ietf-httpbis-p4-conditional-16 . . . . . . . . 26 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 | C.19. Since draft-ietf-httpbis-p4-conditional-17 . . . . . . . . 27 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 | ||||
| 1. Introduction | 1. Introduction | |||
| This document defines the HTTP/1.1 conditional request mechanisms, | This document defines the HTTP/1.1 conditional request mechanisms, | |||
| including both metadata for indicating/observing changes in resource | including both metadata for indicating/observing changes in resource | |||
| representations and request header fields that specify preconditions | representations and request header fields that specify preconditions | |||
| on that metadata be checked before performing the request method. | on that metadata be checked before performing the request method. | |||
| Conditional GET requests are the most efficient mechanism for HTTP | Conditional GET requests are the most efficient mechanism for HTTP | |||
| cache updates [Part6]. Conditionals can also be applied to state- | cache updates [Part6]. Conditionals can also be applied to state- | |||
| changing methods, such as PUT and DELETE, to prevent the "lost | changing methods, such as PUT and DELETE, to prevent the "lost | |||
| skipping to change at page 6, line 34 | skipping to change at page 6, line 34 | |||
| The following core rules are included by reference, as defined in | The following core rules are included by reference, as defined in | |||
| [RFC5234], Appendix B.1: ALPHA (letters), CR (carriage return), CRLF | [RFC5234], Appendix B.1: ALPHA (letters), CR (carriage return), CRLF | |||
| (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote), | (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote), | |||
| HEXDIG (hexadecimal 0-9/A-F/a-f), LF (line feed), OCTET (any 8-bit | HEXDIG (hexadecimal 0-9/A-F/a-f), LF (line feed), OCTET (any 8-bit | |||
| sequence of data), SP (space), and VCHAR (any visible US-ASCII | sequence of data), SP (space), and VCHAR (any visible US-ASCII | |||
| character). | character). | |||
| The ABNF rules below are defined in [Part1] and [Part2]: | The ABNF rules below are defined in [Part1] and [Part2]: | |||
| OWS = <OWS, defined in [Part1], Section 1.2.2> | OWS = <OWS, defined in [Part1], Section 1.2.2> | |||
| quoted-string = <quoted-string, defined in [Part1], Section 3.2.3> | obs-text = <obs-text, defined in [Part1], Section 3.2.3> | |||
| HTTP-date = <HTTP-date, defined in [Part2], Section 8> | HTTP-date = <HTTP-date, defined in [Part2], Section 8> | |||
| 2. Validators | 2. Validators | |||
| This specification defines two forms of metadata that are commonly | This specification defines two forms of metadata that are commonly | |||
| used to observe resource state and test for preconditions: | used to observe resource state and test for preconditions: | |||
| modification dates and opaque entity tags. Additional metadata that | modification dates and opaque entity tags. Additional metadata that | |||
| reflects resource state has been defined by various extensions of | reflects resource state has been defined by various extensions of | |||
| HTTP, such as WebDAV [RFC4918], that are beyond the scope of this | HTTP, such as WebDAV [RFC4918], that are beyond the scope of this | |||
| specification. A resource metadata value is referred to as a | specification. A resource metadata value is referred to as a | |||
| skipping to change at page 10, line 47 | skipping to change at page 10, line 47 | |||
| resource, regardless of whether those multiple representations are | resource, regardless of whether those multiple representations are | |||
| due to resource state changes over time, content negotiation | due to resource state changes over time, content negotiation | |||
| resulting in multiple representations being valid at the same time, | resulting in multiple representations being valid at the same time, | |||
| or both. An entity-tag consists of an opaque quoted string, possibly | or both. An entity-tag consists of an opaque quoted string, possibly | |||
| prefixed by a weakness indicator. | prefixed by a weakness indicator. | |||
| ETag = entity-tag | ETag = entity-tag | |||
| entity-tag = [ weak ] opaque-tag | entity-tag = [ weak ] opaque-tag | |||
| weak = %x57.2F ; "W/", case-sensitive | weak = %x57.2F ; "W/", case-sensitive | |||
| opaque-tag = quoted-string | opaque-tag = DQUOTE *etagc DQUOTE | |||
| etagc = %x21 / %x23-7E / obs-text | ||||
| ; VCHAR except double quotes, plus obs-text | ||||
| Note: Previously, opaque-tag was defined to be a quoted-string | ||||
| ([RFC2616], Section 3.11), thus some recipients might perform | ||||
| backslash unescaping. Servers therefore ought to avoid backslash | ||||
| characters in entity tags. | ||||
| An entity-tag can be more reliable for validation than a modification | An entity-tag can be more reliable for validation than a modification | |||
| date in situations where it is inconvenient to store modification | date in situations where it is inconvenient to store modification | |||
| dates, where the one-second resolution of HTTP date values is not | dates, where the one-second resolution of HTTP date values is not | |||
| sufficient, or where modification dates are not consistently | sufficient, or where modification dates are not consistently | |||
| maintained. | maintained. | |||
| Examples: | Examples: | |||
| ETag: "xyzzy" | ETag: "xyzzy" | |||
| skipping to change at page 21, line 16 | skipping to change at page 21, line 35 | |||
| See Section 11 of [Part1]. | See Section 11 of [Part1]. | |||
| 8. References | 8. References | |||
| 8.1. Normative References | 8.1. Normative References | |||
| [Part1] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part1] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
| and J. Reschke, Ed., "HTTP/1.1, part 1: URIs, Connections, | and J. Reschke, Ed., "HTTP/1.1, part 1: URIs, Connections, | |||
| and Message Parsing", draft-ietf-httpbis-p1-messaging-17 | and Message Parsing", draft-ietf-httpbis-p1-messaging-18 | |||
| (work in progress), October 2011. | (work in progress), January 2012. | |||
| [Part2] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part2] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
| and J. Reschke, Ed., "HTTP/1.1, part 2: Message | and J. Reschke, Ed., "HTTP/1.1, part 2: Message | |||
| Semantics", draft-ietf-httpbis-p2-semantics-17 (work in | Semantics", draft-ietf-httpbis-p2-semantics-18 (work in | |||
| progress), October 2011. | progress), January 2012. | |||
| [Part3] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part3] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
| and J. Reschke, Ed., "HTTP/1.1, part 3: Message Payload | and J. Reschke, Ed., "HTTP/1.1, part 3: Message Payload | |||
| and Content Negotiation", draft-ietf-httpbis-p3-payload-17 | and Content Negotiation", draft-ietf-httpbis-p3-payload-18 | |||
| (work in progress), October 2011. | (work in progress), January 2012. | |||
| [Part5] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part5] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
| and J. Reschke, Ed., "HTTP/1.1, part 5: Range Requests and | and J. Reschke, Ed., "HTTP/1.1, part 5: Range Requests and | |||
| Partial Responses", draft-ietf-httpbis-p5-range-17 (work | Partial Responses", draft-ietf-httpbis-p5-range-18 (work | |||
| in progress), October 2011. | in progress), January 2012. | |||
| [Part6] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part6] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
| Nottingham, M., Ed., and J. Reschke, Ed., "HTTP/1.1, part | Nottingham, M., Ed., and J. Reschke, Ed., "HTTP/1.1, part | |||
| 6: Caching", draft-ietf-httpbis-p6-cache-17 (work in | 6: Caching", draft-ietf-httpbis-p6-cache-18 (work in | |||
| progress), October 2011. | progress), January 2012. | |||
| [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
| Requirement Levels", BCP 14, RFC 2119, March 1997. | Requirement Levels", BCP 14, RFC 2119, March 1997. | |||
| [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax | [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax | |||
| Specifications: ABNF", STD 68, RFC 5234, January 2008. | Specifications: ABNF", STD 68, RFC 5234, January 2008. | |||
| 8.2. Informative References | 8.2. Informative References | |||
| [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., | [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., | |||
| skipping to change at page 22, line 18 | skipping to change at page 22, line 37 | |||
| September 2004. | September 2004. | |||
| [RFC4918] Dusseault, L., Ed., "HTTP Extensions for Web Distributed | [RFC4918] Dusseault, L., Ed., "HTTP Extensions for Web Distributed | |||
| Authoring and Versioning (WebDAV)", RFC 4918, June 2007. | Authoring and Versioning (WebDAV)", RFC 4918, June 2007. | |||
| Appendix A. Changes from RFC 2616 | Appendix A. Changes from RFC 2616 | |||
| Allow weak entity-tags in all requests except range requests | Allow weak entity-tags in all requests except range requests | |||
| (Sections 2.1 and 3.2). | (Sections 2.1 and 3.2). | |||
| Change ETag header field ABNF not to use quoted-string, thus avoiding | ||||
| escaping issues. (Section 2.3) | ||||
| Change ABNF productions for header fields to only define the field | Change ABNF productions for header fields to only define the field | |||
| value. (Section 3) | value. (Section 3) | |||
| Appendix B. Collected ABNF | Appendix B. Collected ABNF | |||
| ETag = entity-tag | ETag = entity-tag | |||
| HTTP-date = <HTTP-date, defined in [Part2], Section 8> | HTTP-date = <HTTP-date, defined in [Part2], Section 8> | |||
| If-Match = "*" / ( *( "," OWS ) entity-tag *( OWS "," [ OWS | If-Match = "*" / ( *( "," OWS ) entity-tag *( OWS "," [ OWS | |||
| skipping to change at page 22, line 39 | skipping to change at page 23, line 23 | |||
| If-Modified-Since = HTTP-date | If-Modified-Since = HTTP-date | |||
| If-None-Match = "*" / ( *( "," OWS ) entity-tag *( OWS "," [ OWS | If-None-Match = "*" / ( *( "," OWS ) entity-tag *( OWS "," [ OWS | |||
| entity-tag ] ) ) | entity-tag ] ) ) | |||
| If-Unmodified-Since = HTTP-date | If-Unmodified-Since = HTTP-date | |||
| Last-Modified = HTTP-date | Last-Modified = HTTP-date | |||
| OWS = <OWS, defined in [Part1], Section 1.2.2> | OWS = <OWS, defined in [Part1], Section 1.2.2> | |||
| entity-tag = [ weak ] opaque-tag | entity-tag = [ weak ] opaque-tag | |||
| etagc = "!" / %x23-7E ; '#'-'~' | ||||
| / obs-text | ||||
| opaque-tag = quoted-string | obs-text = <obs-text, defined in [Part1], Section 3.2.3> | |||
| opaque-tag = DQUOTE *etagc DQUOTE | ||||
| quoted-string = <quoted-string, defined in [Part1], Section 3.2.3> | ||||
| weak = %x57.2F ; W/ | weak = %x57.2F ; W/ | |||
| ABNF diagnostics: | ABNF diagnostics: | |||
| ; ETag defined but not used | ; ETag defined but not used | |||
| ; If-Match defined but not used | ; If-Match defined but not used | |||
| ; If-Modified-Since defined but not used | ; If-Modified-Since defined but not used | |||
| ; If-None-Match defined but not used | ; If-None-Match defined but not used | |||
| ; If-Unmodified-Since defined but not used | ; If-Unmodified-Since defined but not used | |||
| ; Last-Modified defined but not used | ; Last-Modified defined but not used | |||
| Appendix C. Change Log (to be removed by RFC Editor before publication) | Appendix C. Change Log (to be removed by RFC Editor before publication) | |||
| skipping to change at page 26, line 27 | skipping to change at page 27, line 5 | |||
| should be listed when dicussing contexts where L-M can be | should be listed when dicussing contexts where L-M can be | |||
| considered strong" | considered strong" | |||
| C.18. Since draft-ietf-httpbis-p4-conditional-16 | C.18. Since draft-ietf-httpbis-p4-conditional-16 | |||
| Closed issues: | Closed issues: | |||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/186>: "Document | o <http://tools.ietf.org/wg/httpbis/trac/ticket/186>: "Document | |||
| HTTP's error-handling philosophy" | HTTP's error-handling philosophy" | |||
| C.19. Since draft-ietf-httpbis-p4-conditional-17 | ||||
| Closed issues: | ||||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/306>: "does etag | ||||
| value really use quoted-string" | ||||
| Index | Index | |||
| 3 | 3 | |||
| 304 Not Modified (status code) 19 | 304 Not Modified (status code) 19 | |||
| 4 | 4 | |||
| 412 Precondition Failed (status code) 20 | 412 Precondition Failed (status code) 20 | |||
| E | E | |||
| ETag header field 10 | ETag header field 10 | |||
| G | G | |||
| Grammar | Grammar | |||
| entity-tag 10 | entity-tag 10 | |||
| ETag 10 | ETag 10 | |||
| etagc 10 | ||||
| If-Match 15 | If-Match 15 | |||
| If-Modified-Since 17 | If-Modified-Since 17 | |||
| If-None-Match 16 | If-None-Match 16 | |||
| If-Unmodified-Since 18 | If-Unmodified-Since 18 | |||
| Last-Modified 8 | Last-Modified 8 | |||
| opaque-tag 10 | opaque-tag 10 | |||
| weak 10 | weak 10 | |||
| H | H | |||
| Header Fields | Header Fields | |||
| ETag 10 | ETag 10 | |||
| If-Match 15 | If-Match 15 | |||
| If-Modified-Since 17 | If-Modified-Since 17 | |||
| If-None-Match 15 | If-None-Match 16 | |||
| If-Unmodified-Since 18 | If-Unmodified-Since 18 | |||
| Last-Modified 8 | Last-Modified 8 | |||
| I | I | |||
| If-Match header field 15 | If-Match header field 15 | |||
| If-Modified-Since header field 17 | If-Modified-Since header field 17 | |||
| If-None-Match header field 15 | If-None-Match header field 16 | |||
| If-Unmodified-Since header field 18 | If-Unmodified-Since header field 18 | |||
| L | L | |||
| Last-Modified header field 8 | Last-Modified header field 8 | |||
| M | M | |||
| metadata 6 | metadata 6 | |||
| S | S | |||
| selected representation 5 | selected representation 5 | |||
| End of changes. 31 change blocks. | ||||
| 38 lines changed or deleted | 59 lines changed or added | |||
This html diff was produced by rfcdiff 1.38. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||