DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_PROXYUSERPWD(3)





CURLOPT_PROXYUSERPWD(3curl_easy_setopt optionCURLOPT_PROXYUSERPWD(3)



NAME

     CURLOPT_PROXYUSERPWD - user name and  password  to  use  for
     proxy authentication


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 password 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.58.0      Last change: May 30, 2017                   1


Man(1) output converted with man2html