1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397
|
<pre>Internet Engineering Task Force (IETF) R. Fielding, Ed.
Request for Comments: 7233 Adobe
Obsoletes: <a href="./rfc2616">2616</a> Y. Lafon, Ed.
Category: Standards Track W3C
ISSN: 2070-1721 J. Reschke, Ed.
greenbytes
June 2014
<span class="h1">Hypertext Transfer Protocol (HTTP/1.1): Range Requests</span>
Abstract
The Hypertext Transfer Protocol (HTTP) is a stateless 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.
Status of This Memo
This is an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in <a href="./rfc5741#section-2">Section 2 of RFC 5741</a>.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
<a href="http://www.rfc-editor.org/info/rfc7233">http://www.rfc-editor.org/info/rfc7233</a>.
<span class="grey">Fielding, et al. Standards Track [Page 1]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
Copyright Notice
Copyright (c) 2014 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> 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 and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
This document may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
<span class="grey">Fielding, et al. Standards Track [Page 2]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
Table of Contents
<a href="#section-1">1</a>. Introduction ....................................................<a href="#page-4">4</a>
<a href="#section-1.1">1.1</a>. Conformance and Error Handling .............................<a href="#page-4">4</a>
<a href="#section-1.2">1.2</a>. Syntax Notation ............................................<a href="#page-4">4</a>
<a href="#section-2">2</a>. Range Units .....................................................<a href="#page-5">5</a>
<a href="#section-2.1">2.1</a>. Byte Ranges ................................................<a href="#page-5">5</a>
<a href="#section-2.2">2.2</a>. Other Range Units ..........................................<a href="#page-7">7</a>
<a href="#section-2.3">2.3</a>. Accept-Ranges ..............................................<a href="#page-7">7</a>
<a href="#section-3">3</a>. Range Requests ..................................................<a href="#page-8">8</a>
<a href="#section-3.1">3.1</a>. Range ......................................................<a href="#page-8">8</a>
<a href="#section-3.2">3.2</a>. If-Range ...................................................<a href="#page-9">9</a>
<a href="#section-4">4</a>. Responses to a Range Request ...................................<a href="#page-10">10</a>
<a href="#section-4.1">4.1</a>. 206 Partial Content .......................................<a href="#page-10">10</a>
<a href="#section-4.2">4.2</a>. Content-Range .............................................<a href="#page-12">12</a>
<a href="#section-4.3">4.3</a>. Combining Ranges ..........................................<a href="#page-14">14</a>
<a href="#section-4.4">4.4</a>. 416 Range Not Satisfiable .................................<a href="#page-15">15</a>
<a href="#section-5">5</a>. IANA Considerations ............................................<a href="#page-16">16</a>
<a href="#section-5.1">5.1</a>. Range Unit Registry .......................................<a href="#page-16">16</a>
<a href="#section-5.1.1">5.1.1</a>. Procedure ..........................................<a href="#page-16">16</a>
<a href="#section-5.1.2">5.1.2</a>. Registrations ......................................<a href="#page-16">16</a>
<a href="#section-5.2">5.2</a>. Status Code Registration ..................................<a href="#page-17">17</a>
<a href="#section-5.3">5.3</a>. Header Field Registration .................................<a href="#page-17">17</a>
<a href="#section-5.4">5.4</a>. Internet Media Type Registration ..........................<a href="#page-17">17</a>
<a href="#section-5.4.1">5.4.1</a>. Internet Media Type multipart/byteranges ...........<a href="#page-18">18</a>
<a href="#section-6">6</a>. Security Considerations ........................................<a href="#page-19">19</a>
<a href="#section-6.1">6.1</a>. Denial-of-Service Attacks Using Range .....................<a href="#page-19">19</a>
<a href="#section-7">7</a>. Acknowledgments ................................................<a href="#page-19">19</a>
<a href="#section-8">8</a>. References .....................................................<a href="#page-20">20</a>
<a href="#section-8.1">8.1</a>. Normative References ......................................<a href="#page-20">20</a>
<a href="#section-8.2">8.2</a>. Informative References ....................................<a href="#page-20">20</a>
<a href="#appendix-A">Appendix A</a>. Internet Media Type multipart/byteranges ..............<a href="#page-21">21</a>
<a href="#appendix-B">Appendix B</a>. Changes from <a href="./rfc2616">RFC 2616</a> .................................<a href="#page-22">22</a>
<a href="#appendix-C">Appendix C</a>. Imported ABNF .........................................<a href="#page-22">22</a>
<a href="#appendix-D">Appendix D</a>. Collected ABNF ........................................<a href="#page-23">23</a>
Index .............................................................<a href="#page-24">24</a>
<span class="grey">Fielding, et al. Standards Track [Page 3]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span>
Hypertext Transfer Protocol (HTTP) clients often encounter
interrupted data transfers as a result of canceled requests or
dropped connections. When a client has stored a partial
representation, it is desirable to request the remainder of that
representation in a subsequent request rather than transfer the
entire representation. Likewise, devices with limited local storage
might benefit from being able to request only a subset of a larger
representation, such as a single page of a very large document, or
the dimensions of an embedded image.
This document defines HTTP/1.1 range requests, partial responses, and
the multipart/byteranges media type. Range requests are an OPTIONAL
feature of HTTP, designed so that recipients not implementing this
feature (or not supporting it for the target resource) can respond as
if it is a normal GET request without impacting interoperability.
Partial responses are indicated by a distinct status code to not be
mistaken for full responses by caches that might not implement the
feature.
Although the range request mechanism is designed to allow for
extensible range types, this specification only defines requests for
byte ranges.
<span class="h3"><a class="selflink" id="section-1.1" href="#section-1.1">1.1</a>. Conformance and Error Handling</span>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].
Conformance criteria and considerations regarding error handling are
defined in <a href="./rfc7230#section-2.5">Section 2.5 of [RFC7230]</a>.
<span class="h3"><a class="selflink" id="section-1.2" href="#section-1.2">1.2</a>. Syntax Notation</span>
This specification uses the Augmented Backus-Naur Form (ABNF)
notation of [<a href="./rfc5234" title=""Augmented BNF for Syntax Specifications: ABNF"">RFC5234</a>] with a list extension, defined in <a href="./rfc7230#section-7">Section 7 of
[RFC7230]</a>, that allows for compact definition of comma-separated
lists using a '#' operator (similar to how the '*' operator indicates
repetition). <a href="#appendix-C">Appendix C</a> describes rules imported from other
documents. <a href="#appendix-D">Appendix D</a> shows the collected grammar with all list
operators expanded to standard ABNF notation.
<span class="grey">Fielding, et al. Standards Track [Page 4]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. Range Units</span>
A representation can be partitioned into subranges according to
various structural units, depending on the structure inherent in the
representation's media type. This "range unit" is used in the
Accept-Ranges (<a href="#section-2.3">Section 2.3</a>) response header field to advertise
support for range requests, the Range (<a href="#section-3.1">Section 3.1</a>) request header
field to delineate the parts of a representation that are requested,
and the Content-Range (<a href="#section-4.2">Section 4.2</a>) payload header field to describe
which part of a representation is being transferred.
range-unit = bytes-unit / other-range-unit
<span class="h3"><a class="selflink" id="section-2.1" href="#section-2.1">2.1</a>. Byte Ranges</span>
Since representation data is transferred in payloads as a sequence of
octets, a byte range is a meaningful substructure for any
representation transferable over HTTP (<a href="./rfc7231#section-3">Section 3 of [RFC7231]</a>). The
"bytes" range unit is defined for expressing subranges of the data's
octet sequence.
bytes-unit = "bytes"
A byte-range request can specify a single range of bytes or a set of
ranges within a single representation.
byte-ranges-specifier = bytes-unit "=" byte-range-set
byte-range-set = 1#( byte-range-spec / suffix-byte-range-spec )
byte-range-spec = first-byte-pos "-" [ last-byte-pos ]
first-byte-pos = 1*DIGIT
last-byte-pos = 1*DIGIT
The first-byte-pos value in a byte-range-spec gives the byte-offset
of the first byte in a range. The last-byte-pos value gives the
byte-offset of the last byte in the range; that is, the byte
positions specified are inclusive. Byte offsets start at zero.
Examples of byte-ranges-specifier values:
o The first 500 bytes (byte offsets 0-499, inclusive):
bytes=0-499
o The second 500 bytes (byte offsets 500-999, inclusive):
bytes=500-999
<span class="grey">Fielding, et al. Standards Track [Page 5]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-6" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
A byte-range-spec is invalid if the last-byte-pos value is present
and less than the first-byte-pos.
A client can limit the number of bytes requested without knowing the
size of the selected representation. If the last-byte-pos value is
absent, or if the value is greater than or equal to the current
length of the representation data, the byte range is interpreted as
the remainder of the representation (i.e., the server replaces the
value of last-byte-pos with a value that is one less than the current
length of the selected representation).
A client can request the last N bytes of the selected representation
using a suffix-byte-range-spec.
suffix-byte-range-spec = "-" suffix-length
suffix-length = 1*DIGIT
If the selected representation is shorter than the specified
suffix-length, the entire representation is used.
Additional examples, assuming a representation of length 10000:
o The final 500 bytes (byte offsets 9500-9999, inclusive):
bytes=-500
Or:
bytes=9500-
o The first and last bytes only (bytes 0 and 9999):
bytes=0-0,-1
o Other valid (but not canonical) specifications of the second 500
bytes (byte offsets 500-999, inclusive):
bytes=500-600,601-999
bytes=500-700,601-999
If a valid byte-range-set includes at least one byte-range-spec with
a first-byte-pos that is less than the current length of the
representation, or at least one suffix-byte-range-spec with a
non-zero suffix-length, then the byte-range-set is satisfiable.
Otherwise, the byte-range-set is unsatisfiable.
<span class="grey">Fielding, et al. Standards Track [Page 6]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-7" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
In the byte-range syntax, first-byte-pos, last-byte-pos, and
suffix-length are expressed as decimal number of octets. Since there
is no predefined limit to the length of a payload, recipients MUST
anticipate potentially large decimal numerals and prevent parsing
errors due to integer conversion overflows.
<span class="h3"><a class="selflink" id="section-2.2" href="#section-2.2">2.2</a>. Other Range Units</span>
Range units are intended to be extensible. New range units ought to
be registered with IANA, as defined in <a href="#section-5.1">Section 5.1</a>.
other-range-unit = token
<span class="h3"><a class="selflink" id="section-2.3" href="#section-2.3">2.3</a>. Accept-Ranges</span>
The "Accept-Ranges" header field allows a server to indicate that it
supports range requests for the target resource.
Accept-Ranges = acceptable-ranges
acceptable-ranges = 1#range-unit / "none"
An origin server that supports byte-range requests for a given target
resource MAY send
Accept-Ranges: bytes
to indicate what range units are supported. A client MAY generate
range requests without having received this header field for the
resource involved. Range units are defined in <a href="#section-2">Section 2</a>.
A server that does not support any kind of range request for the
target resource MAY send
Accept-Ranges: none
to advise the client not to attempt a range request.
<span class="grey">Fielding, et al. Standards Track [Page 7]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-8" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. Range Requests</span>
<span class="h3"><a class="selflink" id="section-3.1" href="#section-3.1">3.1</a>. Range</span>
The "Range" header field on a GET request modifies the method
semantics to request transfer of only one or more subranges of the
selected representation data, rather than the entire selected
representation data.
Range = byte-ranges-specifier / other-ranges-specifier
other-ranges-specifier = other-range-unit "=" other-range-set
other-range-set = 1*VCHAR
A server MAY ignore the Range header field. However, origin servers
and intermediate caches ought to support byte ranges when possible,
since Range supports efficient recovery from partially failed
transfers and partial retrieval of large representations. A server
MUST ignore a Range header field received with a request method other
than GET.
An origin server MUST ignore a Range header field that contains a
range unit it does not understand. A proxy MAY discard a Range
header field that contains a range unit it does not understand.
A server that supports range requests MAY ignore or reject a Range
header field that consists of more than two overlapping ranges, or a
set of many small ranges that are not listed in ascending order,
since both are indications of either a broken client or a deliberate
denial-of-service attack (<a href="#section-6.1">Section 6.1</a>). A client SHOULD NOT request
multiple ranges that are inherently less efficient to process and
transfer than a single range that encompasses the same data.
A client that is requesting multiple ranges SHOULD list those ranges
in ascending order (the order in which they would typically be
received in a complete representation) unless there is a specific
need to request a later part earlier. For example, a user agent
processing a large representation with an internal catalog of parts
might need to request later parts first, particularly if the
representation consists of pages stored in reverse order and the user
agent wishes to transfer one page at a time.
The Range header field is evaluated after evaluating the precondition
header fields defined in [<a href="./rfc7232" title=""Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests"">RFC7232</a>], and only if the result in absence
of the Range header field would be a 200 (OK) response. In other
words, Range is ignored when a conditional GET would result in a 304
(Not Modified) response.
<span class="grey">Fielding, et al. Standards Track [Page 8]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-9" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
The If-Range header field (<a href="#section-3.2">Section 3.2</a>) can be used as a precondition
to applying the Range header field.
If all of the preconditions are true, the server supports the Range
header field for the target resource, and the specified range(s) are
valid and satisfiable (as defined in <a href="#section-2.1">Section 2.1</a>), the server SHOULD
send a 206 (Partial Content) response with a payload containing one
or more partial representations that correspond to the satisfiable
ranges requested, as defined in <a href="#section-4">Section 4</a>.
If all of the preconditions are true, the server supports the Range
header field for the target resource, and the specified range(s) are
invalid or unsatisfiable, the server SHOULD send a 416 (Range Not
Satisfiable) response.
<span class="h3"><a class="selflink" id="section-3.2" href="#section-3.2">3.2</a>. If-Range</span>
If a client has a partial copy of a representation and wishes to have
an up-to-date copy of the entire representation, it could use the
Range header field with a conditional GET (using either or both of
If-Unmodified-Since and If-Match.) However, if the precondition
fails because the representation has been modified, the client would
then have to make a second request to obtain the entire current
representation.
The "If-Range" header field allows a client to "short-circuit" the
second request. Informally, its meaning is as follows: if the
representation is unchanged, send me the part(s) that I am requesting
in Range; otherwise, send me the entire representation.
If-Range = entity-tag / HTTP-date
A client MUST NOT generate an If-Range header field in a request that
does not contain a Range header field. A server MUST ignore an
If-Range header field received in a request that does not contain a
Range header field. An origin server MUST ignore an If-Range header
field received in a request for a target resource that does not
support Range requests.
A client MUST NOT generate an If-Range header field containing an
entity-tag that is marked as weak. A client MUST NOT generate an
If-Range header field containing an HTTP-date unless the client has
no entity-tag for the corresponding representation and the date is a
strong validator in the sense defined by <a href="./rfc7232#section-2.2.2">Section 2.2.2 of [RFC7232]</a>.
A server that evaluates an If-Range precondition MUST use the strong
comparison function when comparing entity-tags (<a href="./rfc7232#section-2.3.2">Section 2.3.2 of
[RFC7232]</a>) and MUST evaluate the condition as false if an HTTP-date
<span class="grey">Fielding, et al. Standards Track [Page 9]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-10" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
validator is provided that is not a strong validator in the sense
defined by <a href="./rfc7232#section-2.2.2">Section 2.2.2 of [RFC7232]</a>. A valid entity-tag can be
distinguished from a valid HTTP-date by examining the first two
characters for a DQUOTE.
If the validator given in the If-Range header field matches the
current validator for the selected representation of the target
resource, then the server SHOULD process the Range header field as
requested. If the validator does not match, the server MUST ignore
the Range header field. Note that this comparison by exact match,
including when the validator is an HTTP-date, differs from the
"earlier than or equal to" comparison used when evaluating an
If-Unmodified-Since conditional.
<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. Responses to a Range Request</span>
<span class="h3"><a class="selflink" id="section-4.1" href="#section-4.1">4.1</a>. 206 Partial Content</span>
The 206 (Partial Content) status code indicates that the server is
successfully fulfilling a range request for the target resource by
transferring one or more parts of the selected representation that
correspond to the satisfiable ranges found in the request's Range
header field (<a href="#section-3.1">Section 3.1</a>).
If a single part is being transferred, the server generating the 206
response MUST generate a Content-Range header field, describing what
range of the selected representation is enclosed, and a payload
consisting of the range. For example:
HTTP/1.1 206 Partial Content
Date: Wed, 15 Nov 1995 06:25:24 GMT
Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT
Content-Range: bytes 21010-47021/47022
Content-Length: 26012
Content-Type: image/gif
... 26012 bytes of partial image data ...
If multiple parts are being transferred, the server generating the
206 response MUST generate a "multipart/byteranges" payload, as
defined in <a href="#appendix-A">Appendix A</a>, and a Content-Type header field containing the
multipart/byteranges media type and its required boundary parameter.
To avoid confusion with single-part responses, a server MUST NOT
generate a Content-Range header field in the HTTP header section of a
multiple part response (this field will be sent in each part
instead).
<span class="grey">Fielding, et al. Standards Track [Page 10]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-11" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
Within the header area of each body part in the multipart payload,
the server MUST generate a Content-Range header field corresponding
to the range being enclosed in that body part. If the selected
representation would have had a Content-Type header field in a 200
(OK) response, the server SHOULD generate that same Content-Type
field in the header area of each body part. For example:
HTTP/1.1 206 Partial Content
Date: Wed, 15 Nov 1995 06:25:24 GMT
Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT
Content-Length: 1741
Content-Type: multipart/byteranges; boundary=THIS_STRING_SEPARATES
--THIS_STRING_SEPARATES
Content-Type: application/pdf
Content-Range: bytes 500-999/8000
...the first range...
--THIS_STRING_SEPARATES
Content-Type: application/pdf
Content-Range: bytes 7000-7999/8000
...the second range
--THIS_STRING_SEPARATES--
When multiple ranges are requested, a server MAY coalesce any of the
ranges that overlap, or that are separated by a gap that is smaller
than the overhead of sending multiple parts, regardless of the order
in which the corresponding byte-range-spec appeared in the received
Range header field. Since the typical overhead between parts of a
multipart/byteranges payload is around 80 bytes, depending on the
selected representation's media type and the chosen boundary
parameter length, it can be less efficient to transfer many small
disjoint parts than it is to transfer the entire selected
representation.
A server MUST NOT generate a multipart response to a request for a
single range, since a client that does not request multiple parts
might not support multipart responses. However, a server MAY
generate a multipart/byteranges payload with only a single body part
if multiple ranges were requested and only one range was found to be
satisfiable or only one range remained after coalescing. A client
that cannot process a multipart/byteranges response MUST NOT generate
a request that asks for multiple ranges.
When a multipart response payload is generated, the server SHOULD
send the parts in the same order that the corresponding
byte-range-spec appeared in the received Range header field,
<span class="grey">Fielding, et al. Standards Track [Page 11]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-12" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
excluding those ranges that were deemed unsatisfiable or that were
coalesced into other ranges. A client that receives a multipart
response MUST inspect the Content-Range header field present in each
body part in order to determine which range is contained in that body
part; a client cannot rely on receiving the same ranges that it
requested, nor the same order that it requested.
When a 206 response is generated, the server MUST generate the
following header fields, in addition to those required above, if the
field would have been sent in a 200 (OK) response to the same
request: Date, Cache-Control, ETag, Expires, Content-Location, and
Vary.
If a 206 is generated in response to a request with an If-Range
header field, the sender SHOULD NOT generate other representation
header fields beyond those required above, because the client is
understood to already have a prior response containing those header
fields. Otherwise, the sender MUST generate all of the
representation header fields that would have been sent in a 200 (OK)
response to the same request.
A 206 response is cacheable by default; i.e., unless otherwise
indicated by explicit cache controls (see <a href="./rfc7234#section-4.2.2">Section 4.2.2 of
[RFC7234]</a>).
<span class="h3"><a class="selflink" id="section-4.2" href="#section-4.2">4.2</a>. Content-Range</span>
The "Content-Range" header field is sent in a single part 206
(Partial Content) response to indicate the partial range of the
selected representation enclosed as the message payload, sent in each
part of a multipart 206 response to indicate the range enclosed
within each body part, and sent in 416 (Range Not Satisfiable)
responses to provide information about the selected representation.
Content-Range = byte-content-range
/ other-content-range
byte-content-range = bytes-unit SP
( byte-range-resp / unsatisfied-range )
byte-range-resp = byte-range "/" ( complete-length / "*" )
byte-range = first-byte-pos "-" last-byte-pos
unsatisfied-range = "*/" complete-length
complete-length = 1*DIGIT
other-content-range = other-range-unit SP other-range-resp
other-range-resp = *CHAR
<span class="grey">Fielding, et al. Standards Track [Page 12]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-13" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
If a 206 (Partial Content) response contains a Content-Range header
field with a range unit (<a href="#section-2">Section 2</a>) that the recipient does not
understand, the recipient MUST NOT attempt to recombine it with a
stored representation. A proxy that receives such a message SHOULD
forward it downstream.
For byte ranges, a sender SHOULD indicate the complete length of the
representation from which the range has been extracted, unless the
complete length is unknown or difficult to determine. An asterisk
character ("*") in place of the complete-length indicates that the
representation length was unknown when the header field was
generated.
The following example illustrates when the complete length of the
selected representation is known by the sender to be 1234 bytes:
Content-Range: bytes 42-1233/1234
and this second example illustrates when the complete length is
unknown:
Content-Range: bytes 42-1233/*
A Content-Range field value is invalid if it contains a
byte-range-resp that has a last-byte-pos value less than its
first-byte-pos value, or a complete-length value less than or equal
to its last-byte-pos value. The recipient of an invalid
Content-Range MUST NOT attempt to recombine the received content with
a stored representation.
A server generating a 416 (Range Not Satisfiable) response to a
byte-range request SHOULD send a Content-Range header field with an
unsatisfied-range value, as in the following example:
Content-Range: bytes */1234
The complete-length in a 416 response indicates the current length of
the selected representation.
The Content-Range header field has no meaning for status codes that
do not explicitly describe its semantic. For this specification,
only the 206 (Partial Content) and 416 (Range Not Satisfiable) status
codes describe a meaning for Content-Range.
<span class="grey">Fielding, et al. Standards Track [Page 13]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-14" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
The following are examples of Content-Range values in which the
selected representation contains a total of 1234 bytes:
o The first 500 bytes:
Content-Range: bytes 0-499/1234
o The second 500 bytes:
Content-Range: bytes 500-999/1234
o All except for the first 500 bytes:
Content-Range: bytes 500-1233/1234
o The last 500 bytes:
Content-Range: bytes 734-1233/1234
<span class="h3"><a class="selflink" id="section-4.3" href="#section-4.3">4.3</a>. Combining Ranges</span>
A response might transfer only a subrange of a representation if the
connection closed prematurely or if the request used one or more
Range specifications. After several such transfers, a client might
have received several ranges of the same representation. These
ranges can only be safely combined if they all have in common the
same strong validator (<a href="./rfc7232#section-2.1">Section 2.1 of [RFC7232]</a>).
A client that has received multiple partial responses to GET requests
on a target resource MAY combine those responses into a larger
continuous range if they share the same strong validator.
If the most recent response is an incomplete 200 (OK) response, then
the header fields of that response are used for any combined response
and replace those of the matching stored responses.
If the most recent response is a 206 (Partial Content) response and
at least one of the matching stored responses is a 200 (OK), then the
combined response header fields consist of the most recent 200
response's header fields. If all of the matching stored responses
are 206 responses, then the stored response with the most recent
header fields is used as the source of header fields for the combined
response, except that the client MUST use other header fields
provided in the new response, aside from Content-Range, to replace
all instances of the corresponding header fields in the stored
response.
<span class="grey">Fielding, et al. Standards Track [Page 14]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-15" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
The combined response message body consists of the union of partial
content ranges in the new response and each of the selected
responses. If the union consists of the entire range of the
representation, then the client MUST process the combined response as
if it were a complete 200 (OK) response, including a Content-Length
header field that reflects the complete length. Otherwise, the
client MUST process the set of continuous ranges as one of the
following: an incomplete 200 (OK) response if the combined response
is a prefix of the representation, a single 206 (Partial Content)
response containing a multipart/byteranges body, or multiple 206
(Partial Content) responses, each with one continuous range that is
indicated by a Content-Range header field.
<span class="h3"><a class="selflink" id="section-4.4" href="#section-4.4">4.4</a>. 416 Range Not Satisfiable</span>
The 416 (Range Not Satisfiable) status code indicates that none of
the ranges in the request's Range header field (<a href="#section-3.1">Section 3.1</a>) overlap
the current extent of the selected resource or that the set of ranges
requested has been rejected due to invalid ranges or an excessive
request of small or overlapping ranges.
For byte ranges, failing to overlap the current extent means that the
first-byte-pos of all of the byte-range-spec values were greater than
the current length of the selected representation. When this status
code is generated in response to a byte-range request, the sender
SHOULD generate a Content-Range header field specifying the current
length of the selected representation (<a href="#section-4.2">Section 4.2</a>).
For example:
HTTP/1.1 416 Range Not Satisfiable
Date: Fri, 20 Jan 2012 15:41:54 GMT
Content-Range: bytes */47022
Note: Because servers are free to ignore Range, many
implementations will simply respond with the entire selected
representation in a 200 (OK) response. That is partly because
most clients are prepared to receive a 200 (OK) to complete the
task (albeit less efficiently) and partly because clients might
not stop making an invalid partial request until they have
received a complete representation. Thus, clients cannot depend
on receiving a 416 (Range Not Satisfiable) response even when it
is most appropriate.
<span class="grey">Fielding, et al. Standards Track [Page 15]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-16" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. IANA Considerations</span>
<span class="h3"><a class="selflink" id="section-5.1" href="#section-5.1">5.1</a>. Range Unit Registry</span>
The "HTTP Range Unit Registry" defines the namespace for the range
unit names and refers to their corresponding specifications. The
registry has been created and is now maintained at
<<a href="http://www.iana.org/assignments/http-parameters">http://www.iana.org/assignments/http-parameters</a>>.
<span class="h4"><a class="selflink" id="section-5.1.1" href="#section-5.1.1">5.1.1</a>. Procedure</span>
Registration of an HTTP Range Unit MUST include the following fields:
o Name
o Description
o Pointer to specification text
Values to be added to this namespace require IETF Review (see
<a href="./rfc5226#section-4.1">[RFC5226], Section 4.1</a>).
<span class="h4"><a class="selflink" id="section-5.1.2" href="#section-5.1.2">5.1.2</a>. Registrations</span>
The initial range unit registry contains the registrations below:
+-------------+---------------------------------------+-------------+
| Range Unit | Description | Reference |
| Name | | |
+-------------+---------------------------------------+-------------+
| bytes | a range of octets | <a href="#section-2.1">Section 2.1</a> |
| none | reserved as keyword, indicating no | <a href="#section-2.3">Section 2.3</a> |
| | ranges are supported | |
+-------------+---------------------------------------+-------------+
The change controller is: "IETF (iesg@ietf.org) - Internet
Engineering Task Force".
<span class="grey">Fielding, et al. Standards Track [Page 16]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-17" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h3"><a class="selflink" id="section-5.2" href="#section-5.2">5.2</a>. Status Code Registration</span>
The "Hypertext Transfer Protocol (HTTP) Status Code Registry" located
at <<a href="http://www.iana.org/assignments/http-status-codes">http://www.iana.org/assignments/http-status-codes</a>> has been
updated to include the registrations below:
+-------+-----------------------+-------------+
| Value | Description | Reference |
+-------+-----------------------+-------------+
| 206 | Partial Content | <a href="#section-4.1">Section 4.1</a> |
| 416 | Range Not Satisfiable | <a href="#section-4.4">Section 4.4</a> |
+-------+-----------------------+-------------+
<span class="h3"><a class="selflink" id="section-5.3" href="#section-5.3">5.3</a>. Header Field Registration</span>
HTTP header fields are registered within the "Message Headers"
registry maintained at
<<a href="http://www.iana.org/assignments/message-headers/">http://www.iana.org/assignments/message-headers/</a>>.
This document defines the following HTTP header fields, so their
associated registry entries have been updated according to the
permanent registrations below (see [<a href="#ref-BCP90" title=""Registration Procedures for Message Header Fields"">BCP90</a>]):
+-------------------+----------+----------+-------------+
| Header Field Name | Protocol | Status | Reference |
+-------------------+----------+----------+-------------+
| Accept-Ranges | http | standard | <a href="#section-2.3">Section 2.3</a> |
| Content-Range | http | standard | <a href="#section-4.2">Section 4.2</a> |
| If-Range | http | standard | <a href="#section-3.2">Section 3.2</a> |
| Range | http | standard | <a href="#section-3.1">Section 3.1</a> |
+-------------------+----------+----------+-------------+
The change controller is: "IETF (iesg@ietf.org) - Internet
Engineering Task Force".
<span class="h3"><a class="selflink" id="section-5.4" href="#section-5.4">5.4</a>. Internet Media Type Registration</span>
IANA maintains the registry of Internet media types [<a href="#ref-BCP13" title=""Media Type Specifications and Registration Procedures"">BCP13</a>] at
<<a href="http://www.iana.org/assignments/media-types">http://www.iana.org/assignments/media-types</a>>.
This document serves as the specification for the Internet media type
"multipart/byteranges". The following has been registered with IANA.
<span class="grey">Fielding, et al. Standards Track [Page 17]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-18" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h4"><a class="selflink" id="section-5.4.1" href="#section-5.4.1">5.4.1</a>. Internet Media Type multipart/byteranges</span>
Type name: multipart
Subtype name: byteranges
Required parameters: boundary
Optional parameters: N/A
Encoding considerations: only "7bit", "8bit", or "binary" are
permitted
Security considerations: see <a href="#section-6">Section 6</a>
Interoperability considerations: N/A
Published specification: This specification (see <a href="#appendix-A">Appendix A</a>).
Applications that use this media type: HTTP components supporting
multiple ranges in a single request.
Fragment identifier considerations: N/A
Additional information:
Deprecated alias names for this type: N/A
Magic number(s): N/A
File extension(s): N/A
Macintosh file type code(s): N/A
Person and email address to contact for further information: See
Authors' Addresses section.
Intended usage: COMMON
Restrictions on usage: N/A
Author: See Authors' Addresses section.
Change controller: IESG
<span class="grey">Fielding, et al. Standards Track [Page 18]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-19" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. Security Considerations</span>
This section is meant to inform developers, information providers,
and users of known security concerns specific to the HTTP range
request mechanisms. More general security considerations are
addressed in HTTP messaging [<a href="./rfc7230" title=""Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing"">RFC7230</a>] and semantics [<a href="./rfc7231" title=""Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content"">RFC7231</a>].
<span class="h3"><a class="selflink" id="section-6.1" href="#section-6.1">6.1</a>. Denial-of-Service Attacks Using Range</span>
Unconstrained multiple range requests are susceptible to denial-of-
service attacks because the effort required to request many
overlapping ranges of the same data is tiny compared to the time,
memory, and bandwidth consumed by attempting to serve the requested
data in many parts. Servers ought to ignore, coalesce, or reject
egregious range requests, such as requests for more than two
overlapping ranges or for many small ranges in a single set,
particularly when the ranges are requested out of order for no
apparent reason. Multipart range requests are not designed to
support random access.
<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>. Acknowledgments</span>
See <a href="./rfc7230#section-10">Section 10 of [RFC7230]</a>.
<span class="grey">Fielding, et al. Standards Track [Page 19]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-20" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>. References</span>
<span class="h3"><a class="selflink" id="section-8.1" href="#section-8.1">8.1</a>. Normative References</span>
[<a id="ref-RFC2046">RFC2046</a>] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
Extensions (MIME) Part Two: Media Types", <a href="./rfc2046">RFC 2046</a>,
November 1996.
[<a id="ref-RFC2119">RFC2119</a>] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.
[<a id="ref-RFC5234">RFC5234</a>] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
Specifications: ABNF", STD 68, <a href="./rfc5234">RFC 5234</a>, January 2008.
[<a id="ref-RFC7230">RFC7230</a>] Fielding, R., Ed. and J. Reschke, Ed., "Hypertext Transfer
Protocol (HTTP/1.1): Message Syntax and Routing",
<a href="./rfc7230">RFC 7230</a>, June 2014.
[<a id="ref-RFC7231">RFC7231</a>] Fielding, R., Ed. and J. Reschke, Ed., "Hypertext Transfer
Protocol (HTTP/1.1): Semantics and Content", <a href="./rfc7231">RFC 7231</a>,
June 2014.
[<a id="ref-RFC7232">RFC7232</a>] Fielding, R., Ed. and J. Reschke, Ed., "Hypertext Transfer
Protocol (HTTP/1.1): Conditional Requests", <a href="./rfc7232">RFC 7232</a>,
June 2014.
[<a id="ref-RFC7234">RFC7234</a>] Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke,
Ed., "Hypertext Transfer Protocol (HTTP/1.1): Caching",
<a href="./rfc7234">RFC 7234</a>, June 2014.
<span class="h3"><a class="selflink" id="section-8.2" href="#section-8.2">8.2</a>. Informative References</span>
[<a id="ref-BCP13">BCP13</a>] Freed, N., Klensin, J., and T. Hansen, "Media Type
Specifications and Registration Procedures", <a href="https://www.rfc-editor.org/bcp/bcp13">BCP 13</a>,
<a href="./rfc6838">RFC 6838</a>, January 2013.
[<a id="ref-BCP90">BCP90</a>] Klyne, G., Nottingham, M., and J. Mogul, "Registration
Procedures for Message Header Fields", <a href="https://www.rfc-editor.org/bcp/bcp90">BCP 90</a>, <a href="./rfc3864">RFC 3864</a>,
September 2004.
[<a id="ref-RFC2616">RFC2616</a>] Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
Transfer Protocol -- HTTP/1.1", <a href="./rfc2616">RFC 2616</a>, June 1999.
[<a id="ref-RFC5226">RFC5226</a>] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", <a href="https://www.rfc-editor.org/bcp/bcp26">BCP 26</a>, <a href="./rfc5226">RFC 5226</a>,
May 2008.
<span class="grey">Fielding, et al. Standards Track [Page 20]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-21" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="appendix-A" href="#appendix-A">Appendix A</a>. Internet Media Type multipart/byteranges</span>
When a 206 (Partial Content) response message includes the content of
multiple ranges, they are transmitted as body parts in a multipart
message body (<a href="./rfc2046#section-5.1">[RFC2046], Section 5.1</a>) with the media type of
"multipart/byteranges".
The multipart/byteranges media type includes one or more body parts,
each with its own Content-Type and Content-Range fields. The
required boundary parameter specifies the boundary string used to
separate each body part.
Implementation Notes:
1. Additional CRLFs might precede the first boundary string in the
body.
2. Although [<a href="./rfc2046" title=""Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types"">RFC2046</a>] permits the boundary string to be quoted, some
existing implementations handle a quoted boundary string
incorrectly.
3. 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, which is almost (but not quite) compatible with
this type.
Despite the name, the "multipart/byteranges" media type is not
limited to byte ranges. The following example uses an "exampleunit"
range unit:
HTTP/1.1 206 Partial Content
Date: Tue, 14 Nov 1995 06:25:24 GMT
Last-Modified: Tue, 14 July 04:58:08 GMT
Content-Length: 2331785
Content-Type: multipart/byteranges; boundary=THIS_STRING_SEPARATES
--THIS_STRING_SEPARATES
Content-Type: video/example
Content-Range: exampleunit 1.2-4.3/25
...the first range...
--THIS_STRING_SEPARATES
Content-Type: video/example
Content-Range: exampleunit 11.2-14.3/25
...the second range
--THIS_STRING_SEPARATES--
<span class="grey">Fielding, et al. Standards Track [Page 21]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-22" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="appendix-B" href="#appendix-B">Appendix B</a>. Changes from <a href="./rfc2616">RFC 2616</a></span>
Servers are given more leeway in how they respond to a range request,
in order to mitigate abuse by malicious (or just greedy) clients.
(<a href="#section-3.1">Section 3.1</a>)
A weak validator cannot be used in a 206 response. (<a href="#section-4.1">Section 4.1</a>)
The Content-Range header field only has meaning when the status code
explicitly defines its use. (<a href="#section-4.2">Section 4.2</a>)
This specification introduces a Range Unit Registry. (<a href="#section-5.1">Section 5.1</a>)
multipart/byteranges can consist of a single part. (Appendix A)
<span class="h2"><a class="selflink" id="appendix-C" href="#appendix-C">Appendix C</a>. Imported ABNF</span>
The following core rules are included by reference, as defined in
<a href="./rfc5234#appendix-B.1">Appendix B.1 of [RFC5234]</a>: ALPHA (letters), CR (carriage return),
CRLF (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double
quote), HEXDIG (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
character).
Note that all rules derived from token are to be compared
case-insensitively, like range-unit and acceptable-ranges.
The rules below are defined in [<a href="./rfc7230" title=""Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing"">RFC7230</a>]:
OWS = <OWS, see <a href="./rfc7230#section-3.2.3">[RFC7230], Section 3.2.3</a>>
token = <token, see <a href="./rfc7230#section-3.2.6">[RFC7230], Section 3.2.6</a>>
The rules below are defined in other parts:
HTTP-date = <HTTP-date, see <a href="./rfc7231#section-7.1.1.1">[RFC7231], Section 7.1.1.1</a>>
entity-tag = <entity-tag, see <a href="./rfc7232#section-2.3">[RFC7232], Section 2.3</a>>
<span class="grey">Fielding, et al. Standards Track [Page 22]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-23" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
<span class="h2"><a class="selflink" id="appendix-D" href="#appendix-D">Appendix D</a>. Collected ABNF</span>
In the collected ABNF below, list rules are expanded as per <a href="./rfc7230#section-1.2">Section</a>
<a href="./rfc7230#section-1.2">1.2 of [RFC7230]</a>.
Accept-Ranges = acceptable-ranges
Content-Range = byte-content-range / other-content-range
HTTP-date = <HTTP-date, see <a href="./rfc7231#section-7.1.1.1">[RFC7231], Section 7.1.1.1</a>>
If-Range = entity-tag / HTTP-date
OWS = <OWS, see <a href="./rfc7230#section-3.2.3">[RFC7230], Section 3.2.3</a>>
Range = byte-ranges-specifier / other-ranges-specifier
acceptable-ranges = ( *( "," OWS ) range-unit *( OWS "," [ OWS
range-unit ] ) ) / "none"
byte-content-range = bytes-unit SP ( byte-range-resp /
unsatisfied-range )
byte-range = first-byte-pos "-" last-byte-pos
byte-range-resp = byte-range "/" ( complete-length / "*" )
byte-range-set = *( "," OWS ) ( byte-range-spec /
suffix-byte-range-spec ) *( OWS "," [ OWS ( byte-range-spec /
suffix-byte-range-spec ) ] )
byte-range-spec = first-byte-pos "-" [ last-byte-pos ]
byte-ranges-specifier = bytes-unit "=" byte-range-set
bytes-unit = "bytes"
complete-length = 1*DIGIT
entity-tag = <entity-tag, see <a href="./rfc7232#section-2.3">[RFC7232], Section 2.3</a>>
first-byte-pos = 1*DIGIT
last-byte-pos = 1*DIGIT
other-content-range = other-range-unit SP other-range-resp
other-range-resp = *CHAR
other-range-set = 1*VCHAR
other-range-unit = token
other-ranges-specifier = other-range-unit "=" other-range-set
range-unit = bytes-unit / other-range-unit
suffix-byte-range-spec = "-" suffix-length
<span class="grey">Fielding, et al. Standards Track [Page 23]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-24" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
suffix-length = 1*DIGIT
token = <token, see <a href="./rfc7230#section-3.2.6">[RFC7230], Section 3.2.6</a>>
unsatisfied-range = "*/" complete-length
Index
2
206 Partial Content (status code) 10
4
416 Range Not Satisfiable (status code) 15
A
Accept-Ranges header field 7
C
Content-Range header field 12
G
Grammar
Accept-Ranges 7
acceptable-ranges 7
byte-content-range 12
byte-range 12
byte-range-resp 12
byte-range-set 5
byte-range-spec 5
byte-ranges-specifier 5
bytes-unit 5
complete-length 12
Content-Range 12
first-byte-pos 5
If-Range 9
last-byte-pos 5
other-content-range 12
other-range-resp 12
other-range-unit 5, 7
Range 8
range-unit 5
ranges-specifier 5
suffix-byte-range-spec 6
suffix-length 6
unsatisfied-range 12
<span class="grey">Fielding, et al. Standards Track [Page 24]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-25" ></span>
<span class="grey"><a href="./rfc7233">RFC 7233</a> HTTP/1.1 Range Requests June 2014</span>
I
If-Range header field 9
M
Media Type
multipart/byteranges 18, 21
multipart/x-byteranges 19
multipart/byteranges Media Type 18, 21
multipart/x-byteranges Media Type 21
R
Range header field 8
Authors' Addresses
Roy T. Fielding (editor)
Adobe Systems Incorporated
345 Park Ave
San Jose, CA 95110
USA
EMail: fielding@gbiv.com
URI: <a href="http://roy.gbiv.com/">http://roy.gbiv.com/</a>
Yves Lafon (editor)
World Wide Web Consortium
W3C / ERCIM
2004, rte des Lucioles
Sophia-Antipolis, AM 06902
France
EMail: ylafon@w3.org
URI: <a href="http://www.raubacapeu.net/people/yves/">http://www.raubacapeu.net/people/yves/</a>
Julian F. Reschke (editor)
greenbytes GmbH
Hafenweg 16
Muenster, NW 48155
Germany
EMail: julian.reschke@greenbytes.de
URI: <a href="http://greenbytes.de/tech/webdav/">http://greenbytes.de/tech/webdav/</a>
Fielding, et al. Standards Track [Page 25]
</pre>
|