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 16
  36
  37 /*
  38  * a single hostlist obtained by hostlist advertisements
  39  */
  40 struct GNUNET_Hostlist
  41 {
  42
  43   struct GNUNET_PeerIdentity    peer;
  44   char *                        hostlist_uri;
  45   unsigned long                 hello_count;
  46   unsigned long                 times_used;
  47   struct GNUNET_TIME_Absolute   time_creation;
  48   struct GNUNET_TIME_Absolute   time_last_usage;
  49   uint64_t                      quality;
  50 };
  51
  52
  53 /**
  54  * Start downloading hostlists from hostlist servers as necessary.
  55  *
  56  * @param c the configuration to use
  57  * @param s the scheduler to use
  58  * @param st hande for publishing statistics
  59  * @param ch set to handler for connect notifications
  60  * @param dh set to handler for disconnect notifications
  61  * @param msgh set to handler for message handler notifications
  62  * @param learn set if client is learning new hostlists
  63  * @return GNUNET_OK on success
  64  */
  65 int
  66 GNUNET_HOSTLIST_client_start (const struct GNUNET_CONFIGURATION_Handle *c,
  67                               struct GNUNET_SCHEDULER_Handle *s,
  68                               struct GNUNET_STATISTICS_Handle *st,
  69                               GNUNET_CORE_ConnectEventHandler *ch,
  70                               GNUNET_CORE_DisconnectEventHandler *dh,
  71                               GNUNET_CORE_MessageCallback *msgh,
  72                               int learn);
  73
  74
  75 /**
  76  * Stop downloading hostlists from hostlist servers as necessary.
  77  */
  78 void
  79 GNUNET_HOSTLIST_client_stop (void);
  80
  81
  82 #endif
  83 /* end of hostlist-client.h */