small API change: do no longer pass rarely needed GNUNET_SCHEDULER_TaskContext to...
[oweals/gnunet.git] / src / cadet / gnunet-service-cadet_dht.c
1 /*
2      This file is part of GNUnet.
3      Copyright (C) 2013 GNUnet e.V.
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., 51 Franklin Street, Fifth Floor,
18      Boston, MA 02110-1301, USA.
19 */
20
21
22 #include "platform.h"
23 #include "gnunet_util_lib.h"
24
25 #include "gnunet_dht_service.h"
26 #include "gnunet_statistics_service.h"
27
28 #include "cadet_path.h"
29 #include "gnunet-service-cadet_dht.h"
30 #include "gnunet-service-cadet_peer.h"
31 #include "gnunet-service-cadet_hello.h"
32
33 #define LOG(level, ...) GNUNET_log_from (level,"cadet-dht",__VA_ARGS__)
34
35
36 /******************************************************************************/
37 /********************************   STRUCTS  **********************************/
38 /******************************************************************************/
39
40 /**
41  * Handle for DHT searches.
42  */
43 struct GCD_search_handle
44 {
45   /** DHT_GET handle. */
46   struct GNUNET_DHT_GetHandle *dhtget;
47
48   /** Provided callback to call when a path is found. */
49   GCD_search_callback callback;
50
51   /** Provided closure. */
52   void *cls;
53
54   /** Peer ID searched for */
55   GNUNET_PEER_Id peer_id;
56 };
57
58
59 /******************************************************************************/
60 /*******************************   GLOBALS  ***********************************/
61 /******************************************************************************/
62
63 /**
64  * Global handle to the statistics service.
65  */
66 extern struct GNUNET_STATISTICS_Handle *stats;
67
68 /**
69  * Own ID (short value).
70  */
71 extern GNUNET_PEER_Id myid;
72
73 /**
74  * Own ID (full value).
75  */
76 extern struct GNUNET_PeerIdentity my_full_id;
77
78 /**
79  * Handle to use DHT.
80  */
81 static struct GNUNET_DHT_Handle *dht_handle;
82
83 /**
84  * How often to PUT own ID in the DHT.
85  */
86 static struct GNUNET_TIME_Relative id_announce_time;
87
88 /**
89  * DHT replication level, see DHT API: GNUNET_DHT_get_start, GNUNET_DHT_put.
90  */
91 static unsigned long long dht_replication_level;
92
93 /**
94  * Task to periodically announce itself in the network.
95  */
96 static struct GNUNET_SCHEDULER_Task * announce_id_task;
97
98 /**
99  * GET requests to stop on shutdown.
100  */
101 static struct GNUNET_CONTAINER_MultiHashMap32 *get_requests;
102
103 /******************************************************************************/
104 /********************************   STATIC  ***********************************/
105 /******************************************************************************/
106
107
108 /**
109  * Build a PeerPath from the paths returned from the DHT, reversing the paths
110  * to obtain a local peer -> destination path and interning the peer ids.
111  *
112  * @return Newly allocated and created path
113  *
114  * FIXME refactor and use build_path_from_peer_ids
115  */
116 static struct CadetPeerPath *
117 path_build_from_dht (const struct GNUNET_PeerIdentity *get_path,
118                      unsigned int get_path_length,
119                      const struct GNUNET_PeerIdentity *put_path,
120                      unsigned int put_path_length)
121 {
122   size_t size = get_path_length + put_path_length + 1;
123   struct GNUNET_PeerIdentity peers[size];
124   const struct GNUNET_PeerIdentity *peer;
125   struct CadetPeerPath *p;
126   unsigned int own_pos;
127   int i;
128
129   peers[0] = my_full_id;
130   LOG (GNUNET_ERROR_TYPE_DEBUG, "   GET has %d hops.\n", get_path_length);
131   for (i = 0 ; i < get_path_length; i++)
132   {
133     peer = &get_path[get_path_length - i - 1];
134     LOG (GNUNET_ERROR_TYPE_DEBUG, "   From GET: %s\n", GNUNET_i2s (peer));
135     peers[i + 1] = *peer;
136   }
137   for (i = 0 ; i < put_path_length; i++)
138   {
139     peer = &put_path[put_path_length - i - 1];
140     LOG (GNUNET_ERROR_TYPE_DEBUG, "   From PUT: %s\n", GNUNET_i2s (peer));
141     peers[i + get_path_length + 1] = *peer;
142   }
143   p = path_build_from_peer_ids (peers, size, myid, &own_pos);
144   return p;
145 }
146
147
148 /**
149  * Function to process paths received for a new peer addition. The recorded
150  * paths form the initial tunnel, which can be optimized later.
151  * Called on each result obtained for the DHT search.
152  *
153  * @param cls closure
154  * @param exp when will this value expire
155  * @param key key of the result
156  * @param get_path path of the get request
157  * @param get_path_length lenght of @a get_path
158  * @param put_path path of the put request
159  * @param put_path_length length of the @a put_path
160  * @param type type of the result
161  * @param size number of bytes in data
162  * @param data pointer to the result data
163  */
164 static void
165 dht_get_id_handler (void *cls, struct GNUNET_TIME_Absolute exp,
166                     const struct GNUNET_HashCode * key,
167                     const struct GNUNET_PeerIdentity *get_path,
168                     unsigned int get_path_length,
169                     const struct GNUNET_PeerIdentity *put_path,
170                     unsigned int put_path_length, enum GNUNET_BLOCK_Type type,
171                     size_t size, const void *data)
172 {
173   struct GCD_search_handle *h = cls;
174   struct GNUNET_HELLO_Message *hello;
175   struct CadetPeerPath *p;
176   struct CadetPeer *peer;
177   char *s;
178
179   p = path_build_from_dht (get_path, get_path_length,
180                            put_path, put_path_length);
181   if (NULL == p)
182   {
183     GNUNET_break_op (0);
184     return;
185   }
186
187   s = path_2s (p);
188   LOG (GNUNET_ERROR_TYPE_INFO,
189        "Got path from DHT: %s\n",
190        s);
191   GNUNET_free_non_null (s);
192
193   peer = GCP_get_short (p->peers[p->length - 1], GNUNET_YES);
194   LOG (GNUNET_ERROR_TYPE_DEBUG,
195        "Got HELLO for %s\n",
196        GCP_2s (peer));
197   h->callback (h->cls, p);
198   path_destroy (p);
199   hello = (struct GNUNET_HELLO_Message *) data;
200   GCP_set_hello (peer, hello);
201   GCP_try_connect (peer);
202 }
203
204
205 /**
206  * Periodically announce self id in the DHT
207  *
208  * @param cls closure
209  */
210 static void
211 announce_id (void *cls)
212 {
213   struct GNUNET_HashCode phash;
214   const struct GNUNET_HELLO_Message *hello;
215   size_t size;
216   struct GNUNET_TIME_Absolute expiration;
217   struct GNUNET_TIME_Relative retry_time;
218   const struct GNUNET_SCHEDULER_TaskContext *tc;
219
220   tc = GNUNET_SCHEDULER_get_task_context ();
221   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
222   {
223     announce_id_task = NULL;
224     return;
225   }
226   LOG (GNUNET_ERROR_TYPE_DEBUG, "Announce ID\n");
227   /* TODO
228    * - Set data expiration in function of X
229    * - Adapt X to churn
230    */
231   hello = GCH_get_mine ();
232   if (NULL == hello || (size = GNUNET_HELLO_size (hello)) == 0)
233   {
234     /* Peerinfo gave us no hello yet, try again in a second. */
235     announce_id_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_SECONDS,
236                                                      &announce_id, cls);
237     LOG (GNUNET_ERROR_TYPE_DEBUG, "  no hello, waiting!\n");
238     GNUNET_STATISTICS_update (stats, "# DHT announce skipped (no hello)",
239                               1, GNUNET_NO);
240
241     return;
242   }
243   expiration = GNUNET_HELLO_get_last_expiration (hello);
244   retry_time = GNUNET_TIME_absolute_get_remaining (expiration);
245
246   LOG (GNUNET_ERROR_TYPE_DEBUG, "Hello %p size: %u\n", hello, size);
247   GNUNET_STATISTICS_update (stats, "# DHT announce",
248                             1, GNUNET_NO);
249   memset (&phash, 0, sizeof (phash));
250   memcpy (&phash, &my_full_id, sizeof (my_full_id));
251   GNUNET_DHT_put (dht_handle,   /* DHT handle */
252                   &phash,       /* Key to use */
253                   dht_replication_level,     /* Replication level */
254                   GNUNET_DHT_RO_RECORD_ROUTE
255                   | GNUNET_DHT_RO_DEMULTIPLEX_EVERYWHERE,    /* DHT options */
256                   GNUNET_BLOCK_TYPE_DHT_HELLO,       /* Block type */
257                   size,  /* Size of the data */
258                   (const char *) hello, /* Data itself */
259                   expiration,  /* Data expiration */
260                   retry_time, /* Retry time */
261                   NULL,         /* Continuation */
262                   NULL);        /* Continuation closure */
263   announce_id_task =
264       GNUNET_SCHEDULER_add_delayed (id_announce_time, &announce_id, cls);
265 }
266
267 /**
268  * Iterator over hash map entries and stop GET requests before disconnecting
269  * from the DHT.
270  *
271  * @param cls Closure (unused)
272  * @param key Current peer ID.
273  * @param value Value in the hash map (GCD_search_handle).
274  *
275  * @return #GNUNET_YES, we should continue to iterate,
276  */
277 int
278 stop_get (void *cls,
279           uint32_t key,
280           void *value)
281 {
282   struct GCD_search_handle *h = value;
283
284   GCD_search_stop (h);
285   return GNUNET_YES;
286 }
287
288
289 /******************************************************************************/
290 /********************************    API    ***********************************/
291 /******************************************************************************/
292
293 /**
294  * Initialize the DHT subsystem.
295  *
296  * @param c Configuration.
297  */
298 void
299 GCD_init (const struct GNUNET_CONFIGURATION_Handle *c)
300 {
301   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
302   if (GNUNET_OK !=
303       GNUNET_CONFIGURATION_get_value_number (c, "CADET", "DHT_REPLICATION_LEVEL",
304                                              &dht_replication_level))
305   {
306     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
307                                "CADET", "DHT_REPLICATION_LEVEL", "USING DEFAULT");
308     dht_replication_level = 3;
309   }
310
311   if (GNUNET_OK !=
312       GNUNET_CONFIGURATION_get_value_time (c, "CADET", "ID_ANNOUNCE_TIME",
313                                            &id_announce_time))
314   {
315     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_ERROR,
316                                "CADET", "ID_ANNOUNCE_TIME", "MISSING");
317     GNUNET_SCHEDULER_shutdown ();
318     return;
319   }
320
321   dht_handle = GNUNET_DHT_connect (c, 64);
322   if (NULL == dht_handle)
323   {
324     GNUNET_break (0);
325   }
326
327   announce_id_task = GNUNET_SCHEDULER_add_now (&announce_id, NULL);
328   get_requests = GNUNET_CONTAINER_multihashmap32_create (32);
329 }
330
331
332 /**
333  * Shut down the DHT subsystem.
334  */
335 void
336 GCD_shutdown (void)
337 {
338   LOG (GNUNET_ERROR_TYPE_DEBUG, "Shutting down DHT\n");
339   GNUNET_CONTAINER_multihashmap32_iterate (get_requests, &stop_get, NULL);
340   GNUNET_CONTAINER_multihashmap32_destroy (get_requests);
341   if (dht_handle != NULL)
342   {
343     GNUNET_DHT_disconnect (dht_handle);
344     dht_handle = NULL;
345   }
346   if (NULL != announce_id_task)
347   {
348     GNUNET_SCHEDULER_cancel (announce_id_task);
349     announce_id_task = NULL;
350   }
351 }
352
353 struct GCD_search_handle *
354 GCD_search (const struct GNUNET_PeerIdentity *peer_id,
355             GCD_search_callback callback, void *cls)
356 {
357   struct GNUNET_HashCode phash;
358   struct GCD_search_handle *h;
359
360   LOG (GNUNET_ERROR_TYPE_DEBUG, "Starting DHT GET for peer %s\n",
361        GNUNET_i2s (peer_id));
362   GNUNET_STATISTICS_update (stats, "# DHT search", 1, GNUNET_NO);
363   memset (&phash, 0, sizeof (phash));
364   memcpy (&phash, peer_id, sizeof (*peer_id));
365   h = GNUNET_new (struct GCD_search_handle);
366   h->peer_id = GNUNET_PEER_intern (peer_id);
367   h->callback = callback;
368   h->cls = cls;
369   h->dhtget = GNUNET_DHT_get_start (dht_handle,    /* handle */
370                                     GNUNET_BLOCK_TYPE_DHT_HELLO, /* type */
371                                     &phash,     /* key to search */
372                                     dht_replication_level, /* replication level */
373                                     GNUNET_DHT_RO_RECORD_ROUTE |
374                                     GNUNET_DHT_RO_DEMULTIPLEX_EVERYWHERE,
375                                     NULL,       /* xquery */
376                                     0,     /* xquery bits */
377                                     &dht_get_id_handler, h);
378   GNUNET_CONTAINER_multihashmap32_put (get_requests, h->peer_id, h,
379                                        GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
380   return h;
381 }
382
383
384 void
385 GCD_search_stop (struct GCD_search_handle *h)
386 {
387   GNUNET_break (GNUNET_OK ==
388                 GNUNET_CONTAINER_multihashmap32_remove (get_requests,
389                                                         h->peer_id, h));
390   GNUNET_DHT_get_stop (h->dhtget);
391   GNUNET_free (h);
392 }