docs: use .example URLs for proxies

This commit is contained in:
Daniel Stenberg 2025-12-05 13:33:02 +01:00
parent 0b69c47131
commit 58394b1c8c
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
34 changed files with 34 additions and 34 deletions

View File

@ -14,7 +14,7 @@ See-also:
- dump-ca-embed
- proxy
Example:
- --proxy-cacert CA-file.txt -x https://proxy $URL
- --proxy-cacert CA-file.txt -x https://proxy.example $URL
---
# `--proxy-cacert`

View File

@ -13,7 +13,7 @@ See-also:
- capath
- dump-ca-embed
Example:
- --proxy-capath /local/directory -x https://proxy $URL
- --proxy-capath /local/directory -x https://proxy.example $URL
---
# `--proxy-capath`

View File

@ -11,7 +11,7 @@ See-also:
- proxy-cert
- proxy-key
Example:
- --proxy-cert-type PEM --proxy-cert file -x https://proxy $URL
- --proxy-cert-type PEM --proxy-cert file -x https://proxy.example $URL
---
# `--proxy-cert-type`

View File

@ -12,7 +12,7 @@ See-also:
- proxy-key
- proxy-cert-type
Example:
- --proxy-cert file -x https://proxy $URL
- --proxy-cert file -x https://proxy.example $URL
---
# `--proxy-cert`

View File

@ -13,7 +13,7 @@ See-also:
- ciphers
- proxy
Example:
- --proxy-ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256 -x https://proxy $URL
- --proxy-ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256 -x https://proxy.example $URL
---
# `--proxy-ciphers`

View File

@ -11,7 +11,7 @@ See-also:
- crlfile
- proxy
Example:
- --proxy-crlfile rejects.txt -x https://proxy $URL
- --proxy-crlfile rejects.txt -x https://proxy.example $URL
---
# `--proxy-crlfile`

View File

@ -10,7 +10,7 @@ See-also:
- proxy
- insecure
Example:
- --proxy-insecure -x https://proxy $URL
- --proxy-insecure -x https://proxy.example $URL
---
# `--proxy-insecure`

View File

@ -11,7 +11,7 @@ See-also:
- proxy-key
- proxy
Example:
- --proxy-key-type DER --proxy-key here -x https://proxy $URL
- --proxy-key-type DER --proxy-key here -x https://proxy.example $URL
---
# `--proxy-key-type`

View File

@ -11,7 +11,7 @@ See-also:
- proxy-key-type
- proxy
Example:
- --proxy-key here -x https://proxy $URL
- --proxy-key here -x https://proxy.example $URL
---
# `--proxy-key`

View File

@ -11,7 +11,7 @@ See-also:
- proxy
- proxy-key
Example:
- --proxy-pass secret --proxy-key here -x https://proxy $URL
- --proxy-pass secret --proxy-key here -x https://proxy.example $URL
---
# `--proxy-pass`

View File

@ -10,7 +10,7 @@ See-also:
- ssl-allow-beast
- proxy
Example:
- --proxy-ssl-allow-beast -x https://proxy $URL
- --proxy-ssl-allow-beast -x https://proxy.example $URL
---
# `--proxy-ssl-allow-beast`

View File

@ -10,7 +10,7 @@ See-also:
- ssl-auto-client-cert
- proxy
Example:
- --proxy-ssl-auto-client-cert -x https://proxy $URL
- --proxy-ssl-auto-client-cert -x https://proxy.example $URL
---
# `--proxy-ssl-auto-client-cert`

View File

@ -12,7 +12,7 @@ See-also:
- proxy-tlsuser
- proxy-tlspassword
Example:
- --proxy-tlsauthtype SRP -x https://proxy $URL
- --proxy-tlsauthtype SRP -x https://proxy.example $URL
---
# `--proxy-tlsauthtype`

View File

@ -11,7 +11,7 @@ See-also:
- proxy
- proxy-tlsuser
Example:
- --proxy-tlspassword passwd -x https://proxy $URL
- --proxy-tlspassword passwd -x https://proxy.example $URL
---
# `--proxy-tlspassword`

View File

@ -11,7 +11,7 @@ See-also:
- proxy
- proxy-tlspassword
Example:
- --proxy-tlsuser smith -x https://proxy $URL
- --proxy-tlsuser smith -x https://proxy.example $URL
---
# `--proxy-tlsuser`

View File

@ -9,7 +9,7 @@ Multi: mutex
See-also:
- proxy
Example:
- --proxy-tlsv1 -x https://proxy $URL
- --proxy-tlsv1 -x https://proxy.example $URL
---
# `--proxy-tlsv1`

View File

@ -50,7 +50,7 @@ int main(void)
long verifyresult;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
res = curl_easy_perform(curl);
if(res) {

View File

@ -72,7 +72,7 @@ int main(void)
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO, "/etc/certs/cabundle.pem");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);

View File

@ -73,7 +73,7 @@ int main(void)
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
blob.data = strpem;
blob.len = strlen(strpem);
blob.flags = CURL_BLOB_COPY;

View File

@ -64,7 +64,7 @@ int main(void)
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
curl_easy_setopt(curl, CURLOPT_PROXY_CAPATH, "/etc/cert-dir");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);

View File

@ -70,7 +70,7 @@ int main(void)
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
curl_easy_setopt(curl, CURLOPT_PROXY_ISSUERCERT, "/etc/certs/cacert.pem");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);

View File

@ -77,7 +77,7 @@ int main(void)
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;

View File

@ -61,7 +61,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "superman");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);

View File

@ -67,7 +67,7 @@ int main(void)
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example:443");
curl_easy_setopt(curl, CURLOPT_PROXY_PINNEDPUBLICKEY,
"sha256//YhKJKSzoTt2b5FP18fvpHo7fJYqQCjA"
"a3HWY3tvRMwE=;sha256//t62CeU2tQiqkexU74"

View File

@ -64,7 +64,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");

View File

@ -60,7 +60,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERTTYPE, "PEM");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");

View File

@ -68,7 +68,7 @@ int main(void)
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT_BLOB, &blob);

View File

@ -64,7 +64,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");

View File

@ -53,7 +53,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEYTYPE, "PEM");

View File

@ -62,7 +62,7 @@ int main(void)
CURLcode res;
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;

View File

@ -106,7 +106,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
/* weaken TLS only for use with silly proxies */
curl_easy_setopt(curl, CURLOPT_PROXY_SSL_OPTIONS,
CURLSSLOPT_ALLOW_BEAST | CURLSSLOPT_NO_REVOKE);

View File

@ -58,7 +58,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");

View File

@ -65,7 +65,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");

View File

@ -58,7 +58,7 @@ int main(void)
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");