X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/f37c549b29baa06cc6931ce0434d90ab7f619d6f..9979924fa3b7982b47b57555215e258dcc4d51c1:/src/download.h?ds=sidebyside diff --git a/src/download.h b/src/download.h index f4aa8df5..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 @@ -24,6 +25,8 @@ #include +G_BEGIN_DECLS + /* File content check */ typedef gboolean (*VikFileContentCheckerFunc) (FILE*); gboolean a_check_map_file(FILE*); @@ -31,6 +34,17 @@ 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. @@ -47,10 +61,46 @@ typedef struct { * File content checker. */ VikFileContentCheckerFunc check_file; -} DownloadOptions; + + /** + * 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, DownloadOptions *opt ); -int a_ftp_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadOptions *opt ); +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