src/hostlist/hostlist-client.h

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2009 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 2, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @file hostlist/hostlist-client.h
  23  * @brief hostlist support.  Downloads HELLOs via HTTP.
  24  * @author Christian Grothoff
  25  */
  26
  27 #ifndef HOSTLIST_CLIENT_H
  28 #define HOSTLIST_CLIENT_H
  29
  30 #include "gnunet_core_service.h"
  31 #include "gnunet_statistics_service.h"
  32 #include "gnunet_util_lib.h"
  33 #include "gnunet_time_lib.h"
  34
  35 #define MAX_NUMBER_HOSTLISTS 30
  36 #define SAVING_INTERVALL GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 30)
  37
  38 /*
  39  * Defines concerning the hostlist quality metric
  40  */
  41
  42 #define HOSTLIST_INITIAL 10000
  43 #define HOSTLIST_FAILED_DOWNLOAD 100
  44 #define HOSTLIST_SUCCESSFUL_DOWNLOAD 100
  45 #define HOSTLIST_SUCCESSFUL_HELLO 1
  46
  47
  48
  49 /**
  50  * Start downloading hostlists from hostlist servers as necessary.
  51  *
  52  * @param c the configuration to use
  53  * @param s the scheduler to use
  54  * @param st hande for publishing statistics
  55  * @param ch set to handler for connect notifications
  56  * @param dh set to handler for disconnect notifications
  57  * @param msgh set to handler for message handler notifications
  58  * @param learn set if client is learning new hostlists
  59  * @return GNUNET_OK on success
  60  */
  61 int
  62 GNUNET_HOSTLIST_client_start (const struct GNUNET_CONFIGURATION_Handle *c,
  63                               struct GNUNET_SCHEDULER_Handle *s,
  64                               struct GNUNET_STATISTICS_Handle *st,
  65                               GNUNET_CORE_ConnectEventHandler *ch,
  66                               GNUNET_CORE_DisconnectEventHandler *dh,
  67                               GNUNET_CORE_MessageCallback *msgh,
  68                               int learn);
  69
  70
  71 /**
  72  * Stop downloading hostlists from hostlist servers as necessary.
  73  */
  74 void
  75 GNUNET_HOSTLIST_client_stop (void);
  76
  77
  78 #endif
  79 /* end of hostlist-client.h */