| 1 |
Long: range |
| 2 |
Short: r |
| 3 |
Help: Retrieve only the bytes within RANGE |
| 4 |
Arg: <range> |
| 5 |
Protocols: HTTP FTP SFTP FILE |
| 6 |
--- |
| 7 |
Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP |
| 8 |
server or a local FILE. Ranges can be specified in a number of ways. |
| 9 |
.RS |
| 10 |
.TP 10 |
| 11 |
.B 0-499 |
| 12 |
specifies the first 500 bytes |
| 13 |
.TP |
| 14 |
.B 500-999 |
| 15 |
specifies the second 500 bytes |
| 16 |
.TP |
| 17 |
.B -500 |
| 18 |
specifies the last 500 bytes |
| 19 |
.TP |
| 20 |
.B 9500- |
| 21 |
specifies the bytes from offset 9500 and forward |
| 22 |
.TP |
| 23 |
.B 0-0,-1 |
| 24 |
specifies the first and last byte only(*)(HTTP) |
| 25 |
.TP |
| 26 |
.B 100-199,500-599 |
| 27 |
specifies two separate 100-byte ranges(*) (HTTP) |
| 28 |
.RE |
| 29 |
.IP |
| 30 |
(*) = NOTE that this will cause the server to reply with a multipart |
| 31 |
response! |
| 32 |
|
| 33 |
Only digit characters (0-9) are valid in the 'start' and 'stop' fields of the |
| 34 |
\&'start-stop' range syntax. If a non-digit character is given in the range, |
| 35 |
the server's response will be unspecified, depending on the server's |
| 36 |
configuration. |
| 37 |
|
| 38 |
You should also be aware that many HTTP/1.1 servers do not have this feature |
| 39 |
enabled, so that when you attempt to get a range, you'll instead get the whole |
| 40 |
document. |
| 41 |
|
| 42 |
FTP and SFTP range downloads only support the simple 'start-stop' syntax |
| 43 |
(optionally with one of the numbers omitted). FTP use depends on the extended |
| 44 |
FTP command SIZE. |
| 45 |
|
| 46 |
If this option is used several times, the last one will be used. |