HTTP Fetcher(3)

NAME

http_setUserAgent - Changes the User Agent shown to the server during an HTTP GET request.

SYNOPSIS

#include <http_fetcher.h>

int http_setUserAgent(const char *newAgent);

DESCRIPTION

The User Agent field of an HTTP request tells the server what software is making the request. By default, "HTTP Fetcher/VERSION" is sent. Calling http_setUserAgent will change the default User Agent to newAgent for subsequent requests (until the next call to http_setUserAgent). If you pass in NULL as an argument, HTTP Fetcher will NOT give the server a User Agent. This function is useful for mimicing a browser, deceiving the webserver, or a number of other creative uses.

RETURN VALUE

On success, http_setUserAgent returns 0. On error, -1 is returned, and the previous value of
userAgent 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_setReferer(3), http_setTimeout(3),
http_setRedirects(3), http_parseFilename(3), http_perror(3),
http_strerror(3)