| lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame^] | 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 a 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. |