(no commit message)
[oweals/gnunet.git] / src / topology / gnunet-daemon-topology.c
1 /*
2      This file is part of GNUnet.
3      (C) 2007, 2008, 2009, 2010 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 3, 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 topology/gnunet-daemon-topology.c
23  * @brief code for maintaining the mesh topology
24  * @author Christian Grothoff
25  */
26
27 #include <stdlib.h>
28 #include "platform.h"
29 #include "gnunet_constants.h"
30 #include "gnunet_core_service.h"
31 #include "gnunet_protocols.h"
32 #include "gnunet_peerinfo_service.h"
33 #include "gnunet_statistics_service.h"
34 #include "gnunet_transport_service.h"
35 #include "gnunet_util_lib.h"
36
37
38 #define DEBUG_TOPOLOGY GNUNET_YES
39
40 /**
41  * For how long do we blacklist a peer after a failed connection
42  * attempt?
43  */
44 #define GREYLIST_AFTER_ATTEMPT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 15)
45
46 /**
47  * For how long do we blacklist a friend after a failed connection
48  * attempt?
49  */
50 #define GREYLIST_AFTER_ATTEMPT_FRIEND GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 2)
51
52 /**
53  * For how long do we blacklist anyone under any cirumstances after a failed connection
54  * attempt?
55  */
56 #define GREYLIST_AFTER_ATTEMPT_MIN GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 15)
57
58 /**
59  * For how long do we blacklist anyone under any cirumstances after a failed connection
60  * attempt?
61  */
62 #define GREYLIST_AFTER_ATTEMPT_MAX GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_HOURS, 18)
63
64 /**
65  * How often do we at most advertise any HELLO to a peer?
66  */
67 #define HELLO_ADVERTISEMENT_MIN_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_HOURS, 4)
68
69 /**
70  * How often do we at most advertise the same HELLO to the same peer?
71  */
72 #define HELLO_ADVERTISEMENT_MIN_REPEAT_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_HOURS, 4)
73
74
75 /**
76  * Record for neighbours, friends and blacklisted peers.
77  */
78 struct Peer
79 {
80   /**
81    * Which peer is this entry about?
82    */
83   struct GNUNET_PeerIdentity pid;
84
85   /**
86    * Our handle for the request to transmit HELLOs to this peer; NULL
87    * if no such request is pending.
88    */
89   struct GNUNET_CORE_TransmitHandle *hello_req;  
90
91   /**
92    * Our handle for the request to connect to this peer; NULL if no
93    * such request is pending.
94    */
95   struct GNUNET_CORE_PeerRequestHandle *connect_req;  
96
97   /**
98    * Pointer to the HELLO message of this peer; can be NULL.
99    */
100   struct GNUNET_HELLO_Message *hello;
101
102   /**
103    * Bloom filter used to mark which peers already got the HELLO
104    * from this peer.
105    */
106   struct GNUNET_CONTAINER_BloomFilter *filter;
107
108   /**
109    * Until what time should we not try to connect again
110    * to this peer?
111    */
112   struct GNUNET_TIME_Absolute greylisted_until;
113
114   /**
115    * Next time we are allowed to transmit a HELLO to this peer?
116    */
117   struct GNUNET_TIME_Absolute next_hello_allowed;
118
119   /**
120    * When should we reset the bloom filter of this entry?
121    */
122   struct GNUNET_TIME_Absolute filter_expiration;
123
124   /**
125    * ID of task we use to wait for the time to send the next HELLO
126    * to this peer.
127    */
128   GNUNET_SCHEDULER_TaskIdentifier hello_delay_task;
129
130   /**
131    * ID of task we use to clear peers from the greylist.
132    */
133   GNUNET_SCHEDULER_TaskIdentifier greylist_clean_task;
134
135   /**
136    * How often have we tried so far?
137    */
138   unsigned int connect_attempts;
139
140   /**
141    * Is this peer listed here because he is a friend?
142    */
143   int is_friend;
144
145   /**
146    * Are we connected to this peer right now?
147    */
148   int is_connected;
149
150 };
151
152
153 /**
154  * Our peerinfo notification context.  We use notification
155  * to instantly learn about new peers as they are discovered.
156  */
157 static struct GNUNET_PEERINFO_NotifyContext *peerinfo_notify;
158
159 /**
160  * Our configuration.
161  */
162 static const struct GNUNET_CONFIGURATION_Handle *cfg;
163
164 /**
165  * Handle to the core API.
166  */
167 static struct GNUNET_CORE_Handle *handle;
168
169 /**
170  * Handle to the transport API.
171  */
172 static struct GNUNET_TRANSPORT_Handle *transport;
173
174 /**
175  * Identity of this peer.
176  */
177 static struct GNUNET_PeerIdentity my_identity;
178
179 /**
180  * All of our friends, all of our current neighbours and all peers for
181  * which we have HELLOs.  So pretty much everyone.  Maps peer identities
182  * to 'struct Peer *' values.
183  */
184 static struct GNUNET_CONTAINER_MultiHashMap *peers;
185
186 /**
187  * Handle for reporting statistics.
188  */
189 static struct GNUNET_STATISTICS_Handle *stats;
190
191 /**
192  * Blacklist (NULL if we have none).
193  */
194 static struct GNUNET_TRANSPORT_Blacklist *blacklist;
195
196 /**
197  * Flag to disallow non-friend connections (pure F2F mode).
198  */
199 static int friends_only;
200
201 /**
202  * Minimum number of friends to have in the
203  * connection set before we allow non-friends.
204  */
205 static unsigned int minimum_friend_count;
206
207 /**
208  * Number of peers (friends and others) that we are currently connected to.
209  */
210 static unsigned int connection_count;
211
212 /**
213  * Target number of connections.
214  */
215 static unsigned int target_connection_count;
216
217 /**
218  * Number of friends that we are currently connected to.
219  */
220 static unsigned int friend_count;
221
222 /**
223  * Should the topology daemon try to establish connections?
224  */
225 static int autoconnect;
226
227
228 /**
229  * Function that decides if a connection is acceptable or not.  
230  * If we have a blacklist, only friends are allowed, so the check
231  * is rather simple.
232  *
233  * @param cls closure
234  * @param pid peer to approve or disapproave
235  * @return GNUNET_OK if the connection is allowed
236  */
237 static int
238 blacklist_check (void *cls,
239                  const struct GNUNET_PeerIdentity *pid)
240 {
241   struct Peer *pos;
242
243   pos = GNUNET_CONTAINER_multihashmap_get (peers, &pid->hashPubKey);
244   if ( (pos != NULL) &&
245        (pos->is_friend == GNUNET_YES) )
246     return GNUNET_OK;
247   GNUNET_STATISTICS_update (stats,
248                             gettext_noop ("# peers blacklisted"),
249                             1,
250                             GNUNET_NO);
251   return GNUNET_SYSERR;
252 }
253
254
255 /**
256  * Whitelist all peers that we blacklisted; we've passed
257  * the minimum number of friends.
258  */
259 static void
260 whitelist_peers ()
261 {
262   if (blacklist != NULL)
263     {
264       GNUNET_TRANSPORT_blacklist_cancel (blacklist);
265       blacklist = NULL;
266     }
267 }
268
269
270 /**
271  * Function called by core when our attempt to connect succeeded.
272  *
273  * @param cls the 'struct Peer' for which we issued the connect request
274  * @param tc scheduler context
275  */
276 static void
277 connect_completed_callback (void *cls,
278                             const struct GNUNET_SCHEDULER_TaskContext *tc)
279 {
280   struct Peer *pos = cls;
281
282   pos->connect_req = NULL;
283 }
284
285
286 /**
287  * Check if an additional connection from the given peer is allowed.
288  * 
289  * @param peer connection to check
290  * @return GNUNET_OK if the connection is allowed
291  */
292 static int
293 is_connection_allowed (struct Peer *peer)
294 {
295   if (0 == memcmp (&my_identity, 
296                    &peer->pid, 
297                    sizeof (struct GNUNET_PeerIdentity)))
298     return GNUNET_SYSERR;       /* disallow connections to self */
299   if (peer->is_friend)
300     return GNUNET_OK;
301   if (GNUNET_YES == friends_only)
302     {
303 #if DEBUG_TOPOLOGY
304       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
305                   "Determined that `%s' is not allowed to connect (not a friend)\n",
306                   GNUNET_i2s (&peer->pid));
307 #endif       
308       return GNUNET_SYSERR;
309     }
310   if (friend_count >= minimum_friend_count)
311     return GNUNET_OK;
312 #if DEBUG_TOPOLOGY
313   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
314               "Determined that `%s' is not allowed to connect (not enough connected friends)\n",
315               GNUNET_i2s (&peer->pid));
316 #endif       
317   return GNUNET_SYSERR;
318 }
319
320
321 /**
322  * Free all resources associated with the given peer.
323  *
324  * @param cls closure (not used)
325  * @param pid identity of the peer
326  * @param value peer to free
327  * @return GNUNET_YES (always: continue to iterate)
328  */
329 static int
330 free_peer (void *cls,
331            const GNUNET_HashCode *pid,
332            void *value)
333 {
334   struct Peer *pos = value;
335
336   GNUNET_break (GNUNET_OK == 
337                 GNUNET_CONTAINER_multihashmap_remove (peers,
338                                                       pid,
339                                                       pos));
340   if (pos->hello_req != NULL)
341     GNUNET_CORE_notify_transmit_ready_cancel (pos->hello_req);
342   if (pos->connect_req != NULL)
343     GNUNET_CORE_peer_request_connect_cancel (pos->connect_req);       
344   if (pos->hello_delay_task != GNUNET_SCHEDULER_NO_TASK)
345     GNUNET_SCHEDULER_cancel (pos->hello_delay_task);
346   if (pos->greylist_clean_task != GNUNET_SCHEDULER_NO_TASK)
347     GNUNET_SCHEDULER_cancel (pos->greylist_clean_task);
348   GNUNET_free_non_null (pos->hello);   
349   if (pos->filter != NULL)
350     GNUNET_CONTAINER_bloomfilter_free (pos->filter);
351   GNUNET_free (pos);
352   return GNUNET_YES;
353 }
354
355
356 /**
357  * Discard peer entries for greylisted peers
358  * where the greylisting has expired.
359  *
360  * @param cls 'struct Peer' to greylist
361  * @param tc scheduler context
362  */
363 static void
364 remove_from_greylist (void *cls,
365                       const struct GNUNET_SCHEDULER_TaskContext *tc);
366
367
368 /**
369  * Try to connect to the specified peer.
370  *
371  * @param pos peer to connect to
372  */
373 static void
374 attempt_connect (struct Peer *pos)
375 {
376   struct GNUNET_TIME_Relative rem;
377   
378   if ( (connection_count >= target_connection_count) &&
379        (friend_count >= minimum_friend_count) )
380     return;
381   if (GNUNET_YES == pos->is_connected)
382     return;
383   if (GNUNET_OK != is_connection_allowed (pos))
384     return;
385   if (GNUNET_TIME_absolute_get_remaining (pos->greylisted_until).rel_value > 0)
386     return;
387   if (GNUNET_YES == pos->is_friend)
388     rem = GREYLIST_AFTER_ATTEMPT_FRIEND;
389   else
390     rem = GREYLIST_AFTER_ATTEMPT;
391   rem = GNUNET_TIME_relative_multiply (rem, connection_count);
392   rem = GNUNET_TIME_relative_divide (rem, target_connection_count);
393   if (pos->connect_attempts > 30)
394     pos->connect_attempts = 30;
395   rem = GNUNET_TIME_relative_multiply (rem, 1 << (++pos->connect_attempts));
396   rem = GNUNET_TIME_relative_max (rem,
397                                   GREYLIST_AFTER_ATTEMPT_MIN);
398   rem = GNUNET_TIME_relative_min (rem,
399                                   GREYLIST_AFTER_ATTEMPT_MAX);
400   pos->greylisted_until = GNUNET_TIME_relative_to_absolute (rem);
401   if (pos->greylist_clean_task != GNUNET_SCHEDULER_NO_TASK)
402     GNUNET_SCHEDULER_cancel (pos->greylist_clean_task);
403   pos->greylist_clean_task 
404     = GNUNET_SCHEDULER_add_delayed (rem,
405                                     &remove_from_greylist,
406                                     pos);
407 #if DEBUG_TOPOLOGY
408   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
409               "Asking  to connect to `%s'\n",
410               GNUNET_i2s (&pos->pid));
411 #endif
412   GNUNET_STATISTICS_update (stats,
413                             gettext_noop ("# connect requests issued to core"),
414                             1,
415                             GNUNET_NO);
416   pos->connect_req = GNUNET_CORE_peer_request_connect (handle,
417                                                        GNUNET_TIME_UNIT_MINUTES,
418                                                        &pos->pid,
419                                                        &connect_completed_callback,
420                                                        pos);
421 }
422
423
424 /**
425  * Discard peer entries for greylisted peers
426  * where the greylisting has expired.
427  *
428  * @param cls 'struct Peer' to greylist
429  * @param tc scheduler context
430  */
431 static void
432 remove_from_greylist (void *cls,
433                       const struct GNUNET_SCHEDULER_TaskContext *tc)
434 {
435   struct Peer *pos = cls;
436   struct GNUNET_TIME_Relative rem;
437
438   pos->greylist_clean_task = GNUNET_SCHEDULER_NO_TASK;
439   rem = GNUNET_TIME_absolute_get_remaining (pos->greylisted_until);
440   if (rem.rel_value == 0)
441     {
442       attempt_connect (pos);
443     }
444   else
445     {
446       pos->greylist_clean_task 
447         = GNUNET_SCHEDULER_add_delayed (rem,
448                                         &remove_from_greylist,
449                                         pos);
450     }
451   if ( (GNUNET_NO == pos->is_friend) &&
452        (GNUNET_NO == pos->is_connected) )
453     {
454       free_peer (NULL, &pos->pid.hashPubKey, pos);
455       return;
456     }
457 }
458
459
460 /**
461  * Create a new entry in the peer list.
462  *
463  * @param peer identity of the new entry
464  * @param hello hello message, can be NULL
465  * @param is_friend is the new entry for a friend?
466  * @return the new entry
467  */
468 static struct Peer *
469 make_peer (const struct
470            GNUNET_PeerIdentity * peer,
471            const struct GNUNET_HELLO_Message *hello,
472            int is_friend)
473 {
474   struct Peer *ret;
475   
476   ret = GNUNET_malloc (sizeof (struct Peer));
477   ret->pid = *peer;
478   ret->is_friend = is_friend;
479   if (hello != NULL)
480     {
481       ret->hello = GNUNET_malloc (GNUNET_HELLO_size (hello));
482       memcpy (ret->hello, hello,
483               GNUNET_HELLO_size (hello));
484     }
485   GNUNET_break (GNUNET_OK ==
486                 GNUNET_CONTAINER_multihashmap_put (peers,
487                                                    &peer->hashPubKey,
488                                                    ret,
489                                                    GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY));
490   return ret;
491 }
492
493
494 /**
495  * Setup bloom filter for the given peer entry.
496  *
497  * @param peer entry to initialize
498  */
499 static void
500 setup_filter (struct Peer *peer)
501 {
502   /* 2^{-5} chance of not sending a HELLO to a peer is
503      acceptably small (if the filter is 50% full);
504      64 bytes of memory are small compared to the rest
505      of the data structure and would only really become
506      "useless" once a HELLO has been passed on to ~100
507      other peers, which is likely more than enough in
508      any case; hence 64, 5 as bloomfilter parameters. */
509   peer->filter = GNUNET_CONTAINER_bloomfilter_load (NULL, 64, 5);
510   peer->filter_expiration = GNUNET_TIME_relative_to_absolute (HELLO_ADVERTISEMENT_MIN_REPEAT_FREQUENCY);
511   /* never send a peer its own HELLO */
512   GNUNET_CONTAINER_bloomfilter_add (peer->filter, &peer->pid.hashPubKey);
513 }
514
515
516 /**
517  * Function to fill send buffer with HELLO.
518  *
519  * @param cls 'struct Peer' of the target peer
520  * @param size number of bytes available in buf
521  * @param buf where the callee should write the message
522  * @return number of bytes written to buf
523  */
524 static size_t
525 hello_advertising_ready (void *cls,
526                          size_t size,
527                          void *buf);
528
529
530
531
532 /**
533  * Closure for 'find_advertisable_hello'.
534  */
535 struct FindAdvHelloContext {
536
537   /**
538    * Peer we want to advertise to.
539    */
540   struct Peer *peer;
541
542   /**
543    * Where to store the result (peer selected for advertising).
544    */
545   struct Peer *result;
546
547   /**
548    * Maximum HELLO size we can use right now.
549    */
550   size_t max_size;
551
552   struct GNUNET_TIME_Relative next_adv;
553 };
554
555
556 /**
557  * Find a peer that would be reasonable for advertising.
558  *
559  * @param cls closure
560  * @param pid identity of a peer
561  * @param value 'struct Peer*' for the peer we are considering 
562  * @return GNUNET_YES (continue iteration)
563  */
564 static int
565 find_advertisable_hello (void *cls,
566                          const GNUNET_HashCode *pid,
567                          void *value)
568 {
569   struct FindAdvHelloContext *fah = cls;
570   struct Peer *pos = value;
571   struct GNUNET_TIME_Relative rst_time;
572   size_t hs;
573
574   if (pos == fah->peer)
575     return GNUNET_YES;
576   if (pos->hello == NULL)
577     return GNUNET_YES;
578   rst_time = GNUNET_TIME_absolute_get_remaining (pos->filter_expiration);
579   if (0 == rst_time.rel_value)
580     {
581       /* time to discard... */
582       GNUNET_CONTAINER_bloomfilter_free (pos->filter);
583       setup_filter (pos);
584     }
585   fah->next_adv = GNUNET_TIME_relative_min (rst_time,
586                                             fah->next_adv);
587   hs = GNUNET_HELLO_size (pos->hello);
588   if (hs > fah->max_size)
589     return GNUNET_YES;
590   if (GNUNET_NO ==
591       GNUNET_CONTAINER_bloomfilter_test (pos->filter,
592                                          &fah->peer->pid.hashPubKey))
593     fah->result = pos;    
594   return GNUNET_YES;
595 }
596
597
598 /**
599  * Calculate when we would like to send the next HELLO to this
600  * peer and ask for it.
601  *
602  * @param cls for which peer to schedule the HELLO
603  * @param tc task context
604  */
605 static void
606 schedule_next_hello (void *cls,
607                      const struct GNUNET_SCHEDULER_TaskContext *tc)
608 {
609   struct Peer *pl = cls;
610   struct FindAdvHelloContext fah;
611   size_t next_want;
612   struct GNUNET_TIME_Relative delay;
613  
614   pl->hello_delay_task = GNUNET_SCHEDULER_NO_TASK;
615   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
616     return; /* we're out of here */
617   if (pl->hello_req != NULL)
618     return; /* did not finish sending the previous one */
619   /* find applicable HELLOs */
620   fah.peer = pl;
621   fah.result = NULL;
622   fah.max_size = GNUNET_SERVER_MAX_MESSAGE_SIZE - 1;
623   fah.next_adv = GNUNET_TIME_UNIT_FOREVER_REL;
624   GNUNET_CONTAINER_multihashmap_iterate (peers,
625                                          &find_advertisable_hello,
626                                          &fah);
627   pl->hello_delay_task 
628     = GNUNET_SCHEDULER_add_delayed (fah.next_adv,
629                                     &schedule_next_hello,
630                                     pl);
631   if (fah.result == NULL)
632     return;   
633   next_want = GNUNET_HELLO_size (fah.result->hello);
634   delay = GNUNET_TIME_absolute_get_remaining (pl->next_hello_allowed);
635   if (delay.rel_value == 0)
636     {
637       /* now! */
638       pl->hello_req = GNUNET_CORE_notify_transmit_ready (handle, 0,
639                                                          GNUNET_CONSTANTS_SERVICE_TIMEOUT,
640                                                          &pl->pid,
641                                                          next_want,
642                                                          &hello_advertising_ready,
643                                                          pl);
644     }
645 }
646
647
648 /**
649  * Cancel existing requests for sending HELLOs to this peer
650  * and recalculate when we should send HELLOs to it based
651  * on our current state (something changed!).
652  *
653  * @param cls closure, 'struct Peer' to skip, or NULL
654  * @param pid identity of a peer
655  * @param value 'struct Peer*' for the peer
656  * @return GNUNET_YES (always)
657  */
658 static int
659 reschedule_hellos (void *cls,
660                    const GNUNET_HashCode *pid,
661                    void *value)
662 {
663   struct Peer *peer = value;
664   struct Peer *skip = cls;
665
666   if (skip == peer)
667     return GNUNET_YES;
668   if (! peer->is_connected) 
669     return GNUNET_YES;
670   if (peer->hello_req != NULL)
671     {
672       GNUNET_CORE_notify_transmit_ready_cancel (peer->hello_req);
673       peer->hello_req = NULL;
674     }
675   if (peer->hello_delay_task != GNUNET_SCHEDULER_NO_TASK)
676     {
677       GNUNET_SCHEDULER_cancel (peer->hello_delay_task);
678       peer->hello_delay_task = GNUNET_SCHEDULER_NO_TASK;
679     }
680   peer->hello_delay_task 
681     = GNUNET_SCHEDULER_add_now (&schedule_next_hello,
682                                 peer);
683   return GNUNET_YES;
684 }
685
686
687 /**
688  * Method called whenever a peer connects.
689  *
690  * @param cls closure
691  * @param peer peer identity this notification is about
692  * @param atsi performance data
693  */
694 static void 
695 connect_notify (void *cls,
696                 const struct
697                 GNUNET_PeerIdentity * peer,
698                 const struct GNUNET_TRANSPORT_ATS_Information *atsi)
699 {
700   struct Peer *pos;
701
702 #if DEBUG_TOPOLOGY
703   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
704               "Core told us that we are connecting to `%s'\n",
705               GNUNET_i2s (peer));
706 #endif
707   connection_count++;
708   GNUNET_STATISTICS_set (stats,
709                          gettext_noop ("# peers connected"),
710                          connection_count,
711                          GNUNET_NO);
712   pos = GNUNET_CONTAINER_multihashmap_get (peers, &peer->hashPubKey);
713   if (pos == NULL)    
714     {
715       pos = make_peer (peer, NULL, GNUNET_NO);
716       GNUNET_break (GNUNET_OK == is_connection_allowed (pos));
717     }
718   else
719     {
720       GNUNET_assert (GNUNET_NO == pos->is_connected);
721       pos->greylisted_until.abs_value = 0; /* remove greylisting */
722     }
723   pos->is_connected = GNUNET_YES;
724   pos->connect_attempts = 0; /* re-set back-off factor */
725   if (pos->is_friend)
726     {
727       if ( (friend_count == minimum_friend_count - 1) &&
728            (GNUNET_YES != friends_only) )       
729         whitelist_peers ();       
730       friend_count++;
731       GNUNET_STATISTICS_set (stats,
732                              gettext_noop ("# friends connected"),
733                              friend_count,
734                              GNUNET_NO);
735     }
736   reschedule_hellos (NULL, &peer->hashPubKey, pos);
737 }
738
739
740 /**
741  * Try to add more peers to our connection set.
742  *
743  * @param cls closure, not used
744  * @param pid identity of a peer
745  * @param value 'struct Peer*' for the peer
746  * @return GNUNET_YES (continue to iterate)
747  */
748 static int
749 try_add_peers (void *cls,
750                const GNUNET_HashCode *pid,
751                void *value)
752 {
753   struct Peer *pos = value;
754
755   attempt_connect (pos);
756   return GNUNET_YES;
757 }
758
759
760 /**
761  * Method called whenever a peer disconnects.
762  *
763  * @param cls closure
764  * @param peer peer identity this notification is about
765  */
766 static void 
767 disconnect_notify (void *cls,
768                    const struct
769                    GNUNET_PeerIdentity * peer)
770 {
771   struct Peer *pos;
772  
773 #if DEBUG_TOPOLOGY
774   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
775               "Core told us that we disconnected from `%s'\n",
776               GNUNET_i2s (peer));
777 #endif       
778   pos = GNUNET_CONTAINER_multihashmap_get (peers,
779                                            &peer->hashPubKey);
780   if (pos == NULL)
781     {
782       GNUNET_break (0);
783       return;
784     }
785   if (pos->is_connected != GNUNET_YES)
786     {
787       GNUNET_break (0);
788       return;
789     }
790   connection_count--;
791   GNUNET_STATISTICS_set (stats,
792                          gettext_noop ("# peers connected"),
793                          connection_count,
794                          GNUNET_NO);
795   if (pos->is_friend)
796     {
797       friend_count--; 
798       GNUNET_STATISTICS_set (stats,
799                              gettext_noop ("# friends connected"),
800                              friend_count,
801                              GNUNET_NO);
802     }
803   if ( (connection_count < target_connection_count) ||
804        (friend_count < minimum_friend_count) )
805     GNUNET_CONTAINER_multihashmap_iterate (peers,
806                                            &try_add_peers,
807                                            NULL);
808   if ( (friend_count < minimum_friend_count) &&
809        (blacklist == NULL) )
810     blacklist = GNUNET_TRANSPORT_blacklist (cfg,
811                                             &blacklist_check, NULL);
812 }
813
814
815 /**
816  * Iterator called on each address.
817  *
818  * @param cls flag that we will set if we see any addresses
819  * @param tname name of the transport
820  * @param expiration when will the given address expire
821  * @param addr the address of the peer
822  * @param addrlen number of bytes in addr
823  * @return GNUNET_SYSERR always, to terminate iteration
824  */
825 static int
826 address_iterator (void *cls,
827                   const char *tname,
828                   struct GNUNET_TIME_Absolute expiration,
829                   const void *addr, 
830                   uint16_t addrlen)
831 {
832   int *flag = cls;
833   *flag = GNUNET_YES;
834   return GNUNET_SYSERR;
835 }
836
837
838 /**
839  * We've gotten a HELLO from another peer.  Consider it for
840  * advertising.
841  *
842  * @param hello the HELLO we got
843  */
844 static void
845 consider_for_advertising (const struct GNUNET_HELLO_Message *hello)
846 {
847   int have_address;
848   struct GNUNET_PeerIdentity pid;
849   struct GNUNET_TIME_Absolute dt;
850   struct GNUNET_HELLO_Message *nh;
851   struct Peer *peer;
852   uint16_t size;
853
854   if (GNUNET_OK != GNUNET_HELLO_get_id (hello, &pid))
855     {
856         GNUNET_break (0);
857         return;
858     }
859   if (0 == memcmp (&pid,
860                    &my_identity,
861                    sizeof (struct GNUNET_PeerIdentity)))
862     return; /* that's me! */
863   have_address = GNUNET_NO;
864   GNUNET_HELLO_iterate_addresses (hello,
865                                   GNUNET_NO,
866                                   &address_iterator,
867                                   &have_address);
868   if (GNUNET_NO == have_address)
869     return; /* no point in advertising this one... */
870   peer = GNUNET_CONTAINER_multihashmap_get (peers,
871                                             &pid.hashPubKey);
872   if (peer == NULL)
873     {
874       peer = make_peer (&pid, hello, GNUNET_NO);
875     }
876   else if (peer->hello != NULL)
877     {
878       dt = GNUNET_HELLO_equals (peer->hello,
879                                 hello,
880                                 GNUNET_TIME_absolute_get());
881       if (dt.abs_value == GNUNET_TIME_UNIT_FOREVER_ABS.abs_value)
882         return; /* nothing new here */
883     }
884 #if DEBUG_TOPOLOGY
885   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
886               "Found `%s' from peer `%s' for advertising\n",
887               "HELLO",
888               GNUNET_i2s (&pid));
889 #endif 
890   if (peer->hello != NULL)
891     {
892       nh = GNUNET_HELLO_merge (peer->hello,
893                                hello);
894       GNUNET_free (peer->hello);
895       peer->hello = nh;
896     }
897   else
898     {
899       size = GNUNET_HELLO_size (hello);
900       peer->hello = GNUNET_malloc (size);
901       memcpy (peer->hello, hello, size);
902     }
903   if (peer->filter != NULL)
904     GNUNET_CONTAINER_bloomfilter_free (peer->filter);
905   setup_filter (peer);
906   /* since we have a new HELLO to pick from, re-schedule all
907      HELLO requests that are not bound by the HELLO send rate! */
908   GNUNET_CONTAINER_multihashmap_iterate (peers,
909                                          &reschedule_hellos,
910                                          peer);
911 }
912
913
914 /**
915  * PEERINFO calls this function to let us know about a possible peer
916  * that we might want to connect to.
917  *
918  * @param cls closure (not used)
919  * @param peer potential peer to connect to
920  * @param hello HELLO for this peer (or NULL)
921  */
922 static void
923 process_peer (void *cls,
924               const struct GNUNET_PeerIdentity *peer,
925               const struct GNUNET_HELLO_Message *hello)
926 {
927   struct Peer *pos;
928
929   GNUNET_assert (peer != NULL);
930   if (0 == memcmp (&my_identity,
931                    peer, sizeof (struct GNUNET_PeerIdentity)))
932     return;  /* that's me! */
933   if (hello == NULL)
934     {
935       /* free existing HELLO, if any */
936       pos = GNUNET_CONTAINER_multihashmap_get (peers,
937                                                &peer->hashPubKey);
938       if (NULL != pos)
939         {
940           GNUNET_free_non_null (pos->hello);
941           pos->hello = NULL;
942           if (pos->filter != NULL)
943             {
944               GNUNET_CONTAINER_bloomfilter_free (pos->filter);
945               pos->filter = NULL;
946             }
947           if ( (! pos->is_connected) &&
948                (! pos->is_friend) &&
949                (0 == GNUNET_TIME_absolute_get_remaining (pos->greylisted_until).rel_value) )
950             free_peer (NULL, &pos->pid.hashPubKey, pos);
951         }
952       return;
953     }
954   consider_for_advertising (hello);
955   pos = GNUNET_CONTAINER_multihashmap_get (peers,
956                                            &peer->hashPubKey);
957   if (pos == NULL)
958     pos = make_peer (peer, hello, GNUNET_NO);
959   GNUNET_assert (NULL != pos);
960   if (GNUNET_YES == pos->is_connected)
961     {
962 #if DEBUG_TOPOLOGY
963       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
964                   "Already connected to peer `%s'\n",
965                   GNUNET_i2s (peer));
966 #endif 
967       return;
968     }
969   if (GNUNET_TIME_absolute_get_remaining (pos->greylisted_until).rel_value > 0)
970     {
971 #if DEBUG_TOPOLOGY
972       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
973                   "Already tried peer `%s' recently\n",
974                   GNUNET_i2s (peer));
975 #endif 
976       return; /* peer still greylisted */
977     }
978 #if DEBUG_TOPOLOGY
979   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
980               "Considering connecting to peer `%s'\n",
981               GNUNET_i2s (peer));
982 #endif 
983   attempt_connect (pos);
984 }
985
986
987 /**
988  * Function called after GNUNET_CORE_connect has succeeded
989  * (or failed for good).
990  *
991  * @param cls closure
992  * @param server handle to the server, NULL if we failed
993  * @param my_id ID of this peer, NULL if we failed
994  * @param publicKey public key of this peer, NULL if we failed
995  */
996 static void
997 core_init (void *cls,
998            struct GNUNET_CORE_Handle * server,
999            const struct GNUNET_PeerIdentity *
1000            my_id,
1001            const struct
1002            GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded *
1003            publicKey)
1004 {
1005   if (server == NULL)
1006     {
1007       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1008                   _("Failed to connect to core service, can not manage topology!\n"));
1009       GNUNET_SCHEDULER_shutdown ();
1010       return;
1011     }
1012   handle = server;
1013   my_identity = *my_id;
1014 #if DEBUG_TOPOLOGY
1015   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1016               "I am peer `%s'\n",
1017               GNUNET_i2s (my_id));
1018 #endif  
1019   peerinfo_notify = GNUNET_PEERINFO_notify (cfg, &process_peer,
1020                                             NULL);
1021 }
1022
1023
1024 /**
1025  * Read the friends file.
1026  */
1027 static void
1028 read_friends_file (const struct GNUNET_CONFIGURATION_Handle *cfg)
1029 {
1030   char *fn;
1031   char *data;
1032   size_t pos;
1033   struct GNUNET_PeerIdentity pid;
1034   struct stat frstat;
1035   struct GNUNET_CRYPTO_HashAsciiEncoded enc;
1036   unsigned int entries_found;
1037   struct Peer *fl;
1038
1039   if (GNUNET_OK !=
1040       GNUNET_CONFIGURATION_get_value_filename (cfg,
1041                                                "TOPOLOGY",
1042                                                "FRIENDS",
1043                                                &fn))
1044     {
1045       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1046                   _("Option `%s' in section `%s' not specified!\n"),
1047                   "FRIENDS",
1048                   "TOPOLOGY");
1049       return;
1050     }
1051   if (GNUNET_OK != GNUNET_DISK_file_test (fn))
1052     GNUNET_DISK_fn_write (fn, NULL, 0, 
1053                           GNUNET_DISK_PERM_USER_READ
1054                           | GNUNET_DISK_PERM_USER_WRITE);
1055   if (0 != STAT (fn, &frstat))
1056     {
1057       if ((friends_only) || (minimum_friend_count > 0))
1058         GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1059                     _("Could not read friends list `%s'\n"), fn);
1060       GNUNET_free (fn);
1061       return;
1062     }
1063   if (frstat.st_size == 0)
1064     {
1065       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1066                   _("Friends file `%s' is empty.\n"),
1067                   fn);
1068       GNUNET_free (fn);
1069       return;
1070     }
1071   data = GNUNET_malloc_large (frstat.st_size);
1072   if (data == NULL)
1073     {
1074       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1075                   _("Failed to read friends list from `%s': out of memory\n"), fn);
1076       GNUNET_free (fn);
1077       return;
1078     }
1079   if (frstat.st_size !=
1080       GNUNET_DISK_fn_read (fn, data, frstat.st_size))
1081     {
1082       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1083                   _("Failed to read friends list from `%s'\n"), fn);
1084       GNUNET_free (fn);
1085       GNUNET_free (data);
1086       return;
1087     }
1088   entries_found = 0;
1089   pos = 0;
1090   while ((pos < frstat.st_size) && isspace ( (unsigned char) data[pos]))
1091     pos++;
1092   while ((frstat.st_size >= sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)) &&
1093          (pos <= frstat.st_size - sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)))
1094     {
1095       memcpy (&enc, &data[pos], sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
1096       if (!isspace ( (unsigned char) enc.encoding[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1]))
1097         {
1098           GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1099                       _("Syntax error in topology specification at offset %llu, skipping bytes.\n"),
1100                       (unsigned long long) pos);
1101           pos++;
1102           while ((pos < frstat.st_size) && (!isspace ( (unsigned char) data[pos])))
1103             pos++;
1104           continue;
1105         }
1106       enc.encoding[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
1107       if (GNUNET_OK != GNUNET_CRYPTO_hash_from_string ((char *) &enc, &pid.hashPubKey))
1108         {
1109           GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1110                       _("Syntax error in topology specification at offset %llu, skipping bytes `%s'.\n"),
1111                       (unsigned long long) pos,
1112                       &enc);
1113         }
1114       else
1115         {
1116           if (0 != memcmp (&pid,
1117                            &my_identity,
1118                            sizeof (struct GNUNET_PeerIdentity)))
1119             {
1120               entries_found++;
1121               fl = make_peer (&pid,
1122                               NULL,
1123                               GNUNET_YES);
1124               GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1125                           _("Found friend `%s' in configuration\n"),
1126                           GNUNET_i2s (&fl->pid));
1127             }
1128           else
1129             {
1130               GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1131                           _("Found myself `%s' in friend list (useless, ignored)\n"),
1132                           GNUNET_i2s (&pid));
1133             }
1134         }
1135       pos = pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded);
1136       while ((pos < frstat.st_size) && isspace ( (unsigned char) data[pos]))
1137         pos++;
1138     }
1139   GNUNET_free (data);
1140   GNUNET_free (fn);
1141   GNUNET_STATISTICS_update (stats,
1142                             gettext_noop ("# friends in configuration"),
1143                             entries_found,
1144                             GNUNET_NO);
1145   if ( (minimum_friend_count > entries_found) &&
1146        (friends_only == GNUNET_NO) )
1147     {
1148       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1149                   _("Fewer friends specified than required by minimum friend count. Will only connect to friends.\n"));
1150     }
1151   if ( (minimum_friend_count > target_connection_count) &&
1152        (friends_only == GNUNET_NO) )
1153     {
1154       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1155                   _("More friendly connections required than target total number of connections.\n"));
1156     }
1157 }
1158
1159
1160 /**
1161  * This function is called whenever an encrypted HELLO message is
1162  * received.
1163  *
1164  * @param cls closure
1165  * @param other the other peer involved (sender or receiver, NULL
1166  *        for loopback messages where we are both sender and receiver)
1167  * @param message the actual HELLO message
1168  * @param atsi performance data
1169  * @return GNUNET_OK to keep the connection open,
1170  *         GNUNET_SYSERR to close it (signal serious error)
1171  */
1172 static int
1173 handle_encrypted_hello (void *cls,
1174                         const struct GNUNET_PeerIdentity * other,
1175                         const struct GNUNET_MessageHeader *
1176                         message,
1177                         const struct GNUNET_TRANSPORT_ATS_Information *atsi)
1178 {
1179   struct Peer *peer;
1180   struct GNUNET_PeerIdentity pid;
1181
1182 #if DEBUG_TOPOLOGY
1183   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1184               "Received encrypted `%s' from peer `%s'",
1185               "HELLO",
1186               GNUNET_i2s (other));
1187 #endif  
1188   if (GNUNET_OK !=
1189       GNUNET_HELLO_get_id ((const struct GNUNET_HELLO_Message*) message,
1190                            &pid))
1191     {
1192       GNUNET_break_op (0);
1193       return GNUNET_SYSERR;
1194     }
1195   GNUNET_STATISTICS_update (stats,
1196                             gettext_noop ("# HELLO messages received"),
1197                             1,
1198                             GNUNET_NO);
1199   peer = GNUNET_CONTAINER_multihashmap_get (peers,
1200                                             &pid.hashPubKey);
1201   if (peer == NULL)
1202     {
1203       if ( (GNUNET_YES == friends_only) ||
1204            (friend_count < minimum_friend_count) )
1205         return GNUNET_OK;      
1206     }
1207   else
1208     {
1209       if ( (GNUNET_YES != peer->is_friend) &&
1210            (GNUNET_YES == friends_only) )
1211         return GNUNET_OK;
1212       if ( (GNUNET_YES != peer->is_friend) &&
1213            (friend_count < minimum_friend_count) )
1214         return GNUNET_OK;      
1215     }
1216   if (transport != NULL)
1217     GNUNET_TRANSPORT_offer_hello (transport,
1218                                   message);
1219   return GNUNET_OK;
1220 }
1221
1222
1223 /**
1224  * Function to fill send buffer with HELLO.
1225  *
1226  * @param cls 'struct Peer' of the target peer
1227  * @param size number of bytes available in buf
1228  * @param buf where the callee should write the message
1229  * @return number of bytes written to buf
1230  */
1231 static size_t
1232 hello_advertising_ready (void *cls,
1233                          size_t size,
1234                          void *buf)
1235 {
1236   struct Peer *pl = cls;
1237   struct FindAdvHelloContext fah;
1238   size_t want;
1239
1240   pl->hello_req = NULL;
1241   /* find applicable HELLOs */
1242   fah.peer = pl;
1243   fah.result = NULL;
1244   fah.max_size = size;
1245   fah.next_adv = GNUNET_TIME_UNIT_FOREVER_REL;
1246   GNUNET_CONTAINER_multihashmap_iterate (peers,
1247                                          &find_advertisable_hello,
1248                                          &fah);
1249   want = 0;
1250   if (fah.result != NULL)
1251     {
1252       want = GNUNET_HELLO_size (fah.result->hello);
1253       GNUNET_assert (want <= size);
1254       memcpy (buf, fah.result->hello, want);
1255       GNUNET_CONTAINER_bloomfilter_add (fah.result->filter,
1256                                         &pl->pid.hashPubKey);
1257 #if DEBUG_TOPOLOGY
1258       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1259                   "Sending `%s' with %u bytes",
1260                   "HELLO",
1261                   (unsigned int) want);
1262 #endif  
1263       GNUNET_STATISTICS_update (stats,
1264                                 gettext_noop ("# HELLO messages gossipped"),
1265                                 1,
1266                                 GNUNET_NO);    
1267     }
1268   pl->next_hello_allowed = GNUNET_TIME_relative_to_absolute (HELLO_ADVERTISEMENT_MIN_FREQUENCY);
1269   pl->hello_delay_task 
1270     = GNUNET_SCHEDULER_add_now (&schedule_next_hello,
1271                                 pl);
1272   return want;
1273 }
1274
1275
1276 /**
1277  * Last task run during shutdown.  Disconnects us from
1278  * the transport and core.
1279  *
1280  * @param cls unused, NULL
1281  * @param tc scheduler context
1282  */
1283 static void
1284 cleaning_task (void *cls, 
1285                const struct GNUNET_SCHEDULER_TaskContext *tc)
1286 {
1287   if (NULL != peerinfo_notify)
1288     {
1289       GNUNET_PEERINFO_notify_cancel (peerinfo_notify);
1290       peerinfo_notify = NULL;
1291     }
1292   GNUNET_TRANSPORT_disconnect (transport);
1293   transport = NULL;
1294   GNUNET_CONTAINER_multihashmap_iterate (peers,
1295                                          &free_peer,
1296                                          NULL);
1297   GNUNET_CONTAINER_multihashmap_destroy (peers);
1298   if (handle != NULL)
1299     {
1300       GNUNET_CORE_disconnect (handle);
1301       handle = NULL;
1302     }
1303   whitelist_peers ();
1304   if (stats != NULL)
1305     {
1306       GNUNET_STATISTICS_destroy (stats, GNUNET_NO);
1307       stats = NULL;
1308     }
1309 }
1310
1311
1312 /**
1313  * Main function that will be run.
1314  *
1315  * @param cls closure
1316  * @param args remaining command-line arguments
1317  * @param cfgfile name of the configuration file used (for saving, can be NULL!)
1318  * @param c configuration
1319  */
1320 static void
1321 run (void *cls,
1322      char *const *args,
1323      const char *cfgfile,
1324      const struct GNUNET_CONFIGURATION_Handle * c)
1325 {
1326   struct GNUNET_CORE_MessageHandler handlers[] =
1327     {
1328       { &handle_encrypted_hello, GNUNET_MESSAGE_TYPE_HELLO, 0},
1329       { NULL, 0, 0 }
1330     };
1331   unsigned long long opt;
1332
1333   cfg = c;
1334   stats = GNUNET_STATISTICS_create ("topology", cfg);
1335   autoconnect = GNUNET_CONFIGURATION_get_value_yesno (cfg,
1336                                                       "TOPOLOGY",
1337                                                       "AUTOCONNECT");
1338   friends_only = GNUNET_CONFIGURATION_get_value_yesno (cfg,
1339                                                        "TOPOLOGY",
1340                                                        "FRIENDS-ONLY");
1341   if (GNUNET_OK !=
1342       GNUNET_CONFIGURATION_get_value_number (cfg,
1343                                              "TOPOLOGY",
1344                                              "MINIMUM-FRIENDS",
1345                                              &opt))
1346     opt = 0;
1347   minimum_friend_count = (unsigned int) opt;
1348   if (GNUNET_OK !=
1349       GNUNET_CONFIGURATION_get_value_number (cfg,
1350                                              "TOPOLOGY",
1351                                              "TARGET-CONNECTION-COUNT",
1352                                              &opt))
1353     opt = 16;
1354   target_connection_count = (unsigned int) opt;
1355   peers = GNUNET_CONTAINER_multihashmap_create (target_connection_count * 2);
1356
1357   if ( (friends_only == GNUNET_YES) ||
1358        (minimum_friend_count > 0) )
1359     read_friends_file (cfg);
1360 #if DEBUG_TOPOLOGY
1361   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1362               "Topology would like %u connections with at least %u friends (%s)\n",
1363               target_connection_count,
1364               minimum_friend_count,
1365               autoconnect ? "autoconnect enabled" : "autoconnect disabled");
1366 #endif       
1367   if (friend_count < minimum_friend_count) 
1368     blacklist = GNUNET_TRANSPORT_blacklist (cfg,
1369                                             &blacklist_check, NULL);
1370   transport = GNUNET_TRANSPORT_connect (cfg,
1371                                         NULL,
1372                                         NULL,
1373                                         NULL,
1374                                         NULL,
1375                                         NULL);
1376   handle = GNUNET_CORE_connect (cfg,
1377                                 1,
1378                                 NULL,
1379                                 &core_init,
1380                                 &connect_notify,
1381                                 &disconnect_notify, 
1382                                 NULL,
1383                                 NULL, GNUNET_NO,
1384                                 NULL, GNUNET_NO,
1385                                 handlers);
1386   GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL,
1387                                 &cleaning_task, NULL);
1388   if (NULL == transport)
1389     {
1390       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1391                   _("Failed to connect to `%s' service.\n"),
1392                   "transport");
1393       GNUNET_SCHEDULER_shutdown ();
1394       return;
1395     }
1396   if (NULL == handle)
1397     {
1398       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1399                   _("Failed to connect to `%s' service.\n"),
1400                   "core");
1401       GNUNET_SCHEDULER_shutdown ();
1402       return;
1403     }
1404 }
1405
1406
1407 /**
1408  * The main function for the topology daemon.
1409  *
1410  * @param argc number of arguments from the command line
1411  * @param argv command line arguments
1412  * @return 0 ok, 1 on error
1413  */
1414 int
1415 main (int argc, char *const *argv)
1416 {
1417   static const struct GNUNET_GETOPT_CommandLineOption options[] = {
1418     GNUNET_GETOPT_OPTION_END
1419   };
1420   int ret;
1421
1422   ret = (GNUNET_OK ==
1423          GNUNET_PROGRAM_run (argc,
1424                              argv,
1425                              "topology",
1426                              _("GNUnet topology control (maintaining P2P mesh and F2F constraints)"),
1427                              options,
1428                              &run, NULL)) ? 0 : 1;
1429   return ret;
1430 }
1431
1432 /* end of gnunet-daemon-topology.c */