X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/85611cd91c81b8218e954597a3aaf5e31bb22bfc..9979924fa3b7982b47b57555215e258dcc4d51c1:/src/download.h diff --git a/src/download.h b/src/download.h index 50edc5eb..91caa9de 100644 --- a/src/download.h +++ b/src/download.h @@ -2,6 +2,7 @@ * viking -- GPS Data and Topo Analyzer, Explorer, and Manager * * Copyright (C) 2003-2005, Evan Battaglia + * Copyright (C) 2007, Guilhem Bonnefille * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -21,8 +22,85 @@ #ifndef _VIKING_DOWNLOAD_H #define _VIKING_DOWNLOAD_H + +#include + +G_BEGIN_DECLS + +/* File content check */ +typedef gboolean (*VikFileContentCheckerFunc) (FILE*); +gboolean a_check_map_file(FILE*); +gboolean a_check_html_file(FILE*); +gboolean a_check_kml_file(FILE*); + +typedef struct { + /** + * Check if the server has a more recent file than the one we have before downloading it + * This uses http header If-Modified-Since + */ + gboolean check_file_server_time; + + /** + * Set if the server handle ETag + */ + gboolean use_etag; + + /** + * The REFERER string to use. + * Could be NULL. + */ + gchar *referer; + + /** + * follow_location specifies the number of retries + * to follow a redirect while downloading a page. + */ + glong follow_location; + + /** + * File content checker. + */ + VikFileContentCheckerFunc check_file; + + /** + * If need to authenticate on download + * format: 'username:password' + */ + gchar *user_pass; + +} DownloadMapOptions; + +typedef struct { + /** + * Time sent to server on header If-Modified-Since + */ + time_t time_condition; + /** + * Etag sent by server on previous download + */ + char *etag; + /** + * Etag sent by server on this download + */ + char *new_etag; + +} DownloadFileOptions; + +void a_download_init(void); + /* TODO: convert to Glib */ -int a_http_download_get_url ( const char *hostname, const char *uri, const char *fn ); -int a_http_download_get_url_nohostname ( const char *hostname, const char *uri, const char *fn ); +int a_http_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadMapOptions *opt, void *handle ); +int a_ftp_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadMapOptions *opt, void *handle ); +void *a_download_handle_init (); +void a_download_handle_cleanup ( void *handle ); + +gchar *a_download_uri_to_tmp_file ( const gchar *uri, DownloadMapOptions *options ); + +/* Error messages returned by download functions */ +enum { DOWNLOAD_NO_ERROR = 0, + DOWNLOAD_NO_NEWER_FILE, + DOWNLOAD_ERROR }; + +G_END_DECLS #endif