docs/cmdline-opts/range.d

   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.