diff options
Diffstat (limited to 'docs/cmdline-opts/range.d')
-rw-r--r-- | docs/cmdline-opts/range.d | 50 |
1 files changed, 0 insertions, 50 deletions
diff --git a/docs/cmdline-opts/range.d b/docs/cmdline-opts/range.d deleted file mode 100644 index eba7220e1..000000000 --- a/docs/cmdline-opts/range.d +++ /dev/null @@ -1,50 +0,0 @@ -c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -SPDX-License-Identifier: curl -Long: range -Short: r -Help: Retrieve only the bytes within RANGE -Arg: <range> -Protocols: HTTP FTP SFTP FILE -Category: http ftp sftp file -Example: --range 22-44 $URL -Added: 4.0 -See-also: continue-at append -Multi: single ---- -Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP -server or a local FILE. Ranges can be specified in a number of ways. -.RS -.TP 10 -.B 0-499 -specifies the first 500 bytes -.TP -.B 500-999 -specifies the second 500 bytes -.TP -.B -500 -specifies the last 500 bytes -.TP -.B 9500- -specifies the bytes from offset 9500 and forward -.TP -.B 0-0,-1 -specifies the first and last byte only(*)(HTTP) -.TP -.B 100-199,500-599 -specifies two separate 100-byte ranges(*) (HTTP) -.RE -.IP -(*) = NOTE that this causes the server to reply with a multipart response, -which is returned as-is by curl! Parsing or otherwise transforming this -response is the responsibility of the caller. - -Only digit characters (0-9) are valid in the 'start' and 'stop' fields of the -'start-stop' range syntax. If a non-digit character is given in the range, the -server's response is unspecified, depending on the server's configuration. - -Many HTTP/1.1 servers do not have this feature enabled, so that when you -attempt to get a range, curl instead gets the whole document. - -FTP and SFTP range downloads only support the simple 'start-stop' syntax -(optionally with one of the numbers omitted). FTP use depends on the extended -FTP command SIZE. |