Lines Matching +full:download +full:- +full:url
5 Get the main page from a web-server:
9 Get the README file the user's home directory at funet's ftp-server:
35 curl --ftp-ssl ftp://files.are.secure.com/secrets.txt
39 curl -u username sftp://example.com/etc/issue
42 password-protected) to authenticate:
44 curl -u username: --key ~/.ssh/id_rsa scp://example.com/~/file.txt
47 (password-protected) to authenticate:
49 curl -u username: --key ~/.ssh/id_rsa --pass private_key_password
58 curl -u "domain\username:passwd" smb://server.example.com/share/file.txt
60 ## Download to a File
64 curl -o thatpage.html http://www.example.com/
67 the remote document (if no file name part is specified in the URL, this will
70 curl -O http://www.example.com/index.html
74 curl -O www.haxx.se/index.html -O curl.se/download.html
80 To ftp files using name+passwd, include them in the URL like:
84 or specify them with the -u flag like
86 curl -u name:passwd ftp://machine.domain:port/full/path/to/file
90 It is just like for FTP, but you may also want to specify and use SSL-specific
95 `--ftp-ssl` option.
99 This is similar to FTP, but you can use the `--key` option to specify a
102 remote system; this password is specified using the `--pass` option.
105 matching public key file must be specified using the `--pubkey` option.
116 curl -u name:passwd http://machine.domain/full/path/to/file
121 secure ones out of the ones that the server accepts for the given URL, by
122 using `--anyauth`.
124 **Note**! According to the URL specification, HTTP URLs can not contain a user
127 `-u` style for user and password.
141 Get an ftp file using an HTTP proxy named my-proxy that uses port 888:
143 curl -x my-proxy:888 ftp://ftp.leachsite.com/README
148 curl -u user:passwd -x my-proxy:888 http://www.get.this/
150 Some proxies require special authentication. Specify by using -U as above:
152 curl -U user:passwd -x my-proxy:888 http://www.get.this/
154 A comma-separated list of hosts and domains which do not use the proxy can be
157 curl --noproxy localhost,get.this -x my-proxy:888 http://www.get.this/
159 If the proxy is specified with `--proxy1.0` instead of `--proxy` or `-x`, then
162 curl also supports SOCKS4 and SOCKS5 proxies with `--socks4` and `--socks5`.
169 curl supports the `-u`, `-Q` and `--ftp-account` options that can be used to
173 curl -u "username@ftp.server Proxy-Username:Remote-Pass"
174 --ftp-account Proxy-Password --upload-file local-file
175 ftp://my-ftp.proxy.server:21/remote/upload/path/
178 transfers, and curl's `-v` option to see exactly what curl is sending.
182 HTTP 1.1 introduced byte-ranges. Using this, a client can request to get only
183 one or more subparts of a specified document. Curl supports this with the `-r`
188 curl -r 0-99 http://www.get.this/
192 curl -r -500 http://www.get.this/
199 curl -r 0-99 ftp://www.get.this/README
207 curl -T - ftp://ftp.upload.com/myfile
211 curl -T uploadfile -u user:passwd ftp://ftp.upload.com/myfile
216 curl -T uploadfile -u user:passwd ftp://ftp.upload.com/
220 curl -T localfile -a ftp://ftp.upload.com/remotefile
226 curl --proxytunnel -x proxy:port -T localfile ftp.upload.com
230 curl -T file.txt -u "domain\username:passwd"
237 curl -T - http://www.upload.com/myfile
247 you can't understand the responses: use the `-v` flag to get verbose
249 order to let the user see all client-server interaction (but it won't show you
252 curl -v ftp://ftp.upload.com/
255 `--trace` or `--trace-ascii` options with a given file name to log to, like
258 curl --trace trace.txt www.haxx.se
265 a single file, you should use `-I`/`--head` option. It displays all available
269 For HTTP, you can get the header information (the same as `-I` would show)
270 shown before the data by using `-i`/`--include`. Curl understands the
271 `-D`/`--dump-header` option when getting files from both FTP and HTTP, and it
276 curl --dump-header headers.txt curl.se
284 It's easy to post data using curl. This is done using the `-d <data>` option.
289 curl -d "name=Rafael%20Sagula&phone=3320780" http://www.where.com/guest.cgi
295 If there's a "normal" post, you use `-d` to post. `-d` takes a full "post
302 *must* be properly URL encoded. That means you replace space with + and that
323 curl -d "user=foobar&pass=12345&id=blablabla&ding=submit"
326 While `-d` uses the application/x-www-form-urlencoded mime-type, generally
328 multipart/form-data type. This latter type supports things like file upload.
330 `-F` accepts parameters like `-F "name=contents"`. If you want the contents to
337 curl -F "coolfiles=@fil1.gif;type=image/gif,fil2.txt,fil3.html"
340 If the content-type is not specified, curl will try to guess from the file
343 default type 'application/octet-stream'.
345 Emulate a fill-in form with `-F`. Let's say you fill in three fields in a
353 curl -F "file=@cooltext.txt" -F "yourname=Daniel"
354 -F "filedescription=Cool text file with cool text inside"
361 curl -F "pictures=@dog.gif,cat.gif" $URL
365 curl -F "docpicture=@dog.gif" -F "catpicture=@cat.gif" $URL
368 an embedded `;type=`, use `--form-string` instead of `-F`. This is recommended
370 source. Under these circumstances, using `-F` instead of `--form-string` could
381 curl -e www.coolsite.com http://www.showme.com/
392 curl -A 'Mozilla/3.0 (Win95; I)' http://www.nationsbank.com/
396 - `Mozilla/3.0 (Win95; I)` - Netscape Version 3 for Windows 95
397 - `Mozilla/3.04 (Win95; U)` - Netscape Version 3 for Windows 95
398 - `Mozilla/2.02 (OS/2; U)` - Netscape Version 2 for OS/2
399 - `Mozilla/4.04 [en] (X11; U; AIX 4.2; Nav)` - Netscape for AIX
400 - `Mozilla/4.05 [en] (X11; U; Linux 2.0.32 i586)` - Netscape for Linux
404 - `Mozilla/4.0 (compatible; MSIE 4.01; Windows 95)` - MSIE for W95
406 Mozilla is not the only possible User-Agent name:
408 - `Konqueror/1.0` - KDE File Manager desktop client
409 - `Lynx/2.7.1 libwww-FM/2.14` - Lynx command line browser
415 headers that looks like `Set-Cookie: <data>` where the data part then
425 Set-Cookie: sessionid=boo123; path="/foo";
433 curl -b "name=Daniel" www.sillypage.com
439 curl --dump-header headers www.example.com
444 curl -b headers www.example.com
447 however error-prone and not the preferred way to do this. Instead, make curl
448 save the incoming cookies using the well-known netscape cookie format like
451 curl -c cookies.txt www.example.com
453 Note that by specifying `-b` you enable the "cookie awareness" and with `-L`
456 non-existing file to trigger the cookie awareness like:
458 curl -L -b empty.txt www.example.com
467 To read and write cookies from a netscape cookie file, you can set both `-b`
468 and `-c` to use the same file:
470 curl -b cookies.txt -c cookies.txt www.example.com
481 From left-to-right:
483 - % - percentage completed of the whole transfer
484 - Total - total size of the whole expected transfer
485 - % - percentage completed of the download
486 - Received - currently downloaded amount of bytes
487 - % - percentage completed of the upload
488 - Xferd - currently uploaded amount of bytes
489 - Average Speed Dload - the average transfer speed of the download
490 - Average Speed Upload - the average transfer speed of the upload
491 - Time Total - expected time to complete the operation
492 - Time Current - time passed since the invoke
493 - Time Left - expected time left to completion
494 - Curr.Speed - the average transfer speed the last 5 seconds (the first
497 The `-#` option will display a totally different progress bar that doesn't
503 let the transfer keep going. By using the switch `-y` and `-Y` you can make
507 To have curl abort the download if the speed is slower than 3000 bytes per
510 curl -Y 3000 -y 60 www.far-away-site.com
515 curl -m 1800 -Y 3000 -y 60 www.far-away-site.com
524 curl --limit-rate 10K www.far-away-site.com
528 curl --limit-rate 10240 www.far-away-site.com
532 curl -T upload --limit-rate 1M ftp://uploadshereplease.com
534 When using the `--limit-rate` option, the transfer rate is regulated on a
535 per-second basis, which will cause the total transfer speed to become lower
548 line is a `#`-symbol the rest of the line is treated as a comment.
559 -m 1800
566 Prevent curl from reading the default file by using -q as the first command
569 curl -q www.thatsite.com
572 URL by making a config file similar to:
574 # default url to get
575 url = "http://help.with.curl.com/curlhelp.html"
577 You can specify another config file to be read by using the `-K`/`--config`
578 flag. If you set config file name to `-` it'll read the config from stdin,
582 echo "user = user:passwd" | curl -K - http://that.secret.site.com
588 this by using the `-H` flag.
590 Example, send the header `X-you-and-me: yes` to the server when getting a
593 curl -H "X-you-and-me: yes" www.love.com
596 header than it normally does. The `-H` header you specify then replaces the
601 curl -H "Host:" www.server.com
605 Do note that when getting files with a `ftp://` URL, the given path is
624 curl -u $USER sftp://home.example.com/~/.bashrc
637 curl ftp.download.com
645 The `-P` flag to curl supports a few different options. Your machine may have
646 several IP-addresses and/or network interfaces and curl allows you to select
649 curl -P - ftp.download.com
651 Download with `PORT` but use the IP address of our `le0` interface (this does
654 curl -P le0 ftp.download.com
656 Download with `PORT` but use 192.168.0.10 as our IP address to use:
658 curl -P 192.168.0.10 ftp.download.com
664 curl --interface eth0:1 http://www.example.com/
668 curl --interface 192.168.1.10 http://www.example.com/
678 curl https://www.secure-site.com
682 needs to be in PEM-format. PEM is a standard and open format to store
685 you may need to download/compile a converter that can convert your browser's
691 curl -E /path/to/cert.pem:password https://secure.site.com/
698 specify what SSL-version curl should use. Use -3, -2 or -1 to specify that
701 curl -2 https://secure.site.com/
712 curl -C - -o file ftp://ftp.server.com/path/file
716 curl -C - -T file ftp://ftp.server.com/path/file
720 curl -C - -o file http://www.server.com/
725 It is `If-Modified-Since` or `If-Unmodified-Since`. curl allows you to specify
726 them with the `-z`/`--time-cond` flag.
728 For example, you can easily make a download that only gets performed if the
731 curl -z local.html http://remote.server.com/remote.html
733 Or you can download a file only if the local file is newer than the remote
734 one. Do this by prepending the date string with a `-`, as in:
736 curl -z -local.html http://remote.server.com/remote.html
738 You can specify a "free text" date as condition. Tell curl to only download
741 curl -z "Jan 12 2012" http://remote.server.com/remote.html
744 check the other way around by prepending it with a dash (`-`).
759 Commands that break the URL description of the RFC (but not the DICT
778 might be: [RFC 2255, The LDAP URL
782 server that has a certain sub-domain in their email address:
784 curl -B "ldap://ldap.frontec.se/o=frontec??sub?mail=*sth.frontec.se"
786 If I want the same info in HTML format, I can get it by not using the `-B`
791 curl -u user:passwd "ldap://ldap.frontec.se/o=frontec??sub?mail=*"
796 `--basic`, `--ntlm` or `--digest` option in curl command line
798 curl --ntlm "ldap://user:passwd@ldap.frontec.se/o=frontec??sub?mail=*"
800 On Windows, if no user/password specified, auto-negotiation mechanism will be
809 They should be set for protocol-specific proxies. General proxy should be set
814 A comma-separated list of host names that shouldn't go through any proxy is
827 The usage of the `-x`/`--proxy` flag overrides the environment variables.
838 Curl supports `.netrc` files if told to (using the `-n`/`--netrc` and
839 `--netrc-optional` options). This is not restricted to just FTP, so curl can
849 the `-w`/`--write-out` option was introduced. Using this, you can specify what
855 curl -w 'We downloaded %{size_download} bytes\n' www.download.com
862 First, get the krb-ticket the normal way, like with the kinit/kauth tool.
865 curl --krb private ftp://krb4site.com -u username:fakepwd
867 There's no use for a password on the `-u` switch, but a blank one will make
879 stdout or to the file you specify with `-o`.
881 You might want the `-N`/`--no-buffer` option to switch off the buffered output
884 Pass options to the telnet protocol negotiation, by using the `-t` option. To
887 curl -tTTYPE=vt100 telnet://remote.server.com
889 Other interesting options for it `-t` include:
891 - `XDISPLOC=<X display>` Sets the X display location.
892 - `NEW_ENV=<var,val>` Sets an environment variable.
918 As is mentioned above, you can download multiple files with one command line
921 URL you specify. Note that this also goes for the `-O` option (but not
922 `--remote-name-all`).
924 For example: get two files and use `-O` for the first and a custom file
927 curl -O http://url.com/file.txt ftp://ftp.com/moo.exe -o moo.jpg
931 curl -T local1 ftp://ftp.com/moo.exe -T local2 ftp://ftp.com/moo2.txt
936 address and fall back to IPv4 if the connection fails. The `--ipv4` and
937 `--ipv6` options can specify which address to use when both are
943 When this style is used, the `-g` option must be given to stop curl from
947 network interface on Linux and the percent character must be URL escaped. The
948 previous example in an SFTP URL might look like:
952 IPv6 addresses provided other than in URLs (e.g. to the `--proxy`,
953 `--interface` or `--ftp-port` options) should not be URL encoded.
966 ### curl-users
972 ### curl-library
976 ### curl-announce
978 Low-traffic. Only receives announcements of new public versions. At worst,
982 ### curl-and-php
987 ### curl-and-python