Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_PROXYUSERPWD(3)     Library Functions Manual	 CURLOPT_PROXYUSERPWD(3)

NAME
     CURLOPT_PROXYUSERPWD  -  username and password to use for proxy authentica-
     tion

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERPWD, char *userpwd);

DESCRIPTION
     Pass a char pointer as parameter, which should be [username]:[password]  to
     use  for  the  connection to the HTTP proxy. Both the name and the password
     are URL decoded before used, so to include for example a colon in the user-
     name you should encode it as %3A. (This is different to  how  CURLOPT_USER-
     PWD(3) is used - beware.)

     Use CURLOPT_PROXYAUTH(3) to specify the authentication method.

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

     Using this option multiple times makes the last  set  string  override  the
     previous ones. Set it to NULL to disable its use again.

DEFAULT
     NULL

PROTOCOLS
     This functionality affects all supported protocols

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
	 curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:8080");
	 curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "clark%20kent:superman");
	 result = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }
     }

AVAILABILITY
     Added in curl 7.1

RETURN VALUE
     curl_easy_setopt(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     CURLOPT_PROXY(3),	 CURLOPT_PROXYPASSWORD(3),   CURLOPT_PROXYTYPE(3),  CUR-
     LOPT_PROXYUSERNAME(3)

libcurl 			   2026-06-11		 CURLOPT_PROXYUSERPWD(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_PROXYUSERPWD&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help