#include "common.h"
#include <curl/curl.h>

Data Structures
struct	dlqueue_s

struct	dlhandle_s

struct	upparam_s

Macros
#define	CURL_STATICLIB

Typedefs
typedef struct dlqueue_s	dlqueue_t

typedef struct dlhandle_s	dlhandle_t

typedef struct upparam_s	upparam_t

typedef void(*	http_callback_t )(const char response, void userdata)

Enumerations
enum	dlq_state { DLQ_STATE_NOT_STARTED, DLQ_STATE_RUNNING, DLQ_STATE_DONE }

Functions
bool	HTTP_Encode (const char url, char out, size_t outLength)
	This function converts the given url to an URL encoded string. All input characters that are not a-z, A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped" version (NN where NN is a two-digit hexadecimal number). More...

bool	HTTP_GetToFile (const char url, FILE file, const char *postfields=nullptr)
	Downloads the given `url` into the given `file`. More...

bool	HTTP_GetURL (const char url, http_callback_t callback, void userdata=nullptr, const char *postfields=nullptr)
	Downloads the given `url` and return the data to the callback (optional) More...

bool	HTTP_PutFile (const char formName, const char fileName, const char url, const upparam_t params)

size_t	HTTP_Recv (void ptr, size_t size, size_t nmemb, void stream)
	libcurl callback for HTTP_GetURL More...

size_t	HTTP_Header (void ptr, size_t size, size_t nmemb, void stream)
	libcurl callback to update header info. More...

void	HTTP_Cleanup (void)
	UFO is exiting or we're changing servers. Clean up. More...

bool	HTTP_ExtractComponents (const char url, char scheme, size_t schemeLength, char host, size_t hostLength, char path, size_t pathLength, int *port)
	Extract the servername, the port and the path part of the given url. More...

Macro Definition Documentation

#define CURL_STATICLIB

Definition at line 30 of file http.h.

Typedef Documentation

typedef struct dlhandle_s dlhandle_t

typedef struct dlqueue_s dlqueue_t

typedef void(* http_callback_t)(const char *response, void *userdata)

Definition at line 65 of file http.h.

typedef struct upparam_s upparam_t

Enumeration Type Documentation

enum dlq_state

Enumerator
DLQ_STATE_NOT_STARTED
DLQ_STATE_RUNNING
DLQ_STATE_DONE

Definition at line 34 of file http.h.

Function Documentation

void HTTP_Cleanup ( void )

UFO is exiting or we're changing servers. Clean up.

Definition at line 396 of file http.cpp.

Referenced by Qcommon_Shutdown().

bool HTTP_Encode	(	const char *	url,
		char *	out,
		size_t	outLength
	)

This function converts the given url to an URL encoded string. All input characters that are not a-z, A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped" version (NN where NN is a two-digit hexadecimal number).

Returns: true if the conversion was successful, false if it failed or the target buffer was too small.

Definition at line 352 of file http.cpp.

References Q_strncpyz().

Referenced by WEB_CGameGetURL(), WEB_GetToFile(), and WEB_GetURL().

bool HTTP_ExtractComponents	(	const char *	url,
		char *	scheme,
		size_t	schemeLength,
		char *	host,
		size_t	hostLength,
		char *	path,
		size_t	pathLength,
		int *	port
	)

Extract the servername, the port and the path part of the given url.

Parameters

[in]	url	The url to extract the data from
[out]	scheme	The URL scheme string `http` or `https`
[in]	schemeLength	Length of the scheme buffer
[out]	host	The server target buffer
[in]	hostLength	The length of the buffer
[out]	path	The path target buffer
[in]	pathLength	The length of the buffer
[out]	port	The port

Returns: true if the extracting went well, false if an error occurred

Definition at line 38 of file http.cpp.

References Com_Printf(), i, Q_streq, Q_strncpyz(), Q_strneq, and Q_strnull().

Referenced by HTTP_ResolvURL(), and TEST_F().

bool HTTP_GetToFile	(	const char *	url,
		FILE *	file,
		const char *	postfields
	)

Downloads the given url into the given file.

Parameters

[in]	url	The url to fetch
[in]	file	The file to write the result into
[in]	postfields	Some potential POST data in the form

Definition at line 336 of file http.cpp.

References HTTP_GetURLInternal(), and OBJZERO.

Referenced by WEB_CGameDownloadFromUser(), and WEB_GetToFile().

bool HTTP_GetURL	(	const char *	url,
		http_callback_t	callback,
		void *	userdata,
		const char *	postfields
	)

Downloads the given url and return the data to the callback (optional)

Parameters

[in]	url	The url to fetch
[in]	callback	The callback to give the data to. Might also be `NULL`
[in]	userdata	The userdata that is given to the callback
[in]	postfields	Some potential POST data