Changeset 2121 for draft-ietf-httpbis/latest/p5-range.html
- Timestamp:
- 14/01/13 01:45:45 (10 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p5-range.html
r2116 r2121 449 449 } 450 450 @bottom-center { 451 content: "Expires July 1 6, 2013";451 content: "Expires July 17, 2013"; 452 452 } 453 453 @bottom-right { … … 493 493 <meta name="dct.creator" content="Reschke, J. F."> 494 494 <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p5-range-latest"> 495 <meta name="dct.issued" scheme="ISO8601" content="2013-01-1 2">495 <meta name="dct.issued" scheme="ISO8601" content="2013-01-13"> 496 496 <meta name="dct.replaces" content="urn:ietf:rfc:2616"> 497 497 <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information systems. This document defines range requests and the rules for constructing and combining responses to those requests."> … … 519 519 </tr> 520 520 <tr> 521 <td class="left">Expires: July 1 6, 2013</td>521 <td class="left">Expires: July 17, 2013</td> 522 522 <td class="right">J. Reschke, Editor</td> 523 523 </tr> … … 528 528 <tr> 529 529 <td class="left"></td> 530 <td class="right">January 1 2, 2013</td>530 <td class="right">January 13, 2013</td> 531 531 </tr> 532 532 </tbody> … … 553 553 in progress”. 554 554 </p> 555 <p>This Internet-Draft will expire on July 1 6, 2013.</p>555 <p>This Internet-Draft will expire on July 17, 2013.</p> 556 556 <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1> 557 557 <p>Copyright © 2013 IETF Trust and the persons identified as the document authors. All rights reserved.</p> … … 582 582 <li><a href="#rfc.section.3">3.</a> <a href="#status.code.definitions">Status Code Definitions</a><ul> 583 583 <li><a href="#rfc.section.3.1">3.1</a> <a href="#status.206">206 Partial Content</a></li> 584 <li><a href="#rfc.section.3.2">3.2</a> <a href="#status.416">416 R equested Range Not Satisfiable</a></li>584 <li><a href="#rfc.section.3.2">3.2</a> <a href="#status.416">416 Range Not Satisfiable</a></li> 585 585 </ul> 586 586 </li> … … 698 698 </p> 699 699 <div id="rfc.iref.3"></div> 700 <h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a> <a id="status.416" href="#status.416">416 R equested Range Not Satisfiable</a></h2>701 <p id="rfc.section.3.2.p.1">The <dfn>416 (R equested Range Not Satisfiable)</dfn> status code indicates that none of the ranges-specifier values in the request's <a href="#range.retrieval.requests" class="smpl">Range</a> header field (<a href="#header.range" id="rfc.xref.header.range.4" title="Range">Section 5.4</a>) overlap the current extent of the selected resource and the request did not include an <a href="#header.if-range" class="smpl">If-Range</a> header field (<a href="#header.if-range" id="rfc.xref.header.if-range.2" title="If-Range">Section 5.3</a>). (For byte-ranges, this means that the first-byte-pos of all of the byte-range-spec values were greater than the current700 <h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a> <a id="status.416" href="#status.416">416 Range Not Satisfiable</a></h2> 701 <p id="rfc.section.3.2.p.1">The <dfn>416 (Range Not Satisfiable)</dfn> status code indicates that none of the ranges-specifier values in the request's <a href="#range.retrieval.requests" class="smpl">Range</a> header field (<a href="#header.range" id="rfc.xref.header.range.4" title="Range">Section 5.4</a>) overlap the current extent of the selected resource and the request did not include an <a href="#header.if-range" class="smpl">If-Range</a> header field (<a href="#header.if-range" id="rfc.xref.header.if-range.2" title="If-Range">Section 5.3</a>). (For byte-ranges, this means that the first-byte-pos of all of the byte-range-spec values were greater than the current 702 702 length of the selected representation.) 703 703 </p> … … 705 705 </p> 706 706 <div id="rfc.figure.u.2"></div> 707 <p>For example:</p> <pre class="text">HTTP/1.1 416 R equested Range Not Satisfiable707 <p>For example:</p> <pre class="text">HTTP/1.1 416 Range Not Satisfiable 708 708 Date: Mon, 20 Jan 2012 15:41:54 GMT 709 709 Content-Range: bytes */47022 710 710 Content-Type: image/gif 711 711 </pre><div class="note" id="rfc.section.3.2.p.4"> 712 <p> <b>Note:</b> Clients cannot depend on servers to send a <a href="#status.416" class="smpl">416 (Requested713 Range Not Satisfiable)</a>response instead of a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response for an unsatisfiable <a href="#range.retrieval.requests" class="smpl">Range</a> header field, since not all servers implement this header field.712 <p> <b>Note:</b> Clients cannot depend on servers to send a 416 (Requested 713 Range Not Satisfiable) response instead of a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response for an unsatisfiable <a href="#range.retrieval.requests" class="smpl">Range</a> header field, since not all servers implement this header field. 714 714 </p> 715 715 </div> … … 802 802 whose instance-length value is less than or equal to its last-byte-pos value, is invalid. The recipient of an invalid byte-content-range-spec <em class="bcp14">MUST</em> ignore it and any content transferred along with it. 803 803 </p> 804 <p id="rfc.section.5.2.p.7">In the case of a byte range request: a server sending a response with status code <a href="#status.416" class="smpl">416 (Requested Range Not 805 Satisfiable)</a> <em class="bcp14">SHOULD</em> send a Content-Range field with a byte-range-resp-spec of "*". The instance-length specifies the current length of the selected 806 resource. A response with status code <a href="#status.206" class="smpl">206 (Partial Content)</a> <em class="bcp14">MUST NOT</em> send a Content-Range field with a byte-range-resp-spec of "*". 804 <p id="rfc.section.5.2.p.7">In the case of a byte range request: a server sending a response with status code <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> <em class="bcp14">SHOULD</em> send a Content-Range field with a byte-range-resp-spec of "*". The instance-length specifies the current length of the selected 805 resource. A server <em class="bcp14">MUST NOT</em> generate a a Content-Range field with a byte-range-resp-spec of "*" in a <a href="#status.206" class="smpl">206 (Partial Content)</a> response. 807 806 </p> 808 807 <p id="rfc.section.5.2.p.8">The "Content-Range" header field has no meaning for status codes that do not explicitly describe its semantic. Currently, 809 only status codes <a href="#status.206" class="smpl">206 (Partial Content)</a> and <a href="#status.416" class="smpl">416 (R equested Range Not Satisfiable)</a> describe the meaning of this header field.808 only status codes <a href="#status.206" class="smpl">206 (Partial Content)</a> and <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> describe the meaning of this header field. 810 809 </p> 811 810 <p id="rfc.section.5.2.p.9">Examples of byte-content-range-spec values, assuming that the representation contains a total of 1234 bytes: </p> … … 885 884 <p id="rfc.section.5.4.1.p.11">If a syntactically valid byte-range-set includes at least one byte-range-spec whose first-byte-pos is less than the current 886 885 length of the representation, or at least one suffix-byte-range-spec with a non-zero suffix-length, then the byte-range-set 887 is satisfiable. Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set is unsatisfiable, the server <em class="bcp14">SHOULD</em> send a response with a <a href="#status.416" class="smpl">416 (R equested Range Not Satisfiable)</a> status code. Otherwise, the server <em class="bcp14">SHOULD</em> send a response with a <a href="#status.206" class="smpl">206 (Partial Content)</a> status code containing the satisfiable ranges of the representation.886 is satisfiable. Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set is unsatisfiable, the server <em class="bcp14">SHOULD</em> send a response with a <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> status code. Otherwise, the server <em class="bcp14">SHOULD</em> send a response with a <a href="#status.206" class="smpl">206 (Partial Content)</a> status code containing the satisfiable ranges of the representation. 888 887 </p> 889 888 <p id="rfc.section.5.4.1.p.12">In the byte range syntax, <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a>, <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a>, and <a href="#rule.ranges-specifier" class="smpl">suffix-length</a> are expressed as decimal number of octets. Since there is no predefined limit to the length of an HTTP payload, recipients <em class="bcp14">SHOULD</em> anticipate potentially large decimal numerals and prevent parsing errors due to integer conversion overflows. … … 956 955 <tr> 957 956 <td class="left">416</td> 958 <td class="left">R equested Range Not Satisfiable</td>959 <td class="left"> <a href="#status.416" id="rfc.xref.status.416.1" title="416 R equested Range Not Satisfiable">Section 3.2</a>957 <td class="left">Range Not Satisfiable</td> 958 <td class="left"> <a href="#status.416" id="rfc.xref.status.416.1" title="416 Range Not Satisfiable">Section 3.2</a> 960 959 </td> 961 960 </tr> … … 1330 1329 </li> 1331 1330 <li><a id="rfc.index.4" href="#rfc.index.4"><b>4</b></a><ul> 1332 <li>416 R equested Range Not Satisfiable (status code) <a href="#rfc.iref.3"><b>3.2</b></a>, <a href="#rfc.xref.status.416.1">6.1</a></li>1331 <li>416 Range Not Satisfiable (status code) <a href="#rfc.iref.3"><b>3.2</b></a>, <a href="#rfc.xref.status.416.1">6.1</a></li> 1333 1332 </ul> 1334 1333 </li>
Note: See TracChangeset
for help on using the changeset viewer.