DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_SSLCERT(3)




CURLOPT_SSLCERT(3)  curl_easy_setopt options   CURLOPT_SSLCERT(3)


NAME

     CURLOPT_SSLCERT - set SSL client certificate


SYNOPSIS

     #include <curl/curl.h>

     CURLcode  curl_easy_setopt(CURL  *handle,   CURLOPT_SSLCERT,
     char *cert);


DESCRIPTION

     Pass a pointer to a zero terminated string as parameter. The
     string  should  be the file name of your client certificate.
     The default format is "P12" on Secure Transport and "PEM" on
     other     engines,     and     can     be    changed    with
     CURLOPT_SSLCERTTYPE(3).

     With NSS or Secure Transport, this can also be the  nickname
     of  the  certificate  you wish to authenticate with as it is
     named in the security database. If you want to  use  a  file
     from the current directory, please precede it with "./" pre-
     fix, in order to avoid confusion with a nickname.

     When using a client certificate, you most likely  also  need
     to provide a private key with CURLOPT_SSLKEY(3).

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


DEFAULT

     NULL


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_KEYPASSWD, "s3cret");
       ret = curl_easy_perform(curl);
       curl_easy_cleanup(curl);
     }


AVAILABILITY

     If built TLS enabled.


RETURN VALUE

     Returns CURLE_OK if  TLS  enabled,  CURLE_UNKNOWN_OPTION  if
     not,  or  CURLE_OUT_OF_MEMORY if there was insufficient heap

libcurl 7.58.0      Last change: May 31, 2017                   1

CURLOPT_SSLCERT(3)  curl_easy_setopt options   CURLOPT_SSLCERT(3)

     space.


SEE ALSO

     CURLOPT_SSLCERTTYPE(3), CURLOPT_SSLKEY(3),

libcurl 7.58.0      Last change: May 31, 2017                   2


Man(1) output converted with man2html