DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_SSL_VERIFYSTATUS(3)





CURLOPT_SSL_VERIFYSTATUS(3curl_easy_setopt optionCURLOPT_SSL_VERIFYSTATUS(3)



NAME

     CURLOPT_SSL_VERIFYSTATUS - verify the certificate's status


SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_setopt(CURL            *handle,
     CURLOPT_SSL_VERIFYSTATUS, long verify);


DESCRIPTION

     Pass a long as parameter set to 1 to enable or 0 to disable.

     This option determines whether libcurl verifies  the  status
     of  the  server  cert using the "Certificate Status Request"
     TLS extension (aka. OCSP stapling).

     Note that if this option is enabled but the server does  not
     support the TLS extension, the verification will fail.


DEFAULT

     0


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/");
       /* ask for OSCP stapling! */
       curl_easy_setopt(curl, CURLOPT_SSL_VERIFYSTATUS, 1L);
       ret = curl_easy_perform(curl);
       curl_easy_cleanup(curl);
     }


AVAILABILITY

     Added in 7.41.0. This option is currently only supported  by
     the OpenSSL, GnuTLS and NSS TLS backends.


RETURN VALUE

     Returns CURLE_OK if OCSP stapling is supported  by  the  SSL
     backend, otherwise returns CURLE_NOT_BUILT_IN.


SEE ALSO

     CURLOPT_SSL_VERIFYHOST(3),        CURLOPT_SSL_VERIFYPEER(3),
     CURLOPT_CAINFO(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html