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