DragonFly On-Line Manual Pages

Search: Section:  

CURLOPT_PROXY_SERVICE_NAME(3)       libcurl      CURLOPT_PROXY_SERVICE_NAME(3)


NAME

       CURLOPT_PROXY_SERVICE_NAME - proxy authentication service name


SYNOPSIS

       #include <curl/curl.h>

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


DESCRIPTION

       Pass a char * as parameter to a string holding the name of the service.
       The default service name is "HTTP" for HTTP based proxies and "rcmd"
       for SOCKS5. This option allows you to change it.

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


DEFAULT

       See above


PROTOCOLS

       All network protocols


EXAMPLE

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


AVAILABILITY

       Added in 7.43.0 for HTTP proxies, 7.49.0 for SOCKS5 proxies.


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_PROXY_SERVICE_NAME(3)

Search: Section: