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