CURLOPT_SERVICE_NAME(3)

CURLOPT_SERVICE_NAME(3curl_easy_setopt optionCURLOPT_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 authenti-
     cation mechanisms. The  default  service  names  are  "ftp",
     "HTTP",  "imap", "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, POP 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.

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),

libcurl 7.58.0      Last change: May 31, 2017                   1