dwww Home | Manual pages | Find package

CURLOPT_PROXY_KEYPASSWD(3) curl_easy_setopt options CURLOPT_PROXY_KEYPASSWD(3)

NAME
       CURLOPT_PROXY_KEYPASSWD - passphrase for the proxy private key

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_KEYPASSWD, char *pwd);

DESCRIPTION
       This option is for connecting to an HTTPS proxy, not an HTTPS server.

       Pass  a  pointer  to  a null-terminated string as parameter. It will be
       used as the password required to use the  CURLOPT_PROXY_SSLKEY(3)  pri-
       vate key.  You never needed a pass phrase to load a certificate but you
       need one to load your private key.

       The application does not have to keep the string around  after  setting
       this option.

DEFAULT
       NULL

PROTOCOLS
       Used with HTTPS proxy

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         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_KEYPASSWD, "superman");
         ret = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in 7.52.0

RETURN VALUE
       Returns  CURLE_OK  if  TLS  enabled,  CURLE_UNKNOWN_OPTION  if  not, or
       CURLE_OUT_OF_MEMORY if there was insufficient heap space.

SEE ALSO
       CURLOPT_PROXY_SSLKEY(3),  CURLOPT_SSH_PRIVATE_KEYFILE(3),   CURLOPT_SS-
       LKEY(3),

libcurl 7.81.0                 November 26, 2021    CURLOPT_PROXY_KEYPASSWD(3)

Generated by dwww version 1.14 on Fri Jan 24 06:15:32 CET 2025.