]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
docs: use .example URLs for proxies
authorDaniel Stenberg <daniel@haxx.se>
Fri, 5 Dec 2025 12:33:02 +0000 (13:33 +0100)
committerDaniel Stenberg <daniel@haxx.se>
Fri, 5 Dec 2025 22:41:41 +0000 (23:41 +0100)
34 files changed:
docs/cmdline-opts/proxy-cacert.md
docs/cmdline-opts/proxy-capath.md
docs/cmdline-opts/proxy-cert-type.md
docs/cmdline-opts/proxy-cert.md
docs/cmdline-opts/proxy-ciphers.md
docs/cmdline-opts/proxy-crlfile.md
docs/cmdline-opts/proxy-insecure.md
docs/cmdline-opts/proxy-key-type.md
docs/cmdline-opts/proxy-key.md
docs/cmdline-opts/proxy-pass.md
docs/cmdline-opts/proxy-ssl-allow-beast.md
docs/cmdline-opts/proxy-ssl-auto-client-cert.md
docs/cmdline-opts/proxy-tlsauthtype.md
docs/cmdline-opts/proxy-tlspassword.md
docs/cmdline-opts/proxy-tlsuser.md
docs/cmdline-opts/proxy-tlsv1.md
docs/libcurl/opts/CURLINFO_PROXY_SSL_VERIFYRESULT.md
docs/libcurl/opts/CURLOPT_PROXY_CAINFO.md
docs/libcurl/opts/CURLOPT_PROXY_CAINFO_BLOB.md
docs/libcurl/opts/CURLOPT_PROXY_CAPATH.md
docs/libcurl/opts/CURLOPT_PROXY_ISSUERCERT.md
docs/libcurl/opts/CURLOPT_PROXY_ISSUERCERT_BLOB.md
docs/libcurl/opts/CURLOPT_PROXY_KEYPASSWD.md
docs/libcurl/opts/CURLOPT_PROXY_PINNEDPUBLICKEY.md
docs/libcurl/opts/CURLOPT_PROXY_SSLCERT.md
docs/libcurl/opts/CURLOPT_PROXY_SSLCERTTYPE.md
docs/libcurl/opts/CURLOPT_PROXY_SSLCERT_BLOB.md
docs/libcurl/opts/CURLOPT_PROXY_SSLKEY.md
docs/libcurl/opts/CURLOPT_PROXY_SSLKEYTYPE.md
docs/libcurl/opts/CURLOPT_PROXY_SSLKEY_BLOB.md
docs/libcurl/opts/CURLOPT_PROXY_SSL_OPTIONS.md
docs/libcurl/opts/CURLOPT_PROXY_TLSAUTH_PASSWORD.md
docs/libcurl/opts/CURLOPT_PROXY_TLSAUTH_TYPE.md
docs/libcurl/opts/CURLOPT_PROXY_TLSAUTH_USERNAME.md

index 682349a7e26011c9a623c0bf3b6cd804c43b6099..0b2405d1c96aa4fb29720f4a384b90a30aea4aad 100644 (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`
index 91575ae4d8b8b53a928685d46c15401a45a33bf6..344756a43ebb8d1480a983133dbbc83fea980758 100644 (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`
index 8a1121bb36b3a3a459bc900a42575722c9ea26ce..3dcd2017c46ef1ba526d00dc01fa1de8b64def9e 100644 (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`
index 734766730c679a46246fb5155f7fdd7d66e1fe00..929791e3a152bb674d1c27f85bac281852004e3e 100644 (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`
index 420e7563bdd79e47cfe4cec1ed9bd89d2a548c0d..4cb85e1e67fa12d44e2051b2e5684e51a79a2454 100644 (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`
index 726e4495578183817f0c4aeed743f9dff045f711..9f7d3304fa2b4c4960f6b447df8ce96e141a1827 100644 (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`
index 5796c36237d515e7660616392f3188a431290038..0c2d8b99bc086aa64e71846f921e6838525653b7 100644 (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`
index 587c13c592847f92f4e8ae28af1b900a9a6b84ca..e4551400168dc868cc4da32d86b7ceced4a5acfc 100644 (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`
index 7caa636e363f258fbabfabce1414926e39621760..8ee78c46eac667a94d940f467fed2b95a375a7d4 100644 (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`
index 88cefd54c8947836cad34ecc0897970c0d8d5ba8..1005d95d2f3aceab6631165fed7526f5d8be7ae8 100644 (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`
index 089038dec49d0780ea4266d1a6f1034cb2779bda..909a7f026ed10399e39f6f351188d1ec927dc056 100644 (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`
index 578a7a6417cd2dbe6311b94acd5f783575e6ca9f..e041b81523a27f411e96e151834333f5f19a3068 100644 (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`
index 684a7d55ef06f550db19ff0f96664bfa803acd02..84becc149e990f82bacdd880b3a82e79fbf1926d 100644 (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`
index fe9ae7d2e200b4152e7a0668274bff430d3a3a7b..63c2521566271caedb771fe045d4c2d79d96b5e7 100644 (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`
index 351770111948f265b1b73aabbd265c055570b43a..610a2169b88512235d2ff7ebefdfd81358c77661 100644 (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`
index 7b322e3a32de908471a025749b0a7c4e930232c7..20643fd82b8091a537d852acfda676702bdaf6af 100644 (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`
index 17dab0e324196f889a325f330e13f9cff51ea631..39fe1c70d2b95fbd824b520e7b6ede8d75d774fa 100644 (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) {
index 6be10774db837fea9be08eee76198e26a9089ba3..55c97b769f7ed196d3b3d27b831a857320ef4d80 100644 (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);
index 16af56e5cda6347dbf3c897e9b47d64f50dab237..5efc5e5f089eb194f6a5f5834bd0a10ce0c71613 100644 (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;
index d0fce53cae06c5cd5a771fb421be35ddb26db8e0..0cb17c31bfaab3fb0b33faaff8c352845856688a 100644 (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);
index 88af6f8ed9d10a0988408bb86d7e4f5a3ec82342..54e900d2fdb3118c42674b2546e3ae9d832f6c6d 100644 (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);
index a6977513974b9ff80faf0c9df3c944562d10b57b..dd8e81b8d40a810e2ad4b723557807f5f742cc96 100644 (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;
index 4d8287095312cafa5357de9dd96b7ec7f6d48007..9b59ec1fd1a733e38f2676514748702c6d657b73 100644 (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);
index 49c28a7b6e6eb0d6ac78e839ff70d59033c2ce76..70c294c5ac5b7964f617679d3899c6fecddcf1a4 100644 (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"
index f54832839f457b229413e184dadbac535d743b63..efea446a25e5c57c023c59a1c50126a79782fb92 100644 (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");
index f616c75e4034778410a650d25c552520b90affc4..e0c07e325d0b672a616d7bc0d38b5c145b34b18f 100644 (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");
index e3b947b1461522ff2caccfd499f211cefd32f8a9..83bd4d6ea814b9250be6bc117b48efa42033cee2 100644 (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);
index 74b431a6b06e65754e4a7a86213ebcf4e8321f8b..443097dfb45283dad2731f1615c069d3c5e3ee8f 100644 (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");
index df14f081f5cdbc544a5bf653e4699e84ac27c1a3..cf44f3718ab9ef8daf7d6b91de076a0a561bebe2 100644 (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");
index 91e91468493db05b27a1bb25a49aa523aac0c5ca..da997695d04b45397104de08aeaebf90c017ea35 100644 (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;
index 18b7ce6b36a16185050eb5e1d7a3e5ad6d8843c3..ec9ccc16c8c0b9a8bdc73d829c11c7176d6575eb 100644 (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);
index 91f211071641bca0bc70df0495b68f9594845979..540d96149febf80c64f4827c84f856cfa966e019 100644 (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");
index 4c7cfd700f913e68e09eb8bc237a72a25a0648c9..ceb1c1c09184167ec624ca8956c1a80cd3a1ee87 100644 (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");
index 44e32299ee0481b2365e8d332a20b37d4fdf81b5..cbc89527535533e81107df81f8690bcb0b9d2402 100644 (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");