http_setReferer(3)

http_setReferer3

Sets the referer shown to the server during an http get request.

Usage

#include <http_fetcher.h>

int http_setReferer(const char *newReferer);

Overview

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.

Releases

Unchanged in 2 releases since Debian 3.0 (Woody).

  1. 3.0–3.1

From libhttpfetcher-dev 1.0.1-3 in Debian 3.1 (Sarge). Parsed by carta from the page's man source.