GNURLOPT_DEFAULT_PROTOCOL(3)

✨ NAME ✨

Okay bestie, welcome to GNURLOPT_DEFAULT_PROTOCOL(3) — the page for CURLOPT_DEFAULT_PROTOCOL, aka the default protocol to use if the URL is missing a scheme name. 💅✨

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEFAULT_PROTOCOL, char
*protocol);

💖 DESCRIPTION 💖

Bestie, this option tells libcurl to use protocol if the URL is missing a scheme name. 🫶

Use one of these protocol (scheme) names:

dict, file, ftp, ftps, gopher, http, https, imap, imaps, ldap, ldaps,
pop3, pop3s, rtsp, scp, sftp, smb, smbs, smtp, smtps, telnet, tftp

An unknown or unsupported protocol causes error CURLE_UNSUPPORTED_PROTOCOL when libcurl parses a schemeless URL. Parsing happens when curl_easy_perform(3) or curl_multi_perform(3) is called. The protocols supported by libcurl will vary depending on how it was built. Use curl_version_info(3) if you need a list of protocol names supported by the build of libcurl that you are using. 📋

This option does not change the default proxy protocol (http). Nope, proxy stays http. 🙈

Without this option libcurl would make a guess based on the host, see CURLOPT_URL(3) for details. 🔍

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

🌈 DEFAULT 🌈

NULL (make a guess based on the host) — that's the default, bestie. No stress. 💜

🦋 PROTOCOLS 🦋

All — yes bestie, all of them. ✨

🔥 EXAMPLE 🔥

Here's the exact example, no cap:

       curl = curl_easy_init();
       if(curl) {
         /* set a URL without a scheme */
         curl_easy_setopt(curl, CURLOPT_URL, "example.com");

         /* set the default protocol (scheme) for schemeless URLs */
         curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");

         /* Perform the request */
         curl_easy_perform(curl);
       }

⭐ AVAILABILITY ⭐

Added in 7.45.0 — a classic. ⭐

👑 RETURN VALUE 👑

• CURLE_OK — if the option is supported. Slay. 💖
• CURLE_OUT_OF_MEMORY — if there was insufficient heap space. 😭
• CURLE_UNKNOWN_OPTION — if the option is not supported. 💀

🫶 SEE ALSO 🫶

• CURLOPT_URL(3), — go read that one too, bestie. 🫶

Mwah 💋 — source/version libcurl 7.45.0, dated 18 Aug 2015, footer tag GNURLOPT_D...LT_PROTOCOL(3). Bye bestie! 🎀