transport plugin change from single MessageHeader to message buffer and size...
[oweals/gnunet.git] / src / transport / plugin_transport_udp.c
1 /*
2      This file is part of GNUnet
3      (C) 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 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 transport/plugin_transport_udp.c
23  * @brief Implementation of the UDP transport service
24  * @author Christian Grothoff
25  * @author Nathan Evans
26  */
27
28 #include "platform.h"
29 #include "gnunet_hello_lib.h"
30 #include "gnunet_connection_lib.h"
31 #include "gnunet_os_lib.h"
32 #include "gnunet_peerinfo_service.h"
33 #include "gnunet_protocols.h"
34 #include "gnunet_resolver_service.h"
35 #include "gnunet_server_lib.h"
36 #include "gnunet_service_lib.h"
37 #include "gnunet_signatures.h"
38 #include "gnunet_statistics_service.h"
39 #include "gnunet_transport_service.h"
40 #include "plugin_transport.h"
41 #include "transport.h"
42
43 #define DEBUG_UDP GNUNET_YES
44
45 /*
46  * Transport cost to peer, always 1 for UDP (direct connection)
47  */
48 #define UDP_DIRECT_DISTANCE 1
49
50 /**
51  * Handle for request of hostname resolution, non-NULL if pending.
52  */
53 static struct GNUNET_RESOLVER_RequestHandle *hostname_dns;
54
55 /**
56  * How long until we give up on transmitting the welcome message?
57  */
58 #define HOSTNAME_RESOLVE_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 5)
59
60
61 /**
62  * Message-Packet header.
63  */
64 struct UDPMessage
65 {
66   /**
67    * size of the message, in bytes, including this header.
68    */
69   struct GNUNET_MessageHeader header;
70
71   /**
72    * What is the identity of the sender (GNUNET_hash of public key)
73    */
74   struct GNUNET_PeerIdentity sender;
75
76 };
77
78 /* Forward definition */
79 struct Plugin;
80
81 struct PrettyPrinterContext
82 {
83   GNUNET_TRANSPORT_AddressStringCallback asc;
84   void *asc_cls;
85   uint16_t port;
86 };
87
88 /**
89  * Encapsulation of all of the state of the plugin.
90  */
91 struct Plugin
92 {
93   /**
94    * Our environment.
95    */
96   struct GNUNET_TRANSPORT_PluginEnvironment *env;
97
98   /**
99    * Handle for the statistics service.
100    */
101   struct GNUNET_STATISTICS_Handle *statistics;
102
103   /**
104    * Handle to the network service.
105    */
106   struct GNUNET_SERVICE_Context *service;
107
108   /**
109    * Handle for request of hostname resolution, non-NULL if pending.
110    */
111   struct GNUNET_RESOLVER_RequestHandle *hostname_dns;
112
113   /**
114    * ID of task used to update our addresses when one expires.
115    */
116   GNUNET_SCHEDULER_TaskIdentifier address_update_task;
117
118   /**
119    * ID of select task
120    */
121   GNUNET_SCHEDULER_TaskIdentifier select_task;
122
123   /**
124    * Port that we are actually listening on.
125    */
126   uint16_t open_port;
127
128   /**
129    * Port that the user said we would have visible to the
130    * rest of the world.
131    */
132   uint16_t adv_port;
133
134   /*
135    * FD Read set
136    */
137   struct GNUNET_NETWORK_FDSet *rs;
138
139 };
140
141 /* *********** globals ************* */
142
143 /**
144  * the socket that we transmit all data with
145  */
146 static struct GNUNET_NETWORK_Handle *udp_sock;
147
148 /**
149  * Disconnect from a remote node.
150  *
151  * @param tsession the session that is closed
152  * @return GNUNET_OK on success, GNUNET_SYSERR if the operation failed
153  */
154 void
155 udp_disconnect (void *cls, const struct GNUNET_PeerIdentity *target)
156 {
157   return;
158 }
159
160 /**
161  * Shutdown the server process (stop receiving inbound traffic). Maybe
162  * restarted later!
163  */
164 static int
165 udp_transport_server_stop (void *cls)
166 {
167   struct Plugin *plugin = cls;
168   GNUNET_assert (udp_sock != NULL);
169   if (plugin->select_task != GNUNET_SCHEDULER_NO_TASK)
170     {
171       GNUNET_SCHEDULER_cancel (plugin->env->sched, plugin->select_task);
172       plugin->select_task = GNUNET_SCHEDULER_NO_TASK;
173     }
174
175   GNUNET_NETWORK_socket_close (udp_sock);
176   udp_sock = NULL;
177   return GNUNET_OK;
178 }
179
180 /**
181  * Function that can be used by the transport service to transmit
182  * a message using the plugin.
183  *
184  * @param cls closure
185  * @param target who should receive this message (ignored by UDP)
186  * @param msgbuf one or more GNUNET_MessageHeader(s) strung together
187  * @param msgbufsize the size of the msgbuf to send
188  * @param priority how important is the message (ignored by UDP)
189  * @param timeout when should we time out (give up) if we can not transmit?
190  * @param addr the addr to send the message to, needs to be a sockaddr for us
191  * @param addrlen the len of addr
192  * @param force_address not used, we had better have an address to send to
193  *        because we are stateless!!
194  * @param cont continuation to call once the message has
195  *        been transmitted (or if the transport is ready
196  *        for the next transmission call; or if the
197  *        peer disconnected...)
198  * @param cont_cls closure for cont
199  *
200  * @return the number of bytes written
201  */
202
203 static ssize_t
204 udp_plugin_send (void *cls,
205                  const struct GNUNET_PeerIdentity *target,
206                  char *msgbuf,
207                  size_t msgbuf_size,
208                  unsigned int priority,
209                  struct GNUNET_TIME_Relative timeout,
210                  const void *addr,
211                  size_t addrlen,
212                  int force_address,
213                  GNUNET_TRANSPORT_TransmitContinuation cont, void *cont_cls)
214 {
215   struct Plugin *plugin = cls;
216   struct UDPMessage *message;
217   int ssize;
218   ssize_t sent;
219
220   GNUNET_assert(udp_sock != NULL);
221
222   if ((addr == NULL) || (addrlen == 0))
223     {
224 #if DEBUG_UDP
225   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
226                    ("udp_plugin_send called without address, returning!\n"));
227 #endif
228       cont (cont_cls, target, GNUNET_OK);
229       return 0; /* Can never send if we don't have an address!! */
230     }
231
232   /* Build the message to be sent */
233   message = GNUNET_malloc (sizeof (struct UDPMessage) + msgbuf_size);
234   ssize = sizeof (struct UDPMessage) + msgbuf_size;
235
236 #if DEBUG_UDP
237   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
238                    ("In udp_send, ssize is %d\n"), ssize);
239 #endif
240   message->header.size = htons (ssize);
241   message->header.type = htons (0);
242   memcpy (&message->sender, plugin->env->my_identity,
243           sizeof (struct GNUNET_PeerIdentity));
244   memcpy (&message[1], msgbuf, msgbuf_size);
245
246   /* Actually send the message */
247   sent =
248     GNUNET_NETWORK_socket_sendto (udp_sock, message, ssize,
249                                   addr,
250                                   addrlen);
251
252   if (cont != NULL)
253     {
254       if (sent == GNUNET_SYSERR)
255         cont (cont_cls, target, GNUNET_SYSERR);
256       else
257         {
258 #if DEBUG_UDP
259   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
260                    ("Sucessfully sent message, calling transmit continuation!\n"));
261 #endif
262           cont (cont_cls, target, GNUNET_OK);
263         }
264     }
265   GNUNET_free (message);
266   return sent;
267 }
268
269
270 /**
271  * Add the IP of our network interface to the list of
272  * our external IP addresses.
273  */
274 static int
275 process_interfaces (void *cls,
276                     const char *name,
277                     int isDefault,
278                     const struct sockaddr *addr, socklen_t addrlen)
279 {
280   struct Plugin *plugin = cls;
281   int af;
282   struct sockaddr_in *v4;
283   struct sockaddr_in6 *v6;
284
285   af = addr->sa_family;
286   if (af == AF_INET)
287     {
288       v4 = (struct sockaddr_in *) addr;
289       v4->sin_port = htons (plugin->adv_port);
290     }
291   else
292     {
293       GNUNET_assert (af == AF_INET6);
294       v6 = (struct sockaddr_in6 *) addr;
295       v6->sin6_port = htons (plugin->adv_port);
296     }
297   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO |
298                    GNUNET_ERROR_TYPE_BULK,
299                    "udp", _("Found address `%s' (%s)\n"),
300                    GNUNET_a2s (addr, addrlen), name);
301   plugin->env->notify_address (plugin->env->cls,
302                                "udp",
303                                addr, addrlen, GNUNET_TIME_UNIT_FOREVER_REL);
304
305   return GNUNET_OK;
306 }
307
308
309 /**
310  * Function called by the resolver for each address obtained from DNS
311  * for our own hostname.  Add the addresses to the list of our
312  * external IP addresses.
313  *
314  * @param cls closure
315  * @param addr one of the addresses of the host, NULL for the last address
316  * @param addrlen length of the address
317  */
318 static void
319 process_hostname_ips (void *cls,
320                       const struct sockaddr *addr, socklen_t addrlen)
321 {
322   struct Plugin *plugin = cls;
323
324   if (addr == NULL)
325     {
326       plugin->hostname_dns = NULL;
327       return;
328     }
329   process_interfaces (plugin, "<hostname>", GNUNET_YES, addr, addrlen);
330 }
331
332
333 /*
334  * @param cls the plugin handle
335  * @param tc the scheduling context (for rescheduling this function again)
336  *
337  * We have been notified that our writeset has something to read.  Presumably
338  * select has been called already, so we can go ahead and start reading from
339  * the socket immediately.  Then we check if there is more to be read by
340  * calling select ourselves while there is stuff on the wire.  Then reschedule
341  * this function to be called again once more is available.
342  *
343  */
344 static void
345 udp_plugin_select (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
346 {
347   struct Plugin *plugin = cls;
348   struct GNUNET_TIME_Relative timeout =
349     GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, 500);
350   char *buf;
351   struct UDPMessage *msg;
352   const struct GNUNET_MessageHeader *hdr;
353   struct GNUNET_PeerIdentity *sender;
354   unsigned int buflen;
355   socklen_t fromlen;
356   struct sockaddr_storage addr;
357   ssize_t ret;
358   int offset;
359   int count;
360   const struct GNUNET_MessageHeader *currhdr;
361
362   do
363     {
364       buflen = GNUNET_NETWORK_socket_recvfrom_amount (udp_sock);
365
366 #if DEBUG_UDP
367       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
368                        ("we expect to read %u bytes\n"), buflen);
369 #endif
370
371       if (buflen == GNUNET_NO)
372         return;
373
374       buf = GNUNET_malloc (buflen);
375       fromlen = sizeof (addr);
376 #if DEBUG_UDP
377       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
378                        ("src_addr_len is %u\n"), fromlen);
379 #endif
380       memset (&addr, 0, fromlen);
381       ret =
382         GNUNET_NETWORK_socket_recvfrom (udp_sock, buf, buflen,
383                                         (struct sockaddr *) &addr, &fromlen);
384
385 #if DEBUG_UDP
386       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
387                        ("socket_recv returned %u, src_addr_len is %u\n"), ret,
388                        fromlen);
389 #endif
390
391       if (ret <= 0)
392         {
393           GNUNET_free (buf);
394           return;
395         }
396       msg = (struct UDPMessage *) buf;
397
398 #if DEBUG_UDP
399       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
400                        ("header reports message size of %d\n"),
401                        ntohs (msg->header.size));
402
403       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
404                        ("header reports message type of %d\n"),
405                        ntohs (msg->header.type));
406 #endif
407       if (ntohs (msg->header.size) < sizeof (struct UDPMessage))
408         {
409           GNUNET_free (buf);
410           GNUNET_NETWORK_fdset_zero (plugin->rs);
411           GNUNET_NETWORK_fdset_set (plugin->rs, udp_sock);
412           break;
413         }
414       hdr = (const struct GNUNET_MessageHeader *) &msg[1];
415       sender = GNUNET_malloc (sizeof (struct GNUNET_PeerIdentity));
416       memcpy (sender, &msg->sender, sizeof (struct GNUNET_PeerIdentity));
417
418 #if DEBUG_UDP
419       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
420                        ("msg reports message size of %d\n"),
421                        ntohs (hdr->size));
422
423       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
424                        ("msg reports message type of %d\n"),
425                        ntohs (hdr->type));
426 #endif
427       offset = 0;
428       count = 0;
429       while (offset < (ntohs (msg->header.size) - sizeof(struct UDPMessage)))
430         {
431           currhdr = &hdr[offset];
432 #if DEBUG_UDP
433       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
434                        ("processing msg %d: type %d, size %d at offset %d\n"),
435                        count, offset, ntohs(currhdr->size), ntohs(currhdr->type));
436 #endif
437           plugin->env->receive (plugin->env->cls,
438               sender, currhdr, UDP_DIRECT_DISTANCE, (char *)&addr, fromlen);
439           offset += ntohs(currhdr->size);
440         }
441
442       GNUNET_free (sender);
443       GNUNET_free (buf);
444
445     }
446   while (GNUNET_NETWORK_socket_select (plugin->rs,
447                                        NULL,
448                                        NULL,
449                                        timeout) > 0
450          && GNUNET_NETWORK_fdset_isset (plugin->rs, udp_sock));
451
452   plugin->select_task =
453     GNUNET_SCHEDULER_add_select (plugin->env->sched,
454                                  GNUNET_SCHEDULER_PRIORITY_DEFAULT,
455                                  GNUNET_SCHEDULER_NO_TASK,
456                                  GNUNET_TIME_UNIT_FOREVER_REL, plugin->rs,
457                                  NULL, &udp_plugin_select, plugin);
458
459 }
460
461 /**
462  * Create a UDP socket.  If possible, use IPv6, otherwise
463  * try IPv4.
464  */
465 static struct GNUNET_NETWORK_Handle *
466 udp_transport_server_start (void *cls)
467 {
468   struct Plugin *plugin = cls;
469   struct GNUNET_NETWORK_Handle *desc;
470   struct sockaddr_in serverAddrv4;
471   struct sockaddr_in6 serverAddrv6;
472   struct sockaddr *serverAddr;
473   socklen_t addrlen;
474
475   desc = NULL;
476   if (GNUNET_YES !=
477       GNUNET_CONFIGURATION_get_value_yesno (plugin->env->cfg, "GNUNETD",
478                                             "DISABLE-IPV6"))
479     {
480       desc = GNUNET_NETWORK_socket_create (PF_INET6, SOCK_DGRAM, 17);
481       if (desc != NULL)
482         {
483           memset (&serverAddrv6, 0, sizeof (serverAddrv6));
484 #if HAVE_SOCKADDR_IN_SIN_LEN
485           serverAddrv6.sin6_len = sizeof (serverAddrv6);
486 #endif
487           serverAddrv6.sin6_family = AF_INET6;
488           serverAddrv6.sin6_addr = in6addr_any;
489           serverAddrv6.sin6_port = htons (plugin->open_port);
490           addrlen = sizeof (serverAddrv6);
491           serverAddr = (struct sockaddr *) &serverAddrv6;
492         }
493     }
494   if (NULL == desc)
495     {
496       desc = GNUNET_NETWORK_socket_create (PF_INET, SOCK_DGRAM, 17);
497       if (NULL == desc)
498         {
499           GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "udp", "socket");
500           return NULL;
501         }
502       else
503         {
504           memset (&serverAddrv4, 0, sizeof (serverAddrv4));
505 #if HAVE_SOCKADDR_IN_SIN_LEN
506           serverAddrv4.sin_len = sizeof (serverAddrv4);
507 #endif
508           serverAddrv4.sin_family = AF_INET;
509           serverAddrv4.sin_addr.s_addr = INADDR_ANY;
510           serverAddrv4.sin_port = htons (plugin->open_port);
511           addrlen = sizeof (serverAddrv4);
512           serverAddr = (struct sockaddr *) &serverAddrv4;
513         }
514     }
515
516   if (desc != NULL)
517     {
518       GNUNET_assert (GNUNET_NETWORK_socket_bind (desc, serverAddr, addrlen) ==
519                      GNUNET_OK);
520     }
521
522   plugin->rs = GNUNET_NETWORK_fdset_create ();
523
524   GNUNET_NETWORK_fdset_zero (plugin->rs);
525   GNUNET_NETWORK_fdset_set (plugin->rs, desc);
526
527   plugin->select_task =
528     GNUNET_SCHEDULER_add_select (plugin->env->sched,
529                                  GNUNET_SCHEDULER_PRIORITY_DEFAULT,
530                                  GNUNET_SCHEDULER_NO_TASK,
531                                  GNUNET_TIME_UNIT_FOREVER_REL, plugin->rs,
532                                  NULL, &udp_plugin_select, plugin);
533
534   return desc;
535 }
536
537
538 /**
539  * Check if the given port is plausible (must be either
540  * our listen port or our advertised port).  If it is
541  * neither, we return one of these two ports at random.
542  *
543  * @return either in_port or a more plausible port
544  */
545 static uint16_t
546 check_port (struct Plugin *plugin, uint16_t in_port)
547 {
548   if ((in_port == plugin->adv_port) || (in_port == plugin->open_port))
549     return in_port;
550   return (GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK,
551                                     2) == 0)
552     ? plugin->open_port : plugin->adv_port;
553 }
554
555
556 /**
557  * Another peer has suggested an address for this peer and transport
558  * plugin.  Check that this could be a valid address.  This function
559  * is not expected to 'validate' the address in the sense of trying to
560  * connect to it but simply to see if the binary format is technically
561  * legal for establishing a connection.
562  *
563  * @param addr pointer to the address, may be modified (slightly)
564  * @param addrlen length of addr
565  * @return GNUNET_OK if this is a plausible address for this peer
566  *         and transport, GNUNET_SYSERR if not
567  *
568  * TODO: perhaps make everything work with sockaddr_storage, it may
569  *       be a cleaner way to handle addresses in UDP
570  */
571 static int
572 udp_check_address (void *cls, void *addr, size_t addrlen)
573 {
574   struct Plugin *plugin = cls;
575   char buf[sizeof (struct sockaddr_in6)];
576
577   struct sockaddr_in *v4;
578   struct sockaddr_in6 *v6;
579
580   if ((addrlen != sizeof (struct sockaddr_in)) &&
581       (addrlen != sizeof (struct sockaddr_in6)))
582     {
583       GNUNET_break_op (0);
584       return GNUNET_SYSERR;
585     }
586   memcpy (buf, addr, sizeof (struct sockaddr_in6));
587   if (addrlen == sizeof (struct sockaddr_in))
588     {
589       v4 = (struct sockaddr_in *) buf;
590       v4->sin_port = htons (check_port (plugin, ntohs (v4->sin_port)));
591     }
592   else
593     {
594       v6 = (struct sockaddr_in6 *) buf;
595       v6->sin6_port = htons (check_port (plugin, ntohs (v6->sin6_port)));
596     }
597 #if DEBUG_UDP
598   GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG,
599                    "tcp",
600                    "Informing transport service about my address `%s'.\n",
601                    GNUNET_a2s (addr, addrlen));
602 #endif
603   return GNUNET_OK;
604   return GNUNET_OK;
605 }
606
607
608 /**
609  * Append our port and forward the result.
610  */
611 static void
612 append_port (void *cls, const char *hostname)
613 {
614   struct PrettyPrinterContext *ppc = cls;
615   char *ret;
616
617   if (hostname == NULL)
618     {
619       ppc->asc (ppc->asc_cls, NULL);
620       GNUNET_free (ppc);
621       return;
622     }
623   GNUNET_asprintf (&ret, "%s:%d", hostname, ppc->port);
624   ppc->asc (ppc->asc_cls, ret);
625   GNUNET_free (ret);
626 }
627
628
629 /**
630  * Convert the transports address to a nice, human-readable
631  * format.
632  *
633  * @param cls closure
634  * @param type name of the transport that generated the address
635  * @param addr one of the addresses of the host, NULL for the last address
636  *        the specific address format depends on the transport
637  * @param addrlen length of the address
638  * @param numeric should (IP) addresses be displayed in numeric form?
639  * @param timeout after how long should we give up?
640  * @param asc function to call on each string
641  * @param asc_cls closure for asc
642  */
643 static void
644 udp_plugin_address_pretty_printer (void *cls,
645                                    const char *type,
646                                    const void *addr,
647                                    size_t addrlen,
648                                    int numeric,
649                                    struct GNUNET_TIME_Relative timeout,
650                                    GNUNET_TRANSPORT_AddressStringCallback asc,
651                                    void *asc_cls)
652 {
653   struct Plugin *plugin = cls;
654   const struct sockaddr_in *v4;
655   const struct sockaddr_in6 *v6;
656   struct PrettyPrinterContext *ppc;
657
658   if ((addrlen != sizeof (struct sockaddr_in)) &&
659       (addrlen != sizeof (struct sockaddr_in6)))
660     {
661       /* invalid address */
662       GNUNET_break_op (0);
663       asc (asc_cls, NULL);
664       return;
665     }
666   ppc = GNUNET_malloc (sizeof (struct PrettyPrinterContext));
667   ppc->asc = asc;
668   ppc->asc_cls = asc_cls;
669   if (addrlen == sizeof (struct sockaddr_in))
670     {
671       v4 = (const struct sockaddr_in *) addr;
672       ppc->port = ntohs (v4->sin_port);
673     }
674   else
675     {
676       v6 = (const struct sockaddr_in6 *) addr;
677       ppc->port = ntohs (v6->sin6_port);
678
679     }
680   GNUNET_RESOLVER_hostname_get (plugin->env->sched,
681                                 plugin->env->cfg,
682                                 addr,
683                                 addrlen,
684                                 !numeric, timeout, &append_port, ppc);
685 }
686
687 /**
688  * Set a quota for receiving data from the given peer; this is a
689  * per-transport limit.  This call has no meaning for UDP, as if
690  * we don't receive data it still comes in.  UDP has no friendliness
691  * guarantees, and our buffers will fill at some level.
692  *
693  * @param cls closure
694  * @param target the peer for whom the quota is given
695  * @param quota_in quota for receiving/sending data in bytes per ms
696  */
697 static void
698 udp_plugin_set_receive_quota (void *cls,
699                               const struct GNUNET_PeerIdentity *target,
700                               uint32_t quota_in)
701 {
702   return; /* Do nothing */
703 }
704
705 /**
706  * The exported method. Makes the core api available via a global and
707  * returns the udp transport API.
708  */
709 void *
710 libgnunet_plugin_transport_udp_init (void *cls)
711 {
712   unsigned long long mtu;
713
714   struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
715   struct GNUNET_TRANSPORT_PluginFunctions *api;
716   struct Plugin *plugin;
717   struct GNUNET_SERVICE_Context *service;
718   unsigned long long aport;
719   unsigned long long bport;
720
721   service = GNUNET_SERVICE_start ("transport-udp", env->sched, env->cfg);
722   if (service == NULL)
723     {
724       GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "udp", _
725                        ("Failed to start service for `%s' transport plugin.\n"),
726                        "udp");
727       return NULL;
728     }
729   aport = 0;
730   if ((GNUNET_OK !=
731        GNUNET_CONFIGURATION_get_value_number (env->cfg,
732                                               "transport-udp",
733                                               "PORT",
734                                               &bport)) ||
735       (bport > 65535) ||
736       ((GNUNET_OK ==
737         GNUNET_CONFIGURATION_get_value_number (env->cfg,
738                                                "transport-udp",
739                                                "ADVERTISED-PORT",
740                                                &aport)) && (aport > 65535)))
741     {
742       GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR,
743                        "udp",
744                        _
745                        ("Require valid port number for service `%s' in configuration!\n"),
746                        "transport-udp");
747       GNUNET_SERVICE_stop (service);
748       return NULL;
749     }
750   if (aport == 0)
751     aport = bport;
752
753   mtu = 1240;
754   if (mtu < 1200)
755     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO,
756                      "udp",
757                      _("MTU %llu for `%s' is probably too low!\n"), mtu,
758                      "UDP");
759
760   plugin = GNUNET_malloc (sizeof (struct Plugin));
761   plugin->open_port = bport;
762   plugin->adv_port = aport;
763   plugin->env = env;
764   plugin->statistics = NULL;
765   api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
766   api->cls = plugin;
767
768   api->send = &udp_plugin_send;
769   api->disconnect = &udp_disconnect;
770   api->address_pretty_printer = &udp_plugin_address_pretty_printer;
771   api->set_receive_quota = &udp_plugin_set_receive_quota;
772   api->check_address = &udp_check_address;
773
774   plugin->service = service;
775
776   /* FIXME: do the two calls below periodically again and
777      not just once (since the info we get might change...) */
778   GNUNET_OS_network_interfaces_list (&process_interfaces, plugin);
779   plugin->hostname_dns = GNUNET_RESOLVER_hostname_resolve (env->sched,
780                                                            env->cfg,
781                                                            AF_UNSPEC,
782                                                            HOSTNAME_RESOLVE_TIMEOUT,
783                                                            &process_hostname_ips,
784                                                            plugin);
785
786   udp_sock = udp_transport_server_start (plugin);
787
788   GNUNET_assert (udp_sock != NULL);
789
790   return api;
791 }
792
793 void *
794 libgnunet_plugin_transport_udp_done (void *cls)
795 {
796   struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
797   struct Plugin *plugin = api->cls;
798
799   udp_transport_server_stop (plugin);
800   if (NULL != hostname_dns)
801     {
802       GNUNET_RESOLVER_request_cancel (hostname_dns);
803       hostname_dns = NULL;
804     }
805   GNUNET_SERVICE_stop (plugin->service);
806
807   GNUNET_NETWORK_fdset_destroy (plugin->rs);
808   GNUNET_free (plugin);
809   GNUNET_free (api);
810   return NULL;
811 }
812
813 /* end of plugin_transport_udp.c */