![(please configure the [header_logo] section in trac.ini)](https://www.ietf.org/images/ietflogotrans.gif)
Changeset 1232 for draft-ietf-httpbis/latest/p5-range.html
- Timestamp:
- 29/03/11 12:57:19 (12 years ago)
- File:
-
- 1 edited
-
draft-ietf-httpbis/latest/p5-range.html (modified) (15 diffs)
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p5-range.html
r1215 r1232 359 359 } 360 360 @bottom-center { 361 content: "Expires September 28, 2011";361 content: "Expires September 30, 2011"; 362 362 } 363 363 @bottom-right { … … 406 406 <meta name="dct.creator" content="Reschke, J. F."> 407 407 <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p5-range-latest"> 408 <meta name="dct.issued" scheme="ISO8601" content="2011-03-2 7">408 <meta name="dct.issued" scheme="ISO8601" content="2011-03-29"> 409 409 <meta name="dct.replaces" content="urn:ietf:rfc:2616"> 410 410 <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypermedia information systems. HTTP has been in use by the World Wide Web global information initiative since 1990. This document is Part 5 of the seven-part specification that defines the protocol referred to as "HTTP/1.1" and, taken together, obsoletes RFC 2616. Part 5 defines range-specific requests and the rules for constructing and combining responses to those requests."> … … 432 432 </tr> 433 433 <tr> 434 <td class="left">Expires: September 28, 2011</td>434 <td class="left">Expires: September 30, 2011</td> 435 435 <td class="right">J. Mogul</td> 436 436 </tr> … … 489 489 <tr> 490 490 <td class="left"></td> 491 <td class="right">March 2 7, 2011</td>491 <td class="right">March 29, 2011</td> 492 492 </tr> 493 493 </tbody> … … 515 515 in progress”. 516 516 </p> 517 <p>This Internet-Draft will expire on September 28, 2011.</p>517 <p>This Internet-Draft will expire on September 30, 2011.</p> 518 518 <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1> 519 519 <p>Copyright © 2011 IETF Trust and the persons identified as the document authors. All rights reserved.</p> … … 724 724 <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a> <a id="header.accept-ranges" href="#header.accept-ranges">Accept-Ranges</a></h2> 725 725 <p id="rfc.section.5.1.p.1">The "Accept-Ranges" header field allows a resource to indicate its acceptance of range requests.</p> 726 <div id="rfc.figure.u.5"></div><pre class="inline"><span id="rfc.iref.g.4"></span><span id="rfc.iref.g.5"></span><span id="rfc.iref.g.6"></span> <a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = "Accept-Ranges" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.accept-ranges" class="smpl">Accept-Ranges-v</a> 727 <a href="#header.accept-ranges" class="smpl">Accept-Ranges-v</a> = <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> 726 <div id="rfc.figure.u.5"></div><pre class="inline"><span id="rfc.iref.g.4"></span><span id="rfc.iref.g.5"></span> <a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> 728 727 <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> = 1#<a href="#range.units" class="smpl">range-unit</a> / "none" 729 728 </pre><p id="rfc.section.5.1.p.3">Origin servers that accept byte-range requests <em class="bcp14">MAY</em> send … … 744 743 <p id="rfc.section.5.2.p.2">Range units are defined in <a href="#range.units" title="Range Units">Section 2</a>. 745 744 </p> 746 <div id="rfc.figure.u.8"></div><pre class="inline"><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span><span id="rfc.iref.g.9"></span><span id="rfc.iref.g.10"></span><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span> <a href="#header.content-range" class="smpl">Content-Range</a> = "Content-Range" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-range" class="smpl">Content-Range-v</a> 747 <a href="#header.content-range" class="smpl">Content-Range-v</a> = <a href="#header.content-range" class="smpl">content-range-spec</a> 745 <div id="rfc.figure.u.8"></div><pre class="inline"><span id="rfc.iref.g.6"></span><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span><span id="rfc.iref.g.9"></span><span id="rfc.iref.g.10"></span> <a href="#header.content-range" class="smpl">Content-Range</a> = <a href="#header.content-range" class="smpl">content-range-spec</a> 748 746 749 747 <a href="#header.content-range" class="smpl">content-range-spec</a> = <a href="#header.content-range" class="smpl">byte-content-range-spec</a> … … 828 826 is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new representation". 829 827 </p> 830 <div id="rfc.figure.u.14"></div><pre class="inline"><span id="rfc.iref.g.13"></span><span id="rfc.iref.g.14"></span> <a href="#header.if-range" class="smpl">If-Range</a> = "If-Range" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.if-range" class="smpl">If-Range-v</a> 831 <a href="#header.if-range" class="smpl">If-Range-v</a> = <a href="#abnf.dependencies" class="smpl">entity-tag</a> / <a href="#abnf.dependencies" class="smpl">HTTP-date</a> 828 <div id="rfc.figure.u.14"></div><pre class="inline"><span id="rfc.iref.g.11"></span> <a href="#header.if-range" class="smpl">If-Range</a> = <a href="#abnf.dependencies" class="smpl">entity-tag</a> / <a href="#abnf.dependencies" class="smpl">HTTP-date</a> 832 829 </pre><p id="rfc.section.5.3.p.4">If the client has no entity-tag for a representation, but does have a Last-Modified date, it <em class="bcp14">MAY</em> use that date in an If-Range header field. (The server can distinguish between a valid HTTP-date and any form of entity-tag 833 830 by examining no more than two characters.) The If-Range header field <em class="bcp14">SHOULD</em> only be used together with a Range header field, and <em class="bcp14">MUST</em> be ignored if the request does not include a Range header field, or if the server does not support the sub-range operation. … … 851 848 </p> 852 849 </div> 853 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.1 5"></span><span id="rfc.iref.g.16"></span><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span> <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> = <a href="#range.units" class="smpl">bytes-unit</a> "=" <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a>850 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.12"></span><span id="rfc.iref.g.13"></span><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span><span id="rfc.iref.g.16"></span><span id="rfc.iref.g.17"></span> <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> = <a href="#range.units" class="smpl">bytes-unit</a> "=" <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> 854 851 <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> = 1#( <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> / <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> ) 855 852 <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> = <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> "-" [ <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> ] … … 867 864 </p> 868 865 <p id="rfc.section.5.4.1.p.8">By its choice of last-byte-pos, a client can limit the number of bytes retrieved without knowing the size of the representation.</p> 869 <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g. 21"></span><span id="rfc.iref.g.22"></span> <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> = "-" <a href="#rule.ranges-specifier" class="smpl">suffix-length</a>866 <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span> <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> = "-" <a href="#rule.ranges-specifier" class="smpl">suffix-length</a> 870 867 <a href="#rule.ranges-specifier" class="smpl">suffix-length</a> = 1*<a href="#notation" class="smpl">DIGIT</a> 871 868 </pre><p id="rfc.section.5.4.1.p.10">A suffix-byte-range-spec is used to specify the suffix of the representation body, of a length given by the suffix-length … … 901 898 body, instead of the entire representation body. 902 899 </p> 903 <div id="rfc.figure.u.23"></div><pre class="inline"><span id="rfc.iref.g.23"></span> <a href="#range.retrieval.requests" class="smpl">Range</a> = "Range" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#range.retrieval.requests" class="smpl">Range-v</a> 904 <a href="#range.retrieval.requests" class="smpl">Range-v</a> = <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> 905 / <a href="#range.retrieval.requests" class="smpl">other-ranges-specifier</a> 900 <div id="rfc.figure.u.23"></div><pre class="inline"><span id="rfc.iref.g.20"></span> <a href="#range.retrieval.requests" class="smpl">Range</a> = <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> / <a href="#range.retrieval.requests" class="smpl">other-ranges-specifier</a> 906 901 <a href="#range.retrieval.requests" class="smpl">other-ranges-specifier</a> = <a href="#range.units" class="smpl">other-range-unit</a> "=" <a href="#range.retrieval.requests" class="smpl">other-range-set</a> 907 902 <a href="#range.retrieval.requests" class="smpl">other-range-set</a> = 1*<a href="#notation" class="smpl">CHAR</a> … … 1208 1203 <p id="rfc.section.B.1.p.1">Clarify that it is not ok to use a weak cache validator in a 206 response. (<a href="#status.206" id="rfc.xref.status.206.2" title="206 Partial Content">Section 3.1</a>) 1209 1204 </p> 1210 <p id="rfc.section.B.1.p.2">Clarify that multipart/byteranges can consist of a single part. (<a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix A</a>) 1205 <p id="rfc.section.B.1.p.2">Change ABNF productions for header fields to only define the field value. (<a href="#header.fields" title="Header Field Definitions">Section 5</a>) 1206 </p> 1207 <p id="rfc.section.B.1.p.3">Clarify that multipart/byteranges can consist of a single part. (<a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix A</a>) 1211 1208 </p> 1212 1209 <h1 id="rfc.section.C"><a href="#rfc.section.C">C.</a> <a id="collected.abnf" href="#collected.abnf">Collected ABNF</a></h1> 1213 <div id="rfc.figure.u.26"></div> <pre class="inline"><a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = "Accept-Ranges:" OWS Accept-Ranges-v 1214 <a href="#header.accept-ranges" class="smpl">Accept-Ranges-v</a> = acceptable-ranges 1215 1216 <a href="#header.content-range" class="smpl">Content-Range</a> = "Content-Range:" OWS Content-Range-v 1217 <a href="#header.content-range" class="smpl">Content-Range-v</a> = content-range-spec 1210 <div id="rfc.figure.u.26"></div> <pre class="inline"><a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = acceptable-ranges 1211 1212 <a href="#header.content-range" class="smpl">Content-Range</a> = content-range-spec 1218 1213 1219 1214 <a href="#abnf.dependencies" class="smpl">HTTP-date</a> = <HTTP-date, defined in [Part1], Section 6.1> 1220 1215 1221 <a href="#header.if-range" class="smpl">If-Range</a> = "If-Range:" OWS If-Range-v 1222 <a href="#header.if-range" class="smpl">If-Range-v</a> = entity-tag / HTTP-date 1216 <a href="#header.if-range" class="smpl">If-Range</a> = entity-tag / HTTP-date 1223 1217 1224 1218 <a href="#core.rules" class="smpl">OWS</a> = <OWS, defined in [Part1], Section 1.2.2> 1225 1219 1226 <a href="#range.retrieval.requests" class="smpl">Range</a> = "Range:" OWS Range-v 1227 <a href="#range.retrieval.requests" class="smpl">Range-v</a> = byte-ranges-specifier / other-ranges-specifier 1220 <a href="#range.retrieval.requests" class="smpl">Range</a> = byte-ranges-specifier / other-ranges-specifier 1228 1221 1229 1222 <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> = ( *( "," OWS ) range-unit *( OWS "," [ OWS … … 1303 1296 </ul> 1304 1297 <h2 id="rfc.section.D.5"><a href="#rfc.section.D.5">D.5</a> <a id="changes.since.03" href="#changes.since.03">Since draft-ietf-httpbis-p5-range-03</a></h2> 1298 <p id="rfc.section.D.5.p.1">None.</p> 1305 1299 <h2 id="rfc.section.D.6"><a href="#rfc.section.D.6">D.6</a> <a id="changes.since.04" href="#changes.since.04">Since draft-ietf-httpbis-p5-range-04</a></h2> 1306 1300 <p id="rfc.section.D.6.p.1">Closed issues: </p> … … 1381 1375 </ul> 1382 1376 <h2 id="rfc.section.D.15"><a href="#rfc.section.D.15">D.15</a> <a id="changes.since.13" href="#changes.since.13">Since draft-ietf-httpbis-p5-range-13</a></h2> 1383 <p id="rfc.section.D.15.p.1">None yet.</p> 1377 <p id="rfc.section.D.15.p.1">Closed issues: </p> 1378 <ul> 1379 <li> <<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/276">http://tools.ietf.org/wg/httpbis/trac/ticket/276</a>>: "untangle ABNFs for header fields" 1380 </li> 1381 </ul> 1384 1382 <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1> 1385 1383 <p class="noprint"><a href="#rfc.index.2">2</a> <a href="#rfc.index.4">4</a> <a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> … … 1407 1405 <ul> 1408 1406 <li><tt>Accept-Ranges</tt> <a href="#rfc.iref.g.4"><b>5.1</b></a></li> 1409 <li><tt>Accept-Ranges-v</tt> <a href="#rfc.iref.g.5"><b>5.1</b></a></li> 1410 <li><tt>acceptable-ranges</tt> <a href="#rfc.iref.g.6"><b>5.1</b></a></li> 1411 <li><tt>byte-content-range-spec</tt> <a href="#rfc.iref.g.10"><b>5.2</b></a></li> 1412 <li><tt>byte-range-resp-spec</tt> <a href="#rfc.iref.g.11"><b>5.2</b></a></li> 1413 <li><tt>byte-range-set</tt> <a href="#rfc.iref.g.17"><b>5.4.1</b></a></li> 1414 <li><tt>byte-range-spec</tt> <a href="#rfc.iref.g.18"><b>5.4.1</b></a></li> 1415 <li><tt>byte-ranges-specifier</tt> <a href="#rfc.iref.g.16"><b>5.4.1</b></a></li> 1407 <li><tt>acceptable-ranges</tt> <a href="#rfc.iref.g.5"><b>5.1</b></a></li> 1408 <li><tt>byte-content-range-spec</tt> <a href="#rfc.iref.g.8"><b>5.2</b></a></li> 1409 <li><tt>byte-range-resp-spec</tt> <a href="#rfc.iref.g.9"><b>5.2</b></a></li> 1410 <li><tt>byte-range-set</tt> <a href="#rfc.iref.g.14"><b>5.4.1</b></a></li> 1411 <li><tt>byte-range-spec</tt> <a href="#rfc.iref.g.15"><b>5.4.1</b></a></li> 1412 <li><tt>byte-ranges-specifier</tt> <a href="#rfc.iref.g.13"><b>5.4.1</b></a></li> 1416 1413 <li><tt>bytes-unit</tt> <a href="#rfc.iref.g.2"><b>2</b></a></li> 1417 <li><tt>Content-Range</tt> <a href="#rfc.iref.g.7"><b>5.2</b></a></li> 1418 <li><tt>content-range-spec</tt> <a href="#rfc.iref.g.9"><b>5.2</b></a></li> 1419 <li><tt>Content-Range-v</tt> <a href="#rfc.iref.g.8"><b>5.2</b></a></li> 1420 <li><tt>first-byte-pos</tt> <a href="#rfc.iref.g.19"><b>5.4.1</b></a></li> 1421 <li><tt>If-Range</tt> <a href="#rfc.iref.g.13"><b>5.3</b></a></li> 1422 <li><tt>If-Range-v</tt> <a href="#rfc.iref.g.14"><b>5.3</b></a></li> 1423 <li><tt>instance-length</tt> <a href="#rfc.iref.g.12"><b>5.2</b></a></li> 1424 <li><tt>last-byte-pos</tt> <a href="#rfc.iref.g.20"><b>5.4.1</b></a></li> 1414 <li><tt>Content-Range</tt> <a href="#rfc.iref.g.6"><b>5.2</b></a></li> 1415 <li><tt>content-range-spec</tt> <a href="#rfc.iref.g.7"><b>5.2</b></a></li> 1416 <li><tt>first-byte-pos</tt> <a href="#rfc.iref.g.16"><b>5.4.1</b></a></li> 1417 <li><tt>If-Range</tt> <a href="#rfc.iref.g.11"><b>5.3</b></a></li> 1418 <li><tt>instance-length</tt> <a href="#rfc.iref.g.10"><b>5.2</b></a></li> 1419 <li><tt>last-byte-pos</tt> <a href="#rfc.iref.g.17"><b>5.4.1</b></a></li> 1425 1420 <li><tt>other-range-unit</tt> <a href="#rfc.iref.g.3"><b>2</b></a></li> 1426 <li><tt>Range</tt> <a href="#rfc.iref.g.2 3"><b>5.4.2</b></a></li>1421 <li><tt>Range</tt> <a href="#rfc.iref.g.20"><b>5.4.2</b></a></li> 1427 1422 <li><tt>range-unit</tt> <a href="#rfc.iref.g.1"><b>2</b></a></li> 1428 <li><tt>ranges-specifier</tt> <a href="#rfc.iref.g.1 5"><b>5.4.1</b></a></li>1429 <li><tt>suffix-byte-range-spec</tt> <a href="#rfc.iref.g. 21"><b>5.4.1</b></a></li>1430 <li><tt>suffix-length</tt> <a href="#rfc.iref.g. 22"><b>5.4.1</b></a></li>1423 <li><tt>ranges-specifier</tt> <a href="#rfc.iref.g.12"><b>5.4.1</b></a></li> 1424 <li><tt>suffix-byte-range-spec</tt> <a href="#rfc.iref.g.18"><b>5.4.1</b></a></li> 1425 <li><tt>suffix-length</tt> <a href="#rfc.iref.g.19"><b>5.4.1</b></a></li> 1431 1426 </ul> 1432 1427 </li>
Note: See TracChangeset
for help on using the changeset viewer.
