(no commit message)
[oweals/gnunet.git] / 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
34
35 /**
36  * Start downloading hostlists from hostlist servers as necessary.
37  *
38  * @param c the configuration to use
39  * @param s the scheduler to use
40  * @param st hande for publishing statistics
41  * @param ch set to handler for connect notifications
42  * @param dh set to handler for disconnect notifications
43  * @param msgh set to handler for message handler notifications
44  * @return GNUNET_OK on success
45  */
46 int
47 GNUNET_HOSTLIST_client_start (const struct GNUNET_CONFIGURATION_Handle *c,
48                               struct GNUNET_SCHEDULER_Handle *s,
49                               struct GNUNET_STATISTICS_Handle *st,
50                               GNUNET_CORE_ConnectEventHandler *ch,
51                               GNUNET_CORE_DisconnectEventHandler *dh,
52                               GNUNET_CORE_MessageCallback *msgh);
53
54
55 /**
56  * Stop downloading hostlists from hostlist servers as necessary.
57  */
58 void
59 GNUNET_HOSTLIST_client_stop (void);
60
61
62 #endif
63 /* end of hostlist-client.h */