GNUnet  0.11.x
Data Structures | Functions | Variables
gnunet-daemon-hostlist.c File Reference

code for bootstrapping via hostlist servers More...

#include "platform.h"
#include "gnunet-daemon-hostlist_client.h"
#include "gnunet_core_service.h"
#include "gnunet_util_lib.h"
#include "gnunet_protocols.h"
#include "gnunet_statistics_service.h"
#include "gnunet-daemon-hostlist_server.h"
Include dependency graph for gnunet-daemon-hostlist.c:

Go to the source code of this file.

Data Structures

struct  GNUNET_HOSTLIST_ADV_Message
 A HOSTLIST_ADV message is used to exchange information about hostlist advertisements. More...
 

Functions

static void core_init (void *cls, const struct GNUNET_PeerIdentity *my_identity)
 Callback invoked once our connection to CORE service is up. More...
 
static int check_advertisement (void *cls, const struct GNUNET_MessageHeader *message)
 Core handler for p2p hostlist advertisements. More...
 
static void handle_advertisement (void *cls, const struct GNUNET_MessageHeader *message)
 Core handler for p2p hostlist advertisements. More...
 
static void * connect_handler (void *cls, const struct GNUNET_PeerIdentity *peer, struct GNUNET_MQ_Handle *mq)
 Method called whenever a given peer connects. More...
 
static void disconnect_handler (void *cls, const struct GNUNET_PeerIdentity *peer, void *internal_cls)
 Method called whenever a given peer disconnects. More...
 
static void cleaning_task (void *cls)
 Last task run during shutdown. More...
 
static void run (void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
 Main function that will be run. More...
 
int main (int argc, char *const *argv)
 The main function for the hostlist daemon. More...
 

Variables

static int advertising
 Set if we are allowed to advertise our hostlist to others. More...
 
static int provide_hostlist
 Set if the user wants us to run a hostlist server. More...
 
static GNUNET_CORE_ConnectEventHandler server_ch
 Handle to hostlist server's connect handler. More...
 
static int bootstrapping
 Set if we are allowed to learn about peers by accessing hostlist servers. More...
 
static int learning
 Set if the user allows us to learn about new hostlists from the network. More...
 
static struct GNUNET_STATISTICS_Handlestats
 Statistics handle. More...
 
static struct GNUNET_CORE_Handlecore
 Handle to the core service (NULL until we've connected to it). More...
 
static GNUNET_HOSTLIST_UriHandler client_adv_handler
 Handle to the hostlist client's advertisement handler. More...
 
static GNUNET_CORE_ConnectEventHandler client_ch
 Handle to hostlist client's connect handler. More...
 
static GNUNET_CORE_DisconnectEventHandler client_dh
 Handle to hostlist client's disconnect handler. More...
 
static GNUNET_NETWORK_STRUCT_END struct GNUNET_PeerIdentity me
 Our own peer identity. More...
 

Detailed Description

code for bootstrapping via hostlist servers

Author
Christian Grothoff

Definition in file gnunet-daemon-hostlist.c.

Function Documentation

◆ core_init()

static void core_init ( void *  cls,
const struct GNUNET_PeerIdentity my_identity 
)
static

Callback invoked once our connection to CORE service is up.

Parameters
clsNULL
my_identityour peer's identity

Definition at line 129 of file gnunet-daemon-hostlist.c.

References me, and my_identity.

Referenced by run().

131 {
132  me = *my_identity;
133 }
static GNUNET_NETWORK_STRUCT_END struct GNUNET_PeerIdentity me
Our own peer identity.
static struct GNUNET_PeerIdentity my_identity
Identity of this peer.
Here is the caller graph for this function:

◆ check_advertisement()

static int check_advertisement ( void *  cls,
const struct GNUNET_MessageHeader message 
)
static

Core handler for p2p hostlist advertisements.

Parameters
clsclosure
messageadvertisement message we got
Returns
GNUNET_OK if message is well-formed

Definition at line 144 of file gnunet-daemon-hostlist.c.

References GNUNET_break_op, GNUNET_OK, GNUNET_SYSERR, size, GNUNET_MessageHeader::size, and uri.

146 {
147  size_t size;
148  size_t uri_size;
149  const char *uri;
150 
151  size = ntohs (message->size);
152  if (size <= sizeof(struct GNUNET_MessageHeader))
153  {
154  GNUNET_break_op (0);
155  return GNUNET_SYSERR;
156  }
157  uri = (const char *) &message[1];
158  uri_size = size - sizeof(struct GNUNET_MessageHeader);
159  if (uri[uri_size - 1] != '\0')
160  {
161  GNUNET_break_op (0);
162  return GNUNET_SYSERR;
163  }
164  return GNUNET_OK;
165 }
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
static struct GNUNET_FS_Uri * uri
Value of URI provided on command-line (when not publishing a file but just creating UBlocks to refer ...
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
static unsigned int size
Size of the "table".
Definition: peer.c:67
Header for all communications.

◆ handle_advertisement()

static void handle_advertisement ( void *  cls,
const struct GNUNET_MessageHeader message 
)
static

Core handler for p2p hostlist advertisements.

Parameters
clsclosure
messageadvertisement message we got
Returns
GNUNET_OK on success

Definition at line 176 of file gnunet-daemon-hostlist.c.

References client_adv_handler, GNUNET_assert, and uri.

178 {
179  const char *uri = (const char *) &message[1];
180 
182  (void) (*client_adv_handler)(uri);
183 }
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static struct GNUNET_FS_Uri * uri
Value of URI provided on command-line (when not publishing a file but just creating UBlocks to refer ...
static GNUNET_HOSTLIST_UriHandler client_adv_handler
Handle to the hostlist client&#39;s advertisement handler.

◆ connect_handler()

static void* connect_handler ( void *  cls,
const struct GNUNET_PeerIdentity peer,
struct GNUNET_MQ_Handle mq 
)
static

Method called whenever a given peer connects.

Wrapper to call both client's and server's functions

Parameters
clsclosure
peerpeer identity this notification is about
mqqueue for sending messages to peer
Returns
peer

Definition at line 196 of file gnunet-daemon-hostlist.c.

References client_ch, GNUNET_assert, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_memcmp, me, peer, and server_ch.

Referenced by run().

199 {
200  if (0 == GNUNET_memcmp (&me,
201  peer))
202  return NULL;
204  "A new peer connected, notifying client and server\n");
205  if (NULL != client_ch)
206  GNUNET_assert (NULL ==
207  (*client_ch)(cls,
208  peer,
209  mq));
210  if (NULL != server_ch)
211  GNUNET_assert (NULL ==
212  (*server_ch)(cls,
213  peer,
214  mq));
215  return (void *) peer;
216 }
static GNUNET_NETWORK_STRUCT_END struct GNUNET_PeerIdentity me
Our own peer identity.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static GNUNET_CORE_ConnectEventHandler server_ch
Handle to hostlist server&#39;s connect handler.
struct GNUNET_TESTBED_Peer * peer
The peer associated with this model.
#define GNUNET_memcmp(a, b)
Compare memory in a and b, where both must be of the same pointer type.
#define GNUNET_log(kind,...)
static GNUNET_CORE_ConnectEventHandler client_ch
Handle to hostlist client&#39;s connect handler.
Here is the caller graph for this function:

◆ disconnect_handler()

static void disconnect_handler ( void *  cls,
const struct GNUNET_PeerIdentity peer,
void *  internal_cls 
)
static

Method called whenever a given peer disconnects.

Wrapper to call both client's and server's functions

Parameters
clsclosure
peerpeer identity this notification is about

Definition at line 227 of file gnunet-daemon-hostlist.c.

References client_dh, GNUNET_memcmp, me, and peer.

Referenced by run().

230 {
231  if (0 == GNUNET_memcmp (&me,
232  peer))
233  return;
234  /* call hostlist client disconnect handler */
235  if (NULL != client_dh)
236  (*client_dh)(cls,
237  peer,
238  NULL);
239 }
static GNUNET_NETWORK_STRUCT_END struct GNUNET_PeerIdentity me
Our own peer identity.
static GNUNET_CORE_DisconnectEventHandler client_dh
Handle to hostlist client&#39;s disconnect handler.
struct GNUNET_TESTBED_Peer * peer
The peer associated with this model.
#define GNUNET_memcmp(a, b)
Compare memory in a and b, where both must be of the same pointer type.
Here is the caller graph for this function:

◆ cleaning_task()

static void cleaning_task ( void *  cls)
static

Last task run during shutdown.

Disconnects us from the other services.

Parameters
clsNULL

Definition at line 249 of file gnunet-daemon-hostlist.c.

References bootstrapping, GNUNET_CORE_disconnect(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_HOSTLIST_client_stop(), GNUNET_HOSTLIST_server_stop(), GNUNET_log, GNUNET_NO, GNUNET_STATISTICS_destroy(), and provide_hostlist.

Referenced by run().

250 {
252  "Hostlist daemon is shutting down\n");
253  if (NULL != core)
254  {
256  core = NULL;
257  }
258  if (bootstrapping)
259  {
261  }
262  if (provide_hostlist)
263  {
265  }
266  if (NULL != stats)
267  {
269  GNUNET_NO);
270  stats = NULL;
271  }
272 }
void GNUNET_HOSTLIST_client_stop()
Stop downloading hostlists from hostlist servers as necessary.
void GNUNET_STATISTICS_destroy(struct GNUNET_STATISTICS_Handle *h, int sync_first)
Destroy a handle (free all state associated with it).
static int provide_hostlist
Set if the user wants us to run a hostlist server.
void GNUNET_CORE_disconnect(struct GNUNET_CORE_Handle *handle)
Disconnect from the core service.
Definition: core_api.c:730
static struct GNUNET_CORE_Handle * core
Handle to the core service (NULL until we&#39;ve connected to it).
static int bootstrapping
Set if we are allowed to learn about peers by accessing hostlist servers.
void GNUNET_HOSTLIST_server_stop()
Stop server offering our hostlist.
#define GNUNET_log(kind,...)
static struct GNUNET_STATISTICS_Handle * stats
Statistics handle.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ run()

static void run ( void *  cls,
char *const *  args,
const char *  cfgfile,
const struct GNUNET_CONFIGURATION_Handle cfg 
)
static

Main function that will be run.

Parameters
clsclosure
argsremaining command-line arguments
cfgfilename of the configuration file used (for saving, can be NULL!)
cfgconfiguration

Definition at line 284 of file gnunet-daemon-hostlist.c.

References _, advertising, bootstrapping, cleaning_task(), client_adv_handler, client_ch, client_dh, connect_handler(), core_init(), disconnect_handler(), GNUNET_break, GNUNET_CORE_connect(), GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_WARNING, GNUNET_HOSTLIST_client_start(), GNUNET_HOSTLIST_server_start(), GNUNET_log, GNUNET_MESSAGE_TYPE_HOSTLIST_ADVERTISEMENT, GNUNET_MQ_handler_end, GNUNET_MQ_hd_var_size, GNUNET_SCHEDULER_add_shutdown(), GNUNET_SCHEDULER_shutdown(), GNUNET_STATISTICS_create(), learning, provide_hostlist, and server_ch.

Referenced by main().

288 {
289  struct GNUNET_MQ_MessageHandler learn_handlers[] = {
290  GNUNET_MQ_hd_var_size (advertisement,
292  struct GNUNET_MessageHeader,
293  NULL),
295  };
296  struct GNUNET_MQ_MessageHandler no_learn_handlers[] = {
298  };
299 
300  if ((! bootstrapping) && (! learning)
301  && (! provide_hostlist)
302  )
303  {
305  _ (
306  "None of the functions for the hostlist daemon were enabled. I have no reason to run!\n"));
307  return;
308  }
309  stats = GNUNET_STATISTICS_create ("hostlist", cfg);
310  if (NULL == stats)
311  {
312  GNUNET_break (0);
313  return;
314  }
315  if (bootstrapping)
317  stats,
318  &client_ch,
319  &client_dh,
321  learning);
322  core =
323  GNUNET_CORE_connect (cfg,
324  NULL,
325  &core_init,
328  learning ? learn_handlers : no_learn_handlers);
329 
330 
331  if (provide_hostlist)
333  stats,
334  core,
335  &server_ch,
336  advertising);
338  NULL);
339 
340  if (NULL == core)
341  {
343  _ ("Failed to connect to `%s' service.\n"), "core");
345  return;
346  }
347 }
int GNUNET_HOSTLIST_server_start(const struct GNUNET_CONFIGURATION_Handle *c, struct GNUNET_STATISTICS_Handle *st, struct GNUNET_CORE_Handle *co, GNUNET_CORE_ConnectEventHandler *server_ch, int advertise)
Start server offering our hostlist.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_shutdown(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run on shutdown, that is when a CTRL-C signal is received, or when GNUNET_SCHEDULER_shutdown() is being invoked.
Definition: scheduler.c:1331
struct GNUNET_STATISTICS_Handle * GNUNET_STATISTICS_create(const char *subsystem, const struct GNUNET_CONFIGURATION_Handle *cfg)
Get handle for the statistics service.
static void disconnect_handler(void *cls, const struct GNUNET_PeerIdentity *peer, void *internal_cls)
Method called whenever a given peer disconnects.
static void * connect_handler(void *cls, const struct GNUNET_PeerIdentity *peer, struct GNUNET_MQ_Handle *mq)
Method called whenever a given peer connects.
static void core_init(void *cls, const struct GNUNET_PeerIdentity *my_identity)
Callback invoked once our connection to CORE service is up.
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:531
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
static void cleaning_task(void *cls)
Last task run during shutdown.
#define _(String)
GNU gettext support macro.
Definition: platform.h:184
static GNUNET_CORE_DisconnectEventHandler client_dh
Handle to hostlist client&#39;s disconnect handler.
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
static int learning
Set if the user allows us to learn about new hostlists from the network.
static GNUNET_CORE_ConnectEventHandler server_ch
Handle to hostlist server&#39;s connect handler.
Message handler for a specific message type.
static int provide_hostlist
Set if the user wants us to run a hostlist server.
struct GNUNET_CORE_Handle * GNUNET_CORE_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, void *cls, GNUNET_CORE_StartupCallback init, GNUNET_CORE_ConnectEventHandler connects, GNUNET_CORE_DisconnectEventHandler disconnects, const struct GNUNET_MQ_MessageHandler *handlers)
Connect to the core service.
Definition: core_api.c:692
int GNUNET_HOSTLIST_client_start(const struct GNUNET_CONFIGURATION_Handle *c, struct GNUNET_STATISTICS_Handle *st, GNUNET_CORE_ConnectEventHandler *ch, GNUNET_CORE_DisconnectEventHandler *dh, GNUNET_HOSTLIST_UriHandler *msgh, int learn)
Start downloading hostlists from hostlist servers as necessary.
static struct GNUNET_CORE_Handle * core
Handle to the core service (NULL until we&#39;ve connected to it).
static int bootstrapping
Set if we are allowed to learn about peers by accessing hostlist servers.
static GNUNET_HOSTLIST_UriHandler client_adv_handler
Handle to the hostlist client&#39;s advertisement handler.
static int advertising
Set if we are allowed to advertise our hostlist to others.
#define GNUNET_log(kind,...)
#define GNUNET_MESSAGE_TYPE_HOSTLIST_ADVERTISEMENT
Further X-VINE DHT messages continued from 880.
Header for all communications.
static struct GNUNET_STATISTICS_Handle * stats
Statistics handle.
static GNUNET_CORE_ConnectEventHandler client_ch
Handle to hostlist client&#39;s connect handler.
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ main()

int main ( int  argc,
char *const *  argv 
)

The main function for the hostlist daemon.

Parameters
argcnumber of arguments from the command line
argvcommand line arguments
Returns
0 ok, 1 on error

Definition at line 358 of file gnunet-daemon-hostlist.c.

References _, advertising, bootstrapping, gettext_noop, GNUNET_free_nz, GNUNET_GETOPT_OPTION_END, GNUNET_GETOPT_option_flag(), GNUNET_log_setup(), GNUNET_OK, GNUNET_PROGRAM_run(), GNUNET_STRINGS_get_utf8_args(), learning, provide_hostlist, ret, and run().

359 {
362  "advertise",
363  gettext_noop (
364  "advertise our hostlist to other peers"),
365  &advertising),
367  "bootstrap",
368  gettext_noop (
369  "bootstrap using hostlists (it is highly recommended that you always use this option)"),
370  &bootstrapping),
372  "enable-learning",
373  gettext_noop (
374  "enable learning about hostlist servers from other peers"),
375  &learning),
377  "provide-hostlist",
378  gettext_noop ("provide a hostlist server"),
381  };
382 
383  int ret;
384 
385  if (GNUNET_OK != GNUNET_STRINGS_get_utf8_args (argc, argv, &argc, &argv))
386  return 2;
387 
388  GNUNET_log_setup ("hostlist", "WARNING", NULL);
389  ret =
390  (GNUNET_OK ==
391  GNUNET_PROGRAM_run (argc, argv,
392  "hostlist",
393  _ ("GNUnet hostlist server and client"),
394  options,
395  &run, NULL)) ? 0 : 1;
396  GNUNET_free_nz ((void *) argv);
397  return ret;
398 }
struct GNUNET_GETOPT_CommandLineOption options[]
Definition: 002.c:5
int GNUNET_STRINGS_get_utf8_args(int argc, char *const *argv, int *u8argc, char *const **u8argv)
Returns utf-8 encoded arguments.
Definition: strings.c:1459
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
Definition of a command line option.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_OPTION_END
Definition: 002.c:13
#define _(String)
GNU gettext support macro.
Definition: platform.h:184
static int learning
Set if the user allows us to learn about new hostlists from the network.
static int provide_hostlist
Set if the user wants us to run a hostlist server.
#define GNUNET_free_nz(ptr)
Wrapper around free.
static int bootstrapping
Set if we are allowed to learn about peers by accessing hostlist servers.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_flag(char shortName, const char *name, const char *description, int *val)
Allow user to specify a flag (which internally means setting an integer to 1/GNUNET_YES/GNUNET_OK.
static int advertising
Set if we are allowed to advertise our hostlist to others.
int GNUNET_PROGRAM_run(int argc, char *const *argv, const char *binaryName, const char *binaryHelp, const struct GNUNET_GETOPT_CommandLineOption *options, GNUNET_PROGRAM_Main task, void *task_cls)
Run a standard GNUnet command startup sequence (initialize loggers and configuration, parse options).
Definition: program.c:372
int GNUNET_log_setup(const char *comp, const char *loglevel, const char *logfile)
Setup logging.
#define gettext_noop(String)
Definition: gettext.h:69
static void run(void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
Main function that will be run.
Here is the call graph for this function:

Variable Documentation

◆ advertising

int advertising
static

Set if we are allowed to advertise our hostlist to others.

Definition at line 38 of file gnunet-daemon-hostlist.c.

Referenced by main(), and run().

◆ provide_hostlist

int provide_hostlist
static

Set if the user wants us to run a hostlist server.

Definition at line 43 of file gnunet-daemon-hostlist.c.

Referenced by cleaning_task(), main(), and run().

◆ server_ch

Handle to hostlist server's connect handler.

Definition at line 48 of file gnunet-daemon-hostlist.c.

Referenced by connect_handler(), and run().

◆ bootstrapping

int bootstrapping
static

Set if we are allowed to learn about peers by accessing hostlist servers.

Definition at line 54 of file gnunet-daemon-hostlist.c.

Referenced by cleaning_task(), main(), and run().

◆ learning

int learning
static

Set if the user allows us to learn about new hostlists from the network.

Definition at line 60 of file gnunet-daemon-hostlist.c.

Referenced by main(), and run().

◆ stats

struct GNUNET_STATISTICS_Handle* stats
static

Statistics handle.

Definition at line 65 of file gnunet-daemon-hostlist.c.

◆ core

struct GNUNET_CORE_Handle* core
static

Handle to the core service (NULL until we've connected to it).

Definition at line 70 of file gnunet-daemon-hostlist.c.

◆ client_adv_handler

GNUNET_HOSTLIST_UriHandler client_adv_handler
static

Handle to the hostlist client's advertisement handler.

Definition at line 75 of file gnunet-daemon-hostlist.c.

Referenced by handle_advertisement(), and run().

◆ client_ch

Handle to hostlist client's connect handler.

Definition at line 80 of file gnunet-daemon-hostlist.c.

Referenced by connect_handler(), and run().

◆ client_dh

Handle to hostlist client's disconnect handler.

Definition at line 85 of file gnunet-daemon-hostlist.c.

Referenced by disconnect_handler(), and run().

◆ me