| draft-ietf-httpbis-p5-range-14.txt | draft-ietf-httpbis-p5-range-15.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: October 20, 2011 J. Mogul | Expires: January 12, 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 | |||
| April 18, 2011 | July 11, 2011 | |||
| HTTP/1.1, part 5: Range Requests and Partial Responses | HTTP/1.1, part 5: Range Requests and Partial Responses | |||
| draft-ietf-httpbis-p5-range-14 | draft-ietf-httpbis-p5-range-15 | |||
| Abstract | Abstract | |||
| The Hypertext Transfer Protocol (HTTP) is an application-level | The Hypertext Transfer Protocol (HTTP) is an application-level | |||
| protocol for distributed, collaborative, hypermedia information | protocol for distributed, collaborative, hypermedia 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 5 of the | information initiative since 1990. This document is Part 5 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. Part 5 defines | "HTTP/1.1" and, taken together, obsoletes RFC 2616. Part 5 defines | |||
| range-specific requests and the rules for constructing and combining | range-specific requests and the rules for constructing and combining | |||
| skipping to change at page 1, line 48 | skipping to change at page 1, line 48 | |||
| 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 D.15. | The changes in this draft are summarized in Appendix D.16. | |||
| 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 October 20, 2011. | This Internet-Draft will expire on January 12, 2012. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2011 IETF Trust and the persons identified as the | Copyright (c) 2011 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 | |||
| skipping to change at page 2, line 51 | skipping to change at page 2, line 51 | |||
| modifications of such material outside the IETF Standards Process. | modifications of such material outside the IETF Standards Process. | |||
| Without obtaining an adequate license from the person(s) controlling | Without obtaining an adequate license from the person(s) controlling | |||
| the copyright in such materials, this document may not be modified | the copyright in such materials, this document may not be modified | |||
| outside the IETF Standards Process, and derivative works of it may | outside the IETF Standards Process, and derivative works of it may | |||
| not be created outside the IETF Standards Process, except to format | not be created outside the IETF Standards Process, except to format | |||
| it for publication as an RFC or to translate it into languages other | it for publication as an RFC or to translate it into languages other | |||
| than English. | than English. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 4 | 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.2. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 4 | 1.2. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.2.1. Core Rules . . . . . . . . . . . . . . . . . . . . . . 5 | 1.2.1. Core Rules . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 1.2.2. ABNF Rules defined in other Parts of the | 1.2.2. ABNF Rules defined in other Parts of the | |||
| Specification . . . . . . . . . . . . . . . . . . . . 5 | Specification . . . . . . . . . . . . . . . . . . . . 6 | |||
| 2. Range Units . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 2. Range Units . . . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 2.1. Range Specifier Registry . . . . . . . . . . . . . . . . . 5 | 2.1. Range Specifier Registry . . . . . . . . . . . . . . . . . 6 | |||
| 3. Status Code Definitions . . . . . . . . . . . . . . . . . . . 6 | 3. Status Code Definitions . . . . . . . . . . . . . . . . . . . 7 | |||
| 3.1. 206 Partial Content . . . . . . . . . . . . . . . . . . . 6 | 3.1. 206 Partial Content . . . . . . . . . . . . . . . . . . . 7 | |||
| 3.2. 416 Requested Range Not Satisfiable . . . . . . . . . . . 7 | 3.2. 416 Requested Range Not Satisfiable . . . . . . . . . . . 8 | |||
| 4. Combining Ranges . . . . . . . . . . . . . . . . . . . . . . . 7 | 4. Combining Ranges . . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 5. Header Field Definitions . . . . . . . . . . . . . . . . . . . 7 | 5. Header Field Definitions . . . . . . . . . . . . . . . . . . . 8 | |||
| 5.1. Accept-Ranges . . . . . . . . . . . . . . . . . . . . . . 8 | 5.1. Accept-Ranges . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 5.2. Content-Range . . . . . . . . . . . . . . . . . . . . . . 8 | 5.2. Content-Range . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 5.3. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 10 | 5.3. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 11 | |||
| 5.4. Range . . . . . . . . . . . . . . . . . . . . . . . . . . 11 | 5.4. Range . . . . . . . . . . . . . . . . . . . . . . . . . . 12 | |||
| 5.4.1. Byte Ranges . . . . . . . . . . . . . . . . . . . . . 11 | 5.4.1. Byte Ranges . . . . . . . . . . . . . . . . . . . . . 12 | |||
| 5.4.2. Range Retrieval Requests . . . . . . . . . . . . . . . 13 | 5.4.2. Range Retrieval Requests . . . . . . . . . . . . . . . 14 | |||
| 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14 | 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 15 | |||
| 6.1. Status Code Registration . . . . . . . . . . . . . . . . . 14 | 6.1. Status Code Registration . . . . . . . . . . . . . . . . . 15 | |||
| 6.2. Header Field Registration . . . . . . . . . . . . . . . . 14 | 6.2. Header Field Registration . . . . . . . . . . . . . . . . 15 | |||
| 6.3. Range Specifier Registration . . . . . . . . . . . . . . . 15 | 6.3. Range Specifier Registration . . . . . . . . . . . . . . . 16 | |||
| 7. Security Considerations . . . . . . . . . . . . . . . . . . . 15 | 7. Security Considerations . . . . . . . . . . . . . . . . . . . 16 | |||
| 8. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 15 | 8. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 16 | |||
| 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 16 | 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 17 | |||
| 9.1. Normative References . . . . . . . . . . . . . . . . . . . 16 | 9.1. Normative References . . . . . . . . . . . . . . . . . . . 17 | |||
| 9.2. Informative References . . . . . . . . . . . . . . . . . . 16 | 9.2. Informative References . . . . . . . . . . . . . . . . . . 17 | |||
| Appendix A. Internet Media Type multipart/byteranges . . . . . . 16 | Appendix A. Internet Media Type multipart/byteranges . . . . . . 17 | |||
| Appendix B. Compatibility with Previous Versions . . . . . . . . 19 | Appendix B. Compatibility with Previous Versions . . . . . . . . 20 | |||
| B.1. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 19 | B.1. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 20 | |||
| Appendix C. Collected ABNF . . . . . . . . . . . . . . . . . . . 19 | Appendix C. Collected ABNF . . . . . . . . . . . . . . . . . . . 20 | |||
| Appendix D. Change Log (to be removed by RFC Editor before | Appendix D. Change Log (to be removed by RFC Editor before | |||
| publication) . . . . . . . . . . . . . . . . . . . . 21 | publication) . . . . . . . . . . . . . . . . . . . . 22 | |||
| D.1. Since RFC 2616 . . . . . . . . . . . . . . . . . . . . . . 21 | D.1. Since RFC 2616 . . . . . . . . . . . . . . . . . . . . . . 22 | |||
| D.2. Since draft-ietf-httpbis-p5-range-00 . . . . . . . . . . . 21 | D.2. Since draft-ietf-httpbis-p5-range-00 . . . . . . . . . . . 22 | |||
| D.3. Since draft-ietf-httpbis-p5-range-01 . . . . . . . . . . . 21 | D.3. Since draft-ietf-httpbis-p5-range-01 . . . . . . . . . . . 22 | |||
| D.4. Since draft-ietf-httpbis-p5-range-02 . . . . . . . . . . . 21 | D.4. Since draft-ietf-httpbis-p5-range-02 . . . . . . . . . . . 22 | |||
| D.5. Since draft-ietf-httpbis-p5-range-03 . . . . . . . . . . . 22 | D.5. Since draft-ietf-httpbis-p5-range-03 . . . . . . . . . . . 23 | |||
| D.6. Since draft-ietf-httpbis-p5-range-04 . . . . . . . . . . . 22 | D.6. Since draft-ietf-httpbis-p5-range-04 . . . . . . . . . . . 23 | |||
| D.7. Since draft-ietf-httpbis-p5-range-05 . . . . . . . . . . . 22 | D.7. Since draft-ietf-httpbis-p5-range-05 . . . . . . . . . . . 23 | |||
| D.8. Since draft-ietf-httpbis-p5-range-06 . . . . . . . . . . . 22 | D.8. Since draft-ietf-httpbis-p5-range-06 . . . . . . . . . . . 23 | |||
| D.9. Since draft-ietf-httpbis-p5-range-07 . . . . . . . . . . . 23 | D.9. Since draft-ietf-httpbis-p5-range-07 . . . . . . . . . . . 24 | |||
| D.10. Since draft-ietf-httpbis-p5-range-08 . . . . . . . . . . . 23 | D.10. Since draft-ietf-httpbis-p5-range-08 . . . . . . . . . . . 24 | |||
| D.11. Since draft-ietf-httpbis-p5-range-09 . . . . . . . . . . . 23 | D.11. Since draft-ietf-httpbis-p5-range-09 . . . . . . . . . . . 24 | |||
| D.12. Since draft-ietf-httpbis-p5-range-10 . . . . . . . . . . . 23 | D.12. Since draft-ietf-httpbis-p5-range-10 . . . . . . . . . . . 24 | |||
| D.13. Since draft-ietf-httpbis-p5-range-11 . . . . . . . . . . . 23 | D.13. Since draft-ietf-httpbis-p5-range-11 . . . . . . . . . . . 24 | |||
| D.14. Since draft-ietf-httpbis-p5-range-12 . . . . . . . . . . . 24 | D.14. Since draft-ietf-httpbis-p5-range-12 . . . . . . . . . . . 25 | |||
| D.15. Since draft-ietf-httpbis-p5-range-13 . . . . . . . . . . . 24 | D.15. Since draft-ietf-httpbis-p5-range-13 . . . . . . . . . . . 25 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 | D.16. Since draft-ietf-httpbis-p5-range-14 . . . . . . . . . . . 25 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 | ||||
| 1. Introduction | 1. Introduction | |||
| HTTP clients often encounter interrupted data transfers as a result | HTTP clients often encounter interrupted data transfers as a result | |||
| of cancelled requests or dropped connections. When a cache has | of cancelled requests or dropped connections. When a cache has | |||
| stored a partial representation, it is desirable to request the | stored a partial representation, it is desirable to request the | |||
| remainder of that representation in a subsequent request rather than | remainder of that representation in a subsequent request rather than | |||
| transfer the entire representation. There are also a number of Web | transfer the entire representation. There are also a number of Web | |||
| applications that benefit from being able to request only a subset of | applications that benefit from being able to request only a subset of | |||
| a larger representation, such as a single page of a very large | a larger representation, such as a single page of a very large | |||
| skipping to change at page 16, line 9 | skipping to change at page 17, line 9 | |||
| Hamilton, Koen Holtman, Shel Kaplan, Paul Leach, Alex Lopez-Ortiz, | Hamilton, Koen Holtman, Shel Kaplan, Paul Leach, Alex Lopez-Ortiz, | |||
| Larry Masinter, Jeff Mogul, Lou Montulli, David W. Morris, Luigi | Larry Masinter, Jeff Mogul, Lou Montulli, David W. Morris, Luigi | |||
| Rizzo, and Bill Weihl. | Rizzo, and Bill Weihl. | |||
| 9. References | 9. References | |||
| 9.1. Normative References | 9.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-14 | and Message Parsing", draft-ietf-httpbis-p1-messaging-15 | |||
| (work in progress), April 2011. | (work in progress), July 2011. | |||
| [Part4] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part4] 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 4: Conditional | and J. Reschke, Ed., "HTTP/1.1, part 4: Conditional | |||
| Requests", draft-ietf-httpbis-p4-conditional-14 (work in | Requests", draft-ietf-httpbis-p4-conditional-15 (work in | |||
| progress), April 2011. | progress), July 2011. | |||
| [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | |||
| Extensions (MIME) Part Two: Media Types", RFC 2046, | Extensions (MIME) Part Two: Media Types", RFC 2046, | |||
| November 1996. | November 1996. | |||
| [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. | |||
| skipping to change at page 24, line 19 | skipping to change at page 25, line 19 | |||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/224>: "Header | o <http://tools.ietf.org/wg/httpbis/trac/ticket/224>: "Header | |||
| Classification" | Classification" | |||
| D.15. Since draft-ietf-httpbis-p5-range-13 | D.15. Since draft-ietf-httpbis-p5-range-13 | |||
| Closed issues: | Closed issues: | |||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/276>: "untangle | o <http://tools.ietf.org/wg/httpbis/trac/ticket/276>: "untangle | |||
| ABNFs for header fields" | ABNFs for header fields" | |||
| D.16. Since draft-ietf-httpbis-p5-range-14 | ||||
| None. | ||||
| Index | Index | |||
| 2 | 2 | |||
| 206 Partial Content (status code) 6 | 206 Partial Content (status code) 7 | |||
| 4 | 4 | |||
| 416 Requested Range Not Satisfiable (status code) 7 | 416 Requested Range Not Satisfiable (status code) 8 | |||
| A | A | |||
| Accept-Ranges header field 8 | Accept-Ranges header field 9 | |||
| C | C | |||
| Content-Range header field 8 | Content-Range header field 9 | |||
| G | G | |||
| Grammar | Grammar | |||
| Accept-Ranges 8 | Accept-Ranges 9 | |||
| acceptable-ranges 8 | acceptable-ranges 9 | |||
| byte-content-range-spec 8 | byte-content-range-spec 9 | |||
| byte-range-resp-spec 8 | byte-range-resp-spec 9 | |||
| byte-range-set 12 | byte-range-set 13 | |||
| byte-range-spec 12 | byte-range-spec 13 | |||
| byte-ranges-specifier 12 | byte-ranges-specifier 13 | |||
| bytes-unit 5 | bytes-unit 6 | |||
| Content-Range 8 | Content-Range 9 | |||
| content-range-spec 8 | content-range-spec 9 | |||
| first-byte-pos 12 | first-byte-pos 13 | |||
| If-Range 11 | If-Range 12 | |||
| instance-length 8 | instance-length 9 | |||
| last-byte-pos 12 | last-byte-pos 13 | |||
| other-range-unit 5 | other-range-unit 6 | |||
| Range 13 | Range 14 | |||
| range-unit 5 | range-unit 6 | |||
| ranges-specifier 12 | ranges-specifier 13 | |||
| suffix-byte-range-spec 12 | suffix-byte-range-spec 13 | |||
| suffix-length 12 | suffix-length 13 | |||
| H | H | |||
| Header Fields | Header Fields | |||
| Accept-Ranges 8 | Accept-Ranges 9 | |||
| Content-Range 8 | Content-Range 9 | |||
| If-Range 10 | If-Range 11 | |||
| Range 11 | Range 12 | |||
| I | I | |||
| If-Range header field 10 | If-Range header field 11 | |||
| M | M | |||
| Media Type | Media Type | |||
| multipart/byteranges 16 | multipart/byteranges 17 | |||
| multipart/x-byteranges 19 | multipart/x-byteranges 20 | |||
| multipart/byteranges Media Type 16 | multipart/byteranges Media Type 17 | |||
| multipart/x-byteranges Media Type 19 | multipart/x-byteranges Media Type 20 | |||
| R | R | |||
| Range header field 11 | Range header field 12 | |||
| S | S | |||
| Status Codes | Status Codes | |||
| 206 Partial Content 6 | 206 Partial Content 7 | |||
| 416 Requested Range Not Satisfiable 7 | 416 Requested Range Not Satisfiable 8 | |||
| Authors' Addresses | Authors' Addresses | |||
| Roy T. Fielding (editor) | Roy T. Fielding (editor) | |||
| Adobe Systems Incorporated | Adobe Systems Incorporated | |||
| 345 Park Ave | 345 Park Ave | |||
| San Jose, CA 95110 | San Jose, CA 95110 | |||
| USA | USA | |||
| EMail: fielding@gbiv.com | EMail: fielding@gbiv.com | |||
| End of changes. 21 change blocks. | ||||
| 93 lines changed or deleted | 99 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/ | ||||