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)