CURLINFO_SSL_ENGINES(3)

📦
version 8.18.0 · 24 versions
, in fedora 44

🦋 CURLINFO_SSL_ENGINES(3) 🦋

okay bestie, this is the Library Functions Manual page for CURLINFO_SSL_ENGINES(3), and it is literally giving OpenSSL engine-list realness. 🫶

🌸 NAME 🌸

CURLINFO_SSL_ENGINES — an slist of OpenSSL crypto-engines. periodt. 💅

✨ SYNOPSIS ✨

       #include <curl/curl.h>

       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SSL_ENGINES,
                                  struct curl_slist **engine_list);

🎀 DESCRIPTION 🎀

okay so you pass the address of a struct curl_slist * to receive a linked-list of OpenSSL crypto-engines supported. no cap, that's the whole vibe. 🧚

note that engines are normally implemented in separate dynamic libraries. hence not all the returned engines may be available at runtime. NOTE: you must call curl_slist_free_all(3) on the list pointer once you are done with it, as libcurl does not free this data for you. like, do not forget this part, bestie. 😭

🌈 PROTOCOLS 🌈

this functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. 💖

this option works only with the following TLS backends: OpenSSL.

🦋 EXAMPLE 🦋

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           CURLcode result;
           struct curl_slist *engines;
           result = curl_easy_getinfo(curl, CURLINFO_SSL_ENGINES, &engines);
           if((result == CURLE_OK) && engines) {
             /* we have a list, free it when done using it */
             curl_slist_free_all(engines);
           }

           curl_easy_cleanup(curl);
         }
       }

⭐ AVAILABILITY ⭐

Added in curl 7.12.3. iconic behavior. 👑

💜 RETURN VALUE 💜

curl_easy_getinfo(3) returns a CURLcode indicating success or error. 🫡

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

🔥 SEE ALSO 🔥

that's the whole page, bestie — brought to you by libcurl, dated 2026-10-12, and this cutie is CURLINFO_SSL_ENGINES(3). slay, go free your slist. 💖✨🎀

📦 where this page comes from