diff --git a/docs/cmdline-opts/MANPAGE.md b/docs/cmdline-opts/MANPAGE.md index b903bc25e0..f7f09eb1d3 100644 --- a/docs/cmdline-opts/MANPAGE.md +++ b/docs/cmdline-opts/MANPAGE.md @@ -28,6 +28,7 @@ Each file has a set of meta-data and a body of text. Requires: (space separated list of features this requires, no dashes) See-also: (space separated list of related options, no dashes) Help: (short text for the --help output for this option) + Example: (example command line, without "curl" and can use `$URL`) --- (end of meta-data) ### Body diff --git a/docs/cmdline-opts/abstract-unix-socket.d b/docs/cmdline-opts/abstract-unix-socket.d index 8403cab9d1..e26048f1de 100644 --- a/docs/cmdline-opts/abstract-unix-socket.d +++ b/docs/cmdline-opts/abstract-unix-socket.d @@ -4,6 +4,7 @@ Help: Connect via abstract Unix domain socket Added: 7.53.0 Protocols: HTTP Category: connection +Example: --abstract-unix-socket socketpath $URL --- Connect through an abstract Unix domain socket, instead of using the network. Note: netstat shows the path of an abstract socket prefixed with '@', however diff --git a/docs/cmdline-opts/alt-svc.d b/docs/cmdline-opts/alt-svc.d index 5598b59b48..914b1fbc6b 100644 --- a/docs/cmdline-opts/alt-svc.d +++ b/docs/cmdline-opts/alt-svc.d @@ -4,9 +4,8 @@ Protocols: HTTPS Help: Enable alt-svc with this cache file Added: 7.64.1 Category: http +Example: --alt-svc svc.txt $URL --- -WARNING: this option is experimental. Do not use in production. - This option enables the alt-svc parser in curl. If the file name points to an existing alt-svc cache file, that will be used. After a completed transfer, the cache will be saved to the file name again if it has been modified. diff --git a/docs/cmdline-opts/anyauth.d b/docs/cmdline-opts/anyauth.d index bec0c0c861..427a64c89f 100644 --- a/docs/cmdline-opts/anyauth.d +++ b/docs/cmdline-opts/anyauth.d @@ -3,6 +3,7 @@ Help: Pick any authentication method Protocols: HTTP See-also: proxy-anyauth basic digest Category: http proxy auth +Example: --anyauth --user me:pwd $URL --- 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 diff --git a/docs/cmdline-opts/append.d b/docs/cmdline-opts/append.d index 8bdb2594d4..8afaf0eb61 100644 --- a/docs/cmdline-opts/append.d +++ b/docs/cmdline-opts/append.d @@ -3,6 +3,7 @@ Long: append Help: Append to target file when uploading Protocols: FTP SFTP Category: ftp sftp +Example: --upload-file local --append ftp://example.com/ --- 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 diff --git a/docs/cmdline-opts/aws-sigv4.d b/docs/cmdline-opts/aws-sigv4.d index 26546df3f6..db988640b4 100644 --- a/docs/cmdline-opts/aws-sigv4.d +++ b/docs/cmdline-opts/aws-sigv4.d @@ -3,6 +3,7 @@ Arg: Help: Use AWS V4 signature authentication Category: auth http Added: 7.75.0 +Example: --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" $URL --- Use AWS V4 signature authentication in the transfer. diff --git a/docs/cmdline-opts/basic.d b/docs/cmdline-opts/basic.d index e222c51c1c..62d2c22b0a 100644 --- a/docs/cmdline-opts/basic.d +++ b/docs/cmdline-opts/basic.d @@ -3,6 +3,7 @@ Help: Use HTTP Basic Authentication See-also: proxy-basic Protocols: HTTP Category: auth +Example: -u name:password --basic $URL --- 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 diff --git a/docs/cmdline-opts/cacert.d b/docs/cmdline-opts/cacert.d index 793d8c1ba1..1f38040461 100644 --- a/docs/cmdline-opts/cacert.d +++ b/docs/cmdline-opts/cacert.d @@ -3,6 +3,7 @@ Arg: Help: CA certificate to verify peer against Protocols: TLS Category: tls +Example: --cacert CA-file.txt $URL --- 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 @@ -26,9 +27,9 @@ 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 only) This option is supported for Schannel 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 Schannel). +(Schannel only) This option is supported for Schannel 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 Schannel). If this option is used several times, the last one will be used. diff --git a/docs/cmdline-opts/capath.d b/docs/cmdline-opts/capath.d index 4ce077a147..ba407ed0ce 100644 --- a/docs/cmdline-opts/capath.d +++ b/docs/cmdline-opts/capath.d @@ -3,6 +3,7 @@ Arg: Help: CA directory to verify peer against Protocols: TLS Category: tls +Example: --capath /local/directory $URL --- Tells curl to use the specified certificate directory to verify the peer. Multiple paths can be provided by separating them with ":" (e.g. diff --git a/docs/cmdline-opts/cert-status.d b/docs/cmdline-opts/cert-status.d index 63e3520510..360e5c9019 100644 --- a/docs/cmdline-opts/cert-status.d +++ b/docs/cmdline-opts/cert-status.d @@ -3,6 +3,7 @@ Protocols: TLS Added: 7.41.0 Help: Verify the status of the server cert via OCSP-staple Category: tls +Example: --cert-status $URL --- Tells curl to verify the status of the server certificate by using the Certificate Status Request (aka. OCSP stapling) TLS extension. diff --git a/docs/cmdline-opts/cert-type.d b/docs/cmdline-opts/cert-type.d index b041bcb065..9fcbfe752a 100644 --- a/docs/cmdline-opts/cert-type.d +++ b/docs/cmdline-opts/cert-type.d @@ -4,6 +4,7 @@ Arg: Help: Certificate type (DER/PEM/ENG) See-also: cert key key-type Category: tls +Example: --cert-type PEM --cert file $URL --- Tells curl what type the provided client certificate is using. PEM, DER, ENG and P12 are recognized types. If not specified, PEM is assumed. diff --git a/docs/cmdline-opts/cert.d b/docs/cmdline-opts/cert.d index 2938e571fb..8e0fb88e8e 100644 --- a/docs/cmdline-opts/cert.d +++ b/docs/cmdline-opts/cert.d @@ -5,6 +5,7 @@ Help: Client certificate file and password Protocols: TLS See-also: cert-type key key-type Category: tls +Example: --cert certfile --key keyfile $URL --- 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 diff --git a/docs/cmdline-opts/ciphers.d b/docs/cmdline-opts/ciphers.d index 723b959237..c2cb92e065 100644 --- a/docs/cmdline-opts/ciphers.d +++ b/docs/cmdline-opts/ciphers.d @@ -3,6 +3,7 @@ Arg: Help: SSL ciphers to use Protocols: TLS Category: tls +Example: --ciphers ECDHE-ECDSA-AES256-CCM8 $URL --- 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: diff --git a/docs/cmdline-opts/compressed-ssh.d b/docs/cmdline-opts/compressed-ssh.d index 849fe18b00..d95c6adfb0 100644 --- a/docs/cmdline-opts/compressed-ssh.d +++ b/docs/cmdline-opts/compressed-ssh.d @@ -3,6 +3,7 @@ Help: Enable SSH compression Protocols: SCP SFTP Added: 7.56.0 Category: scp ssh +Example: --compressed-ssh sftp://example.com/ --- Enables built-in SSH compression. This is a request, not an order; the server may or may not do it. diff --git a/docs/cmdline-opts/compressed.d b/docs/cmdline-opts/compressed.d index dedd0e9e2d..945beb85d9 100644 --- a/docs/cmdline-opts/compressed.d +++ b/docs/cmdline-opts/compressed.d @@ -2,6 +2,7 @@ Long: compressed Help: Request compressed response Protocols: HTTP Category: http +Example: --compressed $URL --- Request a compressed response using one of the algorithms curl supports, and automatically decompress the content. Headers are not modified. diff --git a/docs/cmdline-opts/config.d b/docs/cmdline-opts/config.d index 5a0ad1f474..1805926950 100644 --- a/docs/cmdline-opts/config.d +++ b/docs/cmdline-opts/config.d @@ -3,6 +3,7 @@ Arg: Help: Read config from a file Short: K Category: curl +Example: --config file.txt $URL --- Specify a text file to read curl arguments from. The command line arguments diff --git a/docs/cmdline-opts/connect-timeout.d b/docs/cmdline-opts/connect-timeout.d index fa3277221a..e66e35adfb 100644 --- a/docs/cmdline-opts/connect-timeout.d +++ b/docs/cmdline-opts/connect-timeout.d @@ -1,8 +1,10 @@ Long: connect-timeout -Arg: +Arg: Help: Maximum time allowed for connection See-also: max-time Category: connection +Example: --connect-timeout 20 $URL +Example: --connect-timeout 3.14 $URL --- 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 diff --git a/docs/cmdline-opts/connect-to.d b/docs/cmdline-opts/connect-to.d index 2f015f8ac4..ebea9b9dae 100644 --- a/docs/cmdline-opts/connect-to.d +++ b/docs/cmdline-opts/connect-to.d @@ -4,6 +4,7 @@ Help: Connect to host Added: 7.49.0 See-also: resolve header Category: connection +Example: --connect-to example.com:443:example.net:8443 $URL --- For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead. diff --git a/docs/cmdline-opts/continue-at.d b/docs/cmdline-opts/continue-at.d index c44d2f496f..9e11bdb123 100644 --- a/docs/cmdline-opts/continue-at.d +++ b/docs/cmdline-opts/continue-at.d @@ -4,6 +4,8 @@ Arg: Help: Resumed transfer offset See-also: range Category: connection +Example: -C - $URL +Example: -C 400 $URL --- 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 diff --git a/docs/cmdline-opts/cookie-jar.d b/docs/cmdline-opts/cookie-jar.d index f11991f4e9..f418af6d76 100644 --- a/docs/cmdline-opts/cookie-jar.d +++ b/docs/cmdline-opts/cookie-jar.d @@ -4,6 +4,8 @@ Arg: Protocols: HTTP Help: Write cookies to after operation Category: http +Example: -c store-here.txt $URL +Example: -c store-here.txt -b read-these $URL --- 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 diff --git a/docs/cmdline-opts/cookie.d b/docs/cmdline-opts/cookie.d index 5c40cf2d84..b593935eb7 100644 --- a/docs/cmdline-opts/cookie.d +++ b/docs/cmdline-opts/cookie.d @@ -4,6 +4,8 @@ Arg: Protocols: HTTP Help: Send cookies from string/file Category: http +Example: -b cookiefile $URL +Example: -b cookiefile -c cookiefile $URL --- 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 diff --git a/docs/cmdline-opts/create-dirs.d b/docs/cmdline-opts/create-dirs.d index 801e95d1ea..cae1d5a51c 100644 --- a/docs/cmdline-opts/create-dirs.d +++ b/docs/cmdline-opts/create-dirs.d @@ -1,6 +1,7 @@ Long: create-dirs Help: Create necessary local directory hierarchy Category: curl +Example: --create-dirs --output local/dir/file $URL --- When used in conjunction with the --output option, curl will create the necessary local directory hierarchy as needed. This option creates the diff --git a/docs/cmdline-opts/create-file-mode.d b/docs/cmdline-opts/create-file-mode.d index 275fc6c210..429b5ee33c 100644 --- a/docs/cmdline-opts/create-file-mode.d +++ b/docs/cmdline-opts/create-file-mode.d @@ -5,6 +5,7 @@ Protocols: SFTP SCP FILE Category: sftp scp file upload See-also: ftp-create-dirs Added: 7.75.0 +Example: --create-file-mode 0777 -T localfile sftp://example.com/new --- When curl is used to create files remotely using one of the supported protocols, this option allows the user to set which 'mode' to set on the file diff --git a/docs/cmdline-opts/crlf.d b/docs/cmdline-opts/crlf.d index 50c4bef81d..856cd135a5 100644 --- a/docs/cmdline-opts/crlf.d +++ b/docs/cmdline-opts/crlf.d @@ -2,6 +2,7 @@ Long: crlf Help: Convert LF to CRLF in upload Protocols: FTP SMTP Category: ftp smtp +Example: --crlf -T file ftp://example.com/ --- Convert LF to CRLF in upload. Useful for MVS (OS/390). diff --git a/docs/cmdline-opts/crlfile.d b/docs/cmdline-opts/crlfile.d index 360e668d1e..21e86a8c24 100644 --- a/docs/cmdline-opts/crlfile.d +++ b/docs/cmdline-opts/crlfile.d @@ -1,9 +1,10 @@ Long: crlfile Arg: Protocols: TLS -Help: Get a CRL list in PEM format from the given file +Help: Use this CRL list Added: 7.19.7 Category: tls +Example: --crlfile rejects.txt $URL --- Provide a file using PEM format with a Certificate Revocation List that may specify peer certificates that are to be considered revoked. diff --git a/docs/cmdline-opts/curves.d b/docs/cmdline-opts/curves.d index 47870a2789..ac5ab10169 100644 --- a/docs/cmdline-opts/curves.d +++ b/docs/cmdline-opts/curves.d @@ -4,6 +4,7 @@ Help: (EC) TLS key exchange algorithm(s) to request Protocols: TLS Added: 7.73.0 Category: tls +Example: --curves X25519 $URL --- Tells curl to request specific curves to use during SSL session establishment according to RFC 8422, 5.1. Multiple algorithms can be provided by separating diff --git a/docs/cmdline-opts/data-ascii.d b/docs/cmdline-opts/data-ascii.d index 3522f6345c..943f301dd1 100644 --- a/docs/cmdline-opts/data-ascii.d +++ b/docs/cmdline-opts/data-ascii.d @@ -3,5 +3,6 @@ Arg: Help: HTTP POST ASCII data Protocols: HTTP Category: http post upload +Example: --data-ascii @file $URL --- This is just an alias for --data. diff --git a/docs/cmdline-opts/data-binary.d b/docs/cmdline-opts/data-binary.d index c40785ece1..578cebca62 100644 --- a/docs/cmdline-opts/data-binary.d +++ b/docs/cmdline-opts/data-binary.d @@ -3,6 +3,7 @@ Arg: Help: HTTP POST binary data Protocols: HTTP Category: http post upload +Example: --data-binary @filename $URL --- This posts data exactly as specified with no extra processing whatsoever. diff --git a/docs/cmdline-opts/data-raw.d b/docs/cmdline-opts/data-raw.d index 4db83aefa0..b8cd0f7211 100644 --- a/docs/cmdline-opts/data-raw.d +++ b/docs/cmdline-opts/data-raw.d @@ -5,6 +5,8 @@ Help: HTTP POST data, '@' allowed Added: 7.43.0 See-also: data Category: http post upload +Example: --data-raw "hello" $URL +Example: --data-raw "@at@at@" $URL --- This posts data similarly to --data but without the special interpretation of the @ character. diff --git a/docs/cmdline-opts/data-urlencode.d b/docs/cmdline-opts/data-urlencode.d index 2205f9db48..8b12957543 100644 --- a/docs/cmdline-opts/data-urlencode.d +++ b/docs/cmdline-opts/data-urlencode.d @@ -5,6 +5,10 @@ Protocols: HTTP See-also: data data-raw Added: 7.18.0 Category: http post upload +Example: --data-urlencode name=val $URL +Example: --data-urlencode =encodethis $URL +Example: --data-urlencode name@file $URL +Example: --data-urlencode @fileonly $URL --- This posts data, similar to the other --data options with the exception that this performs URL-encoding. diff --git a/docs/cmdline-opts/data.d b/docs/cmdline-opts/data.d index 53ba86b36d..35fd675edb 100644 --- a/docs/cmdline-opts/data.d +++ b/docs/cmdline-opts/data.d @@ -6,6 +6,9 @@ Protocols: HTTP MQTT See-also: data-binary data-urlencode data-raw Mutexed: form head upload-file Category: important http post upload +Example: -d "name=curl" $URL +Example: -d "name=curl" -d "tool=cmdline" $URL +Example: -d @filename $URL --- 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 diff --git a/docs/cmdline-opts/delegation.d b/docs/cmdline-opts/delegation.d index 41fa9408c8..1514d66bc8 100644 --- a/docs/cmdline-opts/delegation.d +++ b/docs/cmdline-opts/delegation.d @@ -3,6 +3,7 @@ Arg: Help: GSS-API delegation permission Protocols: GSS/kerberos Category: auth +Example: --delegation "none" $URL --- Set LEVEL to tell the server what it is allowed to delegate when it comes to user credentials. diff --git a/docs/cmdline-opts/digest.d b/docs/cmdline-opts/digest.d index da8c01e265..193413777a 100644 --- a/docs/cmdline-opts/digest.d +++ b/docs/cmdline-opts/digest.d @@ -4,6 +4,7 @@ Protocols: HTTP Mutexed: basic ntlm negotiate See-also: user proxy-digest anyauth Category: proxy auth http +Example: -u name:password --digest $URL --- 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 diff --git a/docs/cmdline-opts/disable-eprt.d b/docs/cmdline-opts/disable-eprt.d index ffcf684e4a..38b3e0b381 100644 --- a/docs/cmdline-opts/disable-eprt.d +++ b/docs/cmdline-opts/disable-eprt.d @@ -2,6 +2,7 @@ Long: disable-eprt Help: Inhibit using EPRT or LPRT Protocols: FTP Category: ftp +Example: --disable-eprt ftp://example.com/ --- 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 diff --git a/docs/cmdline-opts/disable-epsv.d b/docs/cmdline-opts/disable-epsv.d index dadef098b1..281ec5c9d5 100644 --- a/docs/cmdline-opts/disable-epsv.d +++ b/docs/cmdline-opts/disable-epsv.d @@ -2,6 +2,7 @@ Long: disable-epsv Help: Inhibit using EPSV Protocols: FTP Category: ftp +Example: --disable-epsv ftp://example.com/ --- 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 diff --git a/docs/cmdline-opts/disable.d b/docs/cmdline-opts/disable.d index d909608844..3eb87f8d4d 100644 --- a/docs/cmdline-opts/disable.d +++ b/docs/cmdline-opts/disable.d @@ -2,6 +2,7 @@ Long: disable Short: q Help: Disable .curlrc Category: curl +Example: -q $URL --- 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 diff --git a/docs/cmdline-opts/disallow-username-in-url.d b/docs/cmdline-opts/disallow-username-in-url.d index e124f675a9..f3122aea56 100644 --- a/docs/cmdline-opts/disallow-username-in-url.d +++ b/docs/cmdline-opts/disallow-username-in-url.d @@ -4,5 +4,7 @@ Protocols: HTTP Added: 7.61.0 See-also: proto Category: curl http +Example: --disallow-username-in-url $URL --- -This tells curl to exit if passed a url containing a username. +This tells curl to exit if passed a url containing a username. This is probably +most useful when the URL is being provided at run-time or similar. diff --git a/docs/cmdline-opts/dns-interface.d b/docs/cmdline-opts/dns-interface.d index 3cb818ae3e..fec7927eb6 100644 --- a/docs/cmdline-opts/dns-interface.d +++ b/docs/cmdline-opts/dns-interface.d @@ -6,6 +6,7 @@ See-also: dns-ipv4-addr dns-ipv6-addr Added: 7.33.0 Requires: c-ares Category: dns +Example: --dns-interface eth0 $URL --- Tell curl to send outgoing DNS requests through . This option is a counterpart to --interface (which does not affect DNS). The supplied string diff --git a/docs/cmdline-opts/dns-ipv4-addr.d b/docs/cmdline-opts/dns-ipv4-addr.d index 0d7bae6f0e..e09153ab49 100644 --- a/docs/cmdline-opts/dns-ipv4-addr.d +++ b/docs/cmdline-opts/dns-ipv4-addr.d @@ -6,6 +6,7 @@ See-also: dns-interface dns-ipv6-addr Added: 7.33.0 Requires: c-ares Category: dns +Example: --dns-ipv4-addr 10.1.2.3 $URL --- Tell curl to bind to when making IPv4 DNS requests, so that the DNS requests originate from this address. The argument should be a diff --git a/docs/cmdline-opts/dns-ipv6-addr.d b/docs/cmdline-opts/dns-ipv6-addr.d index a964dbb061..954cb98b32 100644 --- a/docs/cmdline-opts/dns-ipv6-addr.d +++ b/docs/cmdline-opts/dns-ipv6-addr.d @@ -6,6 +6,7 @@ See-also: dns-interface dns-ipv4-addr Added: 7.33.0 Requires: c-ares Category: dns +Example: --dns-ipv6-addr 2a04:4e42::561 $URL --- Tell curl to bind to when making IPv6 DNS requests, so that the DNS requests originate from this address. The argument should be a diff --git a/docs/cmdline-opts/dns-servers.d b/docs/cmdline-opts/dns-servers.d index a0954b31f0..089473580f 100644 --- a/docs/cmdline-opts/dns-servers.d +++ b/docs/cmdline-opts/dns-servers.d @@ -4,6 +4,7 @@ Help: DNS server addrs to use Requires: c-ares Added: 7.33.0 Category: dns +Example: --dns-servers 192.168.0.1,192.168.0.2 $URL --- Set the list of DNS servers to be used instead of the system default. The list of IP addresses should be separated with commas. Port numbers diff --git a/docs/cmdline-opts/doh-cert-status.d b/docs/cmdline-opts/doh-cert-status.d index 1442fc8a96..a760a6fb1f 100644 --- a/docs/cmdline-opts/doh-cert-status.d +++ b/docs/cmdline-opts/doh-cert-status.d @@ -3,5 +3,6 @@ Help: Verify the status of the DoH server cert via OCSP-staple Protocols: all Added: 7.76.0 Category: dns tls +Example: --doh-cert-status --doh-url https://doh.example $URL --- Same as --cert-status but used for DoH (DNS-over-HTTPS). diff --git a/docs/cmdline-opts/doh-insecure.d b/docs/cmdline-opts/doh-insecure.d index fe399a2f9e..907a5dcd69 100644 --- a/docs/cmdline-opts/doh-insecure.d +++ b/docs/cmdline-opts/doh-insecure.d @@ -3,5 +3,6 @@ Help: Allow insecure DoH server connections Protocols: all Added: 7.76.0 Category: dns tls +Example: --doh-insecure --doh-url https://doh.example $URL --- Same as --insecure but used for DoH (DNS-over-HTTPS). diff --git a/docs/cmdline-opts/doh-url.d b/docs/cmdline-opts/doh-url.d index 612945afa5..80ff96ccc1 100644 --- a/docs/cmdline-opts/doh-url.d +++ b/docs/cmdline-opts/doh-url.d @@ -4,6 +4,7 @@ Help: Resolve host names over DoH Protocols: all Added: 7.62.0 Category: dns +Example: --doh-url https://doh.example $URL --- Specifies which DNS-over-HTTPS (DoH) server to use to resolve hostnames, instead of using the default name resolver mechanism. The URL must be HTTPS. diff --git a/docs/cmdline-opts/dump-header.d b/docs/cmdline-opts/dump-header.d index aa3bd9e33b..62c92f44bb 100644 --- a/docs/cmdline-opts/dump-header.d +++ b/docs/cmdline-opts/dump-header.d @@ -5,6 +5,7 @@ Help: Write the received headers to Protocols: HTTP FTP See-also: output Category: http ftp +Example: --dump-header store.txt $URL --- Write the received protocol headers to the specified file. If no headers are received, the use of this option will create an empty file. diff --git a/docs/cmdline-opts/egd-file.d b/docs/cmdline-opts/egd-file.d index 05ede9ad13..2e99df4cd1 100644 --- a/docs/cmdline-opts/egd-file.d +++ b/docs/cmdline-opts/egd-file.d @@ -4,6 +4,7 @@ Help: EGD socket path for random data Protocols: TLS See-also: random-file Category: tls +Example: --egd-file /random/here $URL --- Specify the path name to the Entropy Gathering Daemon socket. The socket is used to seed the random engine for SSL connections. diff --git a/docs/cmdline-opts/engine.d b/docs/cmdline-opts/engine.d index 034796c9a7..8a2dcf7463 100644 --- a/docs/cmdline-opts/engine.d +++ b/docs/cmdline-opts/engine.d @@ -3,6 +3,7 @@ Arg: Help: Crypto engine to use Protocols: TLS Category: tls +Example: --engine flavor $URL --- 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 diff --git a/docs/cmdline-opts/etag-compare.d b/docs/cmdline-opts/etag-compare.d index c984cc9f86..fa16762876 100644 --- a/docs/cmdline-opts/etag-compare.d +++ b/docs/cmdline-opts/etag-compare.d @@ -4,6 +4,7 @@ Help: Pass an ETag from a file as a custom header Protocols: HTTP Added: 7.68.0 Category: http +Example: --etag-compare etag.txt $URL --- This option makes a conditional HTTP request for the specific ETag read from the given file by sending a custom If-None-Match header using the diff --git a/docs/cmdline-opts/etag-save.d b/docs/cmdline-opts/etag-save.d index dc2484c326..8efad9044f 100644 --- a/docs/cmdline-opts/etag-save.d +++ b/docs/cmdline-opts/etag-save.d @@ -4,6 +4,7 @@ Help: Parse ETag from a request and save it to a file Protocols: HTTP Added: 7.68.0 Category: http +Example: --etag-save storetag.txt $URL --- This option saves an HTTP ETag to the specified file. An ETag is a caching related header, usually returned in a response. diff --git a/docs/cmdline-opts/expect100-timeout.d b/docs/cmdline-opts/expect100-timeout.d index 431a529c29..8855edd0b7 100644 --- a/docs/cmdline-opts/expect100-timeout.d +++ b/docs/cmdline-opts/expect100-timeout.d @@ -5,6 +5,7 @@ Protocols: HTTP Added: 7.47.0 See-also: connect-timeout Category: http +Example: --expect100-timeout 2.5 -T file $URL --- Maximum time in seconds that you allow curl to wait for a 100-continue response when curl emits an Expects: 100-continue header in its request. By diff --git a/docs/cmdline-opts/fail-early.d b/docs/cmdline-opts/fail-early.d index 3fbe238af2..aad15c3feb 100644 --- a/docs/cmdline-opts/fail-early.d +++ b/docs/cmdline-opts/fail-early.d @@ -2,6 +2,7 @@ Long: fail-early Help: Fail on first transfer error, do not continue Added: 7.52.0 Category: curl +Example: --fail-early $URL https://two.example --- Fail and exit on the first detected transfer error. diff --git a/docs/cmdline-opts/fail-with-body.d b/docs/cmdline-opts/fail-with-body.d index e27d459f9f..9b8c7db4ef 100644 --- a/docs/cmdline-opts/fail-with-body.d +++ b/docs/cmdline-opts/fail-with-body.d @@ -4,6 +4,7 @@ Help: Fail on HTTP errors but save the body Category: http output Added: 7.76.0 See-also: fail +Example: --fail-with-body $URL --- Return an error on server errors where the HTTP response code is 400 or greater). In normal cases when an HTTP server fails to deliver a document, it diff --git a/docs/cmdline-opts/fail.d b/docs/cmdline-opts/fail.d index d4d65fba4e..a5e0c91e7e 100644 --- a/docs/cmdline-opts/fail.d +++ b/docs/cmdline-opts/fail.d @@ -4,6 +4,7 @@ Protocols: HTTP Help: Fail silently (no output at all) on HTTP errors See-also: fail-with-body Category: important http +Example: --fail $URL --- 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 diff --git a/docs/cmdline-opts/false-start.d b/docs/cmdline-opts/false-start.d index abeff0eb5c..de36962eea 100644 --- a/docs/cmdline-opts/false-start.d +++ b/docs/cmdline-opts/false-start.d @@ -3,6 +3,7 @@ Help: Enable TLS False Start Protocols: TLS Added: 7.42.0 Category: tls +Example: --false-start $URL --- Tells curl to use false start during the TLS handshake. False start is a mode where a TLS client will start sending application data before verifying the diff --git a/docs/cmdline-opts/form-string.d b/docs/cmdline-opts/form-string.d index 04d2578c55..4f1a766bc7 100644 --- a/docs/cmdline-opts/form-string.d +++ b/docs/cmdline-opts/form-string.d @@ -4,6 +4,7 @@ Protocols: HTTP SMTP IMAP Arg: See-also: form Category: http upload +Example: --form-string "data" $URL --- Similar to --form except that the value string for the named parameter is used literally. Leading \&'@' and \&'<' characters, and the \&';type=' string in diff --git a/docs/cmdline-opts/form.d b/docs/cmdline-opts/form.d index eec9aac72c..06f2c55326 100644 --- a/docs/cmdline-opts/form.d +++ b/docs/cmdline-opts/form.d @@ -5,6 +5,7 @@ Help: Specify multipart MIME data Protocols: HTTP SMTP IMAP Mutexed: data head upload-file Category: http upload +Example: --form "name=curl" --form "file=@loadthis" $URL --- 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 diff --git a/docs/cmdline-opts/ftp-account.d b/docs/cmdline-opts/ftp-account.d index bc04ba0472..ce816f10d2 100644 --- a/docs/cmdline-opts/ftp-account.d +++ b/docs/cmdline-opts/ftp-account.d @@ -4,6 +4,7 @@ Help: Account data string Protocols: FTP Added: 7.13.0 Category: ftp auth +Example: --ftp-account "mr.robot" ftp://example.com/ --- When an FTP server asks for "account data" after user name and password has been provided, this data is sent off using the ACCT command. diff --git a/docs/cmdline-opts/ftp-alternative-to-user.d b/docs/cmdline-opts/ftp-alternative-to-user.d index 1714849063..a5fb9853d2 100644 --- a/docs/cmdline-opts/ftp-alternative-to-user.d +++ b/docs/cmdline-opts/ftp-alternative-to-user.d @@ -4,6 +4,7 @@ Help: String to replace USER [name] Protocols: FTP Added: 7.15.5 Category: ftp +Example: --ftp-alternative-to-user "U53r" ftp://example.com --- If authenticating with the USER and PASS commands fails, send this command. When connecting to Tumbleweed's Secure Transport server over FTPS using a diff --git a/docs/cmdline-opts/ftp-create-dirs.d b/docs/cmdline-opts/ftp-create-dirs.d index 5d9dfda46a..579f8e36d8 100644 --- a/docs/cmdline-opts/ftp-create-dirs.d +++ b/docs/cmdline-opts/ftp-create-dirs.d @@ -3,6 +3,7 @@ Protocols: FTP SFTP Help: Create the remote dirs if not present See-also: create-dirs Category: ftp sftp curl +Example: --ftp-create-dirs -T file ftp://example.com/remote/path/file --- 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 diff --git a/docs/cmdline-opts/ftp-method.d b/docs/cmdline-opts/ftp-method.d index 149340b82f..4af0baf423 100644 --- a/docs/cmdline-opts/ftp-method.d +++ b/docs/cmdline-opts/ftp-method.d @@ -4,6 +4,9 @@ Help: Control CWD usage Protocols: FTP Added: 7.15.1 Category: ftp +Example: --ftp-method multicwd ftp://example.com/dir1/dir2/file +Example: --ftp-method nocwd ftp://example.com/dir1/dir2/file +Example: --ftp-method singlecwd ftp://example.com/dir1/dir2/file --- Control what method curl should use to reach a file on an FTP(S) server. The method argument should be one of the following alternatives: diff --git a/docs/cmdline-opts/ftp-pasv.d b/docs/cmdline-opts/ftp-pasv.d index cbd548de32..d920fefa6e 100644 --- a/docs/cmdline-opts/ftp-pasv.d +++ b/docs/cmdline-opts/ftp-pasv.d @@ -4,6 +4,7 @@ Protocols: FTP Added: 7.11.0 See-also: disable-epsv Category: ftp +Example: --ftp-pasv ftp://example.com/ --- Use passive mode for the data connection. Passive is the internal default behavior, but using this option can be used to override a previous --ftp-port diff --git a/docs/cmdline-opts/ftp-port.d b/docs/cmdline-opts/ftp-port.d index 9bb1d43f0e..52e55e58f9 100644 --- a/docs/cmdline-opts/ftp-port.d +++ b/docs/cmdline-opts/ftp-port.d @@ -5,6 +5,9 @@ Short: P Protocols: FTP See-also: ftp-pasv disable-eprt Category: ftp +Example: -P - ftp:/example.com +Example: -P eth0 ftp:/example.com +Example: -P 192.168.0.2 ftp:/example.com --- 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 diff --git a/docs/cmdline-opts/ftp-pret.d b/docs/cmdline-opts/ftp-pret.d index e9c7d251a6..453d8cf858 100644 --- a/docs/cmdline-opts/ftp-pret.d +++ b/docs/cmdline-opts/ftp-pret.d @@ -3,6 +3,7 @@ Help: Send PRET before PASV Protocols: FTP Added: 7.20.0 Category: ftp +Example: --ftp-pret ftp://example.com/ --- Tell curl to send a PRET command before PASV (and EPSV). Certain FTP servers, mainly drftpd, require this non-standard command for directory listings as diff --git a/docs/cmdline-opts/ftp-skip-pasv-ip.d b/docs/cmdline-opts/ftp-skip-pasv-ip.d index bcf4e7e62f..36f9e6da13 100644 --- a/docs/cmdline-opts/ftp-skip-pasv-ip.d +++ b/docs/cmdline-opts/ftp-skip-pasv-ip.d @@ -4,6 +4,7 @@ Protocols: FTP Added: 7.14.2 See-also: ftp-pasv Category: ftp +Example: --ftp-skip-pasv-ip ftp://example.com/ --- Tell curl to not use the IP address the server suggests in its response to curl's PASV command when curl connects the data connection. Instead curl diff --git a/docs/cmdline-opts/ftp-ssl-ccc-mode.d b/docs/cmdline-opts/ftp-ssl-ccc-mode.d index 6289e544a8..15ad1f54b0 100644 --- a/docs/cmdline-opts/ftp-ssl-ccc-mode.d +++ b/docs/cmdline-opts/ftp-ssl-ccc-mode.d @@ -5,6 +5,7 @@ Protocols: FTP Added: 7.16.2 See-also: ftp-ssl-ccc Category: ftp tls +Example: --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/ --- Sets the CCC mode. The passive mode will not initiate the shutdown, but instead wait for the server to do it, and will not reply to the shutdown from diff --git a/docs/cmdline-opts/ftp-ssl-ccc.d b/docs/cmdline-opts/ftp-ssl-ccc.d index 33cab4302a..bfaf431bbb 100644 --- a/docs/cmdline-opts/ftp-ssl-ccc.d +++ b/docs/cmdline-opts/ftp-ssl-ccc.d @@ -4,6 +4,7 @@ Protocols: FTP See-also: ssl ftp-ssl-ccc-mode Added: 7.16.1 Category: ftp tls +Example: --ftp-ssl-ccc ftps://example.com/ --- Use CCC (Clear Command Channel) Shuts down the SSL/TLS layer after authenticating. The rest of the control channel communication will be diff --git a/docs/cmdline-opts/ftp-ssl-control.d b/docs/cmdline-opts/ftp-ssl-control.d index 5191353ddc..72dc080bca 100644 --- a/docs/cmdline-opts/ftp-ssl-control.d +++ b/docs/cmdline-opts/ftp-ssl-control.d @@ -3,6 +3,7 @@ Help: Require SSL/TLS for FTP login, clear for transfer Protocols: FTP Added: 7.16.0 Category: ftp tls +Example: --ftp-ssl-control ftp://example.com --- Require SSL/TLS for the FTP login, clear for transfer. Allows secure authentication, but non-encrypted data transfers for efficiency. Fails the diff --git a/docs/cmdline-opts/gen.pl b/docs/cmdline-opts/gen.pl index e651f029a5..c058987d41 100755 --- a/docs/cmdline-opts/gen.pl +++ b/docs/cmdline-opts/gen.pl @@ -138,8 +138,11 @@ sub single { my $requires; my $category; my $seealso; + my @examples; # there can be more than one my $magic; # cmdline special option + my $line; while() { + $line++; if(/^Short: *(.)/i) { $short=$1; } @@ -173,6 +176,9 @@ sub single { elsif(/^Category: *(.*)/i) { $category=$1; } + elsif(/^Example: *(.*)/i) { + push @examples, $1; + } elsif(/^Help: *(.*)/i) { ; } @@ -185,6 +191,10 @@ sub single { print STDERR "ERROR: no 'Category:' in $f\n"; exit 2; } + if(!$examples[0]) { + print STDERR "$f:$line:1:ERROR: no 'Example:' present\n"; + exit 2; + } last; } else { @@ -276,6 +286,16 @@ sub single { } push @foot, overrides($standalone, "This option overrides $mstr. "); } + if($examples[0]) { + my $s =""; + $s="s" if($examples[1]); + print "\nExample$s:\n.nf\n"; + foreach my $e (@examples) { + $e =~ s!\$URL!https://example.com!g; + print " curl $e\n"; + } + print ".fi\n"; + } if($added) { push @foot, added($standalone, $added); } diff --git a/docs/cmdline-opts/get.d b/docs/cmdline-opts/get.d index d529bb4e0b..e51c15563e 100644 --- a/docs/cmdline-opts/get.d +++ b/docs/cmdline-opts/get.d @@ -2,6 +2,7 @@ Long: get Short: G Help: Put the post data in the URL and use GET Category: http upload +Example: --get $URL --- 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 diff --git a/docs/cmdline-opts/globoff.d b/docs/cmdline-opts/globoff.d index 1db0fa264b..ec2c7ae48a 100644 --- a/docs/cmdline-opts/globoff.d +++ b/docs/cmdline-opts/globoff.d @@ -2,6 +2,7 @@ Long: globoff Short: g Help: Disable URL sequences and ranges using {} and [] Category: curl +Example: -g "https://example.com/{[]}}}}" --- 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 diff --git a/docs/cmdline-opts/happy-eyeballs-timeout-ms.d b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d index 1488a5a040..c3b2a51322 100644 --- a/docs/cmdline-opts/happy-eyeballs-timeout-ms.d +++ b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d @@ -3,6 +3,7 @@ Arg: Help: Time for IPv6 before trying IPv4 Added: 7.59.0 Category: connection +Example: --happy-eyeballs-timeout-ms 500 $URL --- Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6 addresses for dual-stack hosts, giving IPv6 a head-start of the specified diff --git a/docs/cmdline-opts/haproxy-protocol.d b/docs/cmdline-opts/haproxy-protocol.d index 835820465a..446dc65722 100644 --- a/docs/cmdline-opts/haproxy-protocol.d +++ b/docs/cmdline-opts/haproxy-protocol.d @@ -3,10 +3,11 @@ Help: Send HAProxy PROXY protocol v1 header Protocols: HTTP Added: 7.60.0 Category: http proxy +Example: --haproxy-protocol $URL --- -Send a HAProxy PROXY protocol v1 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. +Send a HAProxy PROXY protocol v1 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. diff --git a/docs/cmdline-opts/head.d b/docs/cmdline-opts/head.d index 6fe468511e..06d2489d5e 100644 --- a/docs/cmdline-opts/head.d +++ b/docs/cmdline-opts/head.d @@ -3,6 +3,7 @@ Short: I Help: Show document info only Protocols: HTTP FTP FILE Category: http ftp file +Example: -I $URL --- 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, diff --git a/docs/cmdline-opts/header.d b/docs/cmdline-opts/header.d index 121285ae37..11c96d5eae 100644 --- a/docs/cmdline-opts/header.d +++ b/docs/cmdline-opts/header.d @@ -5,6 +5,9 @@ Help: Pass custom header(s) to server Protocols: HTTP Category: http See-also: user-agent referer +Example: -H "X-First-Name: Joe" $URL +Example: -H "User-Agent: yes-please/2000" $URL +Example: -H "Host:" $URL --- 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 @@ -32,10 +35,6 @@ proxy. Added in 7.37.0. Passing on a "Transfer-Encoding: chunked" header when doing a HTTP request with a request body, will make curl send the data using chunked encoding. -Example: - - curl -H "X-First-Name: Joe" http://example.com/ - **WARNING**: headers set with this option will be set in all requests - even after redirects are followed, like when told with --location. This can lead to the header being sent to other hosts than the original host, so sensitive diff --git a/docs/cmdline-opts/help.d b/docs/cmdline-opts/help.d index b7c68233a1..28ae868d2f 100644 --- a/docs/cmdline-opts/help.d +++ b/docs/cmdline-opts/help.d @@ -3,6 +3,7 @@ Arg: Short: h Help: Get help for commands Category: important curl +Example: --help all --- Usage help. This lists all commands of the . If no arg was provided, curl will display the most important diff --git a/docs/cmdline-opts/hostpubmd5.d b/docs/cmdline-opts/hostpubmd5.d index c926ed8b50..833db950c7 100644 --- a/docs/cmdline-opts/hostpubmd5.d +++ b/docs/cmdline-opts/hostpubmd5.d @@ -4,6 +4,7 @@ Help: Acceptable MD5 hash of the host public key Protocols: SFTP SCP Added: 7.17.1 Category: sftp scp +Example: --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/ --- Pass a string containing 32 hexadecimal digits. The string should be the 128 bit MD5 checksum of the remote host's public key, curl will refuse diff --git a/docs/cmdline-opts/hsts.d b/docs/cmdline-opts/hsts.d index 2399084bfc..f9cd453dac 100644 --- a/docs/cmdline-opts/hsts.d +++ b/docs/cmdline-opts/hsts.d @@ -4,9 +4,8 @@ Protocols: HTTPS Help: Enable HSTS with this cache file Added: 7.74.0 Category: http +Example: --hsts cache.txt $URL --- -WARNING: this option is experimental. Do not use in production. - This option enables HSTS for the transfer. If the file name points to an existing HSTS cache file, that will be used. After a completed transfer, the cache will be saved to the file name again if it has been modified. diff --git a/docs/cmdline-opts/http0.9.d b/docs/cmdline-opts/http0.9.d index 954c22a17a..7c45d565a8 100644 --- a/docs/cmdline-opts/http0.9.d +++ b/docs/cmdline-opts/http0.9.d @@ -4,6 +4,7 @@ Protocols: HTTP Added: Help: Allow HTTP 0.9 responses Category: http +Example: --http0.9 $URL --- Tells curl to be fine with HTTP version 0.9 response. diff --git a/docs/cmdline-opts/http1.0.d b/docs/cmdline-opts/http1.0.d index a4059dbf0f..cbfbaee40d 100644 --- a/docs/cmdline-opts/http1.0.d +++ b/docs/cmdline-opts/http1.0.d @@ -6,6 +6,7 @@ Added: Mutexed: http1.1 http2 Help: Use HTTP 1.0 Category: http +Example: --http1.0 $URL --- Tells curl to use HTTP version 1.0 instead of using its internally preferred HTTP version. diff --git a/docs/cmdline-opts/http1.1.d b/docs/cmdline-opts/http1.1.d index a71a40bab2..01fa76d332 100644 --- a/docs/cmdline-opts/http1.1.d +++ b/docs/cmdline-opts/http1.1.d @@ -5,5 +5,6 @@ Added: 7.33.0 Mutexed: http1.0 http2 Help: Use HTTP 1.1 Category: http +Example: --http1.1 $URL --- Tells curl to use HTTP version 1.1. diff --git a/docs/cmdline-opts/http2-prior-knowledge.d b/docs/cmdline-opts/http2-prior-knowledge.d index ea2906edb4..e3b32f6ba4 100644 --- a/docs/cmdline-opts/http2-prior-knowledge.d +++ b/docs/cmdline-opts/http2-prior-knowledge.d @@ -6,6 +6,7 @@ Mutexed: http1.1 http1.0 http2 Requires: HTTP/2 Help: Use HTTP 2 without HTTP/1.1 Upgrade Category: http +Example: --http2-prior-knowledge $URL --- Tells curl to issue its non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires prior knowledge that the server supports HTTP/2 straight diff --git a/docs/cmdline-opts/http2.d b/docs/cmdline-opts/http2.d index 197515ee8c..2a85db600d 100644 --- a/docs/cmdline-opts/http2.d +++ b/docs/cmdline-opts/http2.d @@ -8,5 +8,12 @@ See-also: no-alpn Help: Use HTTP 2 See-also: http1.1 http3 Category: http +Example: --http2 $URL --- Tells curl to use HTTP version 2. + +For HTTPS, this means curl will attempt to negotiate HTTP/2 in the TLS +handshake. curl does this by default. + +For HTTP, this means curl will attempt to upgrade the request to HTTP/2 using +the Upgrade: request header. diff --git a/docs/cmdline-opts/http3.d b/docs/cmdline-opts/http3.d index 50630798f1..f6c92b39a6 100644 --- a/docs/cmdline-opts/http3.d +++ b/docs/cmdline-opts/http3.d @@ -7,8 +7,9 @@ Requires: HTTP/3 Help: Use HTTP v3 See-also: http1.1 http2 Category: http +Example: --http3 $URL --- -WARNING: this option is experimental. Do not use in production. +**WARNING**: this option is experimental. Do not use in production. Tells curl to use HTTP version 3 directly to the host and port number used in the URL. A normal HTTP/3 transaction will be done to a host and then get diff --git a/docs/cmdline-opts/ignore-content-length.d b/docs/cmdline-opts/ignore-content-length.d index 2555ccaaef..8a4c24754a 100644 --- a/docs/cmdline-opts/ignore-content-length.d +++ b/docs/cmdline-opts/ignore-content-length.d @@ -2,6 +2,7 @@ Long: ignore-content-length Help: Ignore the size of the remote resource Protocols: FTP HTTP Category: http ftp +Example: --ignore-content-length $URL --- For HTTP, Ignore the Content-Length header. This is particularly useful for servers running Apache 1.x, which will report incorrect Content-Length for diff --git a/docs/cmdline-opts/include.d b/docs/cmdline-opts/include.d index 250d4accfd..80a05e0c86 100644 --- a/docs/cmdline-opts/include.d +++ b/docs/cmdline-opts/include.d @@ -3,6 +3,7 @@ Short: i Help: Include protocol response headers in the output See-also: verbose Category: important verbose +Example: -i $URL --- 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 diff --git a/docs/cmdline-opts/insecure.d b/docs/cmdline-opts/insecure.d index 443ddd5074..fb2c17d8bb 100644 --- a/docs/cmdline-opts/insecure.d +++ b/docs/cmdline-opts/insecure.d @@ -4,6 +4,7 @@ Help: Allow insecure server connections when using SSL Protocols: TLS See-also: proxy-insecure cacert Category: tls +Example: --insecure $URL --- By default, every SSL connection curl makes is verified to be secure. This option allows curl to proceed and operate even for server connections @@ -14,3 +15,5 @@ contains the right name and verifies successfully using the cert store. See this online resource for further details: https://curl.se/docs/sslcerts.html + +**WARNING**: this makes the transfer insecure. diff --git a/docs/cmdline-opts/interface.d b/docs/cmdline-opts/interface.d index 196e7efa34..b2c8eeec5e 100644 --- a/docs/cmdline-opts/interface.d +++ b/docs/cmdline-opts/interface.d @@ -3,6 +3,7 @@ Arg: Help: Use network INTERFACE (or address) See-also: dns-interface Category: connection +Example: --interface eth0 $URL --- Perform an operation using a specified interface. You can enter interface diff --git a/docs/cmdline-opts/ipv4.d b/docs/cmdline-opts/ipv4.d index a6691376a6..90a6dda007 100644 --- a/docs/cmdline-opts/ipv4.d +++ b/docs/cmdline-opts/ipv4.d @@ -8,6 +8,7 @@ Requires: See-also: http1.1 http2 Help: Resolve names to IPv4 addresses Category: connection dns +Example: --ipv4 $URL --- This option tells curl to resolve names to IPv4 addresses only, and not for example try IPv6. diff --git a/docs/cmdline-opts/ipv6.d b/docs/cmdline-opts/ipv6.d index ce0415caa9..dfa79abab3 100644 --- a/docs/cmdline-opts/ipv6.d +++ b/docs/cmdline-opts/ipv6.d @@ -8,6 +8,7 @@ Requires: See-also: http1.1 http2 Help: Resolve names to IPv6 addresses Category: connection dns +Example: --ipv6 $URL --- This option tells curl to resolve names to IPv6 addresses only, and not for example try IPv4. diff --git a/docs/cmdline-opts/junk-session-cookies.d b/docs/cmdline-opts/junk-session-cookies.d index 993b77fa82..0cc342c720 100644 --- a/docs/cmdline-opts/junk-session-cookies.d +++ b/docs/cmdline-opts/junk-session-cookies.d @@ -4,6 +4,7 @@ Help: Ignore session cookies read from file Protocols: HTTP See-also: cookie cookie-jar Category: http +Example: --junk-session-cookies -b cookies.txt $URL --- 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 diff --git a/docs/cmdline-opts/keepalive-time.d b/docs/cmdline-opts/keepalive-time.d index 41261535c8..1b96c4dc5f 100644 --- a/docs/cmdline-opts/keepalive-time.d +++ b/docs/cmdline-opts/keepalive-time.d @@ -3,6 +3,7 @@ Arg: Help: Interval time for keepalive probes Added: 7.18.0 Category: connection +Example: --keepalive-time 20 $URL --- This option sets the time a connection needs to remain idle before sending keepalive probes and the time between individual keepalive probes. It is diff --git a/docs/cmdline-opts/key-type.d b/docs/cmdline-opts/key-type.d index 50a068676a..4baa9afa29 100644 --- a/docs/cmdline-opts/key-type.d +++ b/docs/cmdline-opts/key-type.d @@ -3,6 +3,7 @@ Arg: Help: Private key file type (DER/PEM/ENG) Protocols: TLS Category: tls +Example: --key-type DER --key here $URL --- 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. diff --git a/docs/cmdline-opts/key.d b/docs/cmdline-opts/key.d index a762e6fafe..d7f5e22a6a 100644 --- a/docs/cmdline-opts/key.d +++ b/docs/cmdline-opts/key.d @@ -3,6 +3,7 @@ Arg: Protocols: TLS SSH Help: Private key file name Category: tls ssh +Example: --cert certificate --key here $URL --- 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: diff --git a/docs/cmdline-opts/krb.d b/docs/cmdline-opts/krb.d index 7759cfb04b..3d9ce999e9 100644 --- a/docs/cmdline-opts/krb.d +++ b/docs/cmdline-opts/krb.d @@ -4,6 +4,7 @@ Help: Enable Kerberos with security Protocols: FTP Requires: Kerberos Category: ftp +Example: --krb clear ftp://example.com/ --- Enable Kerberos authentication and use. The level must be entered and should be one of 'clear', 'safe', 'confidential', or 'private'. Should you use a diff --git a/docs/cmdline-opts/libcurl.d b/docs/cmdline-opts/libcurl.d index 40160824ac..b7371fffe2 100644 --- a/docs/cmdline-opts/libcurl.d +++ b/docs/cmdline-opts/libcurl.d @@ -3,6 +3,7 @@ Arg: Help: Dump libcurl equivalent code of this command line Added: 7.16.1 Category: curl +Example: --libcurl client.c $URL --- Append this option to any ordinary curl command line, and you will get libcurl-using C source code written to the file that does the equivalent diff --git a/docs/cmdline-opts/limit-rate.d b/docs/cmdline-opts/limit-rate.d index 66f5cdaac3..7c46e544a3 100644 --- a/docs/cmdline-opts/limit-rate.d +++ b/docs/cmdline-opts/limit-rate.d @@ -2,6 +2,9 @@ Long: limit-rate Arg: Help: Limit transfer speed to RATE Category: connection +Example: --limit-rate 100K $URL +Example: --limit-rate 1000 $URL +Example: --limit-rate 10M $URL --- 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 diff --git a/docs/cmdline-opts/list-only.d b/docs/cmdline-opts/list-only.d index ac39906929..29f9ba2f3c 100644 --- a/docs/cmdline-opts/list-only.d +++ b/docs/cmdline-opts/list-only.d @@ -4,6 +4,7 @@ Protocols: FTP POP3 Help: List only mode Added: 4.0 Category: ftp pop3 +Example: --list-only ftp://example.com/dir/ --- (FTP) When listing an FTP directory, this switch forces a name-only view. This is diff --git a/docs/cmdline-opts/local-port.d b/docs/cmdline-opts/local-port.d index 3f7a0e024a..7766417003 100644 --- a/docs/cmdline-opts/local-port.d +++ b/docs/cmdline-opts/local-port.d @@ -3,6 +3,7 @@ Arg: Help: Force use of RANGE for local port numbers Added: 7.15.2 Category: connection +Example: --local-port 1000-3000 $URL --- Set a preferred single number or range (FROM-TO) of local port numbers to use for the connection(s). Note that port numbers by nature are a scarce resource diff --git a/docs/cmdline-opts/location-trusted.d b/docs/cmdline-opts/location-trusted.d index f01d842bc5..98c49ffe19 100644 --- a/docs/cmdline-opts/location-trusted.d +++ b/docs/cmdline-opts/location-trusted.d @@ -3,6 +3,7 @@ Help: Like --location, and send auth to other hosts Protocols: HTTP See-also: user Category: http auth +Example: --location-trusted -u user:password $URL --- 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 diff --git a/docs/cmdline-opts/location.d b/docs/cmdline-opts/location.d index 6bf763d3ad..08c939c15d 100644 --- a/docs/cmdline-opts/location.d +++ b/docs/cmdline-opts/location.d @@ -3,6 +3,7 @@ Short: L Help: Follow redirects Protocols: HTTP Category: http +Example: -L $URL --- 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 diff --git a/docs/cmdline-opts/login-options.d b/docs/cmdline-opts/login-options.d index b12246885b..de7728854e 100644 --- a/docs/cmdline-opts/login-options.d +++ b/docs/cmdline-opts/login-options.d @@ -4,6 +4,7 @@ Protocols: IMAP POP3 SMTP Help: Server login options Added: 7.34.0 Category: imap pop3 smtp auth +Example: --login-options 'AUTH=*' imap://example.com --- Specify the login options to use during server authentication. diff --git a/docs/cmdline-opts/mail-auth.d b/docs/cmdline-opts/mail-auth.d index 529997161d..49a02d5baa 100644 --- a/docs/cmdline-opts/mail-auth.d +++ b/docs/cmdline-opts/mail-auth.d @@ -5,6 +5,7 @@ Help: Originator address of the original email Added: 7.25.0 See-also: mail-rcpt mail-from Category: smtp +Example: --mail-auth user@example.come -T mail smtp://example.com/ --- Specify a single address. This will be used to specify the authentication address (identity) of a submitted message that is being relayed to another diff --git a/docs/cmdline-opts/mail-from.d b/docs/cmdline-opts/mail-from.d index faf48e2a4b..be0547c9f2 100644 --- a/docs/cmdline-opts/mail-from.d +++ b/docs/cmdline-opts/mail-from.d @@ -5,5 +5,6 @@ Protocols: SMTP Added: 7.20.0 See-also: mail-rcpt mail-auth Category: smtp +Example: --mail-from user@example.com -T mail smtp://example.com/ --- Specify a single address that the given mail should get sent from. diff --git a/docs/cmdline-opts/mail-rcpt-allowfails.d b/docs/cmdline-opts/mail-rcpt-allowfails.d index e96be3e711..36d555e17c 100644 --- a/docs/cmdline-opts/mail-rcpt-allowfails.d +++ b/docs/cmdline-opts/mail-rcpt-allowfails.d @@ -3,6 +3,7 @@ Help: Allow RCPT TO command to fail for some recipients Protocols: SMTP Added: 7.69.0 Category: smtp +Example: --mail-rcpt-allowfails --mail-rcpt dest@example.com smtp://example.com --- When sending data to multiple recipients, by default curl will abort SMTP conversation if at least one of the recipients causes RCPT TO command to diff --git a/docs/cmdline-opts/mail-rcpt.d b/docs/cmdline-opts/mail-rcpt.d index d464bb41b4..d4a2502eea 100644 --- a/docs/cmdline-opts/mail-rcpt.d +++ b/docs/cmdline-opts/mail-rcpt.d @@ -4,6 +4,7 @@ Help: Mail to this address Protocols: SMTP Added: 7.20.0 Category: smtp +Example: --mail-rcpt user@example.net smtp://example.com --- Specify a single e-mail address, user name or mailing list name. Repeat this option several times to send to multiple recipients. diff --git a/docs/cmdline-opts/manual.d b/docs/cmdline-opts/manual.d index 25ed08dd27..c81754b7a7 100644 --- a/docs/cmdline-opts/manual.d +++ b/docs/cmdline-opts/manual.d @@ -2,5 +2,6 @@ Long: manual Short: M Help: Display the full manual Category: curl +Example: --manual --- Manual. Display the huge help text. diff --git a/docs/cmdline-opts/max-filesize.d b/docs/cmdline-opts/max-filesize.d index 6717f2d954..0f8aca42e2 100644 --- a/docs/cmdline-opts/max-filesize.d +++ b/docs/cmdline-opts/max-filesize.d @@ -4,6 +4,7 @@ Help: Maximum file size to download Protocols: FTP HTTP MQTT See-also: limit-rate Category: connection +Example: --max-filesize 100K $URL --- 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 diff --git a/docs/cmdline-opts/max-redirs.d b/docs/cmdline-opts/max-redirs.d index 1b5de5bc13..eade17f7bc 100644 --- a/docs/cmdline-opts/max-redirs.d +++ b/docs/cmdline-opts/max-redirs.d @@ -3,6 +3,7 @@ Arg: Help: Maximum number of redirects allowed Protocols: HTTP Category: http +Example: --max-redirs 3 --location $URL --- Set maximum number of redirections to follow. When --location is used, to prevent curl from following too many redirects, by default, the limit is diff --git a/docs/cmdline-opts/max-time.d b/docs/cmdline-opts/max-time.d index c4e4ed7eb4..cb86fa9fcd 100644 --- a/docs/cmdline-opts/max-time.d +++ b/docs/cmdline-opts/max-time.d @@ -1,9 +1,11 @@ Long: max-time Short: m -Arg: -Help: Maximum time allowed for the transfer +Arg: +Help: Maximum time allowed for transfer See-also: connect-timeout Category: connection +Example: --max-time 10 $URL +Example: --max-time 2.92 $URL --- 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 diff --git a/docs/cmdline-opts/metalink.d b/docs/cmdline-opts/metalink.d index 4725b389ad..1fc1087421 100644 --- a/docs/cmdline-opts/metalink.d +++ b/docs/cmdline-opts/metalink.d @@ -2,6 +2,7 @@ Long: metalink Help: Process given URLs as metalink XML file Added: 7.27.0 Category: misc +Example: --metalink file $URL --- This option was previously used to specify a metalink resource. Metalink support has been disabled in curl since 7.78.0 for security reasons. diff --git a/docs/cmdline-opts/negotiate.d b/docs/cmdline-opts/negotiate.d index e247bfbee5..e862bc8202 100644 --- a/docs/cmdline-opts/negotiate.d +++ b/docs/cmdline-opts/negotiate.d @@ -3,6 +3,7 @@ Help: Use HTTP Negotiate (SPNEGO) authentication Protocols: HTTP See-also: basic ntlm anyauth proxy-negotiate Category: auth http +Example: --negotiate -u : $URL --- Enables Negotiate (SPNEGO) authentication. diff --git a/docs/cmdline-opts/netrc-file.d b/docs/cmdline-opts/netrc-file.d index 95fb2654a2..df89d51f54 100644 --- a/docs/cmdline-opts/netrc-file.d +++ b/docs/cmdline-opts/netrc-file.d @@ -4,6 +4,7 @@ Arg: Added: 7.21.5 Mutexed: netrc Category: curl +Example: --netrc-file netrc $URL --- This option is similar to --netrc, except that you provide the path (absolute or relative) to the netrc file that curl should use. You can only specify one diff --git a/docs/cmdline-opts/netrc-optional.d b/docs/cmdline-opts/netrc-optional.d index e0b59d19b8..3869a2009b 100644 --- a/docs/cmdline-opts/netrc-optional.d +++ b/docs/cmdline-opts/netrc-optional.d @@ -3,6 +3,7 @@ Help: Use either .netrc or URL Mutexed: netrc See-also: netrc-file Category: curl +Example: --netrc-optional $URL --- Very similar to --netrc, but this option makes the .netrc usage **optional** and not mandatory as the --netrc option does. diff --git a/docs/cmdline-opts/netrc.d b/docs/cmdline-opts/netrc.d index a31e2ede32..21e33a164a 100644 --- a/docs/cmdline-opts/netrc.d +++ b/docs/cmdline-opts/netrc.d @@ -2,6 +2,7 @@ Long: netrc Short: n Help: Must read .netrc for user name and password Category: curl +Example: --netrc $URL --- 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 diff --git a/docs/cmdline-opts/next.d b/docs/cmdline-opts/next.d index 1adcc7535c..bcbad68e58 100644 --- a/docs/cmdline-opts/next.d +++ b/docs/cmdline-opts/next.d @@ -6,6 +6,8 @@ Added: 7.36.0 Magic: divider Help: Make next URL use its separate set of options Category: curl +Example: $URL --next -d postthis www2.example.com +Example: -I $URL --next https://example.net/ --- Tells curl to use a separate operation for the following URL and associated options. This allows you to send several URL requests, each with their own @@ -18,4 +20,6 @@ options include --verbose, --trace, --trace-ascii and --fail-early. For example, you can do both a GET and a POST in a single command line: +.nf curl www1.example.com --next -d postthis www2.example.com +.fi diff --git a/docs/cmdline-opts/no-alpn.d b/docs/cmdline-opts/no-alpn.d index 8031b4f079..bc62076323 100644 --- a/docs/cmdline-opts/no-alpn.d +++ b/docs/cmdline-opts/no-alpn.d @@ -6,6 +6,7 @@ See-also: no-npn http2 Requires: TLS Help: Disable the ALPN TLS extension Category: tls http +Example: --no-alpn $URL --- Disable the ALPN TLS extension. ALPN is enabled by default if libcurl was built with an SSL library that supports ALPN. ALPN is used by a libcurl that supports diff --git a/docs/cmdline-opts/no-buffer.d b/docs/cmdline-opts/no-buffer.d index 1079f47128..fe8da4e964 100644 --- a/docs/cmdline-opts/no-buffer.d +++ b/docs/cmdline-opts/no-buffer.d @@ -2,6 +2,7 @@ Long: no-buffer Short: N Help: Disable buffering of the output stream Category: curl +Example: --no-buffer $URL --- 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 diff --git a/docs/cmdline-opts/no-keepalive.d b/docs/cmdline-opts/no-keepalive.d index 72f3bc9a5b..a264b7ac58 100644 --- a/docs/cmdline-opts/no-keepalive.d +++ b/docs/cmdline-opts/no-keepalive.d @@ -1,6 +1,7 @@ Long: no-keepalive Help: Disable TCP keepalive on the connection Category: connection +Example: --no-keepalive $URL --- Disables the use of keepalive messages on the TCP connection. curl otherwise enables them by default. diff --git a/docs/cmdline-opts/no-npn.d b/docs/cmdline-opts/no-npn.d index 27e5974bdf..7a9239d361 100644 --- a/docs/cmdline-opts/no-npn.d +++ b/docs/cmdline-opts/no-npn.d @@ -7,6 +7,7 @@ See-also: no-alpn http2 Requires: TLS Help: Disable the NPN TLS extension Category: tls http +Example: --no-npn $URL --- Disable the NPN TLS extension. NPN is enabled by default if libcurl was built with an SSL library that supports NPN. NPN is used by a libcurl that supports diff --git a/docs/cmdline-opts/no-progress-meter.d b/docs/cmdline-opts/no-progress-meter.d index bf28d635d5..9c7413eeb9 100644 --- a/docs/cmdline-opts/no-progress-meter.d +++ b/docs/cmdline-opts/no-progress-meter.d @@ -3,6 +3,7 @@ Help: Do not show the progress meter See-also: verbose silent Added: 7.67.0 Category: verbose +Example: --no-progress-meter -o store $URL --- Option to switch off the progress meter output without muting or otherwise affecting warning and informational messages like --silent does. diff --git a/docs/cmdline-opts/no-sessionid.d b/docs/cmdline-opts/no-sessionid.d index 013ca4cb47..70a32210ec 100644 --- a/docs/cmdline-opts/no-sessionid.d +++ b/docs/cmdline-opts/no-sessionid.d @@ -3,6 +3,7 @@ Help: Disable SSL session-ID reusing Protocols: TLS Added: 7.16.0 Category: tls +Example: --no-sessionid $URL --- Disable curl's use of SSL session-ID caching. By default all transfers are done using the cache. Note that while nothing should ever get hurt by diff --git a/docs/cmdline-opts/noproxy.d b/docs/cmdline-opts/noproxy.d index c49e6d180e..ee0978e039 100644 --- a/docs/cmdline-opts/noproxy.d +++ b/docs/cmdline-opts/noproxy.d @@ -3,6 +3,7 @@ Arg: Help: List of hosts which do not use proxy Added: 7.19.4 Category: proxy +Example: --noproxy "www.example" $URL --- Comma-separated list of hosts for which not to use a proxy, if one is specified. The only wildcard is a single * character, which matches all hosts, diff --git a/docs/cmdline-opts/ntlm-wb.d b/docs/cmdline-opts/ntlm-wb.d index 4a2f7e1e6a..890137062c 100644 --- a/docs/cmdline-opts/ntlm-wb.d +++ b/docs/cmdline-opts/ntlm-wb.d @@ -3,6 +3,7 @@ Help: Use HTTP NTLM authentication with winbind Protocols: HTTP See-also: ntlm proxy-ntlm Category: auth http +Example: --ntlm-wb -u user:password $URL --- Enables NTLM much in the style --ntlm does, but hand over the authentication to the separate binary ntlmauth application that is executed when needed. diff --git a/docs/cmdline-opts/ntlm.d b/docs/cmdline-opts/ntlm.d index c63c086ebe..5a50632678 100644 --- a/docs/cmdline-opts/ntlm.d +++ b/docs/cmdline-opts/ntlm.d @@ -5,6 +5,7 @@ See-also: proxy-ntlm Protocols: HTTP Requires: TLS Category: auth http +Example: --ntlm -u user:password $URL --- Enables NTLM authentication. The NTLM authentication method was designed by Microsoft and is used by IIS web servers. It is a proprietary protocol, diff --git a/docs/cmdline-opts/oauth2-bearer.d b/docs/cmdline-opts/oauth2-bearer.d index e0ea210ed8..1662a366cd 100644 --- a/docs/cmdline-opts/oauth2-bearer.d +++ b/docs/cmdline-opts/oauth2-bearer.d @@ -3,6 +3,7 @@ Help: OAuth 2 Bearer Token Arg: Protocols: IMAP POP3 SMTP HTTP Category: auth +Example: --oauth2-bearer "mF_9.B5f-4.1JqM" $URL --- 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 diff --git a/docs/cmdline-opts/output-dir.d b/docs/cmdline-opts/output-dir.d index d2ff7738ef..1664f4590f 100644 --- a/docs/cmdline-opts/output-dir.d +++ b/docs/cmdline-opts/output-dir.d @@ -4,6 +4,7 @@ Help: Directory to save files in Added: 7.73.0 See-also: remote-name remote-header-name Category: curl +Example: --output-dir "tmp" -O $URL --- This option specifies the directory in which files should be stored, when diff --git a/docs/cmdline-opts/output.d b/docs/cmdline-opts/output.d index d639a23512..ce9749d5db 100644 --- a/docs/cmdline-opts/output.d +++ b/docs/cmdline-opts/output.d @@ -4,6 +4,10 @@ Short: o Help: Write to file instead of stdout See-also: remote-name remote-name-all remote-header-name Category: important curl +Example: -o file $URL +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 --- Write output to instead of stdout. If you are using {} or [] to fetch multiple documents, you should quote the URL and you can use '#' followed by a diff --git a/docs/cmdline-opts/parallel-immediate.d b/docs/cmdline-opts/parallel-immediate.d index 47b9a7900a..4f7468de65 100644 --- a/docs/cmdline-opts/parallel-immediate.d +++ b/docs/cmdline-opts/parallel-immediate.d @@ -3,6 +3,7 @@ Help: Do not wait for multiplexing (with --parallel) Added: 7.68.0 See-also: parallel parallel-max Category: connection curl +Example: --parallel-immediate -Z $URL -o file1 $URL -o file2 --- When doing parallel transfers, this option will instruct curl that it should rather prefer opening up more connections in parallel at once rather than diff --git a/docs/cmdline-opts/parallel-max.d b/docs/cmdline-opts/parallel-max.d index 9ec807cdda..1f22fcb7d2 100644 --- a/docs/cmdline-opts/parallel-max.d +++ b/docs/cmdline-opts/parallel-max.d @@ -4,6 +4,7 @@ Help: Maximum concurrency for parallel transfers Added: 7.66.0 See-also: parallel Category: connection curl +Example: --parallel-max 100 -Z $URL ftp://example.com/ --- When asked to do parallel transfers, using --parallel, this option controls the maximum amount of transfers to do simultaneously. diff --git a/docs/cmdline-opts/parallel.d b/docs/cmdline-opts/parallel.d index d49158c242..2a0ca4340f 100644 --- a/docs/cmdline-opts/parallel.d +++ b/docs/cmdline-opts/parallel.d @@ -3,6 +3,7 @@ Long: parallel Help: Perform transfers in parallel Added: 7.66.0 Category: connection curl +Example: --parallel $URL -o file1 $URL -o file2 --- Makes curl perform its transfers in parallel as compared to the regular serial manner. diff --git a/docs/cmdline-opts/pass.d b/docs/cmdline-opts/pass.d index e3fb97ae61..58e355827b 100644 --- a/docs/cmdline-opts/pass.d +++ b/docs/cmdline-opts/pass.d @@ -3,6 +3,7 @@ Arg: Help: Pass phrase for the private key Protocols: SSH TLS Category: ssh tls auth +Example: --pass secret --key file $URL --- Passphrase for the private key. diff --git a/docs/cmdline-opts/path-as-is.d b/docs/cmdline-opts/path-as-is.d index 0bfaf6639b..fb87def947 100644 --- a/docs/cmdline-opts/path-as-is.d +++ b/docs/cmdline-opts/path-as-is.d @@ -2,6 +2,7 @@ Long: path-as-is Help: Do not squash .. sequences in URL path Added: 7.42.0 Category: curl +Example: --path-as-is https://example.com/../../etc/passwd --- Tell curl to not handle sequences of /../ or /./ in the given URL path. Normally curl will squash or merge them according to standards but with diff --git a/docs/cmdline-opts/pinnedpubkey.d b/docs/cmdline-opts/pinnedpubkey.d index 4e0ed5edde..dc98b29f84 100644 --- a/docs/cmdline-opts/pinnedpubkey.d +++ b/docs/cmdline-opts/pinnedpubkey.d @@ -3,6 +3,8 @@ Arg: Help: FILE/HASHES Public key to verify peer against Protocols: TLS Category: tls +Example: --pinnedpubkey keyfile $URL +Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL --- 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 diff --git a/docs/cmdline-opts/post301.d b/docs/cmdline-opts/post301.d index 64ead05360..744ef5813a 100644 --- a/docs/cmdline-opts/post301.d +++ b/docs/cmdline-opts/post301.d @@ -4,6 +4,7 @@ Protocols: HTTP See-also: post302 post303 location Added: 7.17.1 Category: http post +Example: --post301 --location -d "data" $URL --- Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET requests when following a 301 redirection. The non-RFC behavior is ubiquitous diff --git a/docs/cmdline-opts/post302.d b/docs/cmdline-opts/post302.d index d73cb9dcd7..2c6d4b615c 100644 --- a/docs/cmdline-opts/post302.d +++ b/docs/cmdline-opts/post302.d @@ -4,6 +4,7 @@ Protocols: HTTP See-also: post301 post303 location Added: 7.19.1 Category: http post +Example: --post302 --location -d "data" $URL --- Tells curl to respect RFC 7231/6.4.3 and not convert POST requests into GET requests when following a 302 redirection. The non-RFC behavior is ubiquitous diff --git a/docs/cmdline-opts/post303.d b/docs/cmdline-opts/post303.d index 1a67e13efd..a2fec18c4b 100644 --- a/docs/cmdline-opts/post303.d +++ b/docs/cmdline-opts/post303.d @@ -4,6 +4,7 @@ Protocols: HTTP See-also: post302 post301 location Added: 7.26.0 Category: http post +Example: --post303 --location -d "data" $URL --- Tells curl to violate RFC 7231/6.4.4 and not convert POST requests into GET requests when following 303 redirections. A server may require a POST to diff --git a/docs/cmdline-opts/preproxy.d b/docs/cmdline-opts/preproxy.d index a917c16ed8..c91565c0e7 100644 --- a/docs/cmdline-opts/preproxy.d +++ b/docs/cmdline-opts/preproxy.d @@ -3,6 +3,7 @@ Arg: [protocol://]host[:port] Help: Use this proxy first Added: 7.52.0 Category: proxy +Example: --preproxy socks5://proxy.example -x http://http.example $URL --- Use the specified SOCKS proxy before connecting to an HTTP or HTTPS --proxy. In such a case curl first connects to the SOCKS proxy and then connects (through diff --git a/docs/cmdline-opts/progress-bar.d b/docs/cmdline-opts/progress-bar.d index ad2f21b87e..96ac3009b1 100644 --- a/docs/cmdline-opts/progress-bar.d +++ b/docs/cmdline-opts/progress-bar.d @@ -2,6 +2,7 @@ Short: # Long: progress-bar Help: Display transfer progress as a bar Category: verbose +Example: -# -O $URL --- Make curl display transfer progress as a simple progress bar instead of the standard, more informational, meter. diff --git a/docs/cmdline-opts/proto-default.d b/docs/cmdline-opts/proto-default.d index 74d3932cf9..a659b840dc 100644 --- a/docs/cmdline-opts/proto-default.d +++ b/docs/cmdline-opts/proto-default.d @@ -3,17 +3,14 @@ Help: Use PROTOCOL for any URL missing a scheme Arg: Added: 7.45.0 Category: connection curl +Example: --proto-default https ftp.example.com --- Tells curl to use *protocol* for any URL missing a scheme name. -Example: - - curl --proto-default https ftp.mozilla.org - An unknown or unsupported protocol causes error *CURLE_UNSUPPORTED_PROTOCOL* (1). This option does not change the default proxy protocol (http). -Without this option curl would make a guess based on the host, see --url for -details. +Without this option set, curl guesses protocol based on the host name, see +--url for details. diff --git a/docs/cmdline-opts/proto-redir.d b/docs/cmdline-opts/proto-redir.d index 10580ad834..81d495dd8f 100644 --- a/docs/cmdline-opts/proto-redir.d +++ b/docs/cmdline-opts/proto-redir.d @@ -3,6 +3,7 @@ Arg: Help: Enable/disable PROTOCOLS on redirect Added: 7.20.2 Category: connection curl +Example: --proto-redir =http,https $URL --- Tells curl to limit what protocols it may use on redirect. Protocols denied by --proto are not overridden by this option. See --proto for how protocols are diff --git a/docs/cmdline-opts/proto.d b/docs/cmdline-opts/proto.d index 1e269a56ce..6ff52c4174 100644 --- a/docs/cmdline-opts/proto.d +++ b/docs/cmdline-opts/proto.d @@ -4,6 +4,7 @@ Help: Enable/disable PROTOCOLS See-also: proto-redir proto-default Added: 7.20.2 Category: connection curl +Example: --proto =http,https,sftp $URL --- Tells curl to limit what protocols it may use for transfers. Protocols are evaluated left to right, are comma separated, and are each a protocol name or diff --git a/docs/cmdline-opts/proxy-anyauth.d b/docs/cmdline-opts/proxy-anyauth.d index 6410c0e6ac..80f2b97012 100644 --- a/docs/cmdline-opts/proxy-anyauth.d +++ b/docs/cmdline-opts/proxy-anyauth.d @@ -3,6 +3,7 @@ Help: Pick any proxy authentication method Added: 7.13.2 See-also: proxy proxy-basic proxy-digest Category: proxy auth +Example: --proxy-anyauth --proxy-user user:passwd -x proxy $URL --- Tells curl to pick a suitable authentication method when communicating with the given HTTP proxy. This might cause an extra request/response round-trip. diff --git a/docs/cmdline-opts/proxy-basic.d b/docs/cmdline-opts/proxy-basic.d index e842f99001..6d38c733a0 100644 --- a/docs/cmdline-opts/proxy-basic.d +++ b/docs/cmdline-opts/proxy-basic.d @@ -2,6 +2,7 @@ Long: proxy-basic Help: Use Basic authentication on the proxy See-also: proxy proxy-anyauth proxy-digest Category: proxy auth +Example: --proxy-basic --proxy-user user:passwd -x proxy $URL --- 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 diff --git a/docs/cmdline-opts/proxy-cacert.d b/docs/cmdline-opts/proxy-cacert.d index bbc731a28f..5c32944758 100644 --- a/docs/cmdline-opts/proxy-cacert.d +++ b/docs/cmdline-opts/proxy-cacert.d @@ -4,5 +4,6 @@ Arg: Added: 7.52.0 See-also: proxy-capath cacert capath proxy Category: proxy tls +Example: --proxy-cacert CA-file.txt -x https://proxy $URL --- Same as --cacert but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-capath.d b/docs/cmdline-opts/proxy-capath.d index cc342b755e..0429984f2a 100644 --- a/docs/cmdline-opts/proxy-capath.d +++ b/docs/cmdline-opts/proxy-capath.d @@ -4,5 +4,6 @@ Arg: Added: 7.52.0 See-also: proxy-cacert proxy capath Category: proxy tls +Example: --proxy-capath /local/directory -x https://proxy $URL --- Same as --capath but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-cert-type.d b/docs/cmdline-opts/proxy-cert-type.d index fb7596c178..2152f537d6 100644 --- a/docs/cmdline-opts/proxy-cert-type.d +++ b/docs/cmdline-opts/proxy-cert-type.d @@ -3,5 +3,6 @@ Arg: Added: 7.52.0 Help: Client certificate type for HTTPS proxy Category: proxy tls +Example: --proxy-cert-type PEM --proxy-cert file -x https://proxy $URL --- Same as --cert-type but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-cert.d b/docs/cmdline-opts/proxy-cert.d index 7df2712f32..3cf54b73f3 100644 --- a/docs/cmdline-opts/proxy-cert.d +++ b/docs/cmdline-opts/proxy-cert.d @@ -3,5 +3,6 @@ Arg: Help: Set client certificate for proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-cert file -x https://proxy $URL --- Same as --cert but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-ciphers.d b/docs/cmdline-opts/proxy-ciphers.d index 3665556731..b4c3580913 100644 --- a/docs/cmdline-opts/proxy-ciphers.d +++ b/docs/cmdline-opts/proxy-ciphers.d @@ -3,5 +3,6 @@ Arg: Help: SSL ciphers to use for proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy $URL --- Same as --ciphers but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-crlfile.d b/docs/cmdline-opts/proxy-crlfile.d index 580dc50ce0..1ac199965f 100644 --- a/docs/cmdline-opts/proxy-crlfile.d +++ b/docs/cmdline-opts/proxy-crlfile.d @@ -3,5 +3,6 @@ Arg: Help: Set a CRL list for proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-crlfile rejects.txt -x https://proxy $URL --- Same as --crlfile but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-digest.d b/docs/cmdline-opts/proxy-digest.d index 52f1fcc67d..cc18702368 100644 --- a/docs/cmdline-opts/proxy-digest.d +++ b/docs/cmdline-opts/proxy-digest.d @@ -2,6 +2,7 @@ Long: proxy-digest Help: Use Digest authentication on the proxy See-also: proxy proxy-anyauth proxy-basic Category: proxy tls +Example: --proxy-digest --proxy-user user:passwd -x proxy $URL --- Tells curl to use HTTP Digest authentication when communicating with the given proxy. Use --digest for enabling HTTP Digest with a remote host. diff --git a/docs/cmdline-opts/proxy-header.d b/docs/cmdline-opts/proxy-header.d index c2b0928f98..273a773d94 100644 --- a/docs/cmdline-opts/proxy-header.d +++ b/docs/cmdline-opts/proxy-header.d @@ -4,6 +4,9 @@ Help: Pass custom header(s) to proxy Protocols: HTTP Added: 7.37.0 Category: proxy +Example: --proxy-header "X-First-Name: Joe" -x http://proxy $URL +Example: --proxy-header "User-Agent: surprise" -x http://proxy $URL +Example: --proxy-header "Host:" -x http://proxy $URL --- Extra header to include in the request when sending HTTP to a proxy. You may specify any number of extra headers. This is the equivalent option to --header diff --git a/docs/cmdline-opts/proxy-insecure.d b/docs/cmdline-opts/proxy-insecure.d index e123f40192..3f4f7c1805 100644 --- a/docs/cmdline-opts/proxy-insecure.d +++ b/docs/cmdline-opts/proxy-insecure.d @@ -2,5 +2,6 @@ Long: proxy-insecure Help: Do HTTPS proxy connections without verifying the proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-insecure -x https://proxy $URL --- Same as --insecure but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-key-type.d b/docs/cmdline-opts/proxy-key-type.d index 1906872ef6..31f47afa4a 100644 --- a/docs/cmdline-opts/proxy-key-type.d +++ b/docs/cmdline-opts/proxy-key-type.d @@ -3,5 +3,6 @@ Arg: Help: Private key file type for proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-key-type DER --proxy-key here -x https://proxy $URL --- Same as --key-type but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-key.d b/docs/cmdline-opts/proxy-key.d index 57d469f435..1b9797307a 100644 --- a/docs/cmdline-opts/proxy-key.d +++ b/docs/cmdline-opts/proxy-key.d @@ -2,5 +2,6 @@ Long: proxy-key Help: Private key for HTTPS proxy Arg: Category: proxy tls +Example: --proxy-key here -x https://proxy $URL --- Same as --key but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-negotiate.d b/docs/cmdline-opts/proxy-negotiate.d index 72f35960e9..5085a7cb3a 100644 --- a/docs/cmdline-opts/proxy-negotiate.d +++ b/docs/cmdline-opts/proxy-negotiate.d @@ -3,6 +3,7 @@ Help: Use HTTP Negotiate (SPNEGO) authentication on the proxy Added: 7.17.1 See-also: proxy-anyauth proxy-basic Category: proxy auth +Example: --proxy-negotiate --proxy-user user:passwd -x proxy $URL --- Tells curl to use HTTP Negotiate (SPNEGO) authentication when communicating with the given proxy. Use --negotiate for enabling HTTP Negotiate (SPNEGO) diff --git a/docs/cmdline-opts/proxy-ntlm.d b/docs/cmdline-opts/proxy-ntlm.d index cb1ba7b00e..074b7df855 100644 --- a/docs/cmdline-opts/proxy-ntlm.d +++ b/docs/cmdline-opts/proxy-ntlm.d @@ -2,6 +2,7 @@ Long: proxy-ntlm Help: Use NTLM authentication on the proxy See-also: proxy-negotiate proxy-anyauth Category: proxy auth +Example: --proxy-ntlm --proxy-user user:passwd -x http://proxy $URL --- Tells curl to use HTTP NTLM authentication when communicating with the given proxy. Use --ntlm for enabling NTLM with a remote host. diff --git a/docs/cmdline-opts/proxy-pass.d b/docs/cmdline-opts/proxy-pass.d index 627451bbbe..b71468413a 100644 --- a/docs/cmdline-opts/proxy-pass.d +++ b/docs/cmdline-opts/proxy-pass.d @@ -3,5 +3,6 @@ Arg: Help: Pass phrase for the private key for HTTPS proxy Added: 7.52.0 Category: proxy tls auth +Example: --proxy-pass secret --proxy-key here -x https://proxy $URL --- Same as --pass but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-pinnedpubkey.d b/docs/cmdline-opts/proxy-pinnedpubkey.d index 2ab79f19e8..b7f50a769f 100644 --- a/docs/cmdline-opts/proxy-pinnedpubkey.d +++ b/docs/cmdline-opts/proxy-pinnedpubkey.d @@ -3,6 +3,8 @@ Arg: Help: FILE/HASHES public key to verify proxy with Protocols: TLS Category: proxy tls +Example: --proxy-pinnedpubkey keyfile $URL +Example: --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' $URL --- 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 diff --git a/docs/cmdline-opts/proxy-service-name.d b/docs/cmdline-opts/proxy-service-name.d index f78072906e..fbed175700 100644 --- a/docs/cmdline-opts/proxy-service-name.d +++ b/docs/cmdline-opts/proxy-service-name.d @@ -3,5 +3,6 @@ Arg: Help: SPNEGO proxy service name Added: 7.43.0 Category: proxy tls +Example: --proxy-service-name "shrubbery" -x proxy $URL --- This option allows you to change the service name for proxy negotiation. diff --git a/docs/cmdline-opts/proxy-ssl-allow-beast.d b/docs/cmdline-opts/proxy-ssl-allow-beast.d index 138001b36b..b3e701f05a 100644 --- a/docs/cmdline-opts/proxy-ssl-allow-beast.d +++ b/docs/cmdline-opts/proxy-ssl-allow-beast.d @@ -2,5 +2,6 @@ Long: proxy-ssl-allow-beast Help: Allow security flaw for interop for HTTPS proxy Added: 7.52.0 Category: proxy tls +Example: --proxy-ssl-allow-beast -x https://proxy $URL --- Same as --ssl-allow-beast but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-ssl-auto-client-cert.d b/docs/cmdline-opts/proxy-ssl-auto-client-cert.d index 054175457f..7c071d7eca 100644 --- a/docs/cmdline-opts/proxy-ssl-auto-client-cert.d +++ b/docs/cmdline-opts/proxy-ssl-auto-client-cert.d @@ -2,5 +2,6 @@ Long: proxy-ssl-auto-client-cert Help: Use auto client certificate for proxy (Schannel) Added: 7.77.0 Category: proxy tls +Example: --proxy-ssl-auto-client-cert -x https://proxy $URL --- Same as --ssl-auto-client-cert but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-tls13-ciphers.d b/docs/cmdline-opts/proxy-tls13-ciphers.d index 9f03f135e1..62578f7f4e 100644 --- a/docs/cmdline-opts/proxy-tls13-ciphers.d +++ b/docs/cmdline-opts/proxy-tls13-ciphers.d @@ -3,6 +3,7 @@ Arg: help: TLS 1.3 proxy cipher suites Protocols: TLS Category: proxy tls +Example: --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy $URL --- 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 diff --git a/docs/cmdline-opts/proxy-tlsauthtype.d b/docs/cmdline-opts/proxy-tlsauthtype.d index 5649a0f5f9..c00928ed56 100644 --- a/docs/cmdline-opts/proxy-tlsauthtype.d +++ b/docs/cmdline-opts/proxy-tlsauthtype.d @@ -3,5 +3,6 @@ Arg: Help: TLS authentication type for HTTPS proxy Added: 7.52.0 Category: proxy tls auth +Example: --proxy-tlsauthtype SRP -x https://proxy $URL --- Same as --tlsauthtype but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-tlspassword.d b/docs/cmdline-opts/proxy-tlspassword.d index 38a33d45d4..89b551d68a 100644 --- a/docs/cmdline-opts/proxy-tlspassword.d +++ b/docs/cmdline-opts/proxy-tlspassword.d @@ -3,5 +3,6 @@ Arg: Help: TLS password for HTTPS proxy Added: 7.52.0 Category: proxy tls auth +Example: --proxy-tlspassword passwd -x https://proxy $URL --- Same as --tlspassword but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-tlsuser.d b/docs/cmdline-opts/proxy-tlsuser.d index 587f7f5106..b3c400ed5d 100644 --- a/docs/cmdline-opts/proxy-tlsuser.d +++ b/docs/cmdline-opts/proxy-tlsuser.d @@ -3,5 +3,6 @@ Arg: Help: TLS username for HTTPS proxy Added: 7.52.0 Category: proxy tls auth +Example: --proxy-tlsuser smith -x https://proxy $URL --- Same as --tlsuser but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-tlsv1.d b/docs/cmdline-opts/proxy-tlsv1.d index 5003f5f707..c54782e8f8 100644 --- a/docs/cmdline-opts/proxy-tlsv1.d +++ b/docs/cmdline-opts/proxy-tlsv1.d @@ -2,5 +2,6 @@ Long: proxy-tlsv1 Help: Use TLSv1 for HTTPS proxy Added: 7.52.0 Category: proxy tls auth +Example: --proxy-tlsv1 -x https://proxy $URL --- Same as --tlsv1 but used in HTTPS proxy context. diff --git a/docs/cmdline-opts/proxy-user.d b/docs/cmdline-opts/proxy-user.d index 82fc5170f4..81d29f2ab0 100644 --- a/docs/cmdline-opts/proxy-user.d +++ b/docs/cmdline-opts/proxy-user.d @@ -3,6 +3,7 @@ Short: U Arg: Help: Proxy user and password Category: proxy auth +Example: --proxy-user name:pwd -x proxy $URL --- Specify the user name and password to use for proxy authentication. diff --git a/docs/cmdline-opts/proxy.d b/docs/cmdline-opts/proxy.d index 0592f13ba5..81d9bc9521 100644 --- a/docs/cmdline-opts/proxy.d +++ b/docs/cmdline-opts/proxy.d @@ -3,6 +3,7 @@ Short: x Arg: [protocol://]host[:port] Help: Use this proxy Category: proxy +Example: --proxy http://proxy.example $URL --- Use the specified proxy. diff --git a/docs/cmdline-opts/proxy1.0.d b/docs/cmdline-opts/proxy1.0.d index b8a232bf74..f748345675 100644 --- a/docs/cmdline-opts/proxy1.0.d +++ b/docs/cmdline-opts/proxy1.0.d @@ -2,6 +2,7 @@ Long: proxy1.0 Arg: Help: Use HTTP/1.0 proxy on given port Category: proxy +Example: --proxy1.0 -x http://proxy $URL --- Use the specified HTTP 1.0 proxy. If the port number is not specified, it is assumed at port 1080. diff --git a/docs/cmdline-opts/proxytunnel.d b/docs/cmdline-opts/proxytunnel.d index 94dae992f0..712c755a87 100644 --- a/docs/cmdline-opts/proxytunnel.d +++ b/docs/cmdline-opts/proxytunnel.d @@ -3,6 +3,7 @@ Short: p Help: Operate through an HTTP proxy tunnel (using CONNECT) See-also: proxy Category: proxy +Example: --proxytunnel -x http://proxy $URL --- 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 diff --git a/docs/cmdline-opts/pubkey.d b/docs/cmdline-opts/pubkey.d index 692daf6b07..c1fb5d8ef3 100644 --- a/docs/cmdline-opts/pubkey.d +++ b/docs/cmdline-opts/pubkey.d @@ -3,6 +3,7 @@ Arg: Protocols: SFTP SCP Help: SSH Public key file name Category: sftp scp auth +Example: --pubkey file.pub sftp://example.com/ --- Public key file name. Allows you to provide your public key in this separate file. diff --git a/docs/cmdline-opts/quote.d b/docs/cmdline-opts/quote.d index 3adb06f8a8..2707c87dd7 100644 --- a/docs/cmdline-opts/quote.d +++ b/docs/cmdline-opts/quote.d @@ -4,6 +4,7 @@ Short: Q Help: Send command(s) to server before transfer Protocols: FTP SFTP Category: ftp sftp +Example: --quote "DELE file" ftp://example.com/foo --- 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 diff --git a/docs/cmdline-opts/random-file.d b/docs/cmdline-opts/random-file.d index c57f52364e..a207c1e1ba 100644 --- a/docs/cmdline-opts/random-file.d +++ b/docs/cmdline-opts/random-file.d @@ -2,6 +2,7 @@ Long: random-file Arg: Help: File for reading random data from Category: misc +Example: --random-file rubbish $URL --- 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 diff --git a/docs/cmdline-opts/range.d b/docs/cmdline-opts/range.d index e2d1f62fcb..0637f8fc2b 100644 --- a/docs/cmdline-opts/range.d +++ b/docs/cmdline-opts/range.d @@ -4,6 +4,7 @@ Help: Retrieve only the bytes within RANGE Arg: Protocols: HTTP FTP SFTP FILE Category: http ftp sftp file +Example: --range 22-44 $URL --- 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. diff --git a/docs/cmdline-opts/raw.d b/docs/cmdline-opts/raw.d index 90e777263b..c44d33f5cc 100644 --- a/docs/cmdline-opts/raw.d +++ b/docs/cmdline-opts/raw.d @@ -3,6 +3,7 @@ Help: Do HTTP "raw"; no transfer decoding Added: 7.16.2 Protocols: HTTP Category: http +Example: --raw $URL --- When used, it disables all internal HTTP decoding of content or transfer encodings and instead makes them passed on unaltered, raw. diff --git a/docs/cmdline-opts/referer.d b/docs/cmdline-opts/referer.d index 8b2057b940..3f6b7c7e12 100644 --- a/docs/cmdline-opts/referer.d +++ b/docs/cmdline-opts/referer.d @@ -5,6 +5,9 @@ Protocols: HTTP Help: Referrer URL See-also: user-agent header Category: http +Example: --referer "https://fake.example" $URL +Example: --referer "https://fake.example;auto" -L $URL +Example: --referer ";auto" -L $URL --- 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 diff --git a/docs/cmdline-opts/remote-header-name.d b/docs/cmdline-opts/remote-header-name.d index 325dade3f0..6e0b98bd1f 100644 --- a/docs/cmdline-opts/remote-header-name.d +++ b/docs/cmdline-opts/remote-header-name.d @@ -3,6 +3,7 @@ Short: J Protocols: HTTP Help: Use the header-provided filename Category: output +Example: -OJ https://example.com/file --- This option tells the --remote-name option to use the server-specified Content-Disposition filename instead of extracting a filename from the URL. diff --git a/docs/cmdline-opts/remote-name-all.d b/docs/cmdline-opts/remote-name-all.d index 299684c51d..e27bd5f48d 100644 --- a/docs/cmdline-opts/remote-name-all.d +++ b/docs/cmdline-opts/remote-name-all.d @@ -2,6 +2,7 @@ Long: remote-name-all Help: Use the remote file name for all URLs Added: 7.19.0 Category: output +Example: --remote-name-all ftp://example.com/file1 ftp://example.com/file2 --- This option changes the default action for all given URLs to be dealt with as if --remote-name were used for each one. So if you want to disable that for a diff --git a/docs/cmdline-opts/remote-name.d b/docs/cmdline-opts/remote-name.d index 184c32e476..68928794b5 100644 --- a/docs/cmdline-opts/remote-name.d +++ b/docs/cmdline-opts/remote-name.d @@ -2,6 +2,7 @@ Long: remote-name Short: O Help: Write output to a file named as the remote file Category: important output +Example: -O https://example.com/filename --- 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.) diff --git a/docs/cmdline-opts/remote-time.d b/docs/cmdline-opts/remote-time.d index 96fb4fbe99..9c463ae819 100644 --- a/docs/cmdline-opts/remote-time.d +++ b/docs/cmdline-opts/remote-time.d @@ -2,6 +2,7 @@ Long: remote-time Short: R Help: Set the remote file's time on the local output Category: output +Example: --remote-time -o foo $URL --- 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 diff --git a/docs/cmdline-opts/request-target.d b/docs/cmdline-opts/request-target.d index 4422611b13..5f9e475514 100644 --- a/docs/cmdline-opts/request-target.d +++ b/docs/cmdline-opts/request-target.d @@ -4,6 +4,7 @@ Help: Specify the target for this request Protocols: HTTP Added: 7.55.0 Category: http +Example: --request-target "*" -X OPTIONS $URL --- Tells curl to use an alternative "target" (path) instead of using the path as provided in the URL. Particularly useful when wanting to issue HTTP requests diff --git a/docs/cmdline-opts/request.d b/docs/cmdline-opts/request.d index 47c4c8b049..0db0bc9f77 100644 --- a/docs/cmdline-opts/request.d +++ b/docs/cmdline-opts/request.d @@ -3,6 +3,8 @@ Short: X Arg: Help: Specify request command to use Category: connection +Example: -X "DELETE" $URL +Example: -X NLST ftp://example.com/ --- (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 diff --git a/docs/cmdline-opts/resolve.d b/docs/cmdline-opts/resolve.d index ff10f28d96..6464c42fb5 100644 --- a/docs/cmdline-opts/resolve.d +++ b/docs/cmdline-opts/resolve.d @@ -3,6 +3,7 @@ Arg: <[+]host:port:addr[,addr]...> Help: Resolve the host+port to this address Added: 7.21.3 Category: connection +Example: --resolve example.com:443:127.0.0.1 $URL --- Provide a custom address for a specific host and port pair. Using this, you can make the curl requests(s) use a specified address and prevent the diff --git a/docs/cmdline-opts/retry-all-errors.d b/docs/cmdline-opts/retry-all-errors.d index 5ad1da0dec..5cab5ddaaf 100644 --- a/docs/cmdline-opts/retry-all-errors.d +++ b/docs/cmdline-opts/retry-all-errors.d @@ -2,6 +2,7 @@ Long: retry-all-errors Help: Retry all errors (use with --retry) Added: 7.71.0 Category: curl +Example: --retry-all-errors $URL --- Retry on any error. This option is used together with --retry. @@ -11,13 +12,14 @@ receiving duplicate data. Do not use with redirected input or output. You'd be much better off handling your unique problems in shell script. Please read the example below. -Warning: For server compatibility curl attempts to retry failed flaky transfers -as close as possible to how they were started, but this is not possible with -redirected input or output. For example, before retrying it removes output data -from a failed partial transfer that was written to an output file. However this -is not true of data redirected to a | pipe or > file, which are not reset. We -strongly suggest don't parse or record output via redirect in combination with -this option, since you may receive duplicate data. +**WARNING**: For server compatibility curl attempts to retry failed flaky +transfers as close as possible to how they were started, but this is not +possible with redirected input or output. For example, before retrying it +removes output data from a failed partial transfer that was written to an +output file. However this is not true of data redirected to a | pipe or > +file, which are not reset. We strongly suggest don't parse or record output +via redirect in combination with this option, since you may receive duplicate +data. By default curl will not error on an HTTP response code that indicates an HTTP error, if the transfer was successful. For example, if a server replies 404 diff --git a/docs/cmdline-opts/retry-connrefused.d b/docs/cmdline-opts/retry-connrefused.d index be34f973d5..ad079e0962 100644 --- a/docs/cmdline-opts/retry-connrefused.d +++ b/docs/cmdline-opts/retry-connrefused.d @@ -2,6 +2,7 @@ Long: retry-connrefused Help: Retry on connection refused (use with --retry) Added: 7.52.0 Category: curl +Example: --retry-connrefused --retry $URL --- In addition to the other conditions, consider ECONNREFUSED as a transient error too for --retry. This option is used together with --retry. diff --git a/docs/cmdline-opts/retry-delay.d b/docs/cmdline-opts/retry-delay.d index 5645c0e6a5..2839129044 100644 --- a/docs/cmdline-opts/retry-delay.d +++ b/docs/cmdline-opts/retry-delay.d @@ -3,6 +3,7 @@ Arg: Help: Wait time between retries Added: 7.12.3 Category: curl +Example: --retry-delay 5 --retry $URL --- Make curl sleep this amount of time before each retry when a transfer has failed with a transient error (it changes the default backoff time algorithm diff --git a/docs/cmdline-opts/retry-max-time.d b/docs/cmdline-opts/retry-max-time.d index 9d6faf3041..acccff5d41 100644 --- a/docs/cmdline-opts/retry-max-time.d +++ b/docs/cmdline-opts/retry-max-time.d @@ -3,6 +3,7 @@ Arg: Help: Retry only within this period Added: 7.12.3 Category: curl +Example: --retry-max-time 30 --retry 10 $URL --- The retry timer is reset before the first transfer attempt. Retries will be done as usual (see --retry) as long as the timer hasn't reached this given diff --git a/docs/cmdline-opts/retry.d b/docs/cmdline-opts/retry.d index bff0ef2269..6238383fe3 100644 --- a/docs/cmdline-opts/retry.d +++ b/docs/cmdline-opts/retry.d @@ -3,6 +3,7 @@ Arg: Added: 7.12.3 Help: Retry request if transient problems occur Category: curl +Example: --retry 7 $URL --- If a transient error is returned when curl tries to perform a transfer, it will retry this number of times before giving up. Setting the number to 0 diff --git a/docs/cmdline-opts/sasl-authzid.d b/docs/cmdline-opts/sasl-authzid.d index e802c80a16..9065bd5ecb 100644 --- a/docs/cmdline-opts/sasl-authzid.d +++ b/docs/cmdline-opts/sasl-authzid.d @@ -3,6 +3,7 @@ Arg: Help: Identity for SASL PLAIN authentication Added: 7.66.0 Category: auth +Example: --sasl-authzid zid imap://example.com/ --- Use this authorisation identity (authzid), during SASL PLAIN authentication, in addition to the authentication identity (authcid) as specified by --user. diff --git a/docs/cmdline-opts/sasl-ir.d b/docs/cmdline-opts/sasl-ir.d index 0041c3b4e7..5004306a4a 100644 --- a/docs/cmdline-opts/sasl-ir.d +++ b/docs/cmdline-opts/sasl-ir.d @@ -2,5 +2,6 @@ Long: sasl-ir Help: Enable initial response in SASL authentication Added: 7.31.0 Category: auth +Example: --sasl-ir imap://example.com/ --- Enable initial response in SASL authentication. diff --git a/docs/cmdline-opts/service-name.d b/docs/cmdline-opts/service-name.d index c64496b858..3a5559bc86 100644 --- a/docs/cmdline-opts/service-name.d +++ b/docs/cmdline-opts/service-name.d @@ -3,6 +3,7 @@ Help: SPNEGO service name Arg: Added: 7.43.0 Category: misc +Example: --service-name sockd/server $URL --- This option allows you to change the service name for SPNEGO. diff --git a/docs/cmdline-opts/show-error.d b/docs/cmdline-opts/show-error.d index 258949a500..e8b2177129 100644 --- a/docs/cmdline-opts/show-error.d +++ b/docs/cmdline-opts/show-error.d @@ -3,6 +3,7 @@ Short: S Help: Show error even when -s is used See-also: no-progress-meter Category: curl +Example: --show-error --silent $URL --- When used with --silent, it makes curl show an error message if it fails. diff --git a/docs/cmdline-opts/silent.d b/docs/cmdline-opts/silent.d index 58a522335e..7122c542eb 100644 --- a/docs/cmdline-opts/silent.d +++ b/docs/cmdline-opts/silent.d @@ -3,6 +3,7 @@ Short: s Help: Silent mode See-also: verbose stderr no-progress-meter Category: important verbose +Example: -s $URL --- 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 diff --git a/docs/cmdline-opts/socks4.d b/docs/cmdline-opts/socks4.d index 3cfb2540c0..1cae1e1fce 100644 --- a/docs/cmdline-opts/socks4.d +++ b/docs/cmdline-opts/socks4.d @@ -3,6 +3,7 @@ Arg: Help: SOCKS4 proxy on given host + port Added: 7.15.2 Category: proxy +Example: --socks4 hostname:4096 $URL --- Use the specified SOCKS4 proxy. If the port number is not specified, it is assumed at port 1080. Using this socket type make curl resolve the host name diff --git a/docs/cmdline-opts/socks4a.d b/docs/cmdline-opts/socks4a.d index d820566a1a..8edefdd1b6 100644 --- a/docs/cmdline-opts/socks4a.d +++ b/docs/cmdline-opts/socks4a.d @@ -3,6 +3,7 @@ Arg: Help: SOCKS4a proxy on given host + port Added: 7.18.0 Category: proxy +Example: --socks4a hostname:4096 $URL --- Use the specified SOCKS4a proxy. If the port number is not specified, it is assumed at port 1080. This asks the proxy to resolve the host name. diff --git a/docs/cmdline-opts/socks5-basic.d b/docs/cmdline-opts/socks5-basic.d index 52d1e66194..f32e0bf3ea 100644 --- a/docs/cmdline-opts/socks5-basic.d +++ b/docs/cmdline-opts/socks5-basic.d @@ -2,6 +2,7 @@ Long: socks5-basic Help: Enable username/password auth for SOCKS5 proxies Added: 7.55.0 Category: proxy auth +Example: --socks5-basic --socks5 hostname:4096 $URL --- Tells curl to use username/password authentication when connecting to a SOCKS5 proxy. The username/password authentication is enabled by default. Use diff --git a/docs/cmdline-opts/socks5-gssapi-nec.d b/docs/cmdline-opts/socks5-gssapi-nec.d index b538f33f36..73cac7a226 100644 --- a/docs/cmdline-opts/socks5-gssapi-nec.d +++ b/docs/cmdline-opts/socks5-gssapi-nec.d @@ -2,6 +2,7 @@ Long: socks5-gssapi-nec Help: Compatibility with NEC SOCKS5 server Added: 7.19.4 Category: proxy auth +Example: --socks5-gssapi-nec --socks5 hostname:4096 $URL --- As part of the GSS-API negotiation a protection mode is negotiated. RFC 1961 says in section 4.3/4.4 it should be protected, but the NEC reference diff --git a/docs/cmdline-opts/socks5-gssapi-service.d b/docs/cmdline-opts/socks5-gssapi-service.d index e61d0f5ab3..451be8e2d1 100644 --- a/docs/cmdline-opts/socks5-gssapi-service.d +++ b/docs/cmdline-opts/socks5-gssapi-service.d @@ -3,6 +3,7 @@ Arg: Help: SOCKS5 proxy service name for GSS-API Added: 7.19.4 Category: proxy auth +Example: --socks5-gssapi-service sockd --socks5 hostname:4096 $URL --- The default service name for a socks server is rcmd/server-fqdn. This option allows you to change it. diff --git a/docs/cmdline-opts/socks5-gssapi.d b/docs/cmdline-opts/socks5-gssapi.d index 72ae7aeb2b..2ce806955b 100644 --- a/docs/cmdline-opts/socks5-gssapi.d +++ b/docs/cmdline-opts/socks5-gssapi.d @@ -2,6 +2,7 @@ Long: socks5-gssapi Help: Enable GSS-API auth for SOCKS5 proxies Added: 7.55.0 Category: proxy auth +Example: --socks5-gssapi --socks5 hostname:4096 $URL --- Tells curl to use GSS-API authentication when connecting to a SOCKS5 proxy. The GSS-API authentication is enabled by default (if curl is compiled with diff --git a/docs/cmdline-opts/socks5-hostname.d b/docs/cmdline-opts/socks5-hostname.d index 247d7660e7..729a7bf859 100644 --- a/docs/cmdline-opts/socks5-hostname.d +++ b/docs/cmdline-opts/socks5-hostname.d @@ -3,6 +3,7 @@ Arg: Help: SOCKS5 proxy, pass host name to proxy Added: 7.18.0 Category: proxy +Example: --socks5-hostname proxy.example:7000 $URL --- Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If the port number is not specified, it is assumed at port 1080. diff --git a/docs/cmdline-opts/socks5.d b/docs/cmdline-opts/socks5.d index bbe92f0a10..99c740f885 100644 --- a/docs/cmdline-opts/socks5.d +++ b/docs/cmdline-opts/socks5.d @@ -3,6 +3,7 @@ Arg: Help: SOCKS5 proxy on given host + port Added: 7.18.0 Category: proxy +Example: --socks5 proxy.example:7000 $URL --- Use the specified SOCKS5 proxy - but resolve the host name locally. If the port number is not specified, it is assumed at port 1080. diff --git a/docs/cmdline-opts/speed-limit.d b/docs/cmdline-opts/speed-limit.d index 3f9ad3a46e..7bf8d5fb1b 100644 --- a/docs/cmdline-opts/speed-limit.d +++ b/docs/cmdline-opts/speed-limit.d @@ -3,6 +3,7 @@ Short: Y Arg: Help: Stop transfers slower than this Category: connection +Example: --speed-limit 300 --speed-time 10 $URL --- 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 diff --git a/docs/cmdline-opts/speed-time.d b/docs/cmdline-opts/speed-time.d index 81acabec46..6095214564 100644 --- a/docs/cmdline-opts/speed-time.d +++ b/docs/cmdline-opts/speed-time.d @@ -3,6 +3,7 @@ Short: y Arg: Help: Trigger 'speed-limit' abort after this time Category: connection +Example: --speed-limit 300 --speed-time 10 $URL --- 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 diff --git a/docs/cmdline-opts/ssl-allow-beast.d b/docs/cmdline-opts/ssl-allow-beast.d index f18fe74704..f54cf6416f 100644 --- a/docs/cmdline-opts/ssl-allow-beast.d +++ b/docs/cmdline-opts/ssl-allow-beast.d @@ -2,9 +2,12 @@ Long: ssl-allow-beast Help: Allow security flaw to improve interop Added: 7.25.0 Category: tls +Example: --ssl-allow-beast $URL --- This option tells curl to not work around a security flaw in the SSL3 and TLS1.0 protocols known as BEAST. If this option isn't used, the SSL layer may use workarounds known to cause interoperability problems with some older SSL -implementations. WARNING: this option loosens the SSL security, and by using -this flag you ask for exactly that. +implementations. + +**WARNING**: this option loosens the SSL security, and by using this flag you +ask for exactly that. diff --git a/docs/cmdline-opts/ssl-auto-client-cert.d b/docs/cmdline-opts/ssl-auto-client-cert.d index 16108aef13..7581bdff68 100644 --- a/docs/cmdline-opts/ssl-auto-client-cert.d +++ b/docs/cmdline-opts/ssl-auto-client-cert.d @@ -3,6 +3,7 @@ Help: Use auto client certificate (Schannel) Added: 7.77.0 See-also: proxy-ssl-auto-client-cert Category: tls +Example: --ssl-auto-client-cert $URL --- Tell libcurl to automatically locate and use a client certificate for authentication, when requested by the server. This option is only supported diff --git a/docs/cmdline-opts/ssl-no-revoke.d b/docs/cmdline-opts/ssl-no-revoke.d index 3b1614243e..dde77aa113 100644 --- a/docs/cmdline-opts/ssl-no-revoke.d +++ b/docs/cmdline-opts/ssl-no-revoke.d @@ -2,6 +2,7 @@ Long: ssl-no-revoke Help: Disable cert revocation checks (Schannel) Added: 7.44.0 Category: tls +Example: --ssl-no-revoke $URL --- (Schannel) This option tells curl to disable certificate revocation checks. WARNING: this option loosens the SSL security, and by using this flag you ask diff --git a/docs/cmdline-opts/ssl-reqd.d b/docs/cmdline-opts/ssl-reqd.d index 2e573e39d1..489be00d97 100644 --- a/docs/cmdline-opts/ssl-reqd.d +++ b/docs/cmdline-opts/ssl-reqd.d @@ -3,6 +3,7 @@ Help: Require SSL/TLS Protocols: FTP IMAP POP3 SMTP Added: 7.20.0 Category: tls +Example: --ssl-reqd ftp://example.com --- Require SSL/TLS for the connection. Terminates the connection if the server doesn't support SSL/TLS. diff --git a/docs/cmdline-opts/ssl-revoke-best-effort.d b/docs/cmdline-opts/ssl-revoke-best-effort.d index af22da4611..2db32192ee 100644 --- a/docs/cmdline-opts/ssl-revoke-best-effort.d +++ b/docs/cmdline-opts/ssl-revoke-best-effort.d @@ -2,6 +2,7 @@ Long: ssl-revoke-best-effort Help: Ignore missing/offline cert CRL dist points Added: 7.70.0 Category: tls +Example: --ssl-revoke-best-effort $URL --- (Schannel) This option tells curl to ignore certificate revocation checks when they failed due to missing/offline distribution points for the revocation check diff --git a/docs/cmdline-opts/ssl.d b/docs/cmdline-opts/ssl.d index 39616bc2ab..bc339faed3 100644 --- a/docs/cmdline-opts/ssl.d +++ b/docs/cmdline-opts/ssl.d @@ -3,6 +3,7 @@ Help: Try SSL/TLS Protocols: FTP IMAP POP3 SMTP Added: 7.20.0 Category: tls +Example: --ssl pop3://example.com/ --- Try to use SSL/TLS for the connection. Reverts to a non-secure connection if the server doesn't support SSL/TLS. See also --ftp-ssl-control and --ssl-reqd diff --git a/docs/cmdline-opts/sslv2.d b/docs/cmdline-opts/sslv2.d index f9ee99d0d0..d96a6cc8d8 100644 --- a/docs/cmdline-opts/sslv2.d +++ b/docs/cmdline-opts/sslv2.d @@ -8,6 +8,8 @@ Requires: TLS See-also: http1.1 http2 Help: Use SSLv2 Category: tls +Example: --sslv2 $URL --- -This option previously asked curl to use SSLv2, but starting in curl 7.77.0 this -instruction is ignored. SSLv2 is widely considered insecure (see RFC 6176). +This option previously asked curl to use SSLv2, but starting in curl 7.77.0 +this instruction is ignored. SSLv2 is widely considered insecure (see RFC +6176). diff --git a/docs/cmdline-opts/sslv3.d b/docs/cmdline-opts/sslv3.d index e8b2c35e87..3ee483d2ae 100644 --- a/docs/cmdline-opts/sslv3.d +++ b/docs/cmdline-opts/sslv3.d @@ -8,6 +8,7 @@ Requires: TLS See-also: http1.1 http2 Help: Use SSLv3 Category: tls +Example: --sslv3 $URL --- This option previously asked curl to use SSLv3, but starting in curl 7.77.0 this instruction is ignored. SSLv3 is widely considered insecure (see RFC diff --git a/docs/cmdline-opts/stderr.d b/docs/cmdline-opts/stderr.d index 737df6393a..c0f0efa38b 100644 --- a/docs/cmdline-opts/stderr.d +++ b/docs/cmdline-opts/stderr.d @@ -3,6 +3,7 @@ Arg: Help: Where to redirect stderr See-also: verbose silent Category: verbose +Example: --stderr output.txt $URL --- Redirect all writes to stderr to the specified file instead. If the file name is a plain '-', it is instead written to stdout. diff --git a/docs/cmdline-opts/styled-output.d b/docs/cmdline-opts/styled-output.d index 91d36eca7a..bf636019a6 100644 --- a/docs/cmdline-opts/styled-output.d +++ b/docs/cmdline-opts/styled-output.d @@ -2,6 +2,7 @@ Long: styled-output Help: Enable styled output for HTTP headers Added: 7.61.0 Category: verbose +Example: --styled-output -I $URL --- Enables the automatic use of bold font styles when writing HTTP headers to the terminal. Use --no-styled-output to switch them off. diff --git a/docs/cmdline-opts/suppress-connect-headers.d b/docs/cmdline-opts/suppress-connect-headers.d index b4e2a17db1..71078e8877 100644 --- a/docs/cmdline-opts/suppress-connect-headers.d +++ b/docs/cmdline-opts/suppress-connect-headers.d @@ -2,6 +2,7 @@ Long: suppress-connect-headers Help: Suppress proxy CONNECT response headers See-also: dump-header include proxytunnel Category: proxy +Example: --suppress-connect-headers --include -x proxy $URL --- 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 diff --git a/docs/cmdline-opts/tcp-fastopen.d b/docs/cmdline-opts/tcp-fastopen.d index faef499f3e..e7e9d2e9af 100644 --- a/docs/cmdline-opts/tcp-fastopen.d +++ b/docs/cmdline-opts/tcp-fastopen.d @@ -2,5 +2,6 @@ Long: tcp-fastopen Added: 7.49.0 Help: Use TCP Fast Open Category: connection +Example: --tcp-fastopen $URL --- Enable use of TCP Fast Open (RFC7413). diff --git a/docs/cmdline-opts/tcp-nodelay.d b/docs/cmdline-opts/tcp-nodelay.d index 90483d2e40..97cd30aa0e 100644 --- a/docs/cmdline-opts/tcp-nodelay.d +++ b/docs/cmdline-opts/tcp-nodelay.d @@ -2,6 +2,7 @@ Long: tcp-nodelay Help: Use the TCP_NODELAY option Added: 7.11.2 Category: connection +Example: --tcp-nodelay $URL --- Turn on the TCP_NODELAY option. See the *curl_easy_setopt(3)* man page for details about this option. diff --git a/docs/cmdline-opts/telnet-option.d b/docs/cmdline-opts/telnet-option.d index 789de3ea1f..3475cb596c 100644 --- a/docs/cmdline-opts/telnet-option.d +++ b/docs/cmdline-opts/telnet-option.d @@ -3,6 +3,7 @@ Short: t Arg: Help: Set telnet option Category: telnet +Example: -t TTYPE=vt100 telnet://example.com/ --- Pass options to the telnet protocol. Supported options are: diff --git a/docs/cmdline-opts/tftp-blksize.d b/docs/cmdline-opts/tftp-blksize.d index 6e67ed2e11..3b19e5cf78 100644 --- a/docs/cmdline-opts/tftp-blksize.d +++ b/docs/cmdline-opts/tftp-blksize.d @@ -4,6 +4,7 @@ Help: Set TFTP BLKSIZE option Protocols: TFTP Added: 7.20.0 Category: tftp +Example: --tftp-blksize 1024 tftp://example.com/file --- Set TFTP BLKSIZE option (must be >512). This is the block size that curl will try to use when transferring data to or from a TFTP server. By default 512 diff --git a/docs/cmdline-opts/tftp-no-options.d b/docs/cmdline-opts/tftp-no-options.d index 023327301f..9ff334b868 100644 --- a/docs/cmdline-opts/tftp-no-options.d +++ b/docs/cmdline-opts/tftp-no-options.d @@ -3,6 +3,7 @@ Help: Do not send any TFTP options Protocols: TFTP Added: 7.48.0 Category: tftp +Example: --tftp-no-options tftp://192.168.0.1/ --- Tells curl not to send TFTP options requests. diff --git a/docs/cmdline-opts/time-cond.d b/docs/cmdline-opts/time-cond.d index 0b56c6ee39..f82f497fc0 100644 --- a/docs/cmdline-opts/time-cond.d +++ b/docs/cmdline-opts/time-cond.d @@ -4,6 +4,9 @@ Arg: