DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_CAPATH(3)




CURLOPT_CAPATH(3)   curl_easy_setopt options    CURLOPT_CAPATH(3)


NAME

     CURLOPT_CAPATH - specify directory holding CA certificates


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAPATH, char
     *capath);


DESCRIPTION

     Pass a char * to a zero terminated string naming a directory
     holding multiple CA certificates to verify the peer with. If
     libcurl is built against OpenSSL, the certificate  directory
     must  be  prepared using the openssl c_rehash utility.  This
     makes  sense  only  when  used  in  combination   with   the
     CURLOPT_SSL_VERIFYPEER(3) option.

     The CURLOPT_CAPATH(3) function apparently does not  work  in
     Windows due to some limitation in openssl.

     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_CAPATH, "/etc/cert-dir");
       ret = curl_easy_perform(curl);
       curl_easy_cleanup(curl);
     }


AVAILABILITY

     This option is supported by the  OpenSSL,  GnuTLS,  PolarSSL
     and  mbedTLS  (since  7.56.0) backends. The NSS backend pro-
     vides the option only for backward compatibility.


RETURN VALUE

     CURLE_OK if supported; or an error such as:

     CURLE_NOT_BUILT_IN - Not supported by the SSL backend

     CURLE_UNKNOWN_OPTION

     CURLE_OUT_OF_MEMORY

libcurl 7.58.0   Last change: September 10, 2017                1

CURLOPT_CAPATH(3)   curl_easy_setopt options    CURLOPT_CAPATH(3)


SEE ALSO

     CURLOPT_CAINFO(3),                        CURLOPT_STDERR(3),
     CURLOPT_DEBUGFUNCTION(3),

libcurl 7.58.0   Last change: September 10, 2017                2


Man(1) output converted with man2html