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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_PROXYUSERPWD(3)	   curl_easy_setopt options    CURLOPT_PROXYUSERPWD(3)

NAME
       CURLOPT_PROXYUSERPWD  - user name and password to use for proxy authen-
       tication

SYNOPSIS
       #include	<curl/curl.h>

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

DESCRIPTION
       Pass  a	char * as parameter, which should be [user name]:[password] to
       use for the connection to the HTTP proxy. Both the name and  the	 pass-
       word  will be URL decoded before	use, so	to include for example a colon
       in the user name	you should encode it as	%3A. (This is different	to how
       CURLOPT_USERPWD(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.

DEFAULT
       This is NULL by default.

PROTOCOLS
       Used with all protocols that can	use a proxy

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

AVAILABILITY
       Always

RETURN VALUE
       Returns CURLE_OK	if proxies are 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.54.1			 May 30, 2017	       CURLOPT_PROXYUSERPWD(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

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

home | help