---
name: "http_setReferer"
section: "3"
platform: "linux"
package: "libhttpfetcher-dev"
version: "1.0.1-3"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/http_setReferer"
---

# http\_setReferer(3)

Sets the Referer shown to the server during an HTTP GET request.

## NAME

**http\_setReferer** - Sets the Referer shown to the server during an HTTP GET request.

## SYNOPSIS

**#include \<http\_fetcher.h\>**\

**int http\_setReferer(const char \****newReferer***);**\

## DESCRIPTION

**The Referer field of an HTTP request tells the server what URL referred you to the current URL being requested.  By default, no Referer is sent.**

**Calling http\_setReferer** will cause *newReferer* to be sent as the Referer for subsequent requests (until the next call to **http\_setReferer**).

If you pass in **NULL** as an argument, HTTP Fetcher will NOT give the server a Referer.

## RETURN VALUE

On success, **http\_setReferer** returns 0.

On error, -1 is returned, and the previous value of\
 Referer is unchanged.  **http\_perror** can be used to print an informative error message.  **http\_strerror** can be used to get a pointer to the current error description message.

## SEE ALSO

[**http\_fetch**(3)](/http_fetch/3.md), [**http\_setUserAgent**(3)](/http_setUserAgent/3.md), [**http\_setTimeout**(3)](/http_setTimeout/3.md), [**http\_parseFilename**(3)](/http_parseFilename/3.md), [**http\_perror**(3)](/http_perror/3.md), [**http\_strerror**(3)](/http_strerror/3.md)