httpdirfs/src/network.h

#ifndef NETWORK_H
#define NETWORK_H

/**
 * \file network.h
 * \brief network related functions
 */

#include "link.h"

/**
 * \brief the default user agent string
 */
#define DEFAULT_USER_AGENT "HTTPDirFS-" VERSION

typedef struct {
    char *username;
    char *password;
    char *proxy;
    char *proxy_user;
    char *proxy_pass;
    long max_conns;
    char *user_agent;
    int http_429_wait;
    char *cache_dir;
    int cache_enabled;
} NetworkConfigStruct;

/** \brief HTTP response codes */
typedef enum {
    HTTP_OK                         = 200,
    HTTP_PARTIAL_CONTENT            = 206,
    HTTP_RANGE_NOT_SATISFIABLE      = 416,
    HTTP_TOO_MANY_REQUESTS          = 429,
    HTTP_CLOUDFLARE_UNKNOWN_ERROR   = 520,
    HTTP_CLOUDFLARE_TIMEOUT         = 524
} HTTPResponseCode;

/** \brief The waiting time after getting HTTP 429 */
extern int HTTP_WAIT_SEC;

/** \brief CURL configuration */
extern NetworkConfigStruct NETWORK_CONFIG;

/** \brief curl shared interface */
extern CURLSH *CURL_SHARE;

/** \brief perform one transfer cycle */
int curl_multi_perform_once();

/** \brief initialise network config struct */
void network_config_init();

/** \brief initialise the network module */
LinkTable *network_init(const char *url);

/** \brief blocking file transfer */
void transfer_blocking(CURL *curl);

/** \brief non blocking file transfer */
void transfer_nonblocking(CURL *curl);

/** \brief callback function for file transfer */
size_t
write_memory_callback(void *contents, size_t size, size_t nmemb, void *userp);

/**
 * \brief check if a HTTP response code corresponds to a temporary failure
 */
int HTTP_temp_failure(HTTPResponseCode http_resp);

#endif