See-also: proxy-anyauth basic digest
Category: http proxy auth
Example: --anyauth --user me:pwd $URL
+Added: 7.10.6
---
Tells curl to figure out authentication method by itself, and use the most
secure one the remote site claims to support. This is done by first doing a
Protocols: FTP SFTP
Category: ftp sftp
Example: --upload-file local --append ftp://example.com/
+Added: 4.8
---
When used in an upload, this makes curl append to the target file instead of
overwriting it. If the remote file doesn't exist, it will be created. Note
Protocols: HTTP
Category: auth
Example: -u name:password --basic $URL
+Added: 7.10.6
---
Tells curl to use HTTP Basic authentication with the remote host. This is the
default and this option is usually pointless, unless you use it to override a
Protocols: TLS
Category: tls
Example: --cacert CA-file.txt $URL
+Added: 7.5
---
Tells curl to use the specified certificate file to verify the peer. The file
may contain multiple CA certificates. The certificate(s) must be in PEM
Protocols: TLS
Category: tls
Example: --capath /local/directory $URL
+Added: 7.9.8
---
Tells curl to use the specified certificate directory to verify the
peer. Multiple paths can be provided by separating them with ":" (e.g.
See-also: cert key key-type
Category: tls
Example: --cert-type PEM --cert file $URL
+Added: 7.9.3
---
Tells curl what type the provided client certificate is using. PEM, DER, ENG
and P12 are recognized types. If not specified, PEM is assumed.
See-also: cert-type key key-type
Category: tls
Example: --cert certfile --key keyfile $URL
+Added: 5.0
---
Tells curl to use the specified client certificate file when getting a file
with HTTPS, FTPS or another SSL-based protocol. The certificate must be in
Protocols: TLS
Category: tls
Example: --ciphers ECDHE-ECDSA-AES256-CCM8 $URL
+Added: 7.9
---
Specifies which ciphers to use in the connection. The list of ciphers must
specify valid ciphers. Read up on SSL cipher list details on this URL:
Protocols: HTTP
Category: http
Example: --compressed $URL
+Added: 7.10
---
Request a compressed response using one of the algorithms curl supports, and
automatically decompress the content. Headers are not modified.
Short: K
Category: curl
Example: --config file.txt $URL
+Added: 4.10
---
-
Specify a text file to read curl arguments from. The command line arguments
found in the text file will be used as if they were provided on the command
line.
Category: connection
Example: --connect-timeout 20 $URL
Example: --connect-timeout 3.14 $URL
+Added: 7.7
---
Maximum time in seconds that you allow curl's connection to take. This only
limits the connection phase, so if curl connects within the given period it
Category: connection
Example: -C - $URL
Example: -C 400 $URL
+Added: 4.8
---
Continue/Resume a previous file transfer at the given offset. The given offset
is the exact number of bytes that will be skipped, counting from the beginning
Category: http
Example: -c store-here.txt $URL
Example: -c store-here.txt -b read-these $URL
+Added: 7.9
---
Specify to which file you want curl to write all cookies after a completed
operation. Curl writes all cookies from its in-memory cookie storage to the
Category: http
Example: -b cookiefile $URL
Example: -b cookiefile -c cookiefile $URL
+Added: 4.9
---
Pass the data to the HTTP server in the Cookie header. It is supposedly
the data previously received from the server in a "Set-Cookie:" line. The
Help: Create necessary local directory hierarchy
Category: curl
Example: --create-dirs --output local/dir/file $URL
+Added: 7.10.3
---
When used in conjunction with the --output option, curl will create the
necessary local directory hierarchy as needed. This option creates the
Protocols: FTP SMTP
Category: ftp smtp
Example: --crlf -T file ftp://example.com/
+Added: 5.7
---
Convert LF to CRLF in upload. Useful for MVS (OS/390).
Protocols: HTTP
Category: http post upload
Example: --data-ascii @file $URL
+Added: 7.2
---
This is just an alias for --data.
Protocols: HTTP
Category: http post upload
Example: --data-binary @filename $URL
+Added: 7.2
---
This posts data exactly as specified with no extra processing whatsoever.
Example: -d "name=curl" $URL
Example: -d "name=curl" -d "tool=cmdline" $URL
Example: -d @filename $URL
+Added: 4.0
---
Sends the specified data in a POST request to the HTTP server, in the same way
that a browser does when a user has filled in an HTML form and presses the
Protocols: GSS/kerberos
Category: auth
Example: --delegation "none" $URL
+Added: 7.22.0
---
Set LEVEL to tell the server what it is allowed to delegate when it
comes to user credentials.
See-also: user proxy-digest anyauth
Category: proxy auth http
Example: -u name:password --digest $URL
+Added: 7.10.6
---
Enables HTTP Digest authentication. This is an authentication scheme that
prevents the password from being sent over the wire in clear text. Use this in
Protocols: FTP
Category: ftp
Example: --disable-eprt ftp://example.com/
+Added: 7.10.5
---
Tell curl to disable the use of the EPRT and LPRT commands when doing active
FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT
Protocols: FTP
Category: ftp
Example: --disable-epsv ftp://example.com/
+Added: 7.9.2
---
Tell curl to disable the use of the EPSV command when doing passive FTP
transfers. Curl will normally always first attempt to use EPSV before
Help: Disable .curlrc
Category: curl
Example: -q $URL
+Added: 5.0
---
If used as the first parameter on the command line, the *curlrc* config
file will not be read and used. See the --config for details on the default
See-also: output
Category: http ftp
Example: --dump-header store.txt $URL
+Added: 5.7
---
Write the received protocol headers to the specified file. If no headers are
received, the use of this option will create an empty file.
See-also: random-file
Category: tls
Example: --egd-file /random/here $URL
+Added: 7.7
---
Specify the path name to the Entropy Gathering Daemon socket. The socket is
used to seed the random engine for SSL connections.
Protocols: TLS
Category: tls
Example: --engine flavor $URL
+Added: 7.9.3
---
Select the OpenSSL crypto engine to use for cipher operations. Use --engine
list to print a list of build-time supported engines. Note that not all (and
See-also: fail-with-body
Category: important http
Example: --fail $URL
+Added: 4.0
---
Fail silently (no output at all) on server errors. This is mostly done to
enable scripts etc to better deal with failed attempts. In normal cases
See-also: form
Category: http upload
Example: --form-string "data" $URL
+Added: 7.13.2
---
Similar to --form except that the value string for the named parameter is used
literally. Leading \&'@' and \&'<' characters, and the \&';type=' string in
Mutexed: data head upload-file
Category: http upload
Example: --form "name=curl" --form "file=@loadthis" $URL
+Added: 5.0
---
For HTTP protocol family, this lets curl emulate a filled-in form in which a
user has pressed the submit button. This causes curl to POST data using the
See-also: create-dirs
Category: ftp sftp curl
Example: --ftp-create-dirs -T file ftp://example.com/remote/path/file
+Added: 7.10.7
---
When an FTP or SFTP URL/operation uses a path that doesn't currently exist on
the server, the standard behavior of curl is to fail. Using this option, curl
Example: -P - ftp:/example.com
Example: -P eth0 ftp:/example.com
Example: -P 192.168.0.2 ftp:/example.com
+Added: 4.0
---
Reverses the default initiator/listener roles when connecting with FTP. This
option makes curl use active mode. curl then tells the server to connect back
sub too_old {
my ($version)=@_;
+ my $a = 999999;
if($version =~ /^(\d+)\.(\d+)\.(\d+)/) {
- my $a = $1 * 1000 + $2 * 10 + $3;
- if($a < 7300) {
- # we consider everything before 7.30.0 to be too old to mention
- # specific changes for
- return 1;
- }
+ $a = $1 * 1000 + $2 * 10 + $3;
+ }
+ elsif($version =~ /^(\d+)\.(\d+)/) {
+ $a = $1 * 1000 + $2 * 10;
+ }
+ if($a < 7300) {
+ # we consider everything before 7.30.0 to be too old to mention
+ # specific changes for
+ return 1;
}
return 0;
}
print STDERR "$f:$line:1:ERROR: no 'Example:' present\n";
exit 2;
}
+ if(!$added) {
+ print STDERR "$f:$line:1:ERROR: no 'Added:' version present\n";
+ exit 2;
+ }
last;
}
else {
Example: --get $URL
Example: --get -d "tool=curl" -d "age=old" $URL
Example: --get -I -d "tool=curl" $URL
+Added: 7.8.1
---
When used, this option will make all data specified with --data, --data-binary
or --data-urlencode to be used in an HTTP GET request instead of the POST
Help: Disable URL sequences and ranges using {} and []
Category: curl
Example: -g "https://example.com/{[]}}}}"
+Added: 7.6
---
This option switches off the "URL globbing parser". When you set this option,
you can specify URLs that contain the letters {}[] without having curl itself
Protocols: HTTP FTP FILE
Category: http ftp file
Example: -I $URL
+Added: 4.0
---
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,
Example: -H "X-First-Name: Joe" $URL
Example: -H "User-Agent: yes-please/2000" $URL
Example: -H "Host:" $URL
+Added: 5.0
---
Extra header to include in the request when sending HTTP to a server. You may
specify any number of extra headers. Note that if you should add a custom
Help: Get help for commands
Category: important curl
Example: --help all
+Added: 4.0
---
Usage help. This lists all commands of the <category>.
If no arg was provided, curl will display the most important
Long: http0.9
Tags: Versions
Protocols: HTTP
-Added:
Help: Allow HTTP 0.9 responses
Category: http
Example: --http0.9 $URL
+Added: 7.64.0
---
Tells curl to be fine with HTTP version 0.9 response.
Long: http1.0
Tags: Versions
Protocols: HTTP
-Added:
+Added: 7.9.1
Mutexed: http1.1 http2
Help: Use HTTP 1.0
Category: http
Protocols: FTP HTTP
Category: http ftp
Example: --ignore-content-length $URL
+Added: 7.14.1
---
For HTTP, Ignore the Content-Length header. This is particularly useful for
servers running Apache 1.x, which will report incorrect Content-Length for
See-also: verbose
Category: important verbose
Example: -i $URL
+Added: 4.8
---
Include the HTTP response headers in the output. The HTTP response headers can
include things like server name, cookies, date of the document, HTTP version
See-also: proxy-insecure cacert
Category: tls
Example: --insecure $URL
+Added: 7.10
---
By default, every SSL connection curl makes is verified to be secure. This
option allows curl to proceed and operate even for server connections
See-also: dns-interface
Category: connection
Example: --interface eth0 $URL
+Added: 7.3
---
-
Perform an operation using a specified interface. You can enter interface
name, IP address or host name. An example could look like:
Long: ipv4
Tags: Versions
Protocols:
-Added:
+Added: 7.10.8
Mutexed: ipv6
Requires:
See-also: http1.1 http2
Long: ipv6
Tags: Versions
Protocols:
-Added:
+Added: 7.10.8
Mutexed: ipv4
Requires:
See-also: http1.1 http2
See-also: cookie cookie-jar
Category: http
Example: --junk-session-cookies -b cookies.txt $URL
+Added: 7.9.7
---
When curl is told to read cookies from a given file, this option will make it
discard all "session cookies". This will basically have the same effect as if
Protocols: TLS
Category: tls
Example: --key-type DER --key here $URL
+Added: 7.9.3
---
Private key file type. Specify which type your --key provided private key
is. DER, PEM, and ENG are supported. If not specified, PEM is assumed.
Help: Private key file name
Category: tls ssh
Example: --cert certificate --key here $URL
+Added: 7.9.3
---
Private key file name. Allows you to provide your private key in this separate
file. For SSH, if not specified, curl tries the following candidates in order:
Requires: Kerberos
Category: ftp
Example: --krb clear ftp://example.com/
+Added: 7.3
---
Enable Kerberos authentication and use. The level must be entered and should
be one of 'clear', 'safe', 'confidential', or 'private'. Should you use a
Example: --limit-rate 100K $URL
Example: --limit-rate 1000 $URL
Example: --limit-rate 10M $URL
+Added: 7.10
---
Specify the maximum transfer rate you want curl to use - for both downloads
and uploads. This feature is useful if you have a limited pipe and you'd like
See-also: user
Category: http auth
Example: --location-trusted -u user:password $URL
+Added: 7.10.4
---
Like --location, but will allow sending the name + password to all hosts that
the site may redirect to. This may or may not introduce a security breach if
Protocols: HTTP
Category: http
Example: -L $URL
+Added: 4.9
---
If the server reports that the requested page has moved to a different
location (indicated with a Location: header and a 3XX response code), this
Help: Display the full manual
Category: curl
Example: --manual
+Added: 5.2
---
Manual. Display the huge help text.
See-also: limit-rate
Category: connection
Example: --max-filesize 100K $URL
+Added: 7.10.8
---
Specify the maximum size (in bytes) of a file to download. If the file
requested is larger than this value, the transfer will not start and curl will
Protocols: HTTP
Category: http
Example: --max-redirs 3 --location $URL
+Added: 7.5
---
Set maximum number of redirections to follow. When --location is used, to
prevent curl from following too many redirects, by default, the limit is
Category: connection
Example: --max-time 10 $URL
Example: --max-time 2.92 $URL
+Added: 4.0
---
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
See-also: basic ntlm anyauth proxy-negotiate
Category: auth http
Example: --negotiate -u : $URL
+Added: 7.10.6
---
Enables Negotiate (SPNEGO) authentication.
See-also: netrc-file
Category: curl
Example: --netrc-optional $URL
+Added: 7.9.8
---
Very similar to --netrc, but this option makes the .netrc usage **optional**
and not mandatory as the --netrc option does.
Help: Must read .netrc for user name and password
Category: curl
Example: --netrc $URL
+Added: 4.6
---
Makes curl scan the *.netrc* (*_netrc* on Windows) file in the user's home
directory for login name and password. This is typically used for FTP on
Help: Disable buffering of the output stream
Category: curl
Example: --no-buffer $URL
+Added: 6.5
---
Disables the buffering of the output stream. In normal work situations, curl
will use a standard buffered output stream that will have the effect that it
Help: Disable TCP keepalive on the connection
Category: connection
Example: --no-keepalive $URL
+Added: 7.18.0
---
Disables the use of keepalive messages on the TCP connection. curl otherwise
enables them by default.
See-also: ntlm proxy-ntlm
Category: auth http
Example: --ntlm-wb -u user:password $URL
+Added: 7.22.0
---
Enables NTLM much in the style --ntlm does, but hand over the authentication
to the separate binary ntlmauth application that is executed when needed.
Requires: TLS
Category: auth http
Example: --ntlm -u user:password $URL
+Added: 7.10.6
---
Enables NTLM authentication. The NTLM authentication method was designed by
Microsoft and is used by IIS web servers. It is a proprietary protocol,
Protocols: IMAP POP3 SMTP HTTP
Category: auth
Example: --oauth2-bearer "mF_9.B5f-4.1JqM" $URL
+Added: 7.33.0
---
Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token
is used in conjunction with the user name which can be specified as part of
Example: "http://{one,two}.example.com" -o "file_#1.txt"
Example: "http://{site,host}.host[1-5].com" -o "#1_#2"
Example: -o file $URL -o file2 https://example.net
+Added: 4.0
---
Write output to <file> instead of stdout. If you are using {} or [] to fetch
multiple documents, you should quote the URL and you can use '#' followed by a
Protocols: SSH TLS
Category: ssh tls auth
Example: --pass secret --key file $URL
+Added: 7.9.3
---
Passphrase for the private key.
Category: tls
Example: --pinnedpubkey keyfile $URL
Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+Added: 7.39.0
---
Tells curl to use the specified public key file (or hashes) to verify the
peer. This can be a path to a file which contains a single public key in PEM
Help: Display transfer progress as a bar
Category: verbose
Example: -# -O $URL
+Added: 5.10
---
Make curl display transfer progress as a simple progress bar instead of the
standard, more informational, meter.
See-also: proxy proxy-anyauth proxy-digest
Category: proxy auth
Example: --proxy-basic --proxy-user user:passwd -x proxy $URL
+Added: 7.12.0
---
Tells curl to use HTTP Basic authentication when communicating with the given
proxy. Use --basic for enabling HTTP Basic with a remote host. Basic is the
See-also: proxy proxy-anyauth proxy-basic
Category: proxy tls
Example: --proxy-digest --proxy-user user:passwd -x proxy $URL
+Added: 7.12.0
---
Tells curl to use HTTP Digest authentication when communicating with the given
proxy. Use --digest for enabling HTTP Digest with a remote host.
Arg: <key>
Category: proxy tls
Example: --proxy-key here -x https://proxy $URL
+Added: 7.52.0
---
Same as --key but used in HTTPS proxy context.
See-also: proxy-negotiate proxy-anyauth
Category: proxy auth
Example: --proxy-ntlm --proxy-user user:passwd -x http://proxy $URL
+Added: 7.10.7
---
Tells curl to use HTTP NTLM authentication when communicating with the given
proxy. Use --ntlm for enabling NTLM with a remote host.
Category: proxy tls
Example: --proxy-pinnedpubkey keyfile $URL
Example: --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+Added: 7.59.0
---
Tells curl to use the specified public key file (or hashes) to verify the
proxy. This can be a path to a file which contains a single public key in PEM
Protocols: TLS
Category: proxy tls
Example: --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy $URL
+Added: 7.61.0
---
Specifies which cipher suites to use in the connection to your HTTPS proxy
when it negotiates TLS 1.3. The list of ciphers suites must specify valid
Help: Proxy user and password
Category: proxy auth
Example: --proxy-user name:pwd -x proxy $URL
+Added: 4.0
---
Specify the user name and password to use for proxy authentication.
Help: Use this proxy
Category: proxy
Example: --proxy http://proxy.example $URL
+Added: 4.0
---
Use the specified proxy.
Help: Use HTTP/1.0 proxy on given port
Category: proxy
Example: --proxy1.0 -x http://proxy $URL
+Added: 7.19.4
---
Use the specified HTTP 1.0 proxy. If the port number is not specified, it is
assumed at port 1080.
See-also: proxy
Category: proxy
Example: --proxytunnel -x http://proxy $URL
+Added: 7.3
---
When an HTTP proxy is used --proxy, this option will make curl tunnel through
the proxy. The tunnel approach is made with the HTTP proxy CONNECT request and
Help: SSH Public key file name
Category: sftp scp auth
Example: --pubkey file.pub sftp://example.com/
+Added: 7.16.2
---
Public key file name. Allows you to provide your public key in this separate
file.
Protocols: FTP SFTP
Category: ftp sftp
Example: --quote "DELE file" ftp://example.com/foo
+Added: 5.3
---
Send an arbitrary command to the remote FTP or SFTP server. Quote commands are
sent BEFORE the transfer takes place (just after the initial PWD command in an
Help: File for reading random data from
Category: misc
Example: --random-file rubbish $URL
+Added: 7.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
Protocols: HTTP FTP SFTP FILE
Category: http ftp sftp file
Example: --range 22-44 $URL
+Added: 4.0
---
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.
Example: --referer "https://fake.example" $URL
Example: --referer "https://fake.example;auto" -L $URL
Example: --referer ";auto" -L $URL
+Added: 4.0
---
Sends the "Referrer Page" information to the HTTP server. This can also be set
with the --header flag of course. When used with --location you can append
Help: Use the header-provided filename
Category: output
Example: -OJ https://example.com/file
+Added: 7.20.0
---
This option tells the --remote-name option to use the server-specified
Content-Disposition filename instead of extracting a filename from the URL.
Help: Write output to a file named as the remote file
Category: important output
Example: -O https://example.com/filename
+Added: 4.0
---
Write output to a local file named like the remote file we get. (Only the file
part of the remote file is used, the path is cut off.)
Help: Set the remote file's time on the local output
Category: output
Example: --remote-time -o foo $URL
+Added: 7.9
---
When used, this will make curl attempt to figure out the timestamp of the
remote file, and if that is available make the local file get that same
Category: connection
Example: -X "DELETE" $URL
Example: -X NLST ftp://example.com/
+Added: 6.0
---
(HTTP) Specifies a custom request method to use when communicating with the
HTTP server. The specified request method will be used instead of the method
See-also: no-progress-meter
Category: curl
Example: --show-error --silent $URL
+Added: 5.9
---
When used with --silent, it makes curl show an error message if it fails.
See-also: verbose stderr no-progress-meter
Category: important verbose
Example: -s $URL
+Added: 4.0
---
Silent or quiet mode. Don't show progress meter or error messages. Makes Curl
mute. It will still output the data you ask for, potentially even to the
Help: Stop transfers slower than this
Category: connection
Example: --speed-limit 300 --speed-time 10 $URL
+Added: 4.7
---
If a download is slower than this given speed (in bytes per second) for
speed-time seconds it gets aborted. speed-time is set with --speed-time and is
Help: Trigger 'speed-limit' abort after this time
Category: connection
Example: --speed-limit 300 --speed-time 10 $URL
+Added: 4.7
---
If a download is slower than speed-limit bytes per second during a speed-time
period, the download gets aborted. If speed-time is used, the default
Long: sslv2
Tags: Versions
Protocols: SSL
-Added:
+Added: 5.9
Mutexed: sslv3 tlsv1 tlsv1.1 tlsv1.2
Requires: TLS
See-also: http1.1 http2
Long: sslv3
Tags: Versions
Protocols: SSL
-Added:
+Added: 5.9
Mutexed: sslv2 tlsv1 tlsv1.1 tlsv1.2
Requires: TLS
See-also: http1.1 http2
See-also: verbose silent
Category: verbose
Example: --stderr output.txt $URL
+Added: 6.2
---
Redirect all writes to stderr to the specified file instead. If the file name
is a plain '-', it is instead written to stdout.
See-also: dump-header include proxytunnel
Category: proxy
Example: --suppress-connect-headers --include -x proxy $URL
+Added: 7.54.0
---
When --proxytunnel is used and a CONNECT request is made don't output proxy
CONNECT response headers. This option is meant to be used with --dump-header or
Help: Set telnet option
Category: telnet
Example: -t TTYPE=vt100 telnet://example.com/
+Added: 7.7
---
Pass options to the telnet protocol. Supported options are:
Example: -z "Wed 01 Sep 2021 12:18:00" $URL
Example: -z "-Wed 01 Sep 2021 12:18:00" $URL
Example: -z file $URL
+Added: 5.8
---
Request a file that has been modified later than the given time and date, or
one that has been modified before that time. The <date expression> can be all
Protocols: TLS
Category: tls
Example: --tls13-ciphers TLS_AES_128_GCM_SHA256 $URL
+Added: 7.61.0
---
Specifies which cipher suites to use in the connection if it negotiates TLS
1.3. The list of ciphers suites must specify valid ciphers. Read up on TLS 1.3
Long: tlsv1
Tags: Versions
Protocols: SSL
-Added:
+Added: 7.9.2
Mutexed: tlsv1.1 tlsv1.2 tlsv1.3
Requires: TLS
See-also: http1.1 http2
Mutexed: trace verbose
Category: verbose
Example: --trace-ascii log.txt $URL
+Added: 7.9.7
---
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
Mutexed: verbose trace-ascii
Category: verbose
Example: --trace log.txt $URL
+Added: 7.9.7
---
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
Example: -T file $URL
Example: -T "img[1-1000].png" ftp://ftp.example.com/
Example: --upload-file "{file1,file2}" $URL
+Added: 4.0
---
This transfers the specified local file to the remote URL. If there is no file
part in the specified URL, curl will append the local file name. NOTE that you
Help: URL to work with
Category: curl
Example: --url $URL
+Added: 7.5
---
Specify a URL to fetch. This option is mostly handy when you want to specify
URL(s) in a config file.
Protocols: FTP LDAP
Category: misc
Example: -B ftp://example.com/README
+Added: 5.0
---
Enable ASCII transfer. For FTP, this can also be enforced by using a URL that
ends with ";type=A". This option causes data sent to stdout to be in text mode
Protocols: HTTP
Category: important http
Example: -A "Agent 007" $URL
+Added: 4.5.1
---
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 header can also
Help: Server user and password
Category: important auth
Example: -u user:secret $URL
+Added: 4.0
---
Specify the user name and password to use for server authentication. Overrides
--netrc and --netrc-optional.
See-also: include
Category: important verbose
Example: --verbose $URL
+Added: 4.0
---
Makes curl verbose during the operation. Useful for debugging and seeing
what's going on "under the hood". A line starting with '>' means "header data"
Help: Show version number and quit
Category: important curl
Example: --version
+Added: 4.0
---
Displays information about curl and the libcurl version it uses.
Help: Use output FORMAT after completion
Category: verbose
Example: -w '%{http_code}\\n' $URL
+Added: 6.5
---
Make curl display information on stdout after a completed transfer. The format
is a string that may contain plain text mixed with any number of
Help: Store metadata in extended file attributes
Category: misc
Example: --xattr -o storage $URL
+Added: 7.21.3
---
When saving output to a file, this option tells curl to store certain file
metadata in extended file attributes. Currently, the URL is stored in the
projects / thirdparty / curl.git / commitdiff
