diff options
Diffstat (limited to 'docs/curl.1')
| -rw-r--r-- | docs/curl.1 | 60 |
1 files changed, 43 insertions, 17 deletions
diff --git a/docs/curl.1 b/docs/curl.1 index f2ce1425..9dfdaf7d 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. +.\" * Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -22,13 +22,12 @@ .\" .\" DO NOT EDIT. Generated by the curl project gen.pl man page generator. .\" -.TH curl 1 "November 16, 2016" "Curl 7.59.0" "Curl Manual" +.TH curl 1 "November 16, 2016" "Curl 7.60.0" "Curl Manual" .SH NAME curl \- transfer a URL .SH SYNOPSIS -.B curl [options] -.I [URL...] +.B curl [options / URLs] .SH DESCRIPTION .B curl is a tool to transfer data from or to a server, using one of the supported @@ -66,7 +65,8 @@ other: http://example.com/archive[1996-1999]/vol[1-4]/part{a,b,c}.html You can specify any amount of URLs on the command line. They will be fetched -in a sequential manner in the specified order. +in a sequential manner in the specified order. You can specify command line +options and URLs mixed and in any order on the command line. You can specify a step counter for the ranges to get every Nth number or letter: @@ -197,6 +197,11 @@ should not be set. If the option is not set, then curl will use the certificates in the system and user Keychain to verify the peer, which is the preferred method of verifying the peer's certificate chain. +(Schannel/WinSSL only) This option is supported for WinSSL in Windows 7 or +later with libcurl 7.60 or later. This option is supported for backward +compatibility with other SSL engines; instead it is recommended to use Windows' +store of root certificates (the default for WinSSL). + If this option is used several times, the last one will be used. .IP "--capath <dir>" (TLS) Tells curl to use the specified certificate directory to verify the @@ -252,6 +257,17 @@ system or user keychain, or the path to a PKCS#12-encoded certificate and private key. If you want to use a file from the current directory, please precede it with "./" prefix, in order to avoid confusion with a nickname. +(Schannel/WinSSL only) Client certificates must be specified by a path +expression to a certificate store. (Loading PFX is not supported; you can +import it to a store first). You can use +"<store location>\\<store name>\\<thumbprint>" to refer to a certificate +in the system certificates store, for example, +"CurrentUser\\MY\\934a7ac6f8a5d579285a74fa61e19f23ddfe8d7a". Thumbprint is +usually a SHA-1 hex string which you can see in certificate details. Following +store locations are supported: CurrentUser, LocalMachine, CurrentService, +Services, CurrentUserGroupPolicy, LocalMachineGroupPolicy, +LocalMachineEnterprise. + If this option is used several times, the last one will be used. See also \fI--cert-type\fP and \fI--key\fP and \fI--key-type\fP. @@ -395,7 +411,8 @@ If no '=' symbol is used in the argument, it is instead treated as a filename to read previously stored cookie from. This option also activates the cookie engine which will make curl record incoming cookies, which may be handy if you're using this in combination with the \fI-L, --location\fP option or do multiple URL -transfers on the same invoke. +transfers on the same invoke. If the file name is exactly a minus ("-"), curl +will instead the contents from stdin. The file format of the file to read cookies from should be plain HTTP headers (Set-Cookie style) or the Netscape/Mozilla cookie file format. @@ -854,11 +871,11 @@ to setup an IP address and port for it to connect to. <address> should be one of: .RS .IP interface -i.e "eth0" to specify which interface's IP address you want to use (Unix only) +e.g. "eth0" to specify which interface's IP address you want to use (Unix only) .IP "IP address" -i.e "192.168.10.1" to specify the exact IP address +e.g. "192.168.10.1" to specify the exact IP address .IP "host name" -i.e "my.host.domain" to specify the machine +e.g. "my.host.domain" to specify the machine .IP "-" make curl pick the same IP address that is already used for the control connection @@ -941,6 +958,15 @@ balance human factors against network load." libcurl currently defaults to If this option is used several times, the last one will be used. Added in 7.59.0. +.IP "--haproxy-protocol" +(HTTP) Send a HAProxy PROXY protocol header at the beginning of the connection. This +is used by some load balancers and reverse proxies to indicate the client's +true IP address and port. + +This option is primarily useful when sending test requests to a service that +expects this header. + +Added in 7.60.0. .IP "-I, --head" (HTTP FTP FILE) Fetch the headers only! HTTP-servers feature the command HEAD which this uses to get nothing but the header of a document. When used on an FTP or FILE file, @@ -1048,7 +1074,7 @@ name, IP address or host name. An example could look like: If this option is used several times, the last one will be used. On Linux it can be used to specify a VRF, but the binary needs to either -have CAP_NET_RAW or to be ran as root. More information about Linux VRF: +have CAP_NET_RAW or to be run as root. More information about Linux VRF: https://www.kernel.org/doc/Documentation/networking/vrf.txt See also \fI--dns-interface\fP. @@ -1237,7 +1263,7 @@ default, the limit is set to 50 redirections. Set this option to -1 to make it unlimited. If this option is used several times, the last one will be used. -.IP "-m, --max-time <time>" +.IP "-m, --max-time <seconds>" Maximum time in seconds that you allow the whole operation to take. This is useful for preventing your batch jobs from hanging for hours due to slow networks or links going down. Since 7.32.0, this option accepts decimal @@ -1841,7 +1867,7 @@ Specify the path name to file containing what will be considered as random data. The data may be used to seed the random engine for SSL connections. See also the \fI--egd-file\fP option. .IP "-r, --range <range>" -(HTTP FTP SFTP FILE) Retrieve a byte range (i.e a partial document) from a HTTP/1.1, FTP or SFTP +(HTTP FTP SFTP FILE) 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 @@ -2425,8 +2451,8 @@ for win32 systems. .IP "-A, --user-agent <name>" (HTTP) Specify the User-Agent string to send to the HTTP server. To encode blanks in -the string, surround the string with single quote marks. This can also be set -with the \fI-H, --header\fP option of course. +the string, surround the string with single quote marks. This header can also +be set with the \fI-H, --header\fP or the \fI--proxy-header\fP options. If this option is used several times, the last one will be used. .IP "-u, --user <user:password>" @@ -2696,7 +2722,7 @@ SMTP, LDAP etc. .IP "ALL_PROXY [protocol://]<host>[:port]" Sets the proxy server to use if no protocol-specific proxy is set. .IP "NO_PROXY <comma-separated list of hosts>" -list of host names that shouldn't go through any proxy. If set to a asterisk +list of host names that shouldn't go through any proxy. If set to an asterisk \&'*' only, it matches all hosts. This environment variable disables use of the proxy even when specified with @@ -2720,9 +2746,9 @@ a supported one, the proxy will be treated as an HTTP proxy. The supported proxy protocol prefixes are as follows: .IP "http://" -Makes it use it as a HTTP proxy. The default if no scheme prefix is used. +Makes it use it as an HTTP proxy. The default if no scheme prefix is used. .IP "https://" -Makes it treated as a \fBHTTPS\fP proxy. +Makes it treated as an \fBHTTPS\fP proxy. .IP "socks4://" Makes it the equivalent of \fI--socks4\fP .IP "socks4a://" |