Merge branch 'master' into blub/cmd_unset
[divverent/darkplaces.git] / libcurl.h
1 enum
2 {
3         CURLCBSTATUS_OK = 0,
4         CURLCBSTATUS_FAILED = -1, // failed for generic reason (e.g. buffer too small)
5         CURLCBSTATUS_ABORTED = -2, // aborted by curl --cancel
6         CURLCBSTATUS_SERVERERROR = -3, // only used if no HTTP status code is available
7         CURLCBSTATUS_UNKNOWN = -4 // should never happen
8 };
9 typedef void (*curl_callback_t) (int status, size_t length_received, unsigned char *buffer, void *cbdata);
10 // code is one of the CURLCBSTATUS constants, or the HTTP error code (when > 0).
11
12 void Curl_Run(void);
13 qboolean Curl_Running(void);
14 qboolean Curl_Begin_ToFile(const char *URL, const char *name, qboolean ispak, qboolean forthismap);
15 qboolean Curl_Begin_ToMemory(const char *URL, unsigned char *buf, size_t bufsize, curl_callback_t callback, void *cbdata);
16         // NOTE: if it returns false, the callback will NOT get called, so free your buffer then!
17 void Curl_Cancel_ToMemory(curl_callback_t callback, void *cbdata);
18         // removes all downloads with the given callback and cbdata (this does NOT call the callbacks!)
19 void Curl_Init(void);
20 void Curl_Init_Commands(void);
21 void Curl_Shutdown(void);
22 void Curl_CancelAll(void);
23 void Curl_Clear_forthismap(void);
24 qboolean Curl_Have_forthismap(void);
25 void Curl_Register_predownload(void);
26
27 void Curl_ClearRequirements(void);
28 void Curl_RequireFile(const char *filename);
29 void Curl_SendRequirements(void);
30
31 typedef struct Curl_downloadinfo_s
32 {
33         char filename[MAX_QPATH];
34         double progress;
35         double speed;
36         qboolean queued;
37 }
38 Curl_downloadinfo_t;
39 Curl_downloadinfo_t *Curl_GetDownloadInfo(int *nDownloads, const char **additional_info);
40         // this may and should be Z_Free()ed
41         // the result is actually an array
42         // an additional info string may be returned in additional_info as a
43         // pointer to a static string (but the argument may be NULL if the caller
44         // does not care)