CURLOPT_SERVICE_NAME(3)

1CURLOPT_SERVICE_NAME(3)    curl_easy_setopt options    CURLOPT_SERVICE_NAME(3)
2
3
4

NAME

6       CURLOPT_SERVICE_NAME - authentication service name
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode   curl_easy_setopt(CURL  *handle,  CURLOPT_SERVICE_NAME,  char
12       *name);
13

DESCRIPTION

15       Pass a char * as parameter to a string holding the name of the  service
16       for  DIGEST-MD5,  SPNEGO  and Kerberos 5 authentication mechanisms. The
17       default service names are "ftp", "HTTP", "imap", "pop" and "smtp". This
18       option allows you to change them.
19
20       The  application  does not have to keep the string around after setting
21       this option.
22

DEFAULT

24       See above
25

PROTOCOLS

27       HTTP, FTP, IMAP, POP and SMTP
28

EXAMPLE

30       CURL *curl = curl_easy_init();
31       if(curl) {
32         CURLcode ret;
33         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
34         curl_easy_setopt(curl, CURLOPT_SERVICE_NAME, "custom");
35         ret = curl_easy_perform(curl);
36       }
37

AVAILABILITY

39       Added in 7.43.0 for HTTP, 7.49.0 for FTP, IMAP, POP3 and SMTP.
40

RETURN VALUE

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