| 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/