dwww Home | Manual pages | Find package

CURLOPT_SSLKEYTYPE(3)      curl_easy_setopt options      CURLOPT_SSLKEYTYPE(3)

NAME
       CURLOPT_SSLKEYTYPE - type of the private key file

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEYTYPE, char *type);

DESCRIPTION
       Pass  a  pointer  to  a null-terminated string as parameter. The string
       should be the format of your private key. Supported formats are  "PEM",
       "DER" and "ENG".

       The  format "ENG" enables you to load the private key from a crypto en-
       gine. In this case CURLOPT_SSLKEY(3) is used as an identifier passed to
       the   engine.   You   have   to   set   the  crypto  engine  with  CUR-
       LOPT_SSLENGINE(3).  "DER" format key file currently does not  work  be-
       cause of a bug in OpenSSL.

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

DEFAULT
       "PEM"

PROTOCOLS
       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
         curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
         curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
         curl_easy_setopt(curl, CURLOPT_SSLKEYTYPE, "PEM");
         curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
         ret = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }

AVAILABILITY
       If built TLS enabled.

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

SEE ALSO
       CURLOPT_SSLKEY(3), CURLOPT_SSLCERT(3),

libcurl 7.81.0                 November 26, 2021         CURLOPT_SSLKEYTYPE(3)

Generated by dwww version 1.14 on Sat Apr 19 23:32:12 CEST 2025.