149 lines
3.1 KiB
C
149 lines
3.1 KiB
C
#ifndef LINK_H
|
|
#define LINK_H
|
|
|
|
/**
|
|
* \file link.h
|
|
* \brief link related structures and functions
|
|
*/
|
|
|
|
typedef struct Link Link;
|
|
typedef struct LinkTable LinkTable;
|
|
|
|
#include "cache.h"
|
|
#include "config.h"
|
|
#include "network.h"
|
|
#include "sonic.h"
|
|
|
|
#include <curl/curl.h>
|
|
|
|
/**
|
|
* \brief the link type
|
|
*/
|
|
typedef enum {
|
|
LINK_HEAD = 'H',
|
|
LINK_DIR = 'D',
|
|
LINK_FILE = 'F',
|
|
LINK_INVALID = 'I',
|
|
LINK_UNINITIALISED_FILE = 'U'
|
|
} LinkType;
|
|
|
|
/**
|
|
* \brief link table type
|
|
* \details index 0 contains the Link for the base URL
|
|
*/
|
|
struct LinkTable {
|
|
int num;
|
|
time_t index_time;
|
|
Link **links;
|
|
};
|
|
|
|
/**
|
|
* \brief Link type data structure
|
|
*/
|
|
struct Link {
|
|
/** \brief The link name in the last level of the URL */
|
|
char linkname[MAX_FILENAME_LEN + 1];
|
|
char linkpath[MAX_FILENAME_LEN + 1];
|
|
/** \brief The full URL of the file */
|
|
char f_url[MAX_PATH_LEN + 1];
|
|
/** \brief The type of the link */
|
|
LinkType type;
|
|
/** \brief CURLINFO_CONTENT_LENGTH_DOWNLOAD of the file */
|
|
size_t content_length;
|
|
/** \brief The next LinkTable level, if it is a LINK_DIR */
|
|
LinkTable *next_table;
|
|
/** \brief CURLINFO_FILETIME obtained from the server */
|
|
long time;
|
|
/** \brief The pointer associated with the cache file */
|
|
Cache *cache_ptr;
|
|
/** \brief Stores *sonic related data */
|
|
Sonic sonic;
|
|
};
|
|
|
|
/**
|
|
* \brief root link table
|
|
*/
|
|
extern LinkTable *ROOT_LINK_TBL;
|
|
|
|
/**
|
|
* \brief the offset for calculating partial URL
|
|
*/
|
|
extern int ROOT_LINK_OFFSET;
|
|
|
|
/**
|
|
* \brief initialise link sub-system.
|
|
*/
|
|
LinkTable *LinkSystem_init(const char *raw_url);
|
|
|
|
/**
|
|
* \brief Set the stats of a link, after curl multi handle finished querying
|
|
*/
|
|
void Link_set_file_stat(Link *this_link, CURL *curl);
|
|
|
|
/**
|
|
* \brief create a new LinkTable
|
|
*/
|
|
LinkTable *LinkTable_new(const char *url);
|
|
|
|
/**
|
|
* \brief download a path
|
|
* \return the number of bytes downloaded
|
|
*/
|
|
long path_download(const char *path, char *output_buf, size_t size,
|
|
off_t offset);
|
|
|
|
/**
|
|
* \brief Download a Link
|
|
* \return the number of bytes downloaded
|
|
*/
|
|
long Link_download(Link *link, char *output_buf, size_t req_size,
|
|
off_t offset);
|
|
|
|
/**
|
|
* \brief find the link associated with a path
|
|
*/
|
|
Link *path_to_Link(const char *path);
|
|
|
|
/**
|
|
* \brief return the link table for the associated path
|
|
*/
|
|
LinkTable *path_to_Link_LinkTable_new(const char *path);
|
|
|
|
/**
|
|
* \brief dump a link table to the disk.
|
|
*/
|
|
int LinkTable_disk_save(LinkTable *linktbl, const char *dirn);
|
|
|
|
/**
|
|
* \brief load a link table from the disk.
|
|
*/
|
|
LinkTable *LinkTable_disk_open(const char *dirn);
|
|
|
|
/**
|
|
* \brief Download a link's content to the memory
|
|
* \warning You MUST free the memory field in TransferStruct after use!
|
|
*/
|
|
TransferStruct Link_download_full(Link *head_link);
|
|
|
|
/**
|
|
* \brief Allocate a LinkTable
|
|
* \note This does not fill in the LinkTable.
|
|
*/
|
|
LinkTable *LinkTable_alloc(const char *url);
|
|
|
|
/**
|
|
* \brief free a LinkTable
|
|
*/
|
|
void LinkTable_free(LinkTable *linktbl);
|
|
|
|
/**
|
|
* \brief print a LinkTable
|
|
*/
|
|
void LinkTable_print(LinkTable *linktbl);
|
|
|
|
/**
|
|
* \brief add a Link to a LinkTable
|
|
*/
|
|
void LinkTable_add(LinkTable *linktbl, Link *link);
|
|
#endif
|