http.hon commit manpages: italicize git command names (which were in teletype font) (ba020ef)
   1#ifndef HTTP_H
   2#define HTTP_H
   3
   4#include "cache.h"
   5
   6#include <curl/curl.h>
   7#include <curl/easy.h>
   8
   9#include "strbuf.h"
  10#include "remote.h"
  11
  12/*
  13 * We detect based on the cURL version if multi-transfer is
  14 * usable in this implementation and define this symbol accordingly.
  15 * This is not something Makefile should set nor users should pass
  16 * via CFLAGS.
  17 */
  18#undef USE_CURL_MULTI
  19
  20#if LIBCURL_VERSION_NUM >= 0x071000
  21#define USE_CURL_MULTI
  22#define DEFAULT_MAX_REQUESTS 5
  23#endif
  24
  25#if LIBCURL_VERSION_NUM < 0x070704
  26#define curl_global_cleanup() do { /* nothing */ } while(0)
  27#endif
  28#if LIBCURL_VERSION_NUM < 0x070800
  29#define curl_global_init(a) do { /* nothing */ } while(0)
  30#endif
  31
  32#if (LIBCURL_VERSION_NUM < 0x070c04) || (LIBCURL_VERSION_NUM == 0x071000)
  33#define NO_CURL_EASY_DUPHANDLE
  34#endif
  35
  36#if LIBCURL_VERSION_NUM < 0x070a03
  37#define CURLE_HTTP_RETURNED_ERROR CURLE_HTTP_NOT_FOUND
  38#endif
  39
  40struct slot_results
  41{
  42        CURLcode curl_result;
  43        long http_code;
  44};
  45
  46struct active_request_slot
  47{
  48        CURL *curl;
  49        FILE *local;
  50        int in_use;
  51        CURLcode curl_result;
  52        long http_code;
  53        int *finished;
  54        struct slot_results *results;
  55        void *callback_data;
  56        void (*callback_func)(void *data);
  57        struct active_request_slot *next;
  58};
  59
  60struct buffer
  61{
  62        struct strbuf buf;
  63        size_t posn;
  64};
  65
  66/* Curl request read/write callbacks */
  67extern size_t fread_buffer(void *ptr, size_t eltsize, size_t nmemb, void *strbuf);
  68extern size_t fwrite_buffer(const void *ptr, size_t eltsize, size_t nmemb, void *strbuf);
  69extern size_t fwrite_null(const void *ptr, size_t eltsize, size_t nmemb, void *strbuf);
  70
  71/* Slot lifecycle functions */
  72extern struct active_request_slot *get_active_slot(void);
  73extern int start_active_slot(struct active_request_slot *slot);
  74extern void run_active_slot(struct active_request_slot *slot);
  75extern void finish_all_active_slots(void);
  76extern void release_active_slot(struct active_request_slot *slot);
  77
  78#ifdef USE_CURL_MULTI
  79extern void fill_active_slots(void);
  80extern void add_fill_function(void *data, int (*fill)(void *));
  81extern void step_active_slots(void);
  82#endif
  83
  84extern void http_init(struct remote *remote);
  85extern void http_cleanup(void);
  86
  87extern int data_received;
  88extern int active_requests;
  89
  90extern char curl_errorstr[CURL_ERROR_SIZE];
  91
  92static inline int missing__target(int code, int result)
  93{
  94        return  /* file:// URL -- do we ever use one??? */
  95                (result == CURLE_FILE_COULDNT_READ_FILE) ||
  96                /* http:// and https:// URL */
  97                (code == 404 && result == CURLE_HTTP_RETURNED_ERROR) ||
  98                /* ftp:// URL */
  99                (code == 550 && result == CURLE_FTP_COULDNT_RETR_FILE)
 100                ;
 101}
 102
 103#define missing_target(a) missing__target((a)->http_code, (a)->curl_result)
 104
 105extern int http_fetch_ref(const char *base, struct ref *ref);
 106
 107#endif /* HTTP_H */