Lines Matching +full:windows +full:- +full:remote +full:- +full:only
1 <!--
4 SPDX-License-Identifier: curl
5 -->
11 Get the main page from a web-server:
45 curl --ftp-ssl ftp://files.are.example.com/secrets.txt
49 curl -u username sftp://example.com/etc/issue
52 password-protected) to authenticate:
54 curl -u username: --key ~/.ssh/id_rsa scp://example.com/~/file.txt
57 (password-protected) to authenticate:
59 curl -u username: --key ~/.ssh/id_rsa --pass private_key_password
68 curl -u "domain\username:passwd" smb://server.example.com/share/file.txt
74 curl -o thatpage.html http://www.example.com/
77 the remote document (if no filename part is specified in the URL, this fails):
79 curl -O http://www.example.com/index.html
81 Fetch two files and store them with their remote names:
83 curl -O www.haxx.se/index.html -O curl.se/download.html
93 or specify them with the `-u` flag like
95 curl -u name:passwd ftp://ftp.server.example:port/full/path/to/file
99 It is just like for FTP, but you may also want to specify and use SSL-specific
104 the `--ssl-reqd` option.
108 This is similar to FTP, but you can use the `--key` option to specify a
111 remote system; this password is specified using the `--pass` option.
114 matching public key file must be specified using the `--pubkey` option.
125 curl -u name:passwd http://http.server.example/full/path/to/file
131 using `--anyauth`.
136 `-u` style for user and password.
150 Get an ftp file using an HTTP proxy named my-proxy that uses port 888:
152 curl -x my-proxy:888 ftp://ftp.example.com/README
157 curl -u user:passwd -x my-proxy:888 http://www.example.com/
159 Some proxies require special authentication. Specify by using -U as above:
161 curl -U user:passwd -x my-proxy:888 http://www.example.com/
163 A comma-separated list of hosts and domains which do not use the proxy can be
166 curl --noproxy example.com -x my-proxy:888 http://www.example.com/
168 If the proxy is specified with `--proxy1.0` instead of `--proxy` or `-x`, then
171 curl also supports SOCKS4 and SOCKS5 proxies with `--socks4` and `--socks5`.
177 client's perspective, with special commands to select the remote FTP server.
178 curl supports the `-u`, `-Q` and `--ftp-account` options that can be used to
180 to a remote FTP server using a Blue Coat FTP proxy with the options:
182 curl -u "username@ftp.server.example Proxy-Username:Remote-Pass"
183 --ftp-account Proxy-Password --upload-file local-file
184 ftp://my-ftp.proxy.example:21/remote/upload/path/
187 transfers, and curl's `-v` option to see exactly what curl is sending.
191 Get a key file and add it with `apt-key` (when on a system that uses `apt` for
194 curl -L https://apt.example.org/llvm-snapshot.gpg.key | sudo apt-key add -
196 The '|' pipes the output to STDIN. `-` tells `apt-key` that the key file
201 HTTP 1.1 introduced byte-ranges. Using this, a client can request to get only
202 one or more sub-parts of a specified document. Curl supports this with the
203 `-r` flag.
207 curl -r 0-99 http://www.example.com/
211 curl -r -500 http://www.example.com/
213 Curl also supports simple ranges for FTP files as well. Then you can only
218 curl -r 0-99 ftp://www.example.com/README
226 curl -T - ftp://ftp.example.com/myfile
230 curl -T uploadfile -u user:passwd ftp://ftp.example.com/myfile
232 Upload a local file to the remote site, and use the local filename at the
233 remote site too:
235 curl -T uploadfile -u user:passwd ftp://ftp.example.com/
237 Upload a local file to get appended to the remote file:
239 curl -T localfile -a ftp://ftp.example.com/remotefile
241 Curl also supports ftp upload through a proxy, but only if the proxy is
245 curl --proxytunnel -x proxy:port -T localfile ftp.example.com
249 curl -T file.txt -u "domain\username:passwd"
256 curl -T - http://www.example.com/myfile
266 if you cannot understand the responses: use the `-v` flag to get verbose
268 let the user see all client-server interaction (but it does not show you the
271 curl -v ftp://ftp.example.com/
274 `--trace` or `--trace-ascii` options with a given filename to log to, like
277 curl --trace trace.txt www.haxx.se
284 a single file, you should use `-I`/`--head` option. It displays all available
288 For HTTP, you can get the header information (the same as `-I` would show)
289 shown before the data by using `-i`/`--include`. Curl understands the
290 `-D`/`--dump-header` option when getting files from both FTP and HTTP, and it
295 curl --dump-header headers.txt curl.se
303 It is easy to post data using curl. This is done using the `-d <data>` option.
308 curl -d "name=Rafael%20Sagula&phone=3320780" http://www.example.com/guest.cgi
310 Or automatically [URL encode the data](https://everything.curl.dev/http/post/url-encode).
312 curl --data-urlencode "name=Rafael Sagula&phone=3320780" http://www.example.com/guest.cgi
318 If there is a normal post, you use `-d` to post. `-d` takes a full post
346 curl -d "user=foobar&pass=12345&id=blablabla&ding=submit" http://example.com/post.cgi
348 While `-d` uses the application/x-www-form-urlencoded mime-type, generally
350 multipart/form-data type. This latter type supports things like file upload.
352 `-F` accepts parameters like `-F "name=contents"`. If you want the contents to
359 curl -F "coolfiles=@fil1.gif;type=image/gif,fil2.txt,fil3.html"
362 If the content-type is not specified, curl tries to guess from the file
363 extension (it only knows a few), or use the previously specified type (from an
365 default type `application/octet-stream`.
367 Emulate a fill-in form with `-F`. Let's say you fill in three fields in a
375 curl -F "file=@cooltext.txt" -F "yourname=Daniel"
376 -F "filedescription=Cool text file with cool text inside"
383 curl -F "pictures=@dog.gif,cat.gif" $URL
387 curl -F "docpicture=@dog.gif" -F "catpicture=@cat.gif" $URL
390 an embedded `;type=`, use `--form-string` instead of `-F`. This is recommended
392 source. Under these circumstances, using `-F` instead of `--form-string` could
403 curl -e www.example.org http://www.example.com/
409 is especially useful to fool or trick stupid servers or CGI scripts that only
414 curl -A 'Mozilla/3.0 (Win95; I)' http://www.bank.example.com/
418 - `Mozilla/3.0 (Win95; I)` - Netscape Version 3 for Windows 95
419 - `Mozilla/3.04 (Win95; U)` - Netscape Version 3 for Windows 95
420 - `Mozilla/2.02 (OS/2; U)` - Netscape Version 2 for OS/2
421 - `Mozilla/4.04 [en] (X11; U; AIX 4.2; Nav)` - Netscape for AIX
422 - `Mozilla/4.05 [en] (X11; U; Linux 2.0.32 i586)` - Netscape for Linux
426 - `Mozilla/4.0 (compatible; MSIE 4.01; Windows 95)` - MSIE for W95
428 Mozilla is not the only possible User-Agent name:
430 - `Konqueror/1.0` - KDE File Manager desktop client
431 - `Lynx/2.7.1 libwww-FM/2.14` - Lynx command line browser
437 headers that looks like `Set-Cookie: <data>` where the data part then
442 if it should be used on secure connections only (`secure`).
447 Set-Cookie: sessionid=boo123; path="/foo";
455 curl -b "name=Daniel" www.example.com
461 curl --dump-header headers www.example.com
466 curl -b headers.txt www.example.com
469 however error-prone and not the preferred way to do this. Instead, make curl
470 save the incoming cookies using the well-known Netscape cookie format like
473 curl -c cookies.txt www.example.com
475 Note that by specifying `-b` you enable the cookie engine and with `-L` you
478 non-existing file to trigger the cookie awareness like:
480 curl -L -b empty.txt www.example.com
489 To read and write cookies from a Netscape cookie file, you can set both `-b`
490 and `-c` to use the same file:
492 curl -b cookies.txt -c cookies.txt www.example.com
503 From left-to-right:
505 - `%` - percentage completed of the whole transfer
506 - `Total` - total size of the whole expected transfer
507 - `%` - percentage completed of the download
508 - `Received` - currently downloaded amount of bytes
509 - `%` - percentage completed of the upload
510 - `Xferd` - currently uploaded amount of bytes
511 - `Average Speed Dload` - the average transfer speed of the download
512 - `Average Speed Upload` - the average transfer speed of the upload
513 - `Time Total` - expected time to complete the operation
514 - `Time Current` - time passed since the invoke
515 - `Time Left` - expected time left to completion
516 - `Curr.Speed` - the average transfer speed the last 5 seconds (the first
519 The `-#` option displays a totally different progress bar that does not need
525 let the transfer keep going. By using the switch `-y` and `-Y` you can make
532 curl -Y 3000 -y 60 www.far-away.example.com
537 curl -m 1800 -Y 3000 -y 60 www.far-away.example.com
546 curl --limit-rate 10K www.far-away.example.com
550 curl --limit-rate 10240 www.far-away.example.com
554 curl -T upload --limit-rate 1M ftp://uploads.example.com
556 When using the `--limit-rate` option, the transfer rate is regulated on a
557 per-second basis, which causes the total transfer speed to become lower than
564 Microsoft Windows systems) from the user's home directory on startup.
570 line is a `#`-symbol the rest of the line is treated as a comment.
581 -m 1800
588 Prevent curl from reading the default file by using -q as the first command
591 curl -q www.example.org
599 You can specify another config file to be read by using the `-K`/`--config`
600 flag. If you set config filename to `-` it reads the config from stdin, which
604 echo "user = user:passwd" | curl -K - http://that.secret.example.com
609 own custom headers when getting a webpage. You can do this by using the `-H`
612 Example, send the header `X-you-and-me: yes` to the server when getting a
615 curl -H "X-you-and-me: yes" love.example.com
618 header than it normally does. The `-H` header you specify then replaces the
623 curl -H "Host:" server.example.com
643 server. To access a file relative to the remote user's home directory, prefix
646 curl -u $USER sftp://home.example.com/~/.bashrc
667 The `-P` flag to curl supports a few different options. Your machine may have
668 several IP-addresses and/or network interfaces and curl allows you to select
671 curl -P - ftp.example.com
674 not work on Windows):
676 curl -P le0 ftp.example.com
680 curl -P 192.168.0.10 ftp.example.com
686 curl --interface eth0:1 http://www.example.com/
690 curl --interface 192.168.1.10 http://www.example.com/
703 that require valid certificates. The only drawback is that the certificate
704 needs to be in PEM-format. PEM is a standard and open format to store
713 curl -E /path/to/cert.pem:password https://secure.example.com/
722 curl --tlv1.0 https://secure.example.com/
733 curl -C - -o file ftp://ftp.example.com/path/file
737 curl -C - -T file ftp://ftp.example.com/path/file
741 curl -C - -o file http://www.example.com/
746 It is `If-Modified-Since` or `If-Unmodified-Since`. curl allows you to specify
747 them with the `-z`/`--time-cond` flag.
749 For example, you can easily make a download that only gets performed if the
750 remote file is newer than a local copy. It would be made like:
752 curl -z local.html http://remote.example.com/remote.html
754 Or you can download a file only if the local file is newer than the remote
755 one. Do this by prepending the date string with a `-`, as in:
757 curl -z -local.html http://remote.example.com/remote.html
759 You can specify a plain text date as condition. Tell curl to only download the
762 curl -z "Jan 12 2012" http://remote.example.com/remote.html
765 other way around by prepending it with a dash (`-`).
791 offer `ldap://` support. On Windows, curl uses WinLDAP from Platform SDK by
805 curl -B "ldap://ldap.example.com/o=frontec??sub?mail=*sth.example.com"
809 curl -u user:passwd "ldap://ldap.example.com/o=frontec??sub?mail=*"
813 authentication. On Windows you can control this behavior by providing one of
814 `--basic`, `--ntlm` or `--digest` option in curl command line
816 curl --ntlm "ldap://user:passwd@ldap.example.com/o=frontec??sub?mail=*"
818 On Windows, if no user/password specified, auto-negotiation mechanism is used
827 They should be set for protocol-specific proxies. General proxy should be set
832 A comma-separated list of hostnames that should not go through any proxy is
833 set in (only an asterisk, `*` matches all hosts)
845 The usage of the `-x`/`--proxy` flag overrides the environment variables.
853 therefore most Unix programs do not read this file unless it is only readable
856 Curl supports `.netrc` files if told to (using the `-n`/`--netrc` and
857 `--netrc-optional` options). This is not restricted to just FTP, so curl can
867 the `-w`/`--write-out` option was introduced. Using this, you can specify what
873 curl -w 'We downloaded %{size_download} bytes\n' www.example.com
880 First, get the krb-ticket the normal way, like with the `kinit`/`kauth` tool.
883 curl --krb private ftp://krb4site.example.com -u username:fakepwd
885 There is no use for a password on the `-u` switch, but a blank one makes curl
891 to it on stdin to the remote server. Connect to a remote telnet server using a
894 curl telnet://remote.example.com
897 to the file you specify with `-o`.
899 You might want the `-N`/`--no-buffer` option to switch off the buffered output
902 Pass options to the telnet protocol negotiation, by using the `-t` option. To
905 curl -tTTYPE=vt100 telnet://remote.example.com
907 Other interesting options for it `-t` include:
909 - `XDISPLOC=<X display>` Sets the X display location.
910 - `NEW_ENV=<var,val>` Sets an environment variable.
939 URL you specify. Note that this also goes for the `-O` option (but not
940 `--remote-name-all`).
942 For example: get two files and use `-O` for the first and a custom file
945 curl -O http://example.com/file.txt ftp://example.com/moo.exe -o moo.jpg
949 curl -T local1 ftp://example.com/moo.exe -T local2 ftp://example.com/moo2.txt
954 and fall back to IPv4 if the connection fails. The `--ipv4` and `--ipv6`
960 When this style is used, the `-g` option must be given to stop curl from
969 IPv6 addresses provided other than in URLs (e.g. to the `--proxy`,
970 `--interface` or `--ftp-port` options) should not be URL encoded.
983 ### `curl-users`
989 ### `curl-library`
993 ### `curl-announce`
995 Low-traffic. Only receives announcements of new public versions. At worst,
996 that makes something like one or two mails per month, but usually only one
999 ### `curl-and-php`
1004 ### `curl-and-python`