HTTP Fetcher Library Documentation

Return to Main

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)

Return to Main