GNURLOPT_SERVICE_NAME(3)

💖 NAME 💖

okay so this is the GNURLOPT_SERVICE_NAME(3) page from the curl_easy_setopt options manual, bestie, and the main character is literally CURLOPT_SERVICE_NAME — the authentication service name. 🎀

---

✨ SYNOPSIS ✨

Here's the exact spell, no cap:

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVICE_NAME, char
*name);

---

💅 DESCRIPTION 💅

You pass a char * as the parameter, pointing at a string that holds the service name for DIGEST-MD5, SPNEGO and Kerberos 5 authentication mechanisms. The default service names are "ftp", "HTTP", "imap", "pop" and "smtp", and this option is your permission slip to change them. 💫

The app does not have to keep the string around after setting this option. Set it and move on, icon. 🫶

---

🌸 DEFAULT 🌸

The default is literally See above. No extra lore. ✨

---

🦋 PROTOCOLS 🦋

HTTP, FTP, IMAP, POP and SMTP. That's the whole guest list. 👑

---

🎀 EXAMPLE 🎀

CURL *curl = curl_easy_init();
if(curl) {
  CURLcode ret;
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_SERVICE_NAME, "custom");
  ret = curl_easy_perform(curl);
}

---

🔥 AVAILABILITY 🔥

Added in 7.43.0 for HTTP, and in 7.49.0 for FTP, IMAP, POP3 and SMTP. Yes, POP3 here and POP up in protocols — that's what the page says, bestie, don't come for me. 😭

---

🌈 RETURN VALUE 🌈

• CURLE_OK if the option is supported
• CURLE_UNKNOWN_OPTION if not
• CURLE_OUT_OF_MEMORY if there was insufficient heap space

---

💜 SEE ALSO 💜

• CURLOPT_PROXY(3)
• CURLOPT_PROXYTYPE(3)

xoxo, your curl bestie 💜 — this page is from libcurl 7.43.0, dated 17 Jun 2015, and it's the GNURLOPT_SERVICE_NAME(3) manual page. periodt. 🫶