Return to range.d CVS log

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

Annotation of embedaddon/curl/docs/cmdline-opts/range.d, revision 1.1.1.1

1.1       misho       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.