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

FreeBSD Manual Pages

  
 
  

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

NAME
     CURLINFO_REFERER - used HTTP referrer request header

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REFERER, char **hdrp);

DESCRIPTION
     Pass in a pointer to a char pointer and get the referrer header used in the
     most recent request.

     The hdrp pointer is NULL or points to private memory. You must not free it.
     The  memory  gets freed automatically when you call curl_easy_cleanup(3) on
     the corresponding curl handle.

PROTOCOLS
     This functionality affects http only

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
	 curl_easy_setopt(curl, CURLOPT_REFERER, "https://example.org/referrer");
	 result = curl_easy_perform(curl);
	 if(result == CURLE_OK) {
	   char *hdr = NULL;
	   curl_easy_getinfo(curl, CURLINFO_REFERER, &hdr);
	   if(hdr)
	     printf("Referrer header: %s\n", hdr);
	 }
	 curl_easy_cleanup(curl);
       }
     }

AVAILABILITY
     Added in curl 7.76.0

RETURN VALUE
     curl_easy_getinfo(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_REFERER(3),       curl_easy_getinfo(3),	    curl_easy_header(3),
     curl_easy_setopt(3)

libcurl 			   2026-06-11		     CURLINFO_REFERER(3)

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

home | help