Improve README to mention OSM.

[andy/viking.git] / src / download.h

diff --git a/src/download.h b/src/download.h
index fbd2de4c20c8595abf7b02a4356e676e0ed85532..591c8919bd0021c0fd3c53a4ff1e4139c2421756 100644 (file)
--- 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 <gtoevan@gmx.net>
+ * Copyright (C) 2007, Guilhem Bonnefille <guilhem.bonnefille@gmail.com>
  *
  * 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
@@ -22,7 +23,26 @@
 #ifndef _VIKING_DOWNLOAD_H
 #define _VIKING_DOWNLOAD_H
 
+#include <stdio.h>
+
+/* 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.
@@ -34,9 +54,41 @@ typedef struct {
    * to follow a redirect while downloading a page.
    */
   glong follow_location;
-} DownloadOptions;
+  
+  /**
+   * File content checker.
+   */
+  VikFileContentCheckerFunc check_file;
+
+} 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_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 );
+
+/* Error messages returned by download functions */
+enum { DOWNLOAD_NO_ERROR = 0,
+       DOWNLOAD_NO_NEWER_FILE,
+       DOWNLOAD_ERROR };
 
 #endif