DragonFly On-Line Manual Pages

Search: Section:  

CURLOPT_SERVICE_NAME(3)             libcurl            CURLOPT_SERVICE_NAME(3)


NAME

       CURLOPT_SERVICE_NAME - authentication service name


SYNOPSIS

       #include <curl/curl.h>

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


DESCRIPTION

       Pass a char * as parameter to a string holding the name of the service
       for DIGEST-MD5, SPNEGO and Kerberos 5 authentication mechanisms. The
       default service names are "ftp", "HTTP", "imap", "ldap", "pop" and
       "smtp". This option allows you to change them.

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


DEFAULT

       See above


PROTOCOLS

       HTTP, FTP, IMAP, LDAP, POP3 and SMTP


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, 7.49.0 for FTP, IMAP, POP3 and SMTP, 7.82.0
       for OpenLDAP.


RETURN VALUE

       Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if
       not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space.


SEE ALSO

       CURLOPT_PROXY(3), CURLOPT_PROXYTYPE(3),

ibcurl 8.1.2                    April 26, 2023         CURLOPT_SERVICE_NAME(3)

Search: Section: