| draft-ietf-httpbis-p5-range-04.txt | draft-ietf-httpbis-p5-range-05.txt | |||
|---|---|---|---|---|
| Network Working Group R. Fielding, Ed. | Network Working Group R. Fielding, Ed. | |||
| Internet-Draft Day Software | Internet-Draft Day Software | |||
| Obsoletes: 2616 (if approved) J. Gettys | Obsoletes: 2616 (if approved) J. Gettys | |||
| Intended status: Standards Track One Laptop per Child | Intended status: Standards Track One Laptop per Child | |||
| Expires: March 2, 2009 J. Mogul | Expires: May 20, 2009 J. Mogul | |||
| HP | HP | |||
| H. Frystyk | H. Frystyk | |||
| Microsoft | Microsoft | |||
| L. Masinter | L. Masinter | |||
| Adobe Systems | Adobe Systems | |||
| 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 | |||
| August 29, 2008 | November 16, 2008 | |||
| 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-04 | draft-ietf-httpbis-p5-range-05 | |||
| Status of this Memo | Status of this Memo | |||
| By submitting this Internet-Draft, each author represents that any | By submitting this Internet-Draft, each author represents that any | |||
| applicable patent or other IPR claims of which he or she is aware | applicable patent or other IPR claims of which he or she is aware | |||
| have been or will be disclosed, and any of which he or she becomes | have been or will be disclosed, and any of which he or she becomes | |||
| aware will be disclosed, in accordance with Section 6 of BCP 79. | aware will be disclosed, in accordance with Section 6 of BCP 79. | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF), its areas, and its working groups. Note that | Task Force (IETF), its areas, and its working groups. Note that | |||
| skipping to change at page 1, line 49 | skipping to change at page 1, line 49 | |||
| 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." | |||
| The list of current Internet-Drafts can be accessed at | The list of current Internet-Drafts can be accessed at | |||
| http://www.ietf.org/ietf/1id-abstracts.txt. | http://www.ietf.org/ietf/1id-abstracts.txt. | |||
| The list of Internet-Draft Shadow Directories can be accessed at | The list of Internet-Draft Shadow Directories can be accessed at | |||
| http://www.ietf.org/shadow.html. | http://www.ietf.org/shadow.html. | |||
| This Internet-Draft will expire on March 2, 2009. | This Internet-Draft will expire on May 20, 2009. | |||
| 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 | |||
| responses to those requests. | responses to those requests. | |||
| Editorial Note (To be removed by RFC Editor) | Editorial Note (To be removed by RFC Editor) | |||
| 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). The current issues list is | group mailing list (ietf-http-wg@w3.org). The current issues list is | |||
| at <http://www.tools.ietf.org/wg/httpbis/trac/report/11> and related | at <http://tools.ietf.org/wg/httpbis/trac/report/11> and related | |||
| documents (including fancy diffs) can be found at | documents (including fancy diffs) can be found at | |||
| <http://www.tools.ietf.org/wg/httpbis/>. | <http://tools.ietf.org/wg/httpbis/>. | |||
| The changes in this draft are summarized in Appendix C.4. | The changes in this draft are summarized in Appendix C.6. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
| 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 4 | 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
| 2. Notational Conventions and Generic Grammar . . . . . . . . . . 4 | 2. Notational Conventions and Generic Grammar . . . . . . . . . . 4 | |||
| 3. Range Units . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 3. Range Units . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 4. Status Code Definitions . . . . . . . . . . . . . . . . . . . 5 | 4. Status Code Definitions . . . . . . . . . . . . . . . . . . . 5 | |||
| 4.1. 206 Partial Content . . . . . . . . . . . . . . . . . . . 5 | 4.1. 206 Partial Content . . . . . . . . . . . . . . . . . . . 5 | |||
| 4.2. 416 Requested Range Not Satisfiable . . . . . . . . . . . 6 | 4.2. 416 Requested Range Not Satisfiable . . . . . . . . . . . 6 | |||
| 5. Combining Byte Ranges . . . . . . . . . . . . . . . . . . . . 6 | 5. Combining Byte Ranges . . . . . . . . . . . . . . . . . . . . 6 | |||
| 6. Header Field Definitions . . . . . . . . . . . . . . . . . . . 7 | 6. Header Field Definitions . . . . . . . . . . . . . . . . . . . 7 | |||
| 6.1. Accept-Ranges . . . . . . . . . . . . . . . . . . . . . . 7 | 6.1. Accept-Ranges . . . . . . . . . . . . . . . . . . . . . . 7 | |||
| 6.2. Content-Range . . . . . . . . . . . . . . . . . . . . . . 8 | 6.2. Content-Range . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 6.3. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 10 | 6.3. If-Range . . . . . . . . . . . . . . . . . . . . . . . . . 10 | |||
| 6.4. Range . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | 6.4. Range . . . . . . . . . . . . . . . . . . . . . . . . . . 10 | |||
| 6.4.1. Byte Ranges . . . . . . . . . . . . . . . . . . . . . 10 | 6.4.1. Byte Ranges . . . . . . . . . . . . . . . . . . . . . 11 | |||
| 6.4.2. Range Retrieval Requests . . . . . . . . . . . . . . . 12 | 6.4.2. Range Retrieval Requests . . . . . . . . . . . . . . . 12 | |||
| 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13 | 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 7.1. Message Header Registration . . . . . . . . . . . . . . . 13 | 7.1. Message Header Registration . . . . . . . . . . . . . . . 13 | |||
| 8. Security Considerations . . . . . . . . . . . . . . . . . . . 13 | 8. Security Considerations . . . . . . . . . . . . . . . . . . . 13 | |||
| 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 14 | 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 14 | |||
| 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 14 | 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 14 | |||
| 10.1. Normative References . . . . . . . . . . . . . . . . . . . 14 | 10.1. Normative References . . . . . . . . . . . . . . . . . . . 14 | |||
| 10.2. Informative References . . . . . . . . . . . . . . . . . . 15 | 10.2. Informative References . . . . . . . . . . . . . . . . . . 15 | |||
| Appendix A. Internet Media Type multipart/byteranges . . . . . . 15 | Appendix A. Internet Media Type multipart/byteranges . . . . . . 15 | |||
| Appendix B. Compatibility with Previous Versions . . . . . . . . 17 | Appendix B. Compatibility with Previous Versions . . . . . . . . 17 | |||
| B.1. Changes from RFC 2068 . . . . . . . . . . . . . . . . . . 17 | B.1. Changes from RFC 2068 . . . . . . . . . . . . . . . . . . 17 | |||
| B.2. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 17 | B.2. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 17 | |||
| Appendix C. Change Log (to be removed by RFC Editor before | Appendix C. Change Log (to be removed by RFC Editor before | |||
| publication) . . . . . . . . . . . . . . . . . . . . 17 | publication) . . . . . . . . . . . . . . . . . . . . 17 | |||
| C.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 17 | C.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 17 | |||
| C.2. Since draft-ietf-httpbis-p5-range-00 . . . . . . . . . . . 18 | C.2. Since draft-ietf-httpbis-p5-range-00 . . . . . . . . . . . 18 | |||
| C.3. Since draft-ietf-httpbis-p5-range-01 . . . . . . . . . . . 18 | C.3. Since draft-ietf-httpbis-p5-range-01 . . . . . . . . . . . 18 | |||
| C.4. Since draft-ietf-httpbis-p5-range-02 . . . . . . . . . . . 18 | C.4. Since draft-ietf-httpbis-p5-range-02 . . . . . . . . . . . 18 | |||
| C.5. Since draft-ietf-httpbis-p5-range-03 . . . . . . . . . . . 18 | C.5. Since draft-ietf-httpbis-p5-range-03 . . . . . . . . . . . 18 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 | C.6. Since draft-ietf-httpbis-p5-range-04 . . . . . . . . . . . 18 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 | ||||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 20 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 20 | |||
| Intellectual Property and Copyright Statements . . . . . . . . . . 23 | Intellectual Property and Copyright Statements . . . . . . . . . . 23 | |||
| 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 | |||
| skipping to change at page 4, line 49 | skipping to change at page 4, line 49 | |||
| REQUIRED level and all the SHOULD level requirements for its | REQUIRED level and all the SHOULD level requirements for its | |||
| protocols is said to be "unconditionally compliant"; one that | protocols is said to be "unconditionally compliant"; one that | |||
| satisfies all the MUST level requirements but not all the SHOULD | satisfies all the MUST level requirements but not all the SHOULD | |||
| level requirements for its protocols is said to be "conditionally | level requirements for its protocols is said to be "conditionally | |||
| compliant." | compliant." | |||
| 2. Notational Conventions and Generic Grammar | 2. Notational Conventions and Generic Grammar | |||
| This specification uses the ABNF syntax defined in Section 2.1 of | This specification uses the ABNF syntax defined in Section 2.1 of | |||
| [Part1] and the core rules defined in Section 2.2 of [Part1]: | [Part1] and the core rules defined in Section 2.2 of [Part1]: | |||
| [[abnf.dep: ABNF syntax and basic rules will be adopted from RFC | ||||
| 5234, see <http://tools.ietf.org/wg/httpbis/trac/ticket/36>.]] | ||||
| DIGIT = <DIGIT, defined in [Part1], Section 2.2> | DIGIT = <DIGIT, defined in [Part1], Section 2.2> | |||
| SP = <SP, defined in [Part1], Section 2.2> | SP = <SP, defined in [Part1], Section 2.2> | |||
| token = <token, defined in [Part1], Section 2.2> | token = <token, defined in [Part1], Section 2.2> | |||
| OWS = <OWS, defined in [Part1], Section 2.2> | ||||
| The ABNF rules below are defined in other parts: | The ABNF rules below are defined in other parts: | |||
| HTTP-date = <HTTP-date, defined in [Part1], Section 3.3.1> | HTTP-date = <HTTP-date, defined in [Part1], Section 3.3.1> | |||
| entity-tag = <entity-tag, defined in [Part4], Section 3> | entity-tag = <entity-tag, defined in [Part4], Section 3> | |||
| 3. Range Units | 3. Range Units | |||
| HTTP/1.1 allows a client to request that only part (a range of) the | HTTP/1.1 allows a client to request that only part (a range of) the | |||
| response entity be included within the response. HTTP/1.1 uses range | response entity be included within the response. HTTP/1.1 uses range | |||
| units in the Range (Section 6.4) and Content-Range (Section 6.2) | units in the Range (Section 6.4) and Content-Range (Section 6.2) | |||
| header fields. An entity can be broken down into subranges according | header fields. An entity can be broken down into subranges according | |||
| to various structural units. | to various structural units. | |||
| range-unit = bytes-unit | other-range-unit | range-unit = bytes-unit / other-range-unit | |||
| bytes-unit = "bytes" | bytes-unit = "bytes" | |||
| other-range-unit = token | other-range-unit = token | |||
| The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 | The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 | |||
| implementations MAY ignore ranges specified using other units. | implementations MAY ignore ranges specified using other units. | |||
| HTTP/1.1 has been designed to allow implementations of applications | HTTP/1.1 has been designed to allow implementations of applications | |||
| that do not depend on knowledge of ranges. | that do not depend on knowledge of ranges. | |||
| 4. Status Code Definitions | 4. Status Code Definitions | |||
| skipping to change at page 6, line 32 | skipping to change at page 6, line 30 | |||
| content if the ETag or Last-Modified headers do not match exactly, | content if the ETag or Last-Modified headers do not match exactly, | |||
| see Section 5. | see Section 5. | |||
| A cache that does not support the Range and Content-Range headers | A cache that does not support the Range and Content-Range headers | |||
| MUST NOT cache 206 (Partial Content) responses. | MUST NOT cache 206 (Partial Content) responses. | |||
| 4.2. 416 Requested Range Not Satisfiable | 4.2. 416 Requested Range Not Satisfiable | |||
| A server SHOULD return a response with this status code if a request | A server SHOULD return a response with this status code if a request | |||
| included a Range request-header field (Section 6.4), and none of the | included a Range request-header field (Section 6.4), and none of the | |||
| range-specifier values in this field overlap the current extent of | ranges-specifier values in this field overlap the current extent of | |||
| the selected resource, and the request did not include an If-Range | the selected resource, and the request did not include an If-Range | |||
| request-header field. (For byte-ranges, this means that the first- | request-header field. (For byte-ranges, this means that the first- | |||
| byte-pos of all of the byte-range-spec values were greater than the | byte-pos of all of the byte-range-spec values were greater than the | |||
| current length of the selected resource.) | current length of the selected resource.) | |||
| When this status code is returned for a byte-range request, the | When this status code is returned for a byte-range request, the | |||
| response SHOULD include a Content-Range entity-header field | response SHOULD include a Content-Range entity-header field | |||
| specifying the current length of the selected resource (see | specifying the current length of the selected resource (see | |||
| Section 6.2). This response MUST NOT use the multipart/byteranges | Section 6.2). This response MUST NOT use the multipart/byteranges | |||
| content-type. | content-type. | |||
| skipping to change at page 7, line 32 | skipping to change at page 7, line 29 | |||
| This section defines the syntax and semantics of HTTP/1.1 header | This section defines the syntax and semantics of HTTP/1.1 header | |||
| fields related to range requests and partial responses. | fields related to range requests and partial responses. | |||
| For entity-header fields, both sender and recipient refer to either | For entity-header fields, both sender and recipient refer to either | |||
| the client or the server, depending on who sends and who receives the | the client or the server, depending on who sends and who receives the | |||
| entity. | entity. | |||
| 6.1. Accept-Ranges | 6.1. Accept-Ranges | |||
| The Accept-Ranges response-header field allows the server to indicate | The response-header "Accept-Ranges" field allows the server to | |||
| its acceptance of range requests for a resource: | indicate its acceptance of range requests for a resource: | |||
| Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges | Accept-Ranges = "Accept-Ranges" ":" OWS Accept-Ranges-v | |||
| acceptable-ranges = 1#range-unit | "none" | Accept-Ranges-v = acceptable-ranges | |||
| acceptable-ranges = 1#range-unit / "none" | ||||
| Origin servers that accept byte-range requests MAY send | Origin servers that accept byte-range requests MAY send | |||
| Accept-Ranges: bytes | Accept-Ranges: bytes | |||
| but are not required to do so. Clients MAY generate byte-range | but are not required to do so. Clients MAY generate byte-range | |||
| requests without having received this header for the resource | requests without having received this header for the resource | |||
| involved. Range units are defined in Section 3. | involved. Range units are defined in Section 3. | |||
| Servers that do not accept any kind of range request for a resource | Servers that do not accept any kind of range request for a resource | |||
| MAY send | MAY send | |||
| Accept-Ranges: none | Accept-Ranges: none | |||
| to advise the client not to attempt a range request. | to advise the client not to attempt a range request. | |||
| 6.2. Content-Range | 6.2. Content-Range | |||
| The Content-Range entity-header is sent with a partial entity-body to | The entity-header "Content-Range" is sent with a partial entity-body | |||
| specify where in the full entity-body the partial body should be | to specify where in the full entity-body the partial body should be | |||
| applied. Range units are defined in Section 3. | applied. Range units are defined in Section 3. | |||
| Content-Range = "Content-Range" ":" content-range-spec | Content-Range = "Content-Range" ":" OWS Content-Range-v | |||
| Content-Range-v = content-range-spec | ||||
| content-range-spec = byte-content-range-spec | content-range-spec = byte-content-range-spec | |||
| byte-content-range-spec = bytes-unit SP | byte-content-range-spec = bytes-unit SP | |||
| byte-range-resp-spec "/" | byte-range-resp-spec "/" | |||
| ( instance-length | "*" ) | ( instance-length / "*" ) | |||
| byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) | byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) | |||
| | "*" | / "*" | |||
| instance-length = 1*DIGIT | instance-length = 1*DIGIT | |||
| The header SHOULD indicate the total length of the full entity-body, | The header SHOULD indicate the total length of the full entity-body, | |||
| unless this length is unknown or difficult to determine. The | unless this length is unknown or difficult to determine. The | |||
| asterisk "*" character means that the instance-length is unknown at | asterisk "*" character means that the instance-length is unknown at | |||
| the time when the response was generated. | the time when the response was generated. | |||
| Unlike byte-ranges-specifier values (see Section 6.4.1), a byte- | Unlike byte-ranges-specifier values (see Section 6.4.1), a byte- | |||
| range-resp-spec MUST only specify one range, and MUST contain | range-resp-spec MUST only specify one range, and MUST contain | |||
| skipping to change at page 10, line 25 | skipping to change at page 10, line 25 | |||
| 6.3. If-Range | 6.3. If-Range | |||
| If a client has a partial copy of an entity in its cache, and wishes | If a client has a partial copy of an entity in its cache, and wishes | |||
| to have an up-to-date copy of the entire entity in its cache, it | to have an up-to-date copy of the entire entity in its cache, it | |||
| could use the Range request-header with a conditional GET (using | could use the Range request-header with a conditional GET (using | |||
| either or both of If-Unmodified-Since and If-Match.) However, if the | either or both of If-Unmodified-Since and If-Match.) However, if the | |||
| condition fails because the entity has been modified, the client | condition fails because the entity has been modified, the client | |||
| would then have to make a second request to obtain the entire current | would then have to make a second request to obtain the entire current | |||
| entity-body. | entity-body. | |||
| The If-Range header allows a client to "short-circuit" the second | The request header "If-Range" allows a client to "short-circuit" the | |||
| request. Informally, its meaning is `if the entity is unchanged, | second request. Informally, its meaning is `if the entity is | |||
| send me the part(s) that I am missing; otherwise, send me the entire | unchanged, send me the part(s) that I am missing; otherwise, send me | |||
| new entity'. | the entire new entity'. | |||
| If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) | If-Range = "If-Range" ":" OWS If-Range-v | |||
| If-Range-v = entity-tag / HTTP-date | ||||
| If the client has no entity tag for an entity, but does have a Last- | If the client has no entity tag for an entity, but does have a Last- | |||
| Modified date, it MAY use that date in an If-Range header. (The | Modified date, it MAY use that date in an If-Range header. (The | |||
| server can distinguish between a valid HTTP-date and any form of | server can distinguish between a valid HTTP-date and any form of | |||
| entity-tag by examining no more than two characters.) The If-Range | entity-tag by examining no more than two characters.) The If-Range | |||
| header SHOULD only be used together with a Range header, and MUST be | header SHOULD only be used together with a Range header, and MUST be | |||
| ignored if the request does not include a Range header, or if the | ignored if the request does not include a Range header, or if the | |||
| server does not support the sub-range operation. | server does not support the sub-range operation. | |||
| If the entity tag given in the If-Range header matches the current | If the entity tag given in the If-Range header matches the current | |||
| skipping to change at page 11, line 15 | skipping to change at page 11, line 20 | |||
| range operations.) | range operations.) | |||
| Byte range specifications in HTTP apply to the sequence of bytes in | Byte range specifications in HTTP apply to the sequence of bytes in | |||
| the entity-body (not necessarily the same as the message-body). | the entity-body (not necessarily the same as the message-body). | |||
| A byte range operation MAY specify a single range of bytes, or a set | A byte range operation MAY specify a single range of bytes, or a set | |||
| of ranges within a single entity. | of ranges within a single entity. | |||
| ranges-specifier = byte-ranges-specifier | ranges-specifier = byte-ranges-specifier | |||
| byte-ranges-specifier = bytes-unit "=" byte-range-set | byte-ranges-specifier = bytes-unit "=" byte-range-set | |||
| byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) | byte-range-set = 1#( byte-range-spec / suffix-byte-range-spec ) | |||
| byte-range-spec = first-byte-pos "-" [last-byte-pos] | byte-range-spec = first-byte-pos "-" [last-byte-pos] | |||
| first-byte-pos = 1*DIGIT | first-byte-pos = 1*DIGIT | |||
| last-byte-pos = 1*DIGIT | last-byte-pos = 1*DIGIT | |||
| The first-byte-pos value in a byte-range-spec gives the byte-offset | The first-byte-pos value in a byte-range-spec gives the byte-offset | |||
| of the first byte in a range. The last-byte-pos value gives the | of the first byte in a range. The last-byte-pos value gives the | |||
| byte-offset of the last byte in the range; that is, the byte | byte-offset of the last byte in the range; that is, the byte | |||
| positions specified are inclusive. Byte offsets start at zero. | positions specified are inclusive. Byte offsets start at zero. | |||
| If the last-byte-pos value is present, it MUST be greater than or | If the last-byte-pos value is present, it MUST be greater than or | |||
| skipping to change at page 12, line 38 | skipping to change at page 12, line 42 | |||
| bytes=500-600,601-999 | bytes=500-600,601-999 | |||
| bytes=500-700,601-999 | bytes=500-700,601-999 | |||
| 6.4.2. Range Retrieval Requests | 6.4.2. Range Retrieval Requests | |||
| HTTP retrieval requests using conditional or unconditional GET | HTTP retrieval requests using conditional or unconditional GET | |||
| methods MAY request one or more sub-ranges of the entity, instead of | methods MAY request one or more sub-ranges of the entity, instead of | |||
| the entire entity, using the Range request header, which applies to | the entire entity, using the Range request header, which applies to | |||
| the entity returned as the result of the request: | the entity returned as the result of the request: | |||
| Range = "Range" ":" ranges-specifier | Range = "Range" ":" OWS Range-v | |||
| Range-v = ranges-specifier | ||||
| A server MAY ignore the Range header. However, HTTP/1.1 origin | A server MAY ignore the Range header. However, HTTP/1.1 origin | |||
| servers and intermediate caches ought to support byte ranges when | servers and intermediate caches ought to support byte ranges when | |||
| possible, since Range supports efficient recovery from partially | possible, since Range supports efficient recovery from partially | |||
| failed transfers, and supports efficient partial retrieval of large | failed transfers, and supports efficient partial retrieval of large | |||
| entities. | entities. | |||
| If the server supports the Range header and the specified range or | If the server supports the Range header and the specified range or | |||
| ranges are appropriate for the entity: | ranges are appropriate for the entity: | |||
| skipping to change at page 14, line 21 | skipping to change at page 14, line 21 | |||
| 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. | |||
| 10. References | 10. References | |||
| 10.1. Normative References | 10.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-04 | and Message Parsing", draft-ietf-httpbis-p1-messaging-05 | |||
| (work in progress), August 2008. | (work in progress), November 2008. | |||
| [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-04 | and Content Negotiation", draft-ietf-httpbis-p3-payload-05 | |||
| (work in progress), August 2008. | (work in progress), November 2008. | |||
| [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-04 (work in | Requests", draft-ietf-httpbis-p4-conditional-05 (work in | |||
| progress), August 2008. | progress), November 2008. | |||
| [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., | |||
| and J. Reschke, Ed., "HTTP/1.1, part 6: Caching", | and J. Reschke, Ed., "HTTP/1.1, part 6: Caching", | |||
| draft-ietf-httpbis-p6-cache-04 (work in progress), | draft-ietf-httpbis-p6-cache-05 (work in progress), | |||
| August 2008. | November 2008. | |||
| [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. | |||
| 10.2. Informative References | 10.2. Informative References | |||
| skipping to change at page 15, line 23 | skipping to change at page 15, line 23 | |||
| September 2004. | September 2004. | |||
| [RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and | [RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and | |||
| Registration Procedures", BCP 13, RFC 4288, December 2005. | Registration Procedures", BCP 13, RFC 4288, December 2005. | |||
| Appendix A. Internet Media Type multipart/byteranges | Appendix A. Internet Media Type multipart/byteranges | |||
| When an HTTP 206 (Partial Content) response message includes the | When an HTTP 206 (Partial Content) response message includes the | |||
| content of multiple ranges (a response to a request for multiple non- | content of multiple ranges (a response to a request for multiple non- | |||
| overlapping ranges), these are transmitted as a multipart message- | overlapping ranges), these are transmitted as a multipart message- | |||
| body [RFC2046]. The media type for this purpose is called | body ([RFC2046], Section 5.1). The media type for this purpose is | |||
| "multipart/byteranges". The following is to be registered with IANA | called "multipart/byteranges". The following is to be registered | |||
| [RFC4288]. | with IANA [RFC4288]. | |||
| The multipart/byteranges media type includes two or more parts, each | The multipart/byteranges media type includes one or more parts, each | |||
| with its own Content-Type and Content-Range fields. The required | with its own Content-Type and Content-Range fields. The required | |||
| boundary parameter specifies the boundary string used to separate | boundary parameter specifies the boundary string used to separate | |||
| each body-part. | each body-part. | |||
| Type name: multipart | Type name: multipart | |||
| Subtype name: byteranges | Subtype name: byteranges | |||
| Required parameters: boundary | Required parameters: boundary | |||
| skipping to change at page 17, line 42 | skipping to change at page 17, line 42 | |||
| syntactic problems, and range doesn't exist in the document. The 416 | syntactic problems, and range doesn't exist in the document. The 416 | |||
| status code was needed to resolve this ambiguity needed to indicate | status code was needed to resolve this ambiguity needed to indicate | |||
| an error for a byte range request that falls outside of the actual | an error for a byte range request that falls outside of the actual | |||
| contents of a document. (Section 4.2, 6.2) | contents of a document. (Section 4.2, 6.2) | |||
| B.2. Changes from RFC 2616 | B.2. Changes from RFC 2616 | |||
| Clarify that it is not ok to use a weak cache validator in a 206 | Clarify that it is not ok to use a weak cache validator in a 206 | |||
| response. (Section 4.1) | response. (Section 4.1) | |||
| Clarify that multipart/byteranges can consist of a single part. | ||||
| (Appendix A) | ||||
| Appendix C. Change Log (to be removed by RFC Editor before publication) | Appendix C. Change Log (to be removed by RFC Editor before publication) | |||
| C.1. Since RFC2616 | C.1. Since RFC2616 | |||
| Extracted relevant partitions from [RFC2616]. | Extracted relevant partitions from [RFC2616]. | |||
| C.2. Since draft-ietf-httpbis-p5-range-00 | C.2. Since draft-ietf-httpbis-p5-range-00 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/18>: "Cache | o <http://tools.ietf.org/wg/httpbis/trac/ticket/18>: "Cache | |||
| validators in 206 responses" | validators in 206 responses" | |||
| (<http://purl.org/NET/http-errata#ifrange206>) | (<http://purl.org/NET/http-errata#ifrange206>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/35>: "Normative | o <http://tools.ietf.org/wg/httpbis/trac/ticket/35>: "Normative and | |||
| and Informative references" | Informative references" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/86>: "Normative | o <http://tools.ietf.org/wg/httpbis/trac/ticket/86>: "Normative up- | |||
| up-to-date references" | to-date references" | |||
| C.3. Since draft-ietf-httpbis-p5-range-01 | C.3. Since draft-ietf-httpbis-p5-range-01 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/55>: "Updating | o <http://tools.ietf.org/wg/httpbis/trac/ticket/55>: "Updating to | |||
| to RFC4288" | RFC4288" | |||
| Ongoing work on ABNF conversion | Ongoing work on ABNF conversion | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | |||
| o Add explicit references to BNF syntax and rules imported from | o Add explicit references to BNF syntax and rules imported from | |||
| other parts of the specification. | other parts of the specification. | |||
| C.4. Since draft-ietf-httpbis-p5-range-02 | C.4. Since draft-ietf-httpbis-p5-range-02 | |||
| Ongoing work on IANA Message Header Registration | Ongoing work on IANA Message Header Registration | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/40>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/40>): | |||
| o Reference RFC 3984, and update header registrations for headers | o Reference RFC 3984, and update header registrations for headers | |||
| defined in this document. | defined in this document. | |||
| C.5. Since draft-ietf-httpbis-p5-range-03 | C.5. Since draft-ietf-httpbis-p5-range-03 | |||
| C.6. Since draft-ietf-httpbis-p5-range-04 | ||||
| Closed issues: | ||||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/133>: "multipart/ | ||||
| byteranges minimum number of parts" | ||||
| Ongoing work on ABNF conversion | ||||
| (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | ||||
| o Use "/" instead of "|" for alternatives. | ||||
| o Introduce new ABNF rules for "bad" whitespace ("BWS"), optional | ||||
| whitespace ("OWS") and required whitespace ("RWS"). | ||||
| o Rewrite ABNFs to spell out whitespace rules, factor out header | ||||
| value format definitions. | ||||
| Index | Index | |||
| 2 | 2 | |||
| 206 Partial Content (status code) 5 | 206 Partial Content (status code) 5 | |||
| 4 | 4 | |||
| 416 Requested Range Not Satisfiable (status code) 6 | 416 Requested Range Not Satisfiable (status code) 6 | |||
| A | A | |||
| Accept-Ranges header 7 | Accept-Ranges header 7 | |||
| skipping to change at page 19, line 4 | skipping to change at page 19, line 23 | |||
| Index | Index | |||
| 2 | 2 | |||
| 206 Partial Content (status code) 5 | 206 Partial Content (status code) 5 | |||
| 4 | 4 | |||
| 416 Requested Range Not Satisfiable (status code) 6 | 416 Requested Range Not Satisfiable (status code) 6 | |||
| A | A | |||
| Accept-Ranges header 7 | Accept-Ranges header 7 | |||
| C | C | |||
| Content-Range header 8 | Content-Range header 8 | |||
| G | G | |||
| Grammar | Grammar | |||
| Accept-Ranges 7 | Accept-Ranges 7 | |||
| Accept-Ranges-v 7 | ||||
| acceptable-ranges 7 | acceptable-ranges 7 | |||
| byte-content-range-spec 8 | byte-content-range-spec 8 | |||
| byte-range-resp-spec 8 | byte-range-resp-spec 8 | |||
| byte-range-set 11 | byte-range-set 11 | |||
| byte-range-spec 11 | byte-range-spec 11 | |||
| byte-ranges-specifier 11 | byte-ranges-specifier 11 | |||
| bytes-unit 5 | bytes-unit 5 | |||
| Content-Range 8 | Content-Range 8 | |||
| content-range-spec 8 | content-range-spec 8 | |||
| Content-Range-v 8 | ||||
| first-byte-pos 11 | first-byte-pos 11 | |||
| If-Range 10 | If-Range 10 | |||
| If-Range-v 10 | ||||
| instance-length 8 | instance-length 8 | |||
| last-byte-pos 11 | last-byte-pos 11 | |||
| other-range-unit 5 | other-range-unit 5 | |||
| Range 12 | Range 12 | |||
| range-unit 5 | range-unit 5 | |||
| Range-v 12 | ||||
| ranges-specifier 11 | ranges-specifier 11 | |||
| suffix-byte-range-spec 11 | suffix-byte-range-spec 11 | |||
| suffix-length 11 | suffix-length 11 | |||
| H | H | |||
| Headers | Headers | |||
| Accept-Ranges 7 | Accept-Ranges 7 | |||
| Content-Range 8 | Content-Range 8 | |||
| If-Range 10 | If-Range 10 | |||
| Range 10 | Range 10 | |||
| End of changes. 43 change blocks. | ||||
| 51 lines changed or deleted | 81 lines changed or added | |||
This html diff was produced by rfcdiff 1.34. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||