CURLOPT_PROXY_TLSAUTH_USERNAME(3)

1CURLOPT_PROXY_TLSAUTH_USERNAcMuEr(l3_)easy_setopt opCtUiRoLnOsPT_PROXY_TLSAUTH_USERNAME(3)
2
3
4

NAME

6       CURLOPT_PROXY_TLSAUTH_USERNAME - user name to use for proxy TLS authen‐
7       tication
8

SYNOPSIS

10       #include <curl/curl.h>
11
12       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_USERNAME,
13                                 char *user);
14

DESCRIPTION

16       Pass a char * as parameter, which should point to  the  null-terminated
17       username to use for the HTTPS proxy TLS authentication method specified
18       with the CURLOPT_PROXY_TLSAUTH_TYPE(3) option. Requires that  the  CUR‐
19       LOPT_PROXY_TLSAUTH_PASSWORD(3) option also be set.
20
21       The  application  does not have to keep the string around after setting
22       this option.
23

DEFAULT

25       NULL
26

PROTOCOLS

28       All
29

EXAMPLE

31       CURL *curl = curl_easy_init();
32       if(curl) {
33         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
34         curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
35         curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
36         curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
37         curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");
38         ret = curl_easy_perform(curl);
39         curl_easy_cleanup(curl);
40       }
41

AVAILABILITY

43       Added in 7.52.0, with the OpenSSL and GnuTLS backends only.
44

RETURN VALUE

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