CURLOPT_UNRESTRICTED_AUTH(3)

CURLOPT_UNRESTRICTED_AUTH(3curl_easy_setopt optionCURLOPT_UNRESTRICTED_AUTH(3)

NAME

     CURLOPT_UNRESTRICTED_AUTH - send credentials to other  hosts
     too

SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UNRESTRICTED_AUTH,
                               long goahead);

DESCRIPTION

     Set the long gohead parameter to 1L to make libcurl continue
     to send authentication (user+password) credentials when fol-
     lowing locations, even when hostname changed. This option is
     meaningful only when setting CURLOPT_FOLLOWLOCATION(3).

     By default, libcurl will only send given credentials to  the
     initial  host  name  as  given in the original URL, to avoid
     leaking username + password to other sites.

DEFAULT

     0

PROTOCOLS

     HTTP

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
       curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
       curl_easy_setopt(curl, CURLOPT_UNRESTRICTED_AUTH, 1L);
       curl_easy_perform(curl);
     }

AVAILABILITY

     Along with HTTP

RETURN VALUE

     Returns    CURLE_OK    if    HTTP    is    supported,    and
     CURLE_UNKNOWN_OPTION if not.

SEE ALSO

     CURLOPT_FOLLOWLOCATION(3), CURLOPT_USERPWD(3),

libcurl 7.58.0      Last change: May 15, 2017                   1