CURLOPT_AUTOREFERER(3)

1CURLOPT_AUTOREFERER(3)     curl_easy_setopt options     CURLOPT_AUTOREFERER(3)
2
3
4

NAME

6       CURLOPT_AUTOREFERER - automatically update the referer header
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle, CURLOPT_AUTOREFERER, long au‐
12       torefer);
13

DESCRIPTION

15       Pass a parameter set to 1 to enable this. When  enabled,  libcurl  will
16       automatically  set  the  Referer:  header field in HTTP requests to the
17       full URL where it follows a Location: redirect.
18

DEFAULT

20       0, disabled
21

PROTOCOLS

23       HTTP
24

EXAMPLE

26       CURL *curl = curl_easy_init();
27       if(curl) {
28         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
29
30         /* follow redirects */
31         curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
32
33         /* set Referer: automatically when following redirects */
34         curl_easy_setopt(curl, CURLOPT_AUTOREFERER, 1L);
35
36         ret = curl_easy_perform(curl);
37
38         curl_easy_cleanup(curl);
39       }
40

AVAILABILITY

42       Along with HTTP
43

RETURN VALUE

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