Changeset 2121 for draft-ietf-httpbis/latest
- Timestamp:
- 14/01/13 01:45:45 (10 years ago)
- Location:
- draft-ietf-httpbis/latest
- Files:
-
- 4 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p2-semantics.html
r2120 r2121 2342 2342 <tr> 2343 2343 <td class="left">416</td> 2344 <td class="left">R equested Range Not Satisfiable</td>2345 <td id="status.416" class="left"><a href="p5-range.html#status.416" title="416 R equested Range Not Satisfiable">Section 3.2</a> of <a href="#Part5" id="rfc.xref.Part5.10"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Range Requests">[Part5]</cite></a></td>2344 <td class="left">Range Not Satisfiable</td> 2345 <td id="status.416" class="left"><a href="p5-range.html#status.416" title="416 Range Not Satisfiable">Section 3.2</a> of <a href="#Part5" id="rfc.xref.Part5.10"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Range Requests">[Part5]</cite></a></td> 2346 2346 </tr> 2347 2347 <tr> -
draft-ietf-httpbis/latest/p2-semantics.xml
r2120 r2121 2646 2646 <c>414</c> <c>URI Too Long</c> <c><xref target="status.414"/></c> 2647 2647 <c>415</c> <c>Unsupported Media Type</c> <c><xref target="status.415"/></c> 2648 <c>416</c> <c>R equested Range Not Satisfiable</c> <c anchor="status.416">&status-416;</c>2648 <c>416</c> <c>Range Not Satisfiable</c> <c anchor="status.416">&status-416;</c> 2649 2649 <c>417</c> <c>Expectation Failed</c> <c><xref target="status.417"/></c> 2650 2650 <c>426</c> <c>Upgrade Required</c> <c><xref target="status.426"/></c> -
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> -
draft-ietf-httpbis/latest/p5-range.xml
r2080 r2121 286 286 </section> 287 287 288 <section title="416 R equested Range Not Satisfiable" anchor="status.416">289 <iref primary="true" item="416 R equested Range Not Satisfiable (status code)" x:for-anchor=""/>290 <x:anchor-alias value="416 (R equested Range Not Satisfiable)"/>291 <t> 292 The <x:dfn>416 (R equested Range Not Satisfiable)</x:dfn> status code288 <section title="416 Range Not Satisfiable" anchor="status.416"> 289 <iref primary="true" item="416 Range Not Satisfiable (status code)" x:for-anchor=""/> 290 <x:anchor-alias value="416 (Range Not Satisfiable)"/> 291 <t> 292 The <x:dfn>416 (Range Not Satisfiable)</x:dfn> status code 293 293 indicates that none of the ranges-specifier values in the request's 294 294 <x:ref>Range</x:ref> header field (<xref target="header.range"/>) … … 309 309 <preamble>For example:</preamble> 310 310 <artwork type="message/http; msgtype="response"" x:indent-with=" "> 311 HTTP/1.1 416 R equested Range Not Satisfiable311 HTTP/1.1 416 Range Not Satisfiable 312 312 Date: Mon, 20 Jan 2012 15:41:54 GMT 313 313 Content-Range: bytes */47022 … … 520 520 </t> 521 521 <t> 522 In the case of a byte range request: 523 a server sending a response with status code <x:ref>416 (Requested Range Not 524 Satisfiable)</x:ref> &SHOULD; send a Content-Range field with a byte-range-resp-spec 525 of "*". The instance-length specifies the current length of 526 the selected resource. A response with status code <x:ref>206 (Partial Content)</x:ref> 527 &MUST-NOT; send a Content-Range field with a byte-range-resp-spec of "*". 522 In the case of a byte range request: a server sending a response with 523 status code <x:ref>416 (Range Not Satisfiable)</x:ref> &SHOULD; send a 524 Content-Range field with a byte-range-resp-spec of "*". 525 The instance-length specifies the current length of the selected resource. 526 A server &MUST-NOT; generate a a Content-Range field with a 527 byte-range-resp-spec of "*" in a <x:ref>206 (Partial Content)</x:ref> 528 response. 528 529 </t> 529 530 <t> 530 531 The "Content-Range" header field has no meaning for status codes that do not 531 532 explicitly describe its semantic. Currently, only status codes 532 <x:ref>206 (Partial Content)</x:ref> and <x:ref>416 (R equested Range Not Satisfiable)</x:ref> describe533 <x:ref>206 (Partial Content)</x:ref> and <x:ref>416 (Range Not Satisfiable)</x:ref> describe 533 534 the meaning of this header field. 534 535 </t> … … 700 701 Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set 701 702 is unsatisfiable, the server &SHOULD; send a response with a 702 <x:ref>416 (R equested Range Not Satisfiable)</x:ref> status code. Otherwise, the server703 <x:ref>416 (Range Not Satisfiable)</x:ref> status code. Otherwise, the server 703 704 &SHOULD; send a response with a <x:ref>206 (Partial Content)</x:ref> status code 704 705 containing the satisfiable ranges of the representation. … … 823 824 </c> 824 825 <c>416</c> 825 <c>R equested Range Not Satisfiable</c>826 <c>Range Not Satisfiable</c> 826 827 <c> 827 828 <xref target="status.416"/>
Note: See TracChangeset
for help on using the changeset viewer.