source: draft-ietf-httpbis/latest/p5-range.html @ 2525

Last change on this file since 2525 was 2525, checked in by julian.reschke@…, 7 years ago

improve introduction of list operator (see #542)

  • Property svn:eol-style set to native
  • Property svn:mime-type set to text/html;charset=utf-8
File size: 106.6 KB
Line 
1<!DOCTYPE html
2  PUBLIC "-//W3C//DTD HTML 4.01//EN">
3<html lang="en">
4   <head profile="http://dublincore.org/documents/2008/08/04/dc-html/">
5      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
6      <title>Hypertext Transfer Protocol (HTTP/1.1): Range Requests</title><script>
7var buttonsAdded = false;
8
9function init() {
10  var fb = document.createElement("div");
11  fb.className = "feedback noprint";
12  fb.setAttribute("onclick", "feedback();");
13  fb.appendChild(document.createTextNode("feedback"));
14
15  var bodyl = document.getElementsByTagName("body");
16  bodyl.item(0).appendChild(fb);
17}
18
19function feedback() {
20  toggleButtonsToElementsByName("h1");
21  toggleButtonsToElementsByName("h2");
22  toggleButtonsToElementsByName("h3");
23  toggleButtonsToElementsByName("h4");
24
25  buttonsAdded = !buttonsAdded;
26}
27
28function toggleButtonsToElementsByName(name) {
29  var list = document.getElementsByTagName(name);
30  for (var i = 0; i < list.length; i++) {
31    toggleButton(list.item(i));
32  }
33}
34
35function toggleButton(node) {
36  if (! buttonsAdded) {
37
38    // docname
39    var template = "mailto:ietf-http-wg@w3.org?subject={docname},%20%22{section}%22&body=<{ref}>:";
40
41    var id = node.getAttribute("id");
42    // better id available?
43    var titlelinks = node.getElementsByTagName("a");
44    for (var i = 0; i < titlelinks.length; i++) {
45      var tl = titlelinks.item(i);
46      if (tl.getAttribute("id")) {
47        id = tl.getAttribute("id");
48      }
49    }
50
51    // ref
52    var ref = window.location.toString();
53    var hash = ref.indexOf("#");
54    if (hash != -1) {
55      ref = ref.substring(0, hash);
56    }
57    if (id != "") {
58      ref += "#" + id;
59    }
60
61    // docname
62    var docname = "draft-ietf-httpbis-p5-range-latest";
63
64    // section
65    var section = node.textContent;
66    section = section.replace("\u00a0", " ");
67
68    // build URI from template
69    var uri = template.replace("{docname}", encodeURIComponent(docname));
70    uri = uri.replace("{section}", encodeURIComponent(section));
71    uri = uri.replace("{ref}", encodeURIComponent(ref));
72
73    var button = document.createElement("a");
74    button.className = "fbbutton noprint";
75    button.setAttribute("href", uri);
76    button.appendChild(document.createTextNode("send feedback"));
77    node.appendChild(button);
78  }
79  else {
80    var buttons = node.getElementsByTagName("a");
81    for (var i = 0; i < buttons.length; i++) {
82      var b = buttons.item(i);
83      if (b.className == "fbbutton noprint") {
84        node.removeChild(b);
85      }
86    }
87  }
88}</script><style type="text/css" title="Xml2Rfc (sans serif)">
89a {
90  text-decoration: none;
91}
92a.smpl {
93  color: black;
94}
95a:hover {
96  text-decoration: underline;
97}
98a:active {
99  text-decoration: underline;
100}
101address {
102  margin-top: 1em;
103  margin-left: 2em;
104  font-style: normal;
105}
106body {
107  color: black;
108  font-family: cambria, helvetica, arial, sans-serif;
109  font-size: 11pt;
110  margin-right: 2em;
111}
112cite {
113  font-style: normal;
114}
115div.note {
116  margin-left: 2em;
117}
118dl {
119  margin-left: 2em;
120}
121ul.empty {
122  list-style-type: none;
123}
124ul.empty li {
125  margin-top: .5em;
126}
127dl p {
128  margin-left: 0em;
129}
130dt {
131  margin-top: .5em;
132}
133h1 {
134  font-size: 130%;
135  line-height: 21pt;
136  page-break-after: avoid;
137}
138h1.np {
139  page-break-before: always;
140}
141h2 {
142  font-size: 120%;
143  line-height: 15pt;
144  page-break-after: avoid;
145}
146h3 {
147  font-size: 110%;
148  page-break-after: avoid;
149}
150h4, h5, h6 {
151  page-break-after: avoid;
152}
153h1 a, h2 a, h3 a, h4 a, h5 a, h6 a {
154  color: black;
155}
156img {
157  margin-left: 3em;
158}
159li {
160  margin-left: 2em;
161}
162ol {
163  margin-left: 2em;
164}
165ol.la {
166  list-style-type: lower-alpha;
167}
168ol.ua {
169  list-style-type: upper-alpha;
170}
171ol p {
172  margin-left: 0em;
173}
174p {
175  margin-left: 2em;
176}
177pre {
178  margin-left: 3em;
179  background-color: lightyellow;
180  padding: .25em;
181  page-break-inside: avoid;
182}
183pre.text2 {
184  border-style: dotted;
185  border-width: 1px;
186  background-color: #f0f0f0;
187  width: 69em;
188}
189pre.inline {
190  background-color: white;
191  padding: 0em;
192}
193pre.text {
194  border-style: dotted;
195  border-width: 1px;
196  background-color: #f8f8f8;
197  width: 69em;
198}
199pre.drawing {
200  border-style: solid;
201  border-width: 1px;
202  background-color: #f8f8f8;
203  padding: 2em;
204}
205table {
206  margin-left: 2em;
207}
208table.tt {
209  vertical-align: top;
210}
211table.full {
212  border-style: outset;
213  border-width: 1px;
214}
215table.headers {
216  border-style: outset;
217  border-width: 1px;
218}
219table.tt td {
220  vertical-align: top;
221}
222table.full td {
223  border-style: inset;
224  border-width: 1px;
225}
226table.tt th {
227  vertical-align: top;
228}
229table.full th {
230  border-style: inset;
231  border-width: 1px;
232}
233table.headers th {
234  border-style: none none inset none;
235  border-width: 1px;
236}
237table.left {
238  margin-right: auto;
239}
240table.right {
241  margin-left: auto;
242}
243table.center {
244  margin-left: auto;
245  margin-right: auto;
246}
247caption {
248  caption-side: bottom;
249  font-weight: bold;
250  font-size: 10pt;
251  margin-top: .5em;
252}
253
254table.header {
255  border-spacing: 1px;
256  width: 95%;
257  font-size: 11pt;
258  color: white;
259}
260td.top {
261  vertical-align: top;
262}
263td.topnowrap {
264  vertical-align: top;
265  white-space: nowrap;
266}
267table.header td {
268  background-color: gray;
269  width: 50%;
270}
271table.header a {
272  color: white;
273}
274td.reference {
275  vertical-align: top;
276  white-space: nowrap;
277  padding-right: 1em;
278}
279thead {
280  display:table-header-group;
281}
282ul.toc, ul.toc ul {
283  list-style: none;
284  margin-left: 1.5em;
285  padding-left: 0em;
286}
287ul.toc li {
288  line-height: 150%;
289  font-weight: bold;
290  margin-left: 0em;
291}
292ul.toc li li {
293  line-height: normal;
294  font-weight: normal;
295  font-size: 10pt;
296  margin-left: 0em;
297}
298li.excluded {
299  font-size: 0pt;
300}
301ul p {
302  margin-left: 0em;
303}
304.title, .filename, h1, h2, h3, h4 {
305  font-family: candara, helvetica, arial, sans-serif;
306}
307samp, tt, code, pre {
308  font: consolas, monospace;
309}
310ul.ind, ul.ind ul {
311  list-style: none;
312  margin-left: 1.5em;
313  padding-left: 0em;
314  page-break-before: avoid;
315}
316ul.ind li {
317  font-weight: bold;
318  line-height: 200%;
319  margin-left: 0em;
320}
321ul.ind li li {
322  font-weight: normal;
323  line-height: 150%;
324  margin-left: 0em;
325}
326.avoidbreak {
327  page-break-inside: avoid;
328}
329.bcp14 {
330  font-style: normal;
331  text-transform: lowercase;
332  font-variant: small-caps;
333}
334.comment {
335  background-color: yellow;
336}
337.center {
338  text-align: center;
339}
340.error {
341  color: red;
342  font-style: italic;
343  font-weight: bold;
344}
345.figure {
346  font-weight: bold;
347  text-align: center;
348  font-size: 10pt;
349}
350.filename {
351  color: #333333;
352  font-size: 75%;
353  font-weight: bold;
354  line-height: 21pt;
355  text-align: center;
356}
357.fn {
358  font-weight: bold;
359}
360.left {
361  text-align: left;
362}
363.right {
364  text-align: right;
365}
366.title {
367  color: green;
368  font-size: 150%;
369  line-height: 18pt;
370  font-weight: bold;
371  text-align: center;
372  margin-top: 36pt;
373}
374.warning {
375  font-size: 130%;
376  background-color: yellow;
377}
378.feedback {
379  position: fixed;
380  bottom: 1%;
381  right: 1%;
382  padding: 3px 5px;
383  color: white;
384  border-radius: 5px;
385  background: #a00000;
386  border: 1px solid silver;
387}
388.fbbutton {
389  margin-left: 1em;
390  color: #303030;
391  font-size: small;
392  font-weight: normal;
393  background: #d0d000;
394  padding: 1px 4px;
395  border: 1px solid silver;
396  border-radius: 5px;
397}
398
399@media print {
400  .noprint {
401    display: none;
402  }
403
404  a {
405    color: black;
406    text-decoration: none;
407  }
408
409  table.header {
410    width: 90%;
411  }
412
413  td.header {
414    width: 50%;
415    color: black;
416    background-color: white;
417    vertical-align: top;
418    font-size: 110%;
419  }
420
421  ul.toc a:nth-child(2)::after {
422    content: leader('.') target-counter(attr(href), page);
423  }
424
425  ul.ind li li a {
426    content: target-counter(attr(href), page);
427  }
428
429  .print2col {
430    column-count: 2;
431    -moz-column-count: 2;
432    column-fill: auto;
433  }
434}
435
436@page {
437  @top-left {
438       content: "Internet-Draft";
439  }
440  @top-right {
441       content: "December 2013";
442  }
443  @top-center {
444       content: "HTTP/1.1 Range Requests";
445  }
446  @bottom-left {
447       content: "Fielding, et al.";
448  }
449  @bottom-center {
450       content: "Expires June 30, 2014";
451  }
452  @bottom-right {
453       content: "[Page " counter(page) "]";
454  }
455}
456
457@page:first {
458    @top-left {
459      content: normal;
460    }
461    @top-right {
462      content: normal;
463    }
464    @top-center {
465      content: normal;
466    }
467}
468</style><link rel="Contents" href="#rfc.toc">
469      <link rel="Author" href="#rfc.authors">
470      <link rel="Copyright" href="#rfc.copyrightnotice">
471      <link rel="Index" href="#rfc.index">
472      <link rel="Chapter" title="1 Introduction" href="#rfc.section.1">
473      <link rel="Chapter" title="2 Range Units" href="#rfc.section.2">
474      <link rel="Chapter" title="3 Range Requests" href="#rfc.section.3">
475      <link rel="Chapter" title="4 Responses to a Range Request" href="#rfc.section.4">
476      <link rel="Chapter" title="5 IANA Considerations" href="#rfc.section.5">
477      <link rel="Chapter" title="6 Security Considerations" href="#rfc.section.6">
478      <link rel="Chapter" title="7 Acknowledgments" href="#rfc.section.7">
479      <link rel="Chapter" href="#rfc.section.8" title="8 References">
480      <link rel="Appendix" title="A Internet Media Type multipart/byteranges" href="#rfc.section.A">
481      <link rel="Appendix" title="B Changes from RFC 2616" href="#rfc.section.B">
482      <link rel="Appendix" title="C Imported ABNF" href="#rfc.section.C">
483      <link rel="Appendix" title="D Collected ABNF" href="#rfc.section.D">
484      <link rel="Appendix" title="E Change Log (to be removed by RFC Editor before publication)" href="#rfc.section.E">
485      <link href="p4-conditional.html" rel="prev">
486      <link href="p6-cache.html" rel="next">
487      <meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.611, 2013/11/27 12:23:51, XSLT vendor: SAXON 8.9 from Saxonica http://www.saxonica.com/">
488      <link rel="schema.dct" href="http://purl.org/dc/terms/">
489      <meta name="dct.creator" content="Fielding, R.">
490      <meta name="dct.creator" content="Lafon, Y.">
491      <meta name="dct.creator" content="Reschke, J. F.">
492      <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p5-range-latest">
493      <meta name="dct.issued" scheme="ISO8601" content="2013-12-27">
494      <meta name="dct.replaces" content="urn:ietf:rfc:2616">
495      <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.">
496      <meta name="description" 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.">
497   </head>
498   <body onload="init();">
499      <table class="header">
500         <tbody>
501            <tr>
502               <td class="left">HTTPbis Working Group</td>
503               <td class="right">R. Fielding, Editor</td>
504            </tr>
505            <tr>
506               <td class="left">Internet-Draft</td>
507               <td class="right">Adobe</td>
508            </tr>
509            <tr>
510               <td class="left">Obsoletes: <a href="http://tools.ietf.org/html/rfc2616">2616</a> (if approved)
511               </td>
512               <td class="right">Y. Lafon, Editor</td>
513            </tr>
514            <tr>
515               <td class="left">Intended status: Standards Track</td>
516               <td class="right">W3C</td>
517            </tr>
518            <tr>
519               <td class="left">Expires: June 30, 2014</td>
520               <td class="right">J. Reschke, Editor</td>
521            </tr>
522            <tr>
523               <td class="left"></td>
524               <td class="right">greenbytes</td>
525            </tr>
526            <tr>
527               <td class="left"></td>
528               <td class="right">December 27, 2013</td>
529            </tr>
530         </tbody>
531      </table>
532      <p class="title">Hypertext Transfer Protocol (HTTP/1.1): Range Requests<br><span class="filename">draft-ietf-httpbis-p5-range-latest</span></p>
533      <h1 id="rfc.abstract"><a href="#rfc.abstract">Abstract</a></h1>
534      <p>The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information
535         systems. This document defines range requests and the rules for constructing and combining responses to those requests.
536      </p>
537      <h1 id="rfc.note.1"><a href="#rfc.note.1">Editorial Note (To be removed by RFC Editor)</a></h1>
538      <p>Discussion of this draft takes place on the HTTPBIS working group mailing list (ietf-http-wg@w3.org), which is archived at &lt;<a href="http://lists.w3.org/Archives/Public/ietf-http-wg/">http://lists.w3.org/Archives/Public/ietf-http-wg/</a>&gt;.
539      </p>
540      <p>The current issues list is at &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/report/3">http://tools.ietf.org/wg/httpbis/trac/report/3</a>&gt; and related documents (including fancy diffs) can be found at &lt;<a href="http://tools.ietf.org/wg/httpbis/">http://tools.ietf.org/wg/httpbis/</a>&gt;.
541      </p>
542      <p>The changes in this draft are summarized in <a href="#changes.since.25" title="Since draft-ietf-httpbis-p5-range-25">Appendix&nbsp;E.2</a>.
543      </p>
544      <div id="rfc.status">
545         <h1><a href="#rfc.status">Status of This Memo</a></h1>
546         <p>This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.</p>
547         <p>Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute
548            working documents as Internet-Drafts. The list of current Internet-Drafts is at <a href="http://datatracker.ietf.org/drafts/current/">http://datatracker.ietf.org/drafts/current/</a>.
549         </p>
550         <p>Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other
551            documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as “work
552            in progress”.
553         </p>
554         <p>This Internet-Draft will expire on June 30, 2014.</p>
555      </div>
556      <div id="rfc.copyrightnotice">
557         <h1><a href="#rfc.copyrightnotice">Copyright Notice</a></h1>
558         <p>Copyright © 2013 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
559         <p>This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (<a href="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</a>) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights
560            and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License
561            text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified
562            BSD License.
563         </p>
564         <p>This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November
565            10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to
566            allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s)
567            controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative
568            works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate
569            it into languages other than English.
570         </p>
571      </div>
572      <hr class="noprint">
573      <h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1>
574      <ul class="toc">
575         <li><a href="#rfc.section.1">1.</a>&nbsp;&nbsp;&nbsp;<a href="#introduction">Introduction</a><ul>
576               <li><a href="#rfc.section.1.1">1.1</a>&nbsp;&nbsp;&nbsp;<a href="#conformance">Conformance and Error Handling</a></li>
577               <li><a href="#rfc.section.1.2">1.2</a>&nbsp;&nbsp;&nbsp;<a href="#notation">Syntax Notation</a></li>
578            </ul>
579         </li>
580         <li><a href="#rfc.section.2">2.</a>&nbsp;&nbsp;&nbsp;<a href="#range.units">Range Units</a><ul>
581               <li><a href="#rfc.section.2.1">2.1</a>&nbsp;&nbsp;&nbsp;<a href="#byte.ranges">Byte Ranges</a></li>
582               <li><a href="#rfc.section.2.2">2.2</a>&nbsp;&nbsp;&nbsp;<a href="#range.units.other">Other Range Units</a></li>
583               <li><a href="#rfc.section.2.3">2.3</a>&nbsp;&nbsp;&nbsp;<a href="#header.accept-ranges">Accept-Ranges</a></li>
584            </ul>
585         </li>
586         <li><a href="#rfc.section.3">3.</a>&nbsp;&nbsp;&nbsp;<a href="#range.requests">Range Requests</a><ul>
587               <li><a href="#rfc.section.3.1">3.1</a>&nbsp;&nbsp;&nbsp;<a href="#header.range">Range</a></li>
588               <li><a href="#rfc.section.3.2">3.2</a>&nbsp;&nbsp;&nbsp;<a href="#header.if-range">If-Range</a></li>
589            </ul>
590         </li>
591         <li><a href="#rfc.section.4">4.</a>&nbsp;&nbsp;&nbsp;<a href="#range.response">Responses to a Range Request</a><ul>
592               <li><a href="#rfc.section.4.1">4.1</a>&nbsp;&nbsp;&nbsp;<a href="#status.206">206 Partial Content</a></li>
593               <li><a href="#rfc.section.4.2">4.2</a>&nbsp;&nbsp;&nbsp;<a href="#header.content-range">Content-Range</a></li>
594               <li><a href="#rfc.section.4.3">4.3</a>&nbsp;&nbsp;&nbsp;<a href="#combining.byte.ranges">Combining Ranges</a></li>
595               <li><a href="#rfc.section.4.4">4.4</a>&nbsp;&nbsp;&nbsp;<a href="#status.416">416 Range Not Satisfiable</a></li>
596            </ul>
597         </li>
598         <li><a href="#rfc.section.5">5.</a>&nbsp;&nbsp;&nbsp;<a href="#IANA.considerations">IANA Considerations</a><ul>
599               <li><a href="#rfc.section.5.1">5.1</a>&nbsp;&nbsp;&nbsp;<a href="#range.unit.registry">Range Unit Registry</a><ul>
600                     <li><a href="#rfc.section.5.1.1">5.1.1</a>&nbsp;&nbsp;&nbsp;<a href="#range.unit.registry.procedure">Procedure</a></li>
601                     <li><a href="#rfc.section.5.1.2">5.1.2</a>&nbsp;&nbsp;&nbsp;<a href="#range.unit.registration">Registrations</a></li>
602                  </ul>
603               </li>
604               <li><a href="#rfc.section.5.2">5.2</a>&nbsp;&nbsp;&nbsp;<a href="#status.code.registration">Status Code Registration</a></li>
605               <li><a href="#rfc.section.5.3">5.3</a>&nbsp;&nbsp;&nbsp;<a href="#header.field.registration">Header Field Registration</a></li>
606               <li><a href="#rfc.section.5.4">5.4</a>&nbsp;&nbsp;&nbsp;<a href="#internet.media.type.http">Internet Media Type Registration</a><ul>
607                     <li><a href="#rfc.section.5.4.1">5.4.1</a>&nbsp;&nbsp;&nbsp;<a href="#internet.media.type.multipart.byteranges.reg">Internet Media Type multipart/byteranges</a></li>
608                  </ul>
609               </li>
610            </ul>
611         </li>
612         <li><a href="#rfc.section.6">6.</a>&nbsp;&nbsp;&nbsp;<a href="#security.considerations">Security Considerations</a><ul>
613               <li><a href="#rfc.section.6.1">6.1</a>&nbsp;&nbsp;&nbsp;<a href="#overlapping.ranges">Denial of Service Attacks using Range</a></li>
614            </ul>
615         </li>
616         <li><a href="#rfc.section.7">7.</a>&nbsp;&nbsp;&nbsp;<a href="#acks">Acknowledgments</a></li>
617         <li><a href="#rfc.section.8">8.</a>&nbsp;&nbsp;&nbsp;<a href="#rfc.references">References</a><ul>
618               <li><a href="#rfc.section.8.1">8.1</a>&nbsp;&nbsp;&nbsp;<a href="#rfc.references.1">Normative References</a></li>
619               <li><a href="#rfc.section.8.2">8.2</a>&nbsp;&nbsp;&nbsp;<a href="#rfc.references.2">Informative References</a></li>
620            </ul>
621         </li>
622         <li><a href="#rfc.authors">Authors' Addresses</a></li>
623         <li><a href="#rfc.section.A">A.</a>&nbsp;&nbsp;&nbsp;<a href="#internet.media.type.multipart.byteranges">Internet Media Type multipart/byteranges</a></li>
624         <li><a href="#rfc.section.B">B.</a>&nbsp;&nbsp;&nbsp;<a href="#changes.from.rfc.2616">Changes from RFC 2616</a></li>
625         <li><a href="#rfc.section.C">C.</a>&nbsp;&nbsp;&nbsp;<a href="#imported.abnf">Imported ABNF</a></li>
626         <li><a href="#rfc.section.D">D.</a>&nbsp;&nbsp;&nbsp;<a href="#collected.abnf">Collected ABNF</a></li>
627         <li><a href="#rfc.section.E">E.</a>&nbsp;&nbsp;&nbsp;<a href="#change.log">Change Log (to be removed by RFC Editor before publication)</a><ul>
628               <li><a href="#rfc.section.E.1">E.1</a>&nbsp;&nbsp;&nbsp;<a href="#changes.since.24">Since draft-ietf-httpbis-p5-range-24</a></li>
629               <li><a href="#rfc.section.E.2">E.2</a>&nbsp;&nbsp;&nbsp;<a href="#changes.since.25">Since draft-ietf-httpbis-p5-range-25</a></li>
630            </ul>
631         </li>
632         <li><a href="#rfc.index">Index</a></li>
633      </ul>
634      <div id="introduction">
635         <h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a>&nbsp;<a href="#introduction">Introduction</a></h1>
636         <p id="rfc.section.1.p.1">Hypertext Transfer Protocol (HTTP) clients often encounter interrupted data transfers as a result of canceled requests or
637            dropped connections. When a client has stored a partial representation, it is desirable to request the remainder of that representation
638            in a subsequent request rather than transfer the entire representation. Likewise, devices with limited local storage might
639            benefit from being able to request only a subset of a larger representation, such as a single page of a very large document,
640            or the dimensions of an embedded image.
641         </p>
642         <p id="rfc.section.1.p.2">This document defines HTTP/1.1 range requests, partial responses, and the multipart/byteranges media type. Range requests
643            are an <em class="bcp14">OPTIONAL</em> feature of HTTP, designed so that recipients not implementing this feature (or not supporting it for the target resource)
644            can respond as if it is a normal GET request without impacting interoperability. Partial responses are indicated by a distinct
645            status code to not be mistaken for full responses by caches that might not implement the feature.
646         </p>
647         <p id="rfc.section.1.p.3">Although the range request mechanism is designed to allow for extensible range types, this specification only defines requests
648            for byte ranges.
649         </p>
650         <div id="conformance">
651            <h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a>&nbsp;<a href="#conformance">Conformance and Error Handling</a></h2>
652            <p id="rfc.section.1.1.p.1">The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL"
653               in this document are to be interpreted as described in <a href="#RFC2119" id="rfc.xref.RFC2119.1"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>.
654            </p>
655            <p id="rfc.section.1.1.p.2">Conformance criteria and considerations regarding error handling are defined in <a href="p1-messaging.html#conformance" title="Conformance and Error Handling">Section 2.5</a> of <a href="#Part1" id="rfc.xref.Part1.1"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>.
656            </p>
657         </div>
658         <div id="notation">
659            <h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;<a href="#notation">Syntax Notation</a></h2>
660            <p id="rfc.section.1.2.p.1">This specification uses the Augmented Backus-Naur Form (ABNF) notation of <a href="#RFC5234" id="rfc.xref.RFC5234.1"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a> with an extension defined in <a href="p1-messaging.html#abnf.extension" title="ABNF list extension: #rule">Section 7</a> of <a href="#Part1" id="rfc.xref.Part1.2"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a> that adds compact support for comma-separated lists with the addition of a '#' operator, similar to the '*' operator. <a href="#imported.abnf" title="Imported ABNF">Appendix&nbsp;C</a> describes rules imported from other documents. <a href="#collected.abnf" title="Collected ABNF">Appendix&nbsp;D</a> shows the collected ABNF with the rules using the list operator expanded to standard ABNF notation.
661            </p>
662         </div>
663      </div>
664      <div id="range.units">
665         <h1 id="rfc.section.2"><a href="#rfc.section.2">2.</a>&nbsp;<a href="#range.units">Range Units</a></h1>
666         <p id="rfc.section.2.p.1">A representation can be partitioned into subranges according to various structural units, depending on the structure inherent
667            in the representation's media type. This "<dfn>range unit</dfn>" is used in the <a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> (<a href="#header.accept-ranges" id="rfc.xref.header.accept-ranges.1" title="Accept-Ranges">Section&nbsp;2.3</a>) response header field to advertise support for range requests, the <a href="#header.range" class="smpl">Range</a> (<a href="#header.range" id="rfc.xref.header.range.1" title="Range">Section&nbsp;3.1</a>) request header field to delineate the parts of a representation that are requested, and the <a href="#header.content-range" class="smpl">Content-Range</a> (<a href="#header.content-range" id="rfc.xref.header.content-range.1" title="Content-Range">Section&nbsp;4.2</a>) payload header field to describe which part of a representation is being transferred.
668         </p>
669         <div id="rfc.figure.u.1"></div><pre class="inline"><span id="rfc.iref.g.1"></span><span id="rfc.iref.g.2"></span><span id="rfc.iref.g.3"></span>  <a href="#range.units" class="smpl">range-unit</a>       = <a href="#byte.ranges" class="smpl">bytes-unit</a> / <a href="#range.units.other" class="smpl">other-range-unit</a>
670</pre><div id="byte.ranges">
671            <h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a>&nbsp;<a href="#byte.ranges">Byte Ranges</a></h2>
672            <p id="rfc.section.2.1.p.1">Since representation data is transferred in payloads as a sequence of octets, a byte range is a meaningful substructure for
673               any representation transferable over HTTP (<a href="p2-semantics.html#representations" title="Representations">Section 3</a> of <a href="#Part2" id="rfc.xref.Part2.1"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content">[Part2]</cite></a>). We define the "bytes" range unit for expressing subranges of the data's octet sequence.
674            </p>
675            <div id="rfc.figure.u.2"></div><pre class="inline"><span id="rfc.iref.g.4"></span>  <a href="#byte.ranges" class="smpl">bytes-unit</a>       = "bytes"
676</pre><div id="rule.ranges-specifier">
677               <p id="rfc.section.2.1.p.3">        A byte range request can specify a single range of bytes, or a set of ranges within a single representation.</p>
678            </div>
679            <div id="rfc.figure.u.3"></div><pre class="inline"><span id="rfc.iref.g.5"></span><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="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> = <a href="#byte.ranges" class="smpl">bytes-unit</a> "=" <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a>
680  <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> )
681  <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> ]
682  <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a>  = 1*<a href="#imported.abnf" class="smpl">DIGIT</a>
683  <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a>   = 1*<a href="#imported.abnf" class="smpl">DIGIT</a>
684</pre><p id="rfc.section.2.1.p.5">The <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> value in a <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> gives the byte-offset of the first byte in a range. The <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> value gives the byte-offset of the last byte in the range; that is, the byte positions specified are inclusive. Byte offsets
685               start at zero.
686            </p>
687            <p id="rfc.section.2.1.p.6">Examples of <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> values:
688            </p>
689            <ul>
690               <li>The first 500 bytes (byte offsets 0-499, inclusive):
691                  <div id="rfc.figure.u.4"></div><pre class="text">  bytes=0-499
692</pre> </li>
693               <li>The second 500 bytes (byte offsets 500-999, inclusive):
694                  <div id="rfc.figure.u.5"></div><pre class="text">  bytes=500-999
695</pre> </li>
696            </ul>
697            <p id="rfc.section.2.1.p.7">A <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> is invalid if the <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> value is present and less than the <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a>.
698            </p>
699            <p id="rfc.section.2.1.p.8">A client can limit the number of bytes requested without knowing the size of the selected representation. If the <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> value is absent, or if the value is greater than or equal to the current length of the representation data, the byte range
700               is interpreted as the remainder of the representation (i.e., the server replaces the value of <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> with a value that is one less than the current length of the selected representation).
701            </p>
702            <p id="rfc.section.2.1.p.9">A client can request the last N bytes of the selected representation using a <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a>.
703            </p>
704            <div id="rfc.figure.u.6"></div><pre class="inline"><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span>  <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> = "-" <a href="#rule.ranges-specifier" class="smpl">suffix-length</a>
705  <a href="#rule.ranges-specifier" class="smpl">suffix-length</a> = 1*<a href="#imported.abnf" class="smpl">DIGIT</a>
706</pre><p id="rfc.section.2.1.p.11">If the selected representation is shorter than the specified <a href="#rule.ranges-specifier" class="smpl">suffix-length</a>, the entire representation is used.
707            </p>
708            <p id="rfc.section.2.1.p.12">Additional examples, assuming a representation of length 10000: </p>
709            <ul>
710               <li>The final 500 bytes (byte offsets 9500-9999, inclusive):
711                  <div id="rfc.figure.u.7"></div><pre class="text">  bytes=-500
712</pre> Or: <div id="rfc.figure.u.8"></div><pre class="text">  bytes=9500-
713</pre> </li>
714               <li>The first and last bytes only (bytes 0 and 9999):
715                  <div id="rfc.figure.u.9"></div><pre class="text">  bytes=0-0,-1
716</pre> </li>
717               <li>Other valid (but not canonical) specifications of the second 500 bytes (byte offsets 500-999, inclusive):
718                  <div id="rfc.figure.u.10"></div><pre class="text">  bytes=500-600,601-999
719  bytes=500-700,601-999
720</pre> </li>
721            </ul>
722            <p id="rfc.section.2.1.p.13">If a valid <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> includes at least one <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> with a <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> that is less than the current length of the representation, or at least one <a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> with a non-zero <a href="#rule.ranges-specifier" class="smpl">suffix-length</a>, then the <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> is satisfiable. Otherwise, the <a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> is unsatisfiable.
723            </p>
724            <p id="rfc.section.2.1.p.14">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 a payload, recipients <em class="bcp14">MUST</em> anticipate potentially large decimal numerals and prevent parsing errors due to integer conversion overflows.
725            </p>
726         </div>
727         <div id="range.units.other">
728            <h2 id="rfc.section.2.2"><a href="#rfc.section.2.2">2.2</a>&nbsp;<a href="#range.units.other">Other Range Units</a></h2>
729            <p id="rfc.section.2.2.p.1">Range units are intended to be extensible. New range units ought to be registered with IANA, as defined in <a href="#range.unit.registry" title="Range Unit Registry">Section&nbsp;5.1</a>.
730            </p>
731            <div id="rfc.figure.u.11"></div><pre class="inline"><span id="rfc.iref.g.13"></span>  <a href="#range.units.other" class="smpl">other-range-unit</a> = <a href="#imported.abnf" class="smpl">token</a>
732</pre></div>
733         <div id="header.accept-ranges">
734            <div id="rfc.iref.a.1"></div>
735            <h2 id="rfc.section.2.3"><a href="#rfc.section.2.3">2.3</a>&nbsp;<a href="#header.accept-ranges">Accept-Ranges</a></h2>
736            <p id="rfc.section.2.3.p.1">The "Accept-Ranges" header field allows a server to indicate that it supports range requests for the target resource.</p>
737            <div id="rfc.figure.u.12"></div><pre class="inline"><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span>  <a href="#header.accept-ranges" class="smpl">Accept-Ranges</a>     = <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a>
738  <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> = 1#<a href="#range.units" class="smpl">range-unit</a> / "none"
739</pre><p id="rfc.section.2.3.p.3">An origin server that supports byte-range requests for a given target resource <em class="bcp14">MAY</em> send
740            </p>
741            <div id="rfc.figure.u.13"></div><pre class="text">  Accept-Ranges: bytes
742</pre><p id="rfc.section.2.3.p.5">to indicate what range units are supported. A client <em class="bcp14">MAY</em> generate range requests without having received this header field for the resource involved. Range units are defined in <a href="#range.units" title="Range Units">Section&nbsp;2</a>.
743            </p>
744            <p id="rfc.section.2.3.p.6">A server that does not support any kind of range request for the target resource <em class="bcp14">MAY</em> send
745            </p>
746            <div id="rfc.figure.u.14"></div><pre class="text">  Accept-Ranges: none
747</pre><p id="rfc.section.2.3.p.8">to advise the client not to attempt a range request.</p>
748         </div>
749      </div>
750      <div id="range.requests">
751         <h1 id="rfc.section.3"><a href="#rfc.section.3">3.</a>&nbsp;<a href="#range.requests">Range Requests</a></h1>
752         <div id="header.range">
753            <div id="rfc.iref.r.1"></div>
754            <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;<a href="#header.range">Range</a></h2>
755            <p id="rfc.section.3.1.p.1">The "Range" header field on a GET request modifies the method semantics to request transfer of only one or more subranges
756               of the selected representation data, rather than the entire selected representation data.
757            </p>
758            <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.16"></span>  <a href="#header.range" class="smpl">Range</a> = <a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> / <a href="#header.range" class="smpl">other-ranges-specifier</a>
759  <a href="#header.range" class="smpl">other-ranges-specifier</a> = <a href="#range.units.other" class="smpl">other-range-unit</a> "=" <a href="#header.range" class="smpl">other-range-set</a>
760  <a href="#header.range" class="smpl">other-range-set</a> = 1*<a href="#imported.abnf" class="smpl">VCHAR</a>
761</pre><p id="rfc.section.3.1.p.3">A server <em class="bcp14">MAY</em> ignore the Range header field. However, origin servers and intermediate caches ought to support byte ranges when possible,
762               since Range supports efficient recovery from partially failed transfers and partial retrieval of large representations. A
763               server <em class="bcp14">MUST</em> ignore a Range header field received with a request method other than GET.
764            </p>
765            <p id="rfc.section.3.1.p.4">An origin server <em class="bcp14">MUST</em> ignore a Range header field that contains a range unit it does not understand. A proxy <em class="bcp14">MAY</em> discard a Range header field that contains a range unit it does not understand.
766            </p>
767            <p id="rfc.section.3.1.p.5">A server that supports range requests <em class="bcp14">MAY</em> ignore or reject a <a href="#header.range" class="smpl">Range</a> header field that consists of more than two overlapping ranges, or a set of many small ranges that are not listed in ascending
768               order, since both are indications of either a broken client or a deliberate denial of service attack (<a href="#overlapping.ranges" title="Denial of Service Attacks using Range">Section&nbsp;6.1</a>). A client <em class="bcp14">SHOULD NOT</em> request multiple ranges that are inherently less efficient to process and transfer than a single range that encompasses the
769               same data.
770            </p>
771            <p id="rfc.section.3.1.p.6">A client that is requesting multiple ranges <em class="bcp14">SHOULD</em> list those ranges in ascending order (the order in which they would typically be received in a complete representation) unless
772               there is a specific need to request a later part earlier. For example, a user agent processing a large representation with
773               an internal catalog of parts might need to request later parts first, particularly if the representation consists of pages
774               stored in reverse order and the user agent wishes to transfer one page at a time.
775            </p>
776            <p id="rfc.section.3.1.p.7">The Range header field is evaluated after evaluating the precondition header fields defined in <a href="#Part4" id="rfc.xref.Part4.1"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>, and only if the result in absence of the Range header field would be a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response. In other words, Range is ignored when a conditional GET would result in a <a href="p4-conditional.html#status.304" class="smpl">304 (Not Modified)</a> response.
777            </p>
778            <p id="rfc.section.3.1.p.8">The If-Range header field (<a href="#header.if-range" id="rfc.xref.header.if-range.1" title="If-Range">Section&nbsp;3.2</a>) can be used as a precondition to applying the Range header field.
779            </p>
780            <p id="rfc.section.3.1.p.9">If all of the preconditions are true, the server supports the Range header field for the target resource, and the specified
781               range(s) are valid and satisfiable (as defined in <a href="#byte.ranges" title="Byte Ranges">Section&nbsp;2.1</a>), the server <em class="bcp14">SHOULD</em> send a <a href="#status.206" class="smpl">206 (Partial Content)</a> response with a payload containing one or more partial representations that correspond to the satisfiable ranges requested,
782               as defined in <a href="#range.response" title="Responses to a Range Request">Section&nbsp;4</a>.
783            </p>
784            <p id="rfc.section.3.1.p.10">If all of the preconditions are true, the server supports the Range header field for the target resource, and the specified
785               range(s) are invalid or unsatisfiable, the server <em class="bcp14">SHOULD</em> send a <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> response.
786            </p>
787         </div>
788         <div id="header.if-range">
789            <div id="rfc.iref.i.1"></div>
790            <h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;<a href="#header.if-range">If-Range</a></h2>
791            <p id="rfc.section.3.2.p.1">If a client has a partial copy of a representation and wishes to have an up-to-date copy of the entire representation, it
792               could use the <a href="#header.range" class="smpl">Range</a> header field with a conditional GET (using either or both of <a href="p4-conditional.html#header.if-unmodified-since" class="smpl">If-Unmodified-Since</a> and <a href="p4-conditional.html#header.if-match" class="smpl">If-Match</a>.) However, if the precondition fails because the representation has been modified, the client would then have to make a second
793               request to obtain the entire current representation.
794            </p>
795            <p id="rfc.section.3.2.p.2">The "If-Range" header field allows a client to "short-circuit" the second request. Informally, its meaning is: if the representation
796               is unchanged, send me the part(s) that I am requesting in Range; otherwise, send me the entire representation.
797            </p>
798            <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.17"></span>  <a href="#header.if-range" class="smpl">If-Range</a> = <a href="#imported.abnf" class="smpl">entity-tag</a> / <a href="#imported.abnf" class="smpl">HTTP-date</a>
799</pre><p id="rfc.section.3.2.p.4">A client <em class="bcp14">MUST NOT</em> generate an If-Range header field in a request that does not contain a <a href="#header.range" class="smpl">Range</a> header field. A server <em class="bcp14">MUST</em> ignore an If-Range header field received in a request that does not contain a <a href="#header.range" class="smpl">Range</a> header field. An origin server <em class="bcp14">MUST</em> ignore an If-Range header field received in a request for a target resource that does not support Range requests.
800            </p>
801            <p id="rfc.section.3.2.p.5">A client <em class="bcp14">MUST NOT</em> generate an If-Range header field containing an entity-tag that is marked as weak. A client <em class="bcp14">MUST NOT</em> generate an If-Range header field containing an <a href="#imported.abnf" class="smpl">HTTP-date</a> unless the client has no entity-tag for the corresponding representation and the date is a strong validator in the sense defined
802               by <a href="p4-conditional.html#lastmod.comparison" title="Comparison">Section 2.2.2</a> of <a href="#Part4" id="rfc.xref.Part4.2"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>.
803            </p>
804            <p id="rfc.section.3.2.p.6">A server that evaluates an If-Range precondition <em class="bcp14">MUST</em> use the strong comparison function when comparing entity-tags (<a href="p4-conditional.html#entity.tag.comparison" title="Comparison">Section 2.3.2</a> of <a href="#Part4" id="rfc.xref.Part4.3"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>) and <em class="bcp14">MUST</em> evaluate the condition as false if an <a href="#imported.abnf" class="smpl">HTTP-date</a> validator is provided that is not a strong validator in the sense defined by <a href="p4-conditional.html#lastmod.comparison" title="Comparison">Section 2.2.2</a> of <a href="#Part4" id="rfc.xref.Part4.4"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>. (A server can distinguish between a valid <a href="#imported.abnf" class="smpl">HTTP-date</a> and any form of entity-tag by examining the first two characters.)
805            </p>
806            <p id="rfc.section.3.2.p.7">If the validator given in the If-Range header field matches the current validator for the selected representation of the target
807               resource, then the server <em class="bcp14">SHOULD</em> process the <a href="#header.range" class="smpl">Range</a> header field as requested. If the validator does not match, the server <em class="bcp14">MUST</em> ignore the <a href="#header.range" class="smpl">Range</a> header field.
808            </p>
809         </div>
810      </div>
811      <div id="range.response">
812         <h1 id="rfc.section.4"><a href="#rfc.section.4">4.</a>&nbsp;<a href="#range.response">Responses to a Range Request</a></h1>
813         <div id="status.206">
814            <div id="rfc.iref.20"></div>
815            <h2 id="rfc.section.4.1"><a href="#rfc.section.4.1">4.1</a>&nbsp;<a href="#status.206">206 Partial Content</a></h2>
816            <p id="rfc.section.4.1.p.1">The <dfn>206 (Partial Content)</dfn> status code indicates that the server is successfully fulfilling a range request for the target resource by transferring one
817               or more parts of the selected representation that correspond to the satisfiable ranges found in the request's <a href="#header.range" class="smpl">Range</a> header field (<a href="#header.range" id="rfc.xref.header.range.2" title="Range">Section&nbsp;3.1</a>).
818            </p>
819            <p id="rfc.section.4.1.p.2">If a single part is being transferred, the server generating the 206 response <em class="bcp14">MUST</em> generate a <a href="#header.content-range" class="smpl">Content-Range</a> header field, describing what range of the selected representation is enclosed, and a payload consisting of the range. For
820               example:
821            </p>
822            <div id="rfc.figure.u.17"></div><pre class="text">HTTP/1.1 206 Partial Content
823Date: Wed, 15 Nov 1995 06:25:24 GMT
824Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT
825Content-Range: bytes 21010-47021/47022
826Content-Length: 26012
827Content-Type: image/gif
828
829... 26012 bytes of partial image data ...
830</pre><p id="rfc.section.4.1.p.4">If multiple parts are being transferred, the server generating the 206 response <em class="bcp14">MUST</em> generate a "multipart/byteranges" payload, as defined in <a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix&nbsp;A</a>, and a <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> header field containing the multipart/byteranges media type and its required boundary parameter. To avoid confusion with single
831               part responses, a server <em class="bcp14">MUST NOT</em> generate a <a href="#header.content-range" class="smpl">Content-Range</a> header field in the HTTP header section of a multiple part response (this field will be sent in each part instead).
832            </p>
833            <p id="rfc.section.4.1.p.5">Within the header area of each body part in the multipart payload, the server <em class="bcp14">MUST</em> generate a <a href="#header.content-range" class="smpl">Content-Range</a> header field corresponding to the range being enclosed in that body part. If the selected representation would have had a <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> header field in a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response, the server <em class="bcp14">SHOULD</em> generate that same <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> field in the header area of each body part. For example:
834            </p>
835            <div id="rfc.figure.u.18"></div><pre class="text">HTTP/1.1 206 Partial Content
836Date: Wed, 15 Nov 1995 06:25:24 GMT
837Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT
838Content-Length: 1741
839Content-Type: multipart/byteranges; boundary=THIS_STRING_SEPARATES
840
841--THIS_STRING_SEPARATES
842Content-Type: application/pdf
843Content-Range: bytes 500-999/8000
844
845...the first range...
846--THIS_STRING_SEPARATES
847Content-Type: application/pdf
848Content-Range: bytes 7000-7999/8000
849
850...the second range
851--THIS_STRING_SEPARATES--
852</pre><p id="rfc.section.4.1.p.7">When multiple ranges are requested, a server <em class="bcp14">MAY</em> coalesce any of the ranges that overlap, or that are separated by a gap that is smaller than the overhead of sending multiple
853               parts, regardless of the order in which the corresponding byte-range-spec appeared in the received <a href="#header.range" class="smpl">Range</a> header field. Since the typical overhead between parts of a multipart/byteranges payload is around 80 bytes, depending on
854               the selected representation's media type and the chosen boundary parameter length, it can be less efficient to transfer many
855               small disjoint parts than it is to transfer the entire selected representation.
856            </p>
857            <p id="rfc.section.4.1.p.8">A server <em class="bcp14">MUST NOT</em> generate a multipart response to a request for a single range, since a client that does not request multiple parts might not
858               support multipart responses. However, a server <em class="bcp14">MAY</em> generate a multipart/byteranges payload with only a single body part if multiple ranges were requested and only one range
859               was found to be satisfiable or only one range remained after coalescing. A client that cannot process a multipart/byteranges
860               response <em class="bcp14">MUST NOT</em> generate a request that asks for multiple ranges.
861            </p>
862            <p id="rfc.section.4.1.p.9">When a multipart response payload is generated, the server <em class="bcp14">SHOULD</em> send the parts in the same order that the corresponding byte-range-spec appeared in the received <a href="#header.range" class="smpl">Range</a> header field, excluding those ranges that were deemed unsatisfiable or that were coalesced into other ranges. A client that
863               receives a multipart response <em class="bcp14">MUST</em> inspect the <a href="#header.content-range" class="smpl">Content-Range</a> header field present in each body part in order to determine which range is contained in that body part; a client cannot rely
864               on receiving the same ranges that it requested, nor the same order that it requested.
865            </p>
866            <p id="rfc.section.4.1.p.10">When a 206 response is generated, the server <em class="bcp14">MUST</em> generate the following header fields, in addition to those required above, if the field would have been sent in a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response to the same request: <a href="p2-semantics.html#header.date" class="smpl">Date</a>, <a href="p6-cache.html#header.cache-control" class="smpl">Cache-Control</a>, <a href="p4-conditional.html#header.etag" class="smpl">ETag</a>, <a href="p6-cache.html#header.expires" class="smpl">Expires</a>, <a href="p2-semantics.html#header.content-location" class="smpl">Content-Location</a>, and <a href="p2-semantics.html#header.vary" class="smpl">Vary</a>.
867            </p>
868            <p id="rfc.section.4.1.p.11">If a 206 is generated in response to a request with an <a href="#header.if-range" class="smpl">If-Range</a> header field, the sender <em class="bcp14">SHOULD NOT</em> generate other representation header fields beyond those required above, because the client is understood to already have
869               a prior response containing those header fields. Otherwise, the sender <em class="bcp14">MUST</em> generate all of the representation header fields that would have been sent in a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response to the same request.
870            </p>
871            <p id="rfc.section.4.1.p.12">A 206 response is cacheable by default; i.e., unless otherwise indicated by explicit cache controls (see <a href="p6-cache.html#heuristic.freshness" title="Calculating Heuristic Freshness">Section 4.2.2</a> of <a href="#Part6" id="rfc.xref.Part6.1"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Caching">[Part6]</cite></a>).
872            </p>
873         </div>
874         <div id="header.content-range">
875            <div id="rfc.iref.c.1"></div>
876            <h2 id="rfc.section.4.2"><a href="#rfc.section.4.2">4.2</a>&nbsp;<a href="#header.content-range">Content-Range</a></h2>
877            <p id="rfc.section.4.2.p.1">The "Content-Range" header field is sent in a single part <a href="#status.206" class="smpl">206 (Partial Content)</a> response to indicate the partial range of the selected representation enclosed as the message payload, sent in each part of
878               a multipart 206 response to indicate the range enclosed within each body part, and sent in <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> responses to provide information about the selected representation.
879            </p>
880            <div id="rfc.figure.u.19"></div><pre class="inline"><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span><span id="rfc.iref.g.21"></span><span id="rfc.iref.g.22"></span><span id="rfc.iref.g.23"></span><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span>  <a href="#header.content-range" class="smpl">Content-Range</a>       = <a href="#header.content-range" class="smpl">byte-content-range</a>
881                      / <a href="#header.content-range" class="smpl">other-content-range</a>
882                         
883  <a href="#header.content-range" class="smpl">byte-content-range</a>  = <a href="#byte.ranges" class="smpl">bytes-unit</a> <a href="#imported.abnf" class="smpl">SP</a>
884                        ( <a href="#header.content-range" class="smpl">byte-range-resp</a> / <a href="#header.content-range" class="smpl">unsatisfied-range</a> )
885
886  <a href="#header.content-range" class="smpl">byte-range-resp</a>     = <a href="#header.content-range" class="smpl">byte-range</a> "/" ( <a href="#header.content-range" class="smpl">complete-length</a> / "*" )
887  <a href="#header.content-range" class="smpl">byte-range</a>          = <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> "-" <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a>
888  <a href="#header.content-range" class="smpl">unsatisfied-range</a>   = "*/" <a href="#header.content-range" class="smpl">complete-length</a>
889                         
890  <a href="#header.content-range" class="smpl">complete-length</a>     = 1*<a href="#imported.abnf" class="smpl">DIGIT</a>
891 
892  <a href="#header.content-range" class="smpl">other-content-range</a> = <a href="#range.units.other" class="smpl">other-range-unit</a> <a href="#imported.abnf" class="smpl">SP</a> <a href="#header.content-range" class="smpl">other-range-resp</a>
893  <a href="#header.content-range" class="smpl">other-range-resp</a>    = *<a href="#imported.abnf" class="smpl">CHAR</a>
894</pre><p id="rfc.section.4.2.p.3">If a <a href="#status.206" class="smpl">206 (Partial Content)</a> response contains a <a href="#header.content-range" class="smpl">Content-Range</a> header field with a <a href="#range.units" class="smpl">range unit</a> (<a href="#range.units" title="Range Units">Section&nbsp;2</a>) that the recipient does not understand, the recipient <em class="bcp14">MUST NOT</em> attempt to recombine it with a stored representation. A proxy that receives such a message <em class="bcp14">SHOULD</em> forward it downstream.
895            </p>
896            <p id="rfc.section.4.2.p.4">For byte ranges, a sender <em class="bcp14">SHOULD</em> indicate the complete length of the representation from which the range has been extracted, unless the complete length is
897               unknown or difficult to determine. An asterisk character ("*") in place of the complete-length indicates that the representation
898               length was unknown when the header field was generated.
899            </p>
900            <p id="rfc.section.4.2.p.5">The following example illustrates when the complete length of the selected representation is known by the sender to be 1234
901               bytes:
902            </p>
903            <div id="rfc.figure.u.20"></div><pre class="text">  Content-Range: bytes 42-1233/1234
904</pre><p id="rfc.section.4.2.p.7">and this second example illustrates when the complete length is unknown:</p>
905            <div id="rfc.figure.u.21"></div><pre class="text">  Content-Range: bytes 42-1233/*
906</pre><p id="rfc.section.4.2.p.9">A Content-Range field value is invalid if it contains a <a href="#header.content-range" class="smpl">byte-range-resp</a> that has a <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> value less than its <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> value, or a <a href="#header.content-range" class="smpl">complete-length</a> value less than or equal to its <a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> value. The recipient of an invalid <a href="#header.content-range" class="smpl">Content-Range</a> <em class="bcp14">MUST NOT</em> attempt to recombine the received content with a stored representation.
907            </p>
908            <p id="rfc.section.4.2.p.10">A server generating a <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> response to a byte range request <em class="bcp14">SHOULD</em> send a Content-Range header field with an <a href="#header.content-range" class="smpl">unsatisfied-range</a> value, as in the following example:
909            </p>
910            <div id="rfc.figure.u.22"></div><pre class="text">  Content-Range: bytes */1234
911</pre><p id="rfc.section.4.2.p.12">The complete-length in a 416 response indicates the current length of the selected representation.</p>
912            <p id="rfc.section.4.2.p.13">The "Content-Range" header field has no meaning for status codes that do not explicitly describe its semantic. For this specification,
913               only the <a href="#status.206" class="smpl">206 (Partial Content)</a> and <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> status codes describe a meaning for Content-Range.
914            </p>
915            <p id="rfc.section.4.2.p.14">The following are examples of Content-Range values in which the selected representation contains a total of 1234 bytes: </p>
916            <ul>
917               <li>The first 500 bytes:
918                  <div id="rfc.figure.u.23"></div><pre class="text">  Content-Range: bytes 0-499/1234
919</pre> </li>
920               <li>The second 500 bytes:
921                  <div id="rfc.figure.u.24"></div><pre class="text">  Content-Range: bytes 500-999/1234
922</pre> </li>
923               <li>All except for the first 500 bytes:
924                  <div id="rfc.figure.u.25"></div><pre class="text">  Content-Range: bytes 500-1233/1234
925</pre> </li>
926               <li>The last 500 bytes:
927                  <div id="rfc.figure.u.26"></div><pre class="text">  Content-Range: bytes 734-1233/1234
928</pre> </li>
929            </ul>
930         </div>
931         <div id="combining.byte.ranges">
932            <h2 id="rfc.section.4.3"><a href="#rfc.section.4.3">4.3</a>&nbsp;<a href="#combining.byte.ranges">Combining Ranges</a></h2>
933            <p id="rfc.section.4.3.p.1">A response might transfer only a subrange of a representation if the connection closed prematurely or if the request used
934               one or more Range specifications. After several such transfers, a client might have received several ranges of the same representation.
935               These ranges can only be safely combined if they all have in common the same strong validator (<a href="p4-conditional.html#weak.and.strong.validators" title="Weak versus Strong">Section 2.1</a> of <a href="#Part4" id="rfc.xref.Part4.5"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>).
936            </p>
937            <p id="rfc.section.4.3.p.2">A client that has received multiple partial responses to GET requests on a target resource <em class="bcp14">MAY</em> combine those responses into a larger continuous range if they share the same strong validator.
938            </p>
939            <p id="rfc.section.4.3.p.3">If the most recent response is an incomplete <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response, then the header fields of that response are used for any combined response and replace those of the matching stored
940               responses.
941            </p>
942            <p id="rfc.section.4.3.p.4">If the most recent response is a <a href="#status.206" class="smpl">206 (Partial Content)</a> response and at least one of the matching stored responses is a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a>, then the combined response header fields consist of the most recent 200 response's header fields. If all of the matching
943               stored responses are 206 responses, then the stored response with the most recent header fields is used as the source of header
944               fields for the combined response, except that the client <em class="bcp14">MUST</em> use other header fields provided in the new response, aside from <a href="#header.content-range" class="smpl">Content-Range</a>, to replace all instances of the corresponding header fields in the stored response.
945            </p>
946            <p id="rfc.section.4.3.p.5">The combined response message body consists of the union of partial content ranges in the new response and each of the selected
947               responses. If the union consists of the entire range of the representation, then the client <em class="bcp14">MUST</em> process the combined response as if it were a complete <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response, including a <a href="p1-messaging.html#header.content-length" class="smpl">Content-Length</a> header field that reflects the complete length. Otherwise, the client <em class="bcp14">MUST</em> process the set of continuous ranges as one of the following: an incomplete <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response if the combined response is a prefix of the representation, a single <a href="#status.206" class="smpl">206 (Partial Content)</a> response containing a multipart/byteranges body, or multiple <a href="#status.206" class="smpl">206 (Partial Content)</a> responses, each with one continuous range that is indicated by a <a href="#header.content-range" class="smpl">Content-Range</a> header field.
948            </p>
949         </div>
950         <div id="status.416">
951            <div id="rfc.iref.29"></div>
952            <h2 id="rfc.section.4.4"><a href="#rfc.section.4.4">4.4</a>&nbsp;<a href="#status.416">416 Range Not Satisfiable</a></h2>
953            <p id="rfc.section.4.4.p.1">The <dfn>416 (Range Not Satisfiable)</dfn> status code indicates that none of the ranges in the request's <a href="#header.range" class="smpl">Range</a> header field (<a href="#header.range" id="rfc.xref.header.range.3" title="Range">Section&nbsp;3.1</a>) overlap the current extent of the selected resource or that the set of ranges requested has been rejected due to invalid
954               ranges or an excessive request of small or overlapping ranges.
955            </p>
956            <p id="rfc.section.4.4.p.2">For byte ranges, failing to overlap the current extent means that the <a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> of all of the <a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> values were greater than the current length of the selected representation. When this status code is generated in response
957               to a byte range request, the sender <em class="bcp14">SHOULD</em> generate a <a href="#header.content-range" class="smpl">Content-Range</a> header field specifying the current length of the selected representation (<a href="#header.content-range" id="rfc.xref.header.content-range.2" title="Content-Range">Section&nbsp;4.2</a>).
958            </p>
959            <div id="rfc.figure.u.27"></div>
960            <p>For example:</p><pre class="text">HTTP/1.1 416 Range Not Satisfiable
961Date: Fri, 20 Jan 2012 15:41:54 GMT
962Content-Range: bytes */47022
963</pre><div class="note" id="rfc.section.4.4.p.4">
964               <p><b>Note:</b> Because servers are free to ignore <a href="#header.range" class="smpl">Range</a>, many implementations will simply respond with the entire selected representation in a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> response. That is partly because most clients are prepared to receive a <a href="p2-semantics.html#status.200" class="smpl">200 (OK)</a> to complete the task (albeit less efficiently) and partly because clients might not stop making an invalid partial request
965                  until they have received a complete representation. Thus, clients cannot depend on receiving a <a href="#status.416" class="smpl">416 (Range Not Satisfiable)</a> response even when it is most appropriate.
966               </p>
967            </div>
968         </div>
969      </div>
970      <div id="IANA.considerations">
971         <h1 id="rfc.section.5"><a href="#rfc.section.5">5.</a>&nbsp;<a href="#IANA.considerations">IANA Considerations</a></h1>
972         <div id="range.unit.registry">
973            <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;<a href="#range.unit.registry">Range Unit Registry</a></h2>
974            <p id="rfc.section.5.1.p.1">The HTTP Range Unit Registry defines the name space for the range unit names and refers to their corresponding specifications.
975               The registry will be created and maintained at (the suggested URI) &lt;<a href="http://www.iana.org/assignments/http-parameters">http://www.iana.org/assignments/http-parameters</a>&gt;.
976            </p>
977            <div id="range.unit.registry.procedure">
978               <h3 id="rfc.section.5.1.1"><a href="#rfc.section.5.1.1">5.1.1</a>&nbsp;<a href="#range.unit.registry.procedure">Procedure</a></h3>
979               <p id="rfc.section.5.1.1.p.1">Registration of an HTTP Range Unit <em class="bcp14">MUST</em> include the following fields:
980               </p>
981               <ul>
982                  <li>Name</li>
983                  <li>Description</li>
984                  <li>Pointer to specification text</li>
985               </ul>
986               <p id="rfc.section.5.1.1.p.2">Values to be added to this name space require IETF Review (see <a href="#RFC5226" id="rfc.xref.RFC5226.1"><cite title="Guidelines for Writing an IANA Considerations Section in RFCs">[RFC5226]</cite></a>, <a href="http://tools.ietf.org/html/rfc5226#section-4.1">Section 4.1</a>).
987               </p>
988            </div>
989            <div id="range.unit.registration">
990               <h3 id="rfc.section.5.1.2"><a href="#rfc.section.5.1.2">5.1.2</a>&nbsp;<a href="#range.unit.registration">Registrations</a></h3>
991               <p id="rfc.section.5.1.2.p.1">The initial HTTP Range Unit Registry shall contain the registrations below:</p>
992               <div id="rfc.table.1">
993                  <div id="iana.range.units.table"></div>
994                  <table class="tt full left" cellpadding="3" cellspacing="0">
995                     <thead>
996                        <tr>
997                           <th>Range Unit Name</th>
998                           <th>Description</th>
999                           <th>Reference</th>
1000                        </tr>
1001                     </thead>
1002                     <tbody>
1003                        <tr>
1004                           <td class="left">bytes</td>
1005                           <td class="left">a range of octets</td>
1006                           <td class="left"><a href="#byte.ranges" title="Byte Ranges">Section&nbsp;2.1</a></td>
1007                        </tr>
1008                        <tr>
1009                           <td class="left">none</td>
1010                           <td class="left">reserved as keyword, indicating no ranges are supported</td>
1011                           <td class="left"><a href="#header.accept-ranges" id="rfc.xref.header.accept-ranges.2" title="Accept-Ranges">Section&nbsp;2.3</a></td>
1012                        </tr>
1013                     </tbody>
1014                  </table>
1015               </div>
1016               <p id="rfc.section.5.1.2.p.2">The change controller is: "IETF (iesg@ietf.org) - Internet Engineering Task Force".</p>
1017            </div>
1018         </div>
1019         <div id="status.code.registration">
1020            <h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a href="#status.code.registration">Status Code Registration</a></h2>
1021            <p id="rfc.section.5.2.p.1">The HTTP Status Code Registry located at &lt;<a href="http://www.iana.org/assignments/http-status-codes">http://www.iana.org/assignments/http-status-codes</a>&gt; shall be updated with the registrations below:
1022            </p>
1023            <div id="rfc.table.2">
1024               <div id="iana.status.code.registration.table"></div>
1025               <table class="tt full left" cellpadding="3" cellspacing="0">
1026                  <thead>
1027                     <tr>
1028                        <th>Value</th>
1029                        <th>Description</th>
1030                        <th>Reference</th>
1031                     </tr>
1032                  </thead>
1033                  <tbody>
1034                     <tr>
1035                        <td class="left">206</td>
1036                        <td class="left">Partial Content</td>
1037                        <td class="left"><a href="#status.206" id="rfc.xref.status.206.1" title="206 Partial Content">Section&nbsp;4.1</a>
1038                        </td>
1039                     </tr>
1040                     <tr>
1041                        <td class="left">416</td>
1042                        <td class="left">Range Not Satisfiable</td>
1043                        <td class="left"><a href="#status.416" id="rfc.xref.status.416.1" title="416 Range Not Satisfiable">Section&nbsp;4.4</a>
1044                        </td>
1045                     </tr>
1046                  </tbody>
1047               </table>
1048            </div>
1049         </div>
1050         <div id="header.field.registration">
1051            <h2 id="rfc.section.5.3"><a href="#rfc.section.5.3">5.3</a>&nbsp;<a href="#header.field.registration">Header Field Registration</a></h2>
1052            <p id="rfc.section.5.3.p.1">HTTP header fields are registered within the Message Header Field Registry maintained at &lt;<a href="http://www.iana.org/assignments/message-headers/message-header-index.html">http://www.iana.org/assignments/message-headers/message-header-index.html</a>&gt;.
1053            </p>
1054            <p id="rfc.section.5.3.p.2">This document defines the following HTTP header fields, so their associated registry entries shall be updated according to
1055               the permanent registrations below (see <a href="#BCP90" id="rfc.xref.BCP90.1"><cite title="Registration Procedures for Message Header Fields">[BCP90]</cite></a>):
1056            </p>
1057            <div id="rfc.table.3">
1058               <div id="iana.header.registration.table"></div>
1059               <table class="tt full left" cellpadding="3" cellspacing="0">
1060                  <thead>
1061                     <tr>
1062                        <th>Header Field Name</th>
1063                        <th>Protocol</th>
1064                        <th>Status</th>
1065                        <th>Reference</th>
1066                     </tr>
1067                  </thead>
1068                  <tbody>
1069                     <tr>
1070                        <td class="left">Accept-Ranges</td>
1071                        <td class="left">http</td>
1072                        <td class="left">standard</td>
1073                        <td class="left"><a href="#header.accept-ranges" id="rfc.xref.header.accept-ranges.3" title="Accept-Ranges">Section&nbsp;2.3</a>
1074                        </td>
1075                     </tr>
1076                     <tr>
1077                        <td class="left">Content-Range</td>
1078                        <td class="left">http</td>
1079                        <td class="left">standard</td>
1080                        <td class="left"><a href="#header.content-range" id="rfc.xref.header.content-range.3" title="Content-Range">Section&nbsp;4.2</a>
1081                        </td>
1082                     </tr>
1083                     <tr>
1084                        <td class="left">If-Range</td>
1085                        <td class="left">http</td>
1086                        <td class="left">standard</td>
1087                        <td class="left"><a href="#header.if-range" id="rfc.xref.header.if-range.2" title="If-Range">Section&nbsp;3.2</a>
1088                        </td>
1089                     </tr>
1090                     <tr>
1091                        <td class="left">Range</td>
1092                        <td class="left">http</td>
1093                        <td class="left">standard</td>
1094                        <td class="left"><a href="#header.range" id="rfc.xref.header.range.4" title="Range">Section&nbsp;3.1</a>
1095                        </td>
1096                     </tr>
1097                  </tbody>
1098               </table>
1099            </div>
1100            <p id="rfc.section.5.3.p.3">The change controller is: "IETF (iesg@ietf.org) - Internet Engineering Task Force".</p>
1101         </div>
1102         <div id="internet.media.type.http">
1103            <h2 id="rfc.section.5.4"><a href="#rfc.section.5.4">5.4</a>&nbsp;<a href="#internet.media.type.http">Internet Media Type Registration</a></h2>
1104            <p id="rfc.section.5.4.p.1">IANA maintains the registry of Internet media types <a href="#BCP13" id="rfc.xref.BCP13.1"><cite title="Media Type Specifications and Registration Procedures">[BCP13]</cite></a> at &lt;<a href="http://www.iana.org/assignments/media-types">http://www.iana.org/assignments/media-types</a>&gt;.
1105            </p>
1106            <p id="rfc.section.5.4.p.2">This document serves as the specification for the Internet media type "multipart/byteranges". The following is to be registered
1107               with IANA.
1108            </p>
1109            <div id="internet.media.type.multipart.byteranges.reg">
1110               <div id="rfc.iref.m.1"></div>
1111               <div id="rfc.iref.m.2"></div>
1112               <h3 id="rfc.section.5.4.1"><a href="#rfc.section.5.4.1">5.4.1</a>&nbsp;<a href="#internet.media.type.multipart.byteranges.reg">Internet Media Type multipart/byteranges</a></h3>
1113               <p id="rfc.section.5.4.1.p.1"></p>
1114               <dl>
1115                  <dt>Type name:</dt>
1116                  <dd>multipart</dd>
1117                  <dt>Subtype name:</dt>
1118                  <dd>byteranges</dd>
1119                  <dt>Required parameters:</dt>
1120                  <dd>boundary</dd>
1121                  <dt>Optional parameters:</dt>
1122                  <dd>N/A</dd>
1123                  <dt>Encoding considerations:</dt>
1124                  <dd>only "7bit", "8bit", or "binary" are permitted</dd>
1125                  <dt>Security considerations:</dt>
1126                  <dd>see <a href="#security.considerations" title="Security Considerations">Section&nbsp;6</a>
1127                  </dd>
1128                  <dt>Interoperability considerations:</dt>
1129                  <dd>N/A</dd>
1130                  <dt>Published specification:</dt>
1131                  <dd>This specification (see <a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix&nbsp;A</a>).
1132                  </dd>
1133                  <dt>Applications that use this media type:</dt>
1134                  <dd>HTTP components supporting multiple ranges in a single request.</dd>
1135                  <dt>Fragment identifier considerations:</dt>
1136                  <dd>N/A</dd>
1137                  <dt>Additional information:</dt>
1138                  <dd>
1139                     <dl>
1140                        <dt>Deprecated alias names for this type:</dt>
1141                        <dd>N/A</dd>
1142                        <dt>Magic number(s):</dt>
1143                        <dd>N/A</dd>
1144                        <dt>File extension(s):</dt>
1145                        <dd>N/A</dd>
1146                        <dt>Macintosh file type code(s):</dt>
1147                        <dd>N/A</dd>
1148                     </dl>
1149                  </dd>
1150                  <dt>Person and email address to contact for further information:</dt>
1151                  <dd>See Authors Section.</dd>
1152                  <dt>Intended usage:</dt>
1153                  <dd>COMMON</dd>
1154                  <dt>Restrictions on usage:</dt>
1155                  <dd>N/A</dd>
1156                  <dt>Author:</dt>
1157                  <dd>See Authors Section.</dd>
1158                  <dt>Change controller:</dt>
1159                  <dd>IESG</dd>
1160               </dl>
1161            </div>
1162         </div>
1163      </div>
1164      <div id="security.considerations">
1165         <h1 id="rfc.section.6"><a href="#rfc.section.6">6.</a>&nbsp;<a href="#security.considerations">Security Considerations</a></h1>
1166         <p id="rfc.section.6.p.1">This section is meant to inform developers, information providers, and users of known security concerns specific to the HTTP/1.1
1167            range request mechanisms. More general security considerations are addressed in HTTP messaging <a href="#Part1" id="rfc.xref.Part1.3"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a> and semantics <a href="#Part2" id="rfc.xref.Part2.2"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content">[Part2]</cite></a>.
1168         </p>
1169         <div id="overlapping.ranges">
1170            <h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a>&nbsp;<a href="#overlapping.ranges">Denial of Service Attacks using Range</a></h2>
1171            <p id="rfc.section.6.1.p.1">Unconstrained multiple range requests are susceptible to denial of service attacks because the effort required to request
1172               many overlapping ranges of the same data is tiny compared to the time, memory, and bandwidth consumed by attempting to serve
1173               the requested data in many parts. Servers ought to ignore, coalesce, or reject egregious range requests, such as requests
1174               for more than two overlapping ranges or for many small ranges in a single set, particularly when the ranges are requested
1175               out of order for no apparent reason. Multipart range requests are not designed to support random access.
1176            </p>
1177         </div>
1178      </div>
1179      <div id="acks">
1180         <h1 id="rfc.section.7"><a href="#rfc.section.7">7.</a>&nbsp;<a href="#acks">Acknowledgments</a></h1>
1181         <p id="rfc.section.7.p.1">See <a href="p1-messaging.html#acks" title="Acknowledgments">Section 10</a> of <a href="#Part1" id="rfc.xref.Part1.4"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>.
1182         </p>
1183      </div>
1184      <h1 id="rfc.references"><a id="rfc.section.8" href="#rfc.section.8">8.</a> References
1185      </h1>
1186      <h2 id="rfc.references.1"><a href="#rfc.section.8.1" id="rfc.section.8.1">8.1</a> Normative References
1187      </h2>
1188      <table>
1189         <tr>
1190            <td class="reference"><b id="Part1">[Part1]</b></td>
1191            <td class="top"><a href="mailto:fielding@gbiv.com" title="Adobe Systems Incorporated">Fielding, R., Ed.</a> and <a href="mailto:julian.reschke@greenbytes.de" title="greenbytes GmbH">J. Reschke, Ed.</a>, “<a href="http://tools.ietf.org/html/draft-ietf-httpbis-p1-messaging-latest">Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing</a>”, Internet-Draft&nbsp;draft-ietf-httpbis-p1-messaging-latest (work in progress), December&nbsp;2013.
1192            </td>
1193         </tr>
1194         <tr>
1195            <td class="reference"><b id="Part2">[Part2]</b></td>
1196            <td class="top"><a href="mailto:fielding@gbiv.com" title="Adobe Systems Incorporated">Fielding, R., Ed.</a> and <a href="mailto:julian.reschke@greenbytes.de" title="greenbytes GmbH">J. Reschke, Ed.</a>, “<a href="http://tools.ietf.org/html/draft-ietf-httpbis-p2-semantics-latest">Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</a>”, Internet-Draft&nbsp;draft-ietf-httpbis-p2-semantics-latest (work in progress), December&nbsp;2013.
1197            </td>
1198         </tr>
1199         <tr>
1200            <td class="reference"><b id="Part4">[Part4]</b></td>
1201            <td class="top"><a href="mailto:fielding@gbiv.com" title="Adobe Systems Incorporated">Fielding, R., Ed.</a> and <a href="mailto:julian.reschke@greenbytes.de" title="greenbytes GmbH">J. Reschke, Ed.</a>, “<a href="http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-latest">Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests</a>”, Internet-Draft&nbsp;draft-ietf-httpbis-p4-conditional-latest (work in progress), December&nbsp;2013.
1202            </td>
1203         </tr>
1204         <tr>
1205            <td class="reference"><b id="Part6">[Part6]</b></td>
1206            <td class="top"><a href="mailto:fielding@gbiv.com" title="Adobe Systems Incorporated">Fielding, R., Ed.</a>, <a href="mailto:mnot@mnot.net" title="Akamai">Nottingham, M., Ed.</a>, and <a href="mailto:julian.reschke@greenbytes.de" title="greenbytes GmbH">J. Reschke, Ed.</a>, “<a href="http://tools.ietf.org/html/draft-ietf-httpbis-p6-cache-latest">Hypertext Transfer Protocol (HTTP/1.1): Caching</a>”, Internet-Draft&nbsp;draft-ietf-httpbis-p6-cache-latest (work in progress), December&nbsp;2013.
1207            </td>
1208         </tr>
1209         <tr>
1210            <td class="reference"><b id="RFC2046">[RFC2046]</b></td>
1211            <td class="top"><a href="mailto:ned@innosoft.com" title="Innosoft International, Inc.">Freed, N.</a> and <a href="mailto:nsb@nsb.fv.com" title="First Virtual Holdings">N. Borenstein</a>, “<a href="http://tools.ietf.org/html/rfc2046">Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</a>”, RFC&nbsp;2046, November&nbsp;1996.
1212            </td>
1213         </tr>
1214         <tr>
1215            <td class="reference"><b id="RFC2119">[RFC2119]</b></td>
1216            <td class="top"><a href="mailto:sob@harvard.edu" title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>”, BCP&nbsp;14, RFC&nbsp;2119, March&nbsp;1997.
1217            </td>
1218         </tr>
1219         <tr>
1220            <td class="reference"><b id="RFC5234">[RFC5234]</b></td>
1221            <td class="top"><a href="mailto:dcrocker@bbiw.net" title="Brandenburg InternetWorking">Crocker, D., Ed.</a> and <a href="mailto:paul.overell@thus.net" title="THUS plc.">P. Overell</a>, “<a href="http://tools.ietf.org/html/rfc5234">Augmented BNF for Syntax Specifications: ABNF</a>”, STD&nbsp;68, RFC&nbsp;5234, January&nbsp;2008.
1222            </td>
1223         </tr>
1224      </table>
1225      <h2 id="rfc.references.2"><a href="#rfc.section.8.2" id="rfc.section.8.2">8.2</a> Informative References
1226      </h2>
1227      <table>
1228         <tr>
1229            <td class="reference"><b id="BCP13">[BCP13]</b></td>
1230            <td class="top"><a href="mailto:ned+ietf@mrochek.com" title="Oracle">Freed, N.</a>, <a href="mailto:john+ietf@jck.com">Klensin, J.</a>, and <a href="mailto:tony+mtsuffix@maillennium.att.com" title="AT&amp;T Laboratories">T. Hansen</a>, “<a href="http://tools.ietf.org/html/rfc6838">Media Type Specifications and Registration Procedures</a>”, BCP&nbsp;13, RFC&nbsp;6838, January&nbsp;2013.
1231            </td>
1232         </tr>
1233         <tr>
1234            <td class="reference"><b id="BCP90">[BCP90]</b></td>
1235            <td class="top"><a href="mailto:GK-IETF@ninebynine.org" title="Nine by Nine">Klyne, G.</a>, <a href="mailto:mnot@pobox.com" title="BEA Systems">Nottingham, M.</a>, and <a href="mailto:JeffMogul@acm.org" title="HP Labs">J. Mogul</a>, “<a href="http://tools.ietf.org/html/rfc3864">Registration Procedures for Message Header Fields</a>”, BCP&nbsp;90, RFC&nbsp;3864, September&nbsp;2004.
1236            </td>
1237         </tr>
1238         <tr>
1239            <td class="reference"><b id="RFC2616">[RFC2616]</b></td>
1240            <td class="top"><a href="mailto:fielding@ics.uci.edu" title="University of California, Irvine">Fielding, R.</a>, <a href="mailto:jg@w3.org" title="W3C">Gettys, J.</a>, <a href="mailto:mogul@wrl.dec.com" title="Compaq Computer Corporation">Mogul, J.</a>, <a href="mailto:frystyk@w3.org" title="MIT Laboratory for Computer Science">Frystyk, H.</a>, <a href="mailto:masinter@parc.xerox.com" title="Xerox Corporation">Masinter, L.</a>, <a href="mailto:paulle@microsoft.com" title="Microsoft Corporation">Leach, P.</a>, and <a href="mailto:timbl@w3.org" title="W3C">T. Berners-Lee</a>, “<a href="http://tools.ietf.org/html/rfc2616">Hypertext Transfer Protocol -- HTTP/1.1</a>”, RFC&nbsp;2616, June&nbsp;1999.
1241            </td>
1242         </tr>
1243         <tr>
1244            <td class="reference"><b id="RFC5226">[RFC5226]</b></td>
1245            <td class="top"><a href="mailto:narten@us.ibm.com" title="IBM">Narten, T.</a> and <a href="mailto:Harald@Alvestrand.no" title="Google">H. Alvestrand</a>, “<a href="http://tools.ietf.org/html/rfc5226">Guidelines for Writing an IANA Considerations Section in RFCs</a>”, BCP&nbsp;26, RFC&nbsp;5226, May&nbsp;2008.
1246            </td>
1247         </tr>
1248      </table>
1249      <div class="avoidbreak">
1250         <h1 id="rfc.authors"><a href="#rfc.authors">Authors' Addresses</a></h1>
1251         <p><b>Roy T. Fielding</b>
1252            (editor)
1253            <br>Adobe Systems Incorporated<br>345 Park Ave<br>San Jose, CA&nbsp;95110<br>USA<br>Email: <a href="mailto:fielding@gbiv.com">fielding@gbiv.com</a><br>URI: <a href="http://roy.gbiv.com/">http://roy.gbiv.com/</a></p>
1254         <p><b>Yves Lafon</b>
1255            (editor)
1256            <br>World Wide Web Consortium<br>W3C / ERCIM<br>2004, rte des Lucioles<br>Sophia-Antipolis, AM&nbsp;06902<br>France<br>Email: <a href="mailto:ylafon@w3.org">ylafon@w3.org</a><br>URI: <a href="http://www.raubacapeu.net/people/yves/">http://www.raubacapeu.net/people/yves/</a></p>
1257         <p><b>Julian F. Reschke</b>
1258            (editor)
1259            <br>greenbytes GmbH<br>Hafenweg 16<br>Muenster, NW&nbsp;48155<br>Germany<br>Email: <a href="mailto:julian.reschke@greenbytes.de">julian.reschke@greenbytes.de</a><br>URI: <a href="http://greenbytes.de/tech/webdav/">http://greenbytes.de/tech/webdav/</a></p>
1260      </div>
1261      <div id="internet.media.type.multipart.byteranges">
1262         <div id="rfc.iref.m.3"></div>
1263         <div id="rfc.iref.m.4"></div>
1264         <h1 id="rfc.section.A" class="np"><a href="#rfc.section.A">A.</a>&nbsp;<a href="#internet.media.type.multipart.byteranges">Internet Media Type multipart/byteranges</a></h1>
1265         <p id="rfc.section.A.p.1">When a <a href="#status.206" class="smpl">206 (Partial Content)</a> response message includes the content of multiple ranges, they are transmitted as body parts in a multipart message body (<a href="#RFC2046" id="rfc.xref.RFC2046.1"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a>, <a href="http://tools.ietf.org/html/rfc2046#section-5.1">Section 5.1</a>) with the media type of "multipart/byteranges".
1266         </p>
1267         <p id="rfc.section.A.p.2">The multipart/byteranges media type includes one or more body parts, each with its own <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> and <a href="#header.content-range" class="smpl">Content-Range</a> fields. The required boundary parameter specifies the boundary string used to separate each body part.
1268         </p>
1269         <p id="rfc.section.A.p.3">Implementation Notes: </p>
1270         <ol>
1271            <li>Additional CRLFs might precede the first boundary string in the body.</li>
1272            <li>Although <a href="#RFC2046" id="rfc.xref.RFC2046.2"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a> permits the boundary string to be quoted, some existing implementations handle a quoted boundary string incorrectly.
1273            </li>
1274            <li>A number of clients and servers were coded to an early draft of the byteranges specification that used a media type of multipart/x-byteranges<span id="rfc.iref.m.5"></span><span id="rfc.iref.m.6"></span>, which is almost (but not quite) compatible with this type.
1275            </li>
1276         </ol>
1277         <p id="rfc.section.A.p.4">Despite the name, the "multipart/byteranges" media type is not limited to byte ranges. The following example uses an "exampleunit"
1278            range unit:
1279         </p>
1280         <div id="rfc.figure.u.28"></div><pre class="text">HTTP/1.1 206 Partial Content
1281Date: Tue, 14 Nov 1995 06:25:24 GMT
1282Last-Modified: Tue, 14 July 04:58:08 GMT
1283Content-Length: 2331785
1284Content-Type: multipart/byteranges; boundary=THIS_STRING_SEPARATES
1285
1286--THIS_STRING_SEPARATES
1287Content-Type: video/example
1288Content-Range: exampleunit 1.2-4.3/25
1289
1290...the first range...
1291--THIS_STRING_SEPARATES
1292Content-Type: video/example
1293Content-Range: exampleunit 11.2-14.3/25
1294
1295...the second range
1296--THIS_STRING_SEPARATES--
1297</pre></div>
1298      <div id="changes.from.rfc.2616">
1299         <h1 id="rfc.section.B"><a href="#rfc.section.B">B.</a>&nbsp;<a href="#changes.from.rfc.2616">Changes from RFC 2616</a></h1>
1300         <p id="rfc.section.B.p.1">Servers are given more leeway in how they respond to a range request, in order to mitigate abuse by malicious (or just greedy)
1301            clients. (<a href="#header.range" id="rfc.xref.header.range.5" title="Range">Section&nbsp;3.1</a>)
1302         </p>
1303         <p id="rfc.section.B.p.2">A weak validator cannot be used in a <a href="#status.206" class="smpl">206</a> response. (<a href="#status.206" id="rfc.xref.status.206.2" title="206 Partial Content">Section&nbsp;4.1</a>)
1304         </p>
1305         <p id="rfc.section.B.p.3">The Content-Range header field only has meaning when the status code explicitly defines its use. (<a href="#header.content-range" id="rfc.xref.header.content-range.4" title="Content-Range">Section&nbsp;4.2</a>)
1306         </p>
1307         <p id="rfc.section.B.p.4">This specification introduces a Range Unit Registry. (<a href="#range.unit.registry" title="Range Unit Registry">Section&nbsp;5.1</a>)
1308         </p>
1309         <p id="rfc.section.B.p.5">multipart/byteranges can consist of a single part. (<a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix&nbsp;A</a>)
1310         </p>
1311      </div>
1312      <div id="imported.abnf">
1313         <h1 id="rfc.section.C"><a href="#rfc.section.C">C.</a>&nbsp;<a href="#imported.abnf">Imported ABNF</a></h1>
1314         <p id="rfc.section.C.p.1">The following core rules are included by reference, as defined in <a href="http://tools.ietf.org/html/rfc5234#appendix-B.1">Appendix B.1</a> of <a href="#RFC5234" id="rfc.xref.RFC5234.2"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a>: ALPHA (letters), CR (carriage return), CRLF (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote), HEXDIG
1315            (hexadecimal 0-9/A-F/a-f), LF (line feed), OCTET (any 8-bit sequence of data), SP (space), and VCHAR (any visible US-ASCII
1316            character).
1317         </p>
1318         <p id="rfc.section.C.p.2">Note that all rules derived from <a href="#imported.abnf" class="smpl">token</a> are to be compared case-insensitively, like <a href="#range.units" class="smpl">range-unit</a> and <a href="#header.accept-ranges" class="smpl">acceptable-ranges</a>.
1319         </p>
1320         <p id="rfc.section.C.p.3">The rules below are defined in <a href="#Part1" id="rfc.xref.Part1.5"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>:
1321         </p>
1322         <div id="rfc.figure.u.29"></div><pre class="inline">  <a href="#imported.abnf" class="smpl">OWS</a>        = &lt;OWS, defined in <a href="#Part1" id="rfc.xref.Part1.6"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>, <a href="p1-messaging.html#whitespace" title="Whitespace">Section 3.2.3</a>&gt;
1323  <a href="#imported.abnf" class="smpl">token</a>      = &lt;token, defined in <a href="#Part1" id="rfc.xref.Part1.7"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>, <a href="p1-messaging.html#field.components" title="Field value components">Section 3.2.6</a>&gt;
1324</pre><p id="rfc.section.C.p.5">The rules below are defined in other parts:</p>
1325         <div id="rfc.figure.u.30"></div><pre class="inline">  <a href="#imported.abnf" class="smpl">HTTP-date</a>  = &lt;HTTP-date, defined in <a href="#Part2" id="rfc.xref.Part2.3"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content">[Part2]</cite></a>, <a href="p2-semantics.html#http.date" title="Date/Time Formats">Section 7.1.1.1</a>&gt;
1326  <a href="#imported.abnf" class="smpl">entity-tag</a> = &lt;entity-tag, defined in <a href="#Part4" id="rfc.xref.Part4.6"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests">[Part4]</cite></a>, <a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a>&gt;
1327</pre></div>
1328      <div id="collected.abnf">
1329         <h1 id="rfc.section.D"><a href="#rfc.section.D">D.</a>&nbsp;<a href="#collected.abnf">Collected ABNF</a></h1>
1330         <p id="rfc.section.D.p.1">In the collected ABNF below, list rules are expanded as per <a href="p1-messaging.html#notation" title="Syntax Notation">Section 1.2</a> of <a href="#Part1" id="rfc.xref.Part1.8"><cite title="Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing">[Part1]</cite></a>.
1331         </p>
1332         <div id="rfc.figure.u.31"></div><pre class="inline"><a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = acceptable-ranges
1333
1334<a href="#header.content-range" class="smpl">Content-Range</a> = byte-content-range / other-content-range
1335
1336<a href="#imported.abnf" class="smpl">HTTP-date</a> = &lt;HTTP-date, defined in [Part2], Section 7.1.1.1&gt;
1337
1338<a href="#header.if-range" class="smpl">If-Range</a> = entity-tag / HTTP-date
1339
1340<a href="#imported.abnf" class="smpl">OWS</a> = &lt;OWS, defined in [Part1], Section 3.2.3&gt;
1341
1342<a href="#header.range" class="smpl">Range</a> = byte-ranges-specifier / other-ranges-specifier
1343
1344<a href="#header.accept-ranges" class="smpl">acceptable-ranges</a> = ( *( "," OWS ) range-unit *( OWS "," [ OWS
1345 range-unit ] ) ) / "none"
1346
1347<a href="#header.content-range" class="smpl">byte-content-range</a> = bytes-unit SP ( byte-range-resp /
1348 unsatisfied-range )
1349<a href="#header.content-range" class="smpl">byte-range</a> = first-byte-pos "-" last-byte-pos
1350<a href="#header.content-range" class="smpl">byte-range-resp</a> = byte-range "/" ( complete-length / "*" )
1351<a href="#rule.ranges-specifier" class="smpl">byte-range-set</a> = *( "," OWS ) ( byte-range-spec /
1352 suffix-byte-range-spec ) *( OWS "," [ OWS ( byte-range-spec /
1353 suffix-byte-range-spec ) ] )
1354<a href="#rule.ranges-specifier" class="smpl">byte-range-spec</a> = first-byte-pos "-" [ last-byte-pos ]
1355<a href="#rule.ranges-specifier" class="smpl">byte-ranges-specifier</a> = bytes-unit "=" byte-range-set
1356<a href="#byte.ranges" class="smpl">bytes-unit</a> = "bytes"
1357
1358<a href="#header.content-range" class="smpl">complete-length</a> = 1*DIGIT
1359
1360<a href="#imported.abnf" class="smpl">entity-tag</a> = &lt;entity-tag, defined in [Part4], Section 2.3&gt;
1361
1362<a href="#rule.ranges-specifier" class="smpl">first-byte-pos</a> = 1*DIGIT
1363
1364<a href="#rule.ranges-specifier" class="smpl">last-byte-pos</a> = 1*DIGIT
1365
1366<a href="#header.content-range" class="smpl">other-content-range</a> = other-range-unit SP other-range-resp
1367<a href="#header.content-range" class="smpl">other-range-resp</a> = *CHAR
1368<a href="#header.range" class="smpl">other-range-set</a> = 1*VCHAR
1369<a href="#range.units.other" class="smpl">other-range-unit</a> = token
1370<a href="#header.range" class="smpl">other-ranges-specifier</a> = other-range-unit "=" other-range-set
1371
1372<a href="#range.units" class="smpl">range-unit</a> = bytes-unit / other-range-unit
1373
1374<a href="#rule.ranges-specifier" class="smpl">suffix-byte-range-spec</a> = "-" suffix-length
1375<a href="#rule.ranges-specifier" class="smpl">suffix-length</a> = 1*DIGIT
1376
1377<a href="#imported.abnf" class="smpl">token</a> = &lt;token, defined in [Part1], Section 3.2.6&gt;
1378
1379<a href="#header.content-range" class="smpl">unsatisfied-range</a> = "*/" complete-length
1380</pre></div>
1381      <div id="change.log">
1382         <h1 id="rfc.section.E"><a href="#rfc.section.E">E.</a>&nbsp;<a href="#change.log">Change Log (to be removed by RFC Editor before publication)</a></h1>
1383         <p id="rfc.section.E.p.1">Changes up to the IETF Last Call draft are summarized in &lt;<a href="http://tools.ietf.org/html/draft-ietf-httpbis-p5-range-24#appendix-E">http://tools.ietf.org/html/draft-ietf-httpbis-p5-range-24#appendix-E</a>&gt;.
1384         </p>
1385         <div id="changes.since.24">
1386            <h2 id="rfc.section.E.1"><a href="#rfc.section.E.1">E.1</a>&nbsp;<a href="#changes.since.24">Since draft-ietf-httpbis-p5-range-24</a></h2>
1387            <p id="rfc.section.E.1.p.1">Closed issues: </p>
1388            <ul>
1389               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/506">http://tools.ietf.org/wg/httpbis/trac/ticket/506</a>&gt;: "APPSDIR review of draft-ietf-httpbis-p5-range-24"
1390               </li>
1391               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/507">http://tools.ietf.org/wg/httpbis/trac/ticket/507</a>&gt;: "integer value parsing"
1392               </li>
1393               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/508">http://tools.ietf.org/wg/httpbis/trac/ticket/508</a>&gt;: "broken sentence in description of 206"
1394               </li>
1395            </ul>
1396         </div>
1397         <div id="changes.since.25">
1398            <h2 id="rfc.section.E.2"><a href="#rfc.section.E.2">E.2</a>&nbsp;<a href="#changes.since.25">Since draft-ietf-httpbis-p5-range-25</a></h2>
1399            <p id="rfc.section.E.2.p.1">Closed issues: </p>
1400            <ul>
1401               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/526">http://tools.ietf.org/wg/httpbis/trac/ticket/526</a>&gt;: "check media type registration templates"
1402               </li>
1403               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/527">http://tools.ietf.org/wg/httpbis/trac/ticket/527</a>&gt;: "use of CHAR for other-range-set"
1404               </li>
1405               <li>&lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/542">http://tools.ietf.org/wg/httpbis/trac/ticket/542</a>&gt;: "improve introduction of list rule"
1406               </li>
1407            </ul>
1408         </div>
1409      </div>
1410      <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1>
1411      <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.B">B</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.G">G</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>
1412      </p>
1413      <div class="print2col">
1414         <ul class="ind">
1415            <li><a id="rfc.index.2" href="#rfc.index.2"><b>2</b></a><ul>
1416                  <li>206 Partial Content (status code)&nbsp;&nbsp;<a href="#rfc.iref.20"><b>4.1</b></a>, <a href="#rfc.xref.status.206.1">5.2</a>, <a href="#rfc.xref.status.206.2">B</a></li>
1417               </ul>
1418            </li>
1419            <li><a id="rfc.index.4" href="#rfc.index.4"><b>4</b></a><ul>
1420                  <li>416 Range Not Satisfiable (status code)&nbsp;&nbsp;<a href="#rfc.iref.29"><b>4.4</b></a>, <a href="#rfc.xref.status.416.1">5.2</a></li>
1421               </ul>
1422            </li>
1423            <li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul>
1424                  <li>Accept-Ranges header field&nbsp;&nbsp;<a href="#rfc.xref.header.accept-ranges.1">2</a>, <a href="#rfc.iref.a.1"><b>2.3</b></a>, <a href="#rfc.xref.header.accept-ranges.2">5.1.2</a>, <a href="#rfc.xref.header.accept-ranges.3">5.3</a></li>
1425               </ul>
1426            </li>
1427            <li><a id="rfc.index.B" href="#rfc.index.B"><b>B</b></a><ul>
1428                  <li><em>BCP13</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP13.1">5.4</a>, <a href="#BCP13"><b>8.2</b></a></li>
1429                  <li><em>BCP90</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP90.1">5.3</a>, <a href="#BCP90"><b>8.2</b></a></li>
1430               </ul>
1431            </li>
1432            <li><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul>
1433                  <li>Content-Range header field&nbsp;&nbsp;<a href="#rfc.xref.header.content-range.1">2</a>, <a href="#rfc.iref.c.1"><b>4.2</b></a>, <a href="#rfc.xref.header.content-range.2">4.4</a>, <a href="#rfc.xref.header.content-range.3">5.3</a>, <a href="#rfc.xref.header.content-range.4">B</a></li>
1434               </ul>
1435            </li>
1436            <li><a id="rfc.index.G" href="#rfc.index.G"><b>G</b></a><ul>
1437                  <li><tt>Grammar</tt>&nbsp;&nbsp;
1438                     <ul>
1439                        <li><tt>Accept-Ranges</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.14"><b>2.3</b></a></li>
1440                        <li><tt>acceptable-ranges</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.15"><b>2.3</b></a></li>
1441                        <li><tt>byte-content-range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.19"><b>4.2</b></a></li>
1442                        <li><tt>byte-range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.21"><b>4.2</b></a></li>
1443                        <li><tt>byte-range-resp</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.20"><b>4.2</b></a></li>
1444                        <li><tt>byte-range-set</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.7"><b>2.1</b></a></li>
1445                        <li><tt>byte-range-spec</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.8"><b>2.1</b></a></li>
1446                        <li><tt>byte-ranges-specifier</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.6"><b>2.1</b></a></li>
1447                        <li><tt>bytes-unit</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.2">2</a>, <a href="#rfc.iref.g.4"><b>2.1</b></a></li>
1448                        <li><tt>complete-length</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.25"><b>4.2</b></a></li>
1449                        <li><tt>Content-Range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.18"><b>4.2</b></a></li>
1450                        <li><tt>first-byte-pos</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.9"><b>2.1</b></a></li>
1451                        <li><tt>If-Range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.17"><b>3.2</b></a></li>
1452                        <li><tt>last-byte-pos</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.10"><b>2.1</b></a></li>
1453                        <li><tt>other-content-range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.23"><b>4.2</b></a></li>
1454                        <li><tt>other-range-resp</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.24"><b>4.2</b></a></li>
1455                        <li><tt>other-range-unit</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.3">2</a>, <a href="#rfc.iref.g.13"><b>2.2</b></a></li>
1456                        <li><tt>Range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.16"><b>3.1</b></a></li>
1457                        <li><tt>range-unit</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.1"><b>2</b></a></li>
1458                        <li><tt>ranges-specifier</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.5"><b>2.1</b></a></li>
1459                        <li><tt>suffix-byte-range-spec</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.11"><b>2.1</b></a></li>
1460                        <li><tt>suffix-length</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.12"><b>2.1</b></a></li>
1461                        <li><tt>unsatisfied-range</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.22"><b>4.2</b></a></li>
1462                     </ul>
1463                  </li>
1464               </ul>
1465            </li>
1466            <li><a id="rfc.index.I" href="#rfc.index.I"><b>I</b></a><ul>
1467                  <li>If-Range header field&nbsp;&nbsp;<a href="#rfc.xref.header.if-range.1">3.1</a>, <a href="#rfc.iref.i.1"><b>3.2</b></a>, <a href="#rfc.xref.header.if-range.2">5.3</a></li>
1468               </ul>
1469            </li>
1470            <li><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul>
1471                  <li>Media Type&nbsp;&nbsp;
1472                     <ul>
1473                        <li>multipart/byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.1"><b>5.4.1</b></a>, <a href="#rfc.iref.m.3"><b>A</b></a></li>
1474                        <li>multipart/x-byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.6">A</a></li>
1475                     </ul>
1476                  </li>
1477                  <li>multipart/byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.2"><b>5.4.1</b></a>, <a href="#rfc.iref.m.4"><b>A</b></a></li>
1478                  <li>multipart/x-byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.5">A</a></li>
1479               </ul>
1480            </li>
1481            <li><a id="rfc.index.P" href="#rfc.index.P"><b>P</b></a><ul>
1482                  <li><em>Part1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.1">1.1</a>, <a href="#rfc.xref.Part1.2">1.2</a>, <a href="#rfc.xref.Part1.3">6</a>, <a href="#rfc.xref.Part1.4">7</a>, <a href="#Part1"><b>8.1</b></a>, <a href="#rfc.xref.Part1.5">C</a>, <a href="#rfc.xref.Part1.6">C</a>, <a href="#rfc.xref.Part1.7">C</a>, <a href="#rfc.xref.Part1.8">D</a><ul>
1483                        <li><em>Section 1.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.8">D</a></li>
1484                        <li><em>Section 2.5</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.1">1.1</a></li>
1485                        <li><em>Section 3.2.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.6">C</a></li>
1486                        <li><em>Section 3.2.6</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.7">C</a></li>
1487                        <li><em>Section 7</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.2">1.2</a></li>
1488                        <li><em>Section 10</em>&nbsp;&nbsp;<a href="#rfc.xref.Part1.4">7</a></li>
1489                     </ul>
1490                  </li>
1491                  <li><em>Part2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part2.1">2.1</a>, <a href="#rfc.xref.Part2.2">6</a>, <a href="#Part2"><b>8.1</b></a>, <a href="#rfc.xref.Part2.3">C</a><ul>
1492                        <li><em>Section 3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part2.1">2.1</a></li>
1493                        <li><em>Section 7.1.1.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part2.3">C</a></li>
1494                     </ul>
1495                  </li>
1496                  <li><em>Part4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">3.1</a>, <a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.3">3.2</a>, <a href="#rfc.xref.Part4.4">3.2</a>, <a href="#rfc.xref.Part4.5">4.3</a>, <a href="#Part4"><b>8.1</b></a>, <a href="#rfc.xref.Part4.6">C</a><ul>
1497                        <li><em>Section 2.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.5">4.3</a></li>
1498                        <li><em>Section 2.2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.4">3.2</a></li>
1499                        <li><em>Section 2.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.6">C</a></li>
1500                        <li><em>Section 2.3.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.3">3.2</a></li>
1501                     </ul>
1502                  </li>
1503                  <li><em>Part6</em>&nbsp;&nbsp;<a href="#rfc.xref.Part6.1">4.1</a>, <a href="#Part6"><b>8.1</b></a><ul>
1504                        <li><em>Section 4.2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part6.1">4.1</a></li>
1505                     </ul>
1506                  </li>
1507               </ul>
1508            </li>
1509            <li><a id="rfc.index.R" href="#rfc.index.R"><b>R</b></a><ul>
1510                  <li>Range header field&nbsp;&nbsp;<a href="#rfc.xref.header.range.1">2</a>, <a href="#rfc.iref.r.1"><b>3.1</b></a>, <a href="#rfc.xref.header.range.2">4.1</a>, <a href="#rfc.xref.header.range.3">4.4</a>, <a href="#rfc.xref.header.range.4">5.3</a>, <a href="#rfc.xref.header.range.5">B</a></li>
1511                  <li><em>RFC2046</em>&nbsp;&nbsp;<a href="#RFC2046"><b>8.1</b></a>, <a href="#rfc.xref.RFC2046.1">A</a>, <a href="#rfc.xref.RFC2046.2">A</a><ul>
1512                        <li><em>Section 5.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2046.1">A</a></li>
1513                     </ul>
1514                  </li>
1515                  <li><em>RFC2119</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC2119.1">1.1</a>, <a href="#RFC2119"><b>8.1</b></a></li>
1516                  <li><em>RFC2616</em>&nbsp;&nbsp;<a href="#RFC2616"><b>8.2</b></a></li>
1517                  <li><em>RFC5226</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">5.1.1</a>, <a href="#RFC5226"><b>8.2</b></a><ul>
1518                        <li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">5.1.1</a></li>
1519                     </ul>
1520                  </li>
1521                  <li><em>RFC5234</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5234.1">1.2</a>, <a href="#RFC5234"><b>8.1</b></a>, <a href="#rfc.xref.RFC5234.2">C</a><ul>
1522                        <li><em>Appendix B.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5234.2">C</a></li>
1523                     </ul>
1524                  </li>
1525               </ul>
1526            </li>
1527         </ul>
1528      </div>
1529   </body>
1530</html>
Note: See TracBrowser for help on using the repository browser.