Return to range.d CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs / cmdline-opts

curl

    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.