Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

CURLOPT_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

curl_easy_setopt options                           CURLOPT_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 OCSP 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, oth-
       erwise returns CURLE_NOT_BUILT_IN.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       CURLOPT_SSL_VERIFYHOST(3),        CURLOPT_SSL_VERIFYPEER(3),       CUR-
       LOPT_CAINFO(3),



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was    downloaded    from     https://github.com/curl/curl/ar-
       chive/curl-7_64_0.zip

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.40.0                    04 Dec 2014
                                                   CURLOPT_SSL_VERIFYSTATUS(3)