document API, do not pass unused 'session' argument
[oweals/gnunet.git] / src / transport / plugin_transport_udp.c
1 /*
2  This file is part of GNUnet
3  (C) 2010-2015 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 transport/plugin_transport_udp.c
23  * @brief Implementation of the UDP transport protocol
24  * @author Christian Grothoff
25  * @author Nathan Evans
26  * @author Matthias Wachs
27  */
28 #include "platform.h"
29 #include "plugin_transport_udp.h"
30 #include "gnunet_hello_lib.h"
31 #include "gnunet_util_lib.h"
32 #include "gnunet_fragmentation_lib.h"
33 #include "gnunet_nat_lib.h"
34 #include "gnunet_protocols.h"
35 #include "gnunet_resolver_service.h"
36 #include "gnunet_signatures.h"
37 #include "gnunet_constants.h"
38 #include "gnunet_statistics_service.h"
39 #include "gnunet_transport_service.h"
40 #include "gnunet_transport_plugin.h"
41 #include "transport.h"
42
43 #define LOG(kind,...) GNUNET_log_from (kind, "transport-udp", __VA_ARGS__)
44
45 #define UDP_SESSION_TIME_OUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 60)
46
47 /**
48  * Number of messages we can defragment in parallel.  We only really
49  * defragment 1 message at a time, but if messages get re-ordered, we
50  * may want to keep knowledge about the previous message to avoid
51  * discarding the current message in favor of a single fragment of a
52  * previous message.  3 should be good since we don't expect massive
53  * message reorderings with UDP.
54  */
55 #define UDP_MAX_MESSAGES_IN_DEFRAG 3
56
57 /**
58  * We keep a defragmentation queue per sender address.  How many
59  * sender addresses do we support at the same time? Memory consumption
60  * is roughly a factor of 32k * UDP_MAX_MESSAGES_IN_DEFRAG times this
61  * value. (So 128 corresponds to 12 MB and should suffice for
62  * connecting to roughly 128 peers via UDP).
63  */
64 #define UDP_MAX_SENDER_ADDRESSES_WITH_DEFRAG 128
65
66
67 /**
68  * Closure for #append_port().
69  */
70 struct PrettyPrinterContext
71 {
72   /**
73    * DLL
74    */
75   struct PrettyPrinterContext *next;
76
77   /**
78    * DLL
79    */
80   struct PrettyPrinterContext *prev;
81
82   /**
83    * Our plugin.
84    */
85   struct Plugin *plugin;
86
87   /**
88    * Resolver handle
89    */
90   struct GNUNET_RESOLVER_RequestHandle *resolver_handle;
91
92   /**
93    * Function to call with the result.
94    */
95   GNUNET_TRANSPORT_AddressStringCallback asc;
96
97   /**
98    * Clsoure for @e asc.
99    */
100   void *asc_cls;
101
102   /**
103    * Timeout task
104    */
105   struct GNUNET_SCHEDULER_Task *timeout_task;
106
107   /**
108    * Is this an IPv6 address?
109    */
110   int ipv6;
111
112   /**
113    * Options
114    */
115   uint32_t options;
116
117   /**
118    * Port to add after the IP address.
119    */
120   uint16_t port;
121
122 };
123
124
125 /**
126  * Session with another peer.
127  */
128 struct Session
129 {
130   /**
131    * Which peer is this session for?
132    */
133   struct GNUNET_PeerIdentity target;
134
135   /**
136    * Plugin this session belongs to.
137    */
138   struct Plugin *plugin;
139
140   /**
141    * Context for dealing with fragments.
142    */
143   struct UDP_FragmentationContext *frag_ctx;
144
145   /**
146    * Desired delay for next sending we send to other peer
147    */
148   struct GNUNET_TIME_Relative flow_delay_for_other_peer;
149
150   /**
151    * Desired delay for next sending we received from other peer
152    */
153   struct GNUNET_TIME_Absolute flow_delay_from_other_peer;
154
155   /**
156    * Session timeout task
157    */
158   struct GNUNET_SCHEDULER_Task *timeout_task;
159
160   /**
161    * When does this session time out?
162    */
163   struct GNUNET_TIME_Absolute timeout;
164
165   /**
166    * expected delay for ACKs
167    */
168   struct GNUNET_TIME_Relative last_expected_ack_delay;
169
170   /**
171    * desired delay between UDP messages
172    */
173   struct GNUNET_TIME_Relative last_expected_msg_delay;
174
175   /**
176    * Address metrics (as set by the "update_address_metrics" by
177    * the environment).
178    */
179   struct GNUNET_ATS_Information ats;
180
181   /**
182    * Our own address.
183    */
184   struct GNUNET_HELLO_Address *address;
185
186   /**
187    * Number of bytes waiting for transmission to this peer.
188    */
189   unsigned long long bytes_in_queue;
190
191   /**
192    * Number of messages waiting for transmission to this peer.
193    */
194   unsigned int msgs_in_queue;
195
196   /**
197    * Reference counter to indicate that this session is
198    * currently being used and must not be destroyed;
199    * setting @e in_destroy will destroy it as soon as
200    * possible.
201    */
202   unsigned int rc;
203
204   /**
205    * Is this session about to be destroyed (sometimes we cannot
206    * destroy a session immediately as below us on the stack
207    * there might be code that still uses it; in this case,
208    * @e rc is non-zero).
209    */
210   int in_destroy;
211 };
212
213
214 /**
215  * Closure for #process_inbound_tokenized_messages().
216  */
217 struct SourceInformation
218 {
219   /**
220    * Sender identity.
221    */
222   struct GNUNET_PeerIdentity sender;
223
224   /**
225    * Associated session.
226    */
227   struct Session *session;
228
229 };
230
231 /**
232  * Closure for #find_receive_context().
233  */
234 struct FindReceiveContext
235 {
236   /**
237    * Where to store the result.
238    */
239   struct DefragContext *rc;
240
241   /**
242    * Session associated with this context.
243    */
244   struct Session *session;
245
246   /**
247    * Address to find.
248    */
249   const union UdpAddress *udp_addr;
250
251   /**
252    * Number of bytes in @e udp_addr.
253    */
254   size_t udp_addr_len;
255
256 };
257
258 /**
259  * Data structure to track defragmentation contexts based
260  * on the source of the UDP traffic.
261  */
262 struct DefragContext
263 {
264
265   /**
266    * Defragmentation context.
267    */
268   struct GNUNET_DEFRAGMENT_Context *defrag;
269
270   /**
271    * Reference to master plugin struct.
272    */
273   struct Plugin *plugin;
274
275   /**
276    * Node in the defrag heap.
277    */
278   struct GNUNET_CONTAINER_HeapNode *hnode;
279
280   /**
281    * Who's message(s) are we defragmenting here?
282    * Only initialized once we succeeded and
283    * @e have_sender is set.
284    */
285   struct GNUNET_PeerIdentity sender;
286
287   /**
288    * Source address this receive context is for (allocated at the
289    * end of the struct).
290    */
291   const union UdpAddress *udp_addr;
292
293   /**
294    * Length of @e udp_addr.
295    */
296   size_t udp_addr_len;
297
298   /**
299    * Network type the address belongs to.
300    */
301   enum GNUNET_ATS_Network_Type network_type;
302
303   /**
304    * Has the @e sender field been initialized yet?
305    */
306   int have_sender;
307 };
308
309
310 /**
311  * Context to send fragmented messages
312  */
313 struct UDP_FragmentationContext
314 {
315   /**
316    * Next in linked list
317    */
318   struct UDP_FragmentationContext *next;
319
320   /**
321    * Previous in linked list
322    */
323   struct UDP_FragmentationContext *prev;
324
325   /**
326    * The plugin
327    */
328   struct Plugin *plugin;
329
330   /**
331    * Handle for GNUNET_FRAGMENT context
332    */
333   struct GNUNET_FRAGMENT_Context *frag;
334
335   /**
336    * The session this fragmentation context belongs to
337    */
338   struct Session *session;
339
340   /**
341    * Function to call upon completion of the transmission.
342    */
343   GNUNET_TRANSPORT_TransmitContinuation cont;
344
345   /**
346    * Closure for @e cont.
347    */
348   void *cont_cls;
349
350   /**
351    * Message timeout
352    */
353   struct GNUNET_TIME_Absolute timeout;
354
355   /**
356    * Payload size of original unfragmented message
357    */
358   size_t payload_size;
359
360   /**
361    * Bytes used to send all fragments on wire including UDP overhead
362    */
363   size_t on_wire_size;
364
365   /**
366    * FIXME.
367    */
368   unsigned int fragments_used;
369
370 };
371
372
373 /**
374  * Message types included in a `struct UDP_MessageWrapper`
375  */
376 enum UDP_MessageType
377 {
378   /**
379    * Uninitialized (error)
380    */
381   UMT_UNDEFINED = 0,
382
383   /**
384    * Fragment of a message.
385    */
386   UMT_MSG_FRAGMENTED = 1,
387
388   /**
389    *
390    */
391   UMT_MSG_FRAGMENTED_COMPLETE = 2,
392
393   /**
394    * Unfragmented message.
395    */
396   UMT_MSG_UNFRAGMENTED = 3,
397
398   /**
399    * Receipt confirmation.
400    */
401   UMT_MSG_ACK = 4
402
403 };
404
405
406 /**
407  * Information we track for each message in the queue.
408  */
409 struct UDP_MessageWrapper
410 {
411   /**
412    * Session this message belongs to
413    */
414   struct Session *session;
415
416   /**
417    * DLL of messages
418    * previous element
419    */
420   struct UDP_MessageWrapper *prev;
421
422   /**
423    * DLL of messages
424    * previous element
425    */
426   struct UDP_MessageWrapper *next;
427
428   /**
429    * Message with size msg_size including UDP specific overhead
430    */
431   char *msg_buf;
432
433   /**
434    * Function to call upon completion of the transmission.
435    */
436   GNUNET_TRANSPORT_TransmitContinuation cont;
437
438   /**
439    * Closure for @e cont.
440    */
441   void *cont_cls;
442
443   /**
444    * Fragmentation context
445    * frag_ctx == NULL if transport <= MTU
446    * frag_ctx != NULL if transport > MTU
447    */
448   struct UDP_FragmentationContext *frag_ctx;
449
450   /**
451    * Message timeout
452    */
453   struct GNUNET_TIME_Absolute timeout;
454
455   /**
456    * Size of UDP message to send including UDP specific overhead
457    */
458   size_t msg_size;
459
460   /**
461    * Payload size of original message
462    */
463   size_t payload_size;
464
465   /**
466    * Message type
467    */
468   enum UDP_MessageType msg_type;
469
470 };
471
472
473 /**
474  * UDP ACK Message-Packet header.
475  */
476 struct UDP_ACK_Message
477 {
478   /**
479    * Message header.
480    */
481   struct GNUNET_MessageHeader header;
482
483   /**
484    * Desired delay for flow control
485    */
486   uint32_t delay;
487
488   /**
489    * What is the identity of the sender
490    */
491   struct GNUNET_PeerIdentity sender;
492
493 };
494
495
496 /**
497  * If a session monitor is attached, notify it about the new
498  * session state.
499  *
500  * @param plugin our plugin
501  * @param session session that changed state
502  * @param state new state of the session
503  */
504 static void
505 notify_session_monitor (struct Plugin *plugin,
506                         struct Session *session,
507                         enum GNUNET_TRANSPORT_SessionState state)
508 {
509   struct GNUNET_TRANSPORT_SessionInfo info;
510
511   if (NULL == plugin->sic)
512     return;
513   memset (&info, 0, sizeof (info));
514   info.state = state;
515   info.is_inbound = GNUNET_SYSERR; /* hard to say */
516   info.num_msg_pending = session->msgs_in_queue;
517   info.num_bytes_pending = session->bytes_in_queue;
518   /* info.receive_delay remains zero as this is not supported by UDP
519      (cannot selectively not receive from 'some' peer while continuing
520      to receive from others) */
521   info.session_timeout = session->timeout;
522   info.address = session->address;
523   plugin->sic (plugin->sic_cls,
524                session,
525                &info);
526 }
527
528
529 /**
530  * We have been notified that our readset has something to read.  We don't
531  * know which socket needs to be read, so we have to check each one
532  * Then reschedule this function to be called again once more is available.
533  *
534  * @param cls the plugin handle
535  * @param tc the scheduling context (for rescheduling this function again)
536  */
537 static void
538 udp_plugin_select (void *cls,
539                    const struct GNUNET_SCHEDULER_TaskContext *tc);
540
541
542 /**
543  * We have been notified that our readset has something to read.  We don't
544  * know which socket needs to be read, so we have to check each one
545  * Then reschedule this function to be called again once more is available.
546  *
547  * @param cls the plugin handle
548  * @param tc the scheduling context (for rescheduling this function again)
549  */
550 static void
551 udp_plugin_select_v6 (void *cls,
552                       const struct GNUNET_SCHEDULER_TaskContext *tc);
553
554
555 /**
556  * (re)schedule select tasks for this plugin.
557  *
558  * @param plugin plugin to reschedule
559  */
560 static void
561 schedule_select (struct Plugin *plugin)
562 {
563   struct GNUNET_TIME_Relative min_delay;
564   struct UDP_MessageWrapper *udpw;
565
566   if ((GNUNET_YES == plugin->enable_ipv4) && (NULL != plugin->sockv4))
567   {
568     /* Find a message ready to send:
569      * Flow delay from other peer is expired or not set (0) */
570     min_delay = GNUNET_TIME_UNIT_FOREVER_REL;
571     for (udpw = plugin->ipv4_queue_head; NULL != udpw; udpw = udpw->next)
572       min_delay = GNUNET_TIME_relative_min (min_delay,
573           GNUNET_TIME_absolute_get_remaining (
574               udpw->session->flow_delay_from_other_peer));
575
576     if (plugin->select_task != NULL )
577       GNUNET_SCHEDULER_cancel (plugin->select_task);
578
579     /* Schedule with:
580      * - write active set if message is ready
581      * - timeout minimum delay */
582     plugin->select_task = GNUNET_SCHEDULER_add_select (
583         GNUNET_SCHEDULER_PRIORITY_DEFAULT,
584         (0 == min_delay.rel_value_us) ?
585             GNUNET_TIME_UNIT_FOREVER_REL : min_delay, plugin->rs_v4,
586         (0 == min_delay.rel_value_us) ? plugin->ws_v4 : NULL,
587         &udp_plugin_select, plugin);
588   }
589   if ((GNUNET_YES == plugin->enable_ipv6) && (NULL != plugin->sockv6))
590   {
591     min_delay = GNUNET_TIME_UNIT_FOREVER_REL;
592     for (udpw = plugin->ipv6_queue_head; NULL != udpw; udpw = udpw->next)
593       min_delay = GNUNET_TIME_relative_min (min_delay,
594           GNUNET_TIME_absolute_get_remaining (
595               udpw->session->flow_delay_from_other_peer));
596
597     if (NULL != plugin->select_task_v6)
598       GNUNET_SCHEDULER_cancel (plugin->select_task_v6);
599     plugin->select_task_v6 = GNUNET_SCHEDULER_add_select (
600         GNUNET_SCHEDULER_PRIORITY_DEFAULT,
601         (0 == min_delay.rel_value_us) ?
602             GNUNET_TIME_UNIT_FOREVER_REL : min_delay, plugin->rs_v6,
603         (0 == min_delay.rel_value_us) ? plugin->ws_v6 : NULL,
604         &udp_plugin_select_v6, plugin);
605   }
606 }
607
608
609 /**
610  * Function called for a quick conversion of the binary address to
611  * a numeric address.  Note that the caller must not free the
612  * address and that the next call to this function is allowed
613  * to override the address again.
614  *
615  * @param cls closure
616  * @param addr binary address (a `union UdpAddress`)
617  * @param addrlen length of the @a addr
618  * @return string representing the same address
619  */
620 const char *
621 udp_address_to_string (void *cls,
622                        const void *addr,
623                        size_t addrlen)
624 {
625   static char rbuf[INET6_ADDRSTRLEN + 10];
626   char buf[INET6_ADDRSTRLEN];
627   const void *sb;
628   struct in_addr a4;
629   struct in6_addr a6;
630   const struct IPv4UdpAddress *t4;
631   const struct IPv6UdpAddress *t6;
632   int af;
633   uint16_t port;
634   uint32_t options;
635
636   if ((NULL != addr) && (addrlen == sizeof(struct IPv6UdpAddress)))
637   {
638     t6 = addr;
639     af = AF_INET6;
640     options = ntohl (t6->options);
641     port = ntohs (t6->u6_port);
642     memcpy (&a6, &t6->ipv6_addr, sizeof(a6));
643     sb = &a6;
644   }
645   else if ((NULL != addr) && (addrlen == sizeof(struct IPv4UdpAddress)))
646   {
647     t4 = addr;
648     af = AF_INET;
649     options = ntohl (t4->options);
650     port = ntohs (t4->u4_port);
651     memcpy (&a4, &t4->ipv4_addr, sizeof(a4));
652     sb = &a4;
653   }
654   else
655   {
656     return NULL;
657   }
658   inet_ntop (af, sb, buf, INET6_ADDRSTRLEN);
659
660   GNUNET_snprintf (rbuf, sizeof(rbuf),
661                    (af == AF_INET6)
662                    ? "%s.%u.[%s]:%u"
663                    : "%s.%u.%s:%u",
664                    PLUGIN_NAME,
665                    options,
666                    buf,
667                    port);
668   return rbuf;
669 }
670
671
672 /**
673  * Function called to convert a string address to
674  * a binary address.
675  *
676  * @param cls closure (`struct Plugin *`)
677  * @param addr string address
678  * @param addrlen length of the address
679  * @param buf location to store the buffer
680  * @param added location to store the number of bytes in the buffer.
681  *        If the function returns #GNUNET_SYSERR, its contents are undefined.
682  * @return #GNUNET_OK on success, #GNUNET_SYSERR on failure
683  */
684 static int
685 udp_string_to_address (void *cls,
686                        const char *addr,
687                        uint16_t addrlen,
688                        void **buf,
689                        size_t *added)
690 {
691   struct sockaddr_storage socket_address;
692   char *address;
693   char *plugin;
694   char *optionstr;
695   uint32_t options;
696
697   /* Format tcp.options.address:port */
698   address = NULL;
699   plugin = NULL;
700   optionstr = NULL;
701
702   if ((NULL == addr) || (addrlen == 0))
703   {
704     GNUNET_break(0);
705     return GNUNET_SYSERR;
706   }
707   if ('\0' != addr[addrlen - 1])
708   {
709     GNUNET_break(0);
710     return GNUNET_SYSERR;
711   }
712   if (strlen (addr) != addrlen - 1)
713   {
714     GNUNET_break(0);
715     return GNUNET_SYSERR;
716   }
717   plugin = GNUNET_strdup (addr);
718   optionstr = strchr (plugin, '.');
719   if (NULL == optionstr)
720   {
721     GNUNET_break(0);
722     GNUNET_free(plugin);
723     return GNUNET_SYSERR;
724   }
725   optionstr[0] = '\0';
726   optionstr++;
727   options = atol (optionstr);
728   address = strchr (optionstr, '.');
729   if (NULL == address)
730   {
731     GNUNET_break(0);
732     GNUNET_free(plugin);
733     return GNUNET_SYSERR;
734   }
735   address[0] = '\0';
736   address++;
737
738   if (GNUNET_OK !=
739       GNUNET_STRINGS_to_address_ip (address, strlen (address),
740                                     &socket_address))
741   {
742     GNUNET_break(0);
743     GNUNET_free(plugin);
744     return GNUNET_SYSERR;
745   }
746
747   GNUNET_free(plugin);
748
749   switch (socket_address.ss_family)
750   {
751   case AF_INET:
752   {
753     struct IPv4UdpAddress *u4;
754     struct sockaddr_in *in4 = (struct sockaddr_in *) &socket_address;
755     u4 = GNUNET_new (struct IPv4UdpAddress);
756     u4->options = htonl (options);
757     u4->ipv4_addr = in4->sin_addr.s_addr;
758     u4->u4_port = in4->sin_port;
759     *buf = u4;
760     *added = sizeof(struct IPv4UdpAddress);
761     return GNUNET_OK;
762   }
763   case AF_INET6:
764   {
765     struct IPv6UdpAddress *u6;
766     struct sockaddr_in6 *in6 = (struct sockaddr_in6 *) &socket_address;
767     u6 = GNUNET_new (struct IPv6UdpAddress);
768     u6->options = htonl (options);
769     u6->ipv6_addr = in6->sin6_addr;
770     u6->u6_port = in6->sin6_port;
771     *buf = u6;
772     *added = sizeof(struct IPv6UdpAddress);
773     return GNUNET_OK;
774   }
775   default:
776     GNUNET_break(0);
777     return GNUNET_SYSERR;
778   }
779 }
780
781
782 /**
783  * Append our port and forward the result.
784  *
785  * @param cls a `struct PrettyPrinterContext *`
786  * @param hostname result from DNS resolver
787  */
788 static void
789 append_port (void *cls,
790              const char *hostname)
791 {
792   struct PrettyPrinterContext *ppc = cls;
793   struct Plugin *plugin = ppc->plugin;
794   char *ret;
795
796   if (NULL == hostname)
797   {
798     /* Final call, done */
799     ppc->asc (ppc->asc_cls,
800               NULL,
801               GNUNET_OK);
802     GNUNET_CONTAINER_DLL_remove (plugin->ppc_dll_head,
803                                  plugin->ppc_dll_tail,
804                                  ppc);
805     ppc->resolver_handle = NULL;
806     GNUNET_free (ppc);
807     return;
808   }
809   if (GNUNET_YES == ppc->ipv6)
810     GNUNET_asprintf (&ret,
811                      "%s.%u.[%s]:%d",
812                      PLUGIN_NAME,
813                      ppc->options,
814                      hostname,
815                      ppc->port);
816   else
817     GNUNET_asprintf (&ret,
818                      "%s.%u.%s:%d",
819                      PLUGIN_NAME,
820                      ppc->options,
821                      hostname,
822                      ppc->port);
823   ppc->asc (ppc->asc_cls,
824             ret,
825             GNUNET_OK);
826   GNUNET_free (ret);
827 }
828
829
830 /**
831  * Convert the transports address to a nice, human-readable
832  * format.
833  *
834  * @param cls closure with the `struct Plugin *`
835  * @param type name of the transport that generated the address
836  * @param addr one of the addresses of the host, NULL for the last address
837  *        the specific address format depends on the transport;
838  *        a `union UdpAddress`
839  * @param addrlen length of the address
840  * @param numeric should (IP) addresses be displayed in numeric form?
841  * @param timeout after how long should we give up?
842  * @param asc function to call on each string
843  * @param asc_cls closure for @a asc
844  */
845 static void
846 udp_plugin_address_pretty_printer (void *cls,
847                                    const char *type,
848                                    const void *addr,
849                                    size_t addrlen,
850                                    int numeric,
851                                    struct GNUNET_TIME_Relative timeout,
852                                    GNUNET_TRANSPORT_AddressStringCallback asc,
853                                    void *asc_cls)
854 {
855   struct Plugin *plugin = cls;
856   struct PrettyPrinterContext *ppc;
857   const void *sb;
858   size_t sbs;
859   struct sockaddr_in a4;
860   struct sockaddr_in6 a6;
861   const struct IPv4UdpAddress *u4;
862   const struct IPv6UdpAddress *u6;
863   uint16_t port;
864   uint32_t options;
865
866   if (addrlen == sizeof(struct IPv6UdpAddress))
867   {
868     u6 = addr;
869     memset (&a6, 0, sizeof(a6));
870     a6.sin6_family = AF_INET6;
871 #if HAVE_SOCKADDR_IN_SIN_LEN
872     a6.sin6_len = sizeof (a6);
873 #endif
874     a6.sin6_port = u6->u6_port;
875     memcpy (&a6.sin6_addr, &u6->ipv6_addr, sizeof(struct in6_addr));
876     port = ntohs (u6->u6_port);
877     options = ntohl (u6->options);
878     sb = &a6;
879     sbs = sizeof(a6);
880   }
881   else if (addrlen == sizeof(struct IPv4UdpAddress))
882   {
883     u4 = addr;
884     memset (&a4, 0, sizeof(a4));
885     a4.sin_family = AF_INET;
886 #if HAVE_SOCKADDR_IN_SIN_LEN
887     a4.sin_len = sizeof (a4);
888 #endif
889     a4.sin_port = u4->u4_port;
890     a4.sin_addr.s_addr = u4->ipv4_addr;
891     port = ntohs (u4->u4_port);
892     options = ntohl (u4->options);
893     sb = &a4;
894     sbs = sizeof(a4);
895   }
896   else
897   {
898     /* invalid address */
899     GNUNET_break_op (0);
900     asc (asc_cls, NULL , GNUNET_SYSERR);
901     asc (asc_cls, NULL, GNUNET_OK);
902     return;
903   }
904   ppc = GNUNET_new (struct PrettyPrinterContext);
905   ppc->plugin = plugin;
906   ppc->asc = asc;
907   ppc->asc_cls = asc_cls;
908   ppc->port = port;
909   ppc->options = options;
910   if (addrlen == sizeof(struct IPv6UdpAddress))
911     ppc->ipv6 = GNUNET_YES;
912   else
913     ppc->ipv6 = GNUNET_NO;
914   GNUNET_CONTAINER_DLL_insert (plugin->ppc_dll_head,
915                                plugin->ppc_dll_tail,
916                                ppc);
917   ppc->resolver_handle
918     = GNUNET_RESOLVER_hostname_get (sb,
919                                     sbs,
920                                     ! numeric,
921                                     timeout,
922                                     &append_port, ppc);
923 }
924
925
926 /**
927  * FIXME.
928  */
929 static void
930 call_continuation (struct UDP_MessageWrapper *udpw,
931                    int result)
932 {
933   struct Session *session = udpw->session;
934   struct Plugin *plugin = session->plugin;
935   size_t overhead;
936
937   LOG (GNUNET_ERROR_TYPE_DEBUG,
938        "Calling continuation for %u byte message to `%s' with result %s\n",
939        udpw->payload_size, GNUNET_i2s (&udpw->session->target),
940        (GNUNET_OK == result) ? "OK" : "SYSERR");
941
942   if (udpw->msg_size >= udpw->payload_size)
943     overhead = udpw->msg_size - udpw->payload_size;
944   else
945     overhead = udpw->msg_size;
946
947   switch (result)
948   {
949   case GNUNET_OK:
950     switch (udpw->msg_type)
951     {
952     case UMT_MSG_UNFRAGMENTED:
953       if (NULL != udpw->cont)
954       {
955         /* Transport continuation */
956         udpw->cont (udpw->cont_cls, &udpw->session->target, result,
957             udpw->payload_size, udpw->msg_size);
958       }
959       GNUNET_STATISTICS_update (plugin->env->stats,
960           "# UDP, unfragmented msgs, messages, sent, success", 1, GNUNET_NO);
961       GNUNET_STATISTICS_update (plugin->env->stats,
962           "# UDP, unfragmented msgs, bytes payload, sent, success",
963           udpw->payload_size, GNUNET_NO);
964       GNUNET_STATISTICS_update (plugin->env->stats,
965           "# UDP, unfragmented msgs, bytes overhead, sent, success", overhead,
966           GNUNET_NO);
967       GNUNET_STATISTICS_update (plugin->env->stats,
968           "# UDP, total, bytes overhead, sent", overhead, GNUNET_NO);
969       GNUNET_STATISTICS_update (plugin->env->stats,
970           "# UDP, total, bytes payload, sent", udpw->payload_size, GNUNET_NO);
971       break;
972     case UMT_MSG_FRAGMENTED_COMPLETE:
973       GNUNET_assert(NULL != udpw->frag_ctx);
974       if (udpw->frag_ctx->cont != NULL )
975         udpw->frag_ctx->cont (udpw->frag_ctx->cont_cls, &udpw->session->target,
976             GNUNET_OK, udpw->frag_ctx->payload_size,
977             udpw->frag_ctx->on_wire_size);
978       GNUNET_STATISTICS_update (plugin->env->stats,
979           "# UDP, fragmented msgs, messages, sent, success", 1, GNUNET_NO);
980       GNUNET_STATISTICS_update (plugin->env->stats,
981           "# UDP, fragmented msgs, bytes payload, sent, success",
982           udpw->payload_size, GNUNET_NO);
983       GNUNET_STATISTICS_update (plugin->env->stats,
984           "# UDP, fragmented msgs, bytes overhead, sent, success", overhead,
985           GNUNET_NO);
986       GNUNET_STATISTICS_update (plugin->env->stats,
987           "# UDP, total, bytes overhead, sent", overhead, GNUNET_NO);
988       GNUNET_STATISTICS_update (plugin->env->stats,
989           "# UDP, total, bytes payload, sent", udpw->payload_size, GNUNET_NO);
990       GNUNET_STATISTICS_update (plugin->env->stats,
991           "# UDP, fragmented msgs, messages, pending", -1, GNUNET_NO);
992       break;
993     case UMT_MSG_FRAGMENTED:
994       /* Fragmented message: enqueue next fragment */
995       if (NULL != udpw->cont)
996         udpw->cont (udpw->cont_cls, &udpw->session->target, result,
997             udpw->payload_size, udpw->msg_size);
998       GNUNET_STATISTICS_update (plugin->env->stats,
999           "# UDP, fragmented msgs, fragments, sent, success", 1, GNUNET_NO);
1000       GNUNET_STATISTICS_update (plugin->env->stats,
1001           "# UDP, fragmented msgs, fragments bytes, sent, success",
1002           udpw->msg_size, GNUNET_NO);
1003       break;
1004     case UMT_MSG_ACK:
1005       /* No continuation */
1006       GNUNET_STATISTICS_update (plugin->env->stats,
1007           "# UDP, ACK msgs, messages, sent, success", 1, GNUNET_NO);
1008       GNUNET_STATISTICS_update (plugin->env->stats,
1009           "# UDP, ACK msgs, bytes overhead, sent, success", overhead,
1010           GNUNET_NO);
1011       GNUNET_STATISTICS_update (plugin->env->stats,
1012           "# UDP, total, bytes overhead, sent", overhead, GNUNET_NO);
1013       break;
1014     default:
1015       GNUNET_break(0);
1016       break;
1017     }
1018     break;
1019   case GNUNET_SYSERR:
1020     switch (udpw->msg_type)
1021     {
1022     case UMT_MSG_UNFRAGMENTED:
1023       /* Unfragmented message: failed to send */
1024       if (NULL != udpw->cont)
1025         udpw->cont (udpw->cont_cls, &udpw->session->target, result,
1026             udpw->payload_size, overhead);
1027       GNUNET_STATISTICS_update (plugin->env->stats,
1028           "# UDP, unfragmented msgs, messages, sent, failure", 1, GNUNET_NO);
1029       GNUNET_STATISTICS_update (plugin->env->stats,
1030           "# UDP, unfragmented msgs, bytes payload, sent, failure",
1031           udpw->payload_size, GNUNET_NO);
1032       GNUNET_STATISTICS_update (plugin->env->stats,
1033           "# UDP, unfragmented msgs, bytes overhead, sent, failure", overhead,
1034           GNUNET_NO);
1035       break;
1036     case UMT_MSG_FRAGMENTED_COMPLETE:
1037       GNUNET_assert(NULL != udpw->frag_ctx);
1038       if (udpw->frag_ctx->cont != NULL )
1039         udpw->frag_ctx->cont (udpw->frag_ctx->cont_cls, &udpw->session->target,
1040             GNUNET_SYSERR, udpw->frag_ctx->payload_size,
1041             udpw->frag_ctx->on_wire_size);
1042       GNUNET_STATISTICS_update (plugin->env->stats,
1043           "# UDP, fragmented msgs, messages, sent, failure", 1, GNUNET_NO);
1044       GNUNET_STATISTICS_update (plugin->env->stats,
1045           "# UDP, fragmented msgs, bytes payload, sent, failure",
1046           udpw->payload_size, GNUNET_NO);
1047       GNUNET_STATISTICS_update (plugin->env->stats,
1048           "# UDP, fragmented msgs, bytes payload, sent, failure", overhead,
1049           GNUNET_NO);
1050       GNUNET_STATISTICS_update (plugin->env->stats,
1051           "# UDP, fragmented msgs, bytes payload, sent, failure", overhead,
1052           GNUNET_NO);
1053       GNUNET_STATISTICS_update (plugin->env->stats,
1054           "# UDP, fragmented msgs, messages, pending", -1, GNUNET_NO);
1055       break;
1056     case UMT_MSG_FRAGMENTED:
1057       GNUNET_assert(NULL != udpw->frag_ctx);
1058       /* Fragmented message: failed to send */
1059       GNUNET_STATISTICS_update (plugin->env->stats,
1060           "# UDP, fragmented msgs, fragments, sent, failure", 1, GNUNET_NO);
1061       GNUNET_STATISTICS_update (plugin->env->stats,
1062           "# UDP, fragmented msgs, fragments bytes, sent, failure",
1063           udpw->msg_size, GNUNET_NO);
1064       break;
1065     case UMT_MSG_ACK:
1066       /* ACK message: failed to send */
1067       GNUNET_STATISTICS_update (plugin->env->stats,
1068           "# UDP, ACK msgs, messages, sent, failure", 1, GNUNET_NO);
1069       break;
1070     default:
1071       GNUNET_break(0);
1072       break;
1073     }
1074     break;
1075   default:
1076     GNUNET_break(0);
1077     break;
1078   }
1079 }
1080
1081
1082 /**
1083  * Check if the given port is plausible (must be either our listen
1084  * port or our advertised port).  If it is neither, we return
1085  * #GNUNET_SYSERR.
1086  *
1087  * @param plugin global variables
1088  * @param in_port port number to check
1089  * @return #GNUNET_OK if port is either open_port or adv_port
1090  */
1091 static int
1092 check_port (struct Plugin *plugin,
1093             uint16_t in_port)
1094 {
1095   if ((in_port == plugin->port) || (in_port == plugin->aport))
1096     return GNUNET_OK;
1097   return GNUNET_SYSERR;
1098 }
1099
1100
1101 /**
1102  * Function that will be called to check if a binary address for this
1103  * plugin is well-formed and corresponds to an address for THIS peer
1104  * (as per our configuration).  Naturally, if absolutely necessary,
1105  * plugins can be a bit conservative in their answer, but in general
1106  * plugins should make sure that the address does not redirect
1107  * traffic to a 3rd party that might try to man-in-the-middle our
1108  * traffic.
1109  *
1110  * @param cls closure, should be our handle to the Plugin
1111  * @param addr pointer to a `union UdpAddress`
1112  * @param addrlen length of @a addr
1113  * @return #GNUNET_OK if this is a plausible address for this peer
1114  *         and transport, #GNUNET_SYSERR if not
1115  */
1116 static int
1117 udp_plugin_check_address (void *cls,
1118                           const void *addr,
1119                           size_t addrlen)
1120 {
1121   struct Plugin *plugin = cls;
1122   struct IPv4UdpAddress *v4;
1123   struct IPv6UdpAddress *v6;
1124
1125   if ((addrlen != sizeof(struct IPv4UdpAddress))
1126       && (addrlen != sizeof(struct IPv6UdpAddress)))
1127   {
1128     GNUNET_break_op(0);
1129     return GNUNET_SYSERR;
1130   }
1131   if (addrlen == sizeof(struct IPv4UdpAddress))
1132   {
1133     v4 = (struct IPv4UdpAddress *) addr;
1134     if (GNUNET_OK != check_port (plugin, ntohs (v4->u4_port)))
1135       return GNUNET_SYSERR;
1136     if (GNUNET_OK
1137         != GNUNET_NAT_test_address (plugin->nat, &v4->ipv4_addr,
1138             sizeof(struct in_addr)))
1139       return GNUNET_SYSERR;
1140   }
1141   else
1142   {
1143     v6 = (struct IPv6UdpAddress *) addr;
1144     if (IN6_IS_ADDR_LINKLOCAL (&v6->ipv6_addr))
1145     {
1146       GNUNET_break_op(0);
1147       return GNUNET_SYSERR;
1148     }
1149     if (GNUNET_OK != check_port (plugin, ntohs (v6->u6_port)))
1150       return GNUNET_SYSERR;
1151     if (GNUNET_OK !=
1152         GNUNET_NAT_test_address (plugin->nat,
1153                                  &v6->ipv6_addr,
1154                                  sizeof(struct in6_addr)))
1155       return GNUNET_SYSERR;
1156   }
1157   return GNUNET_OK;
1158 }
1159
1160
1161 /**
1162  * Function to free last resources associated with a session.
1163  *
1164  * @param s session to free
1165  */
1166 static void
1167 free_session (struct Session *s)
1168 {
1169   if (NULL != s->frag_ctx)
1170   {
1171     GNUNET_FRAGMENT_context_destroy (s->frag_ctx->frag, NULL, NULL );
1172     GNUNET_free(s->frag_ctx);
1173     s->frag_ctx = NULL;
1174   }
1175   GNUNET_free(s);
1176 }
1177
1178
1179 /**
1180  * Remove a message from the transmission queue.
1181  *
1182  * @param plugin the UDP plugin
1183  * @param udpw message wrapper to queue
1184  */
1185 static void
1186 dequeue (struct Plugin *plugin,
1187          struct UDP_MessageWrapper *udpw)
1188 {
1189   struct Session *session = udpw->session;
1190
1191   if (plugin->bytes_in_buffer < udpw->msg_size)
1192   {
1193     GNUNET_break (0);
1194   }
1195   else
1196   {
1197     GNUNET_STATISTICS_update (plugin->env->stats,
1198                               "# UDP, total, bytes in buffers",
1199                               -(long long) udpw->msg_size,
1200                               GNUNET_NO);
1201     plugin->bytes_in_buffer -= udpw->msg_size;
1202   }
1203   GNUNET_STATISTICS_update (plugin->env->stats,
1204                             "# UDP, total, msgs in buffers",
1205                             -1, GNUNET_NO);
1206   if (udpw->session->address->address_length == sizeof(struct IPv4UdpAddress))
1207     GNUNET_CONTAINER_DLL_remove (plugin->ipv4_queue_head,
1208                                  plugin->ipv4_queue_tail,
1209                                  udpw);
1210   else if (udpw->session->address->address_length == sizeof(struct IPv6UdpAddress))
1211     GNUNET_CONTAINER_DLL_remove (plugin->ipv6_queue_head,
1212                                  plugin->ipv6_queue_tail,
1213                                  udpw);
1214   else
1215   {
1216     GNUNET_break (0);
1217     return;
1218   }
1219   GNUNET_assert (session->msgs_in_queue > 0);
1220   session->msgs_in_queue--;
1221   GNUNET_assert (session->bytes_in_queue >= udpw->msg_size);
1222   session->bytes_in_queue -= udpw->msg_size;
1223 }
1224
1225
1226 /**
1227  * FIXME.
1228  */
1229 static void
1230 fragmented_message_done (struct UDP_FragmentationContext *fc,
1231                          int result)
1232 {
1233   struct Plugin *plugin = fc->plugin;
1234   struct Session *s = fc->session;
1235   struct UDP_MessageWrapper *udpw;
1236   struct UDP_MessageWrapper *tmp;
1237   struct UDP_MessageWrapper dummy;
1238
1239   LOG (GNUNET_ERROR_TYPE_DEBUG,
1240        "%p : Fragmented message removed with result %s\n",
1241        fc,
1242        (result == GNUNET_SYSERR) ? "FAIL" : "SUCCESS");
1243
1244   /* Call continuation for fragmented message */
1245   memset (&dummy, 0, sizeof(dummy));
1246   dummy.msg_type = UMT_MSG_FRAGMENTED_COMPLETE;
1247   dummy.msg_size = s->frag_ctx->on_wire_size;
1248   dummy.payload_size = s->frag_ctx->payload_size;
1249   dummy.frag_ctx = s->frag_ctx;
1250   dummy.cont = NULL;
1251   dummy.cont_cls = NULL;
1252   dummy.session = s;
1253   call_continuation (&dummy, result);
1254   /* Remove leftover fragments from queue */
1255   if (s->address->address_length == sizeof(struct IPv6UdpAddress))
1256   {
1257     udpw = plugin->ipv6_queue_head;
1258     while (NULL != udpw)
1259     {
1260       tmp = udpw->next;
1261       if ((udpw->frag_ctx != NULL )&& (udpw->frag_ctx == s->frag_ctx)){
1262       dequeue (plugin, udpw);
1263       call_continuation (udpw, GNUNET_SYSERR);
1264       GNUNET_free (udpw);
1265     }
1266       udpw = tmp;
1267     }
1268   }
1269   if (s->address->address_length == sizeof(struct IPv4UdpAddress))
1270   {
1271     udpw = plugin->ipv4_queue_head;
1272     while (udpw != NULL )
1273     {
1274       tmp = udpw->next;
1275       if ((NULL != udpw->frag_ctx) && (udpw->frag_ctx == s->frag_ctx))
1276       {
1277         dequeue (plugin, udpw);
1278         call_continuation (udpw, GNUNET_SYSERR);
1279         GNUNET_free(udpw);
1280       }
1281       udpw = tmp;
1282     }
1283   }
1284   notify_session_monitor (s->plugin,
1285                           s,
1286                           GNUNET_TRANSPORT_SS_UPDATE);
1287   /* Destroy fragmentation context */
1288   GNUNET_FRAGMENT_context_destroy (fc->frag,
1289                                    &s->last_expected_msg_delay,
1290                                    &s->last_expected_ack_delay);
1291   s->frag_ctx = NULL;
1292   GNUNET_free (fc);
1293 }
1294
1295
1296 /**
1297  * Scan the heap for a receive context with the given address.
1298  *
1299  * @param cls the `struct FindReceiveContext`
1300  * @param node internal node of the heap
1301  * @param element value stored at the node (a `struct ReceiveContext`)
1302  * @param cost cost associated with the node
1303  * @return #GNUNET_YES if we should continue to iterate,
1304  *         #GNUNET_NO if not.
1305  */
1306 static int
1307 find_receive_context (void *cls,
1308                       struct GNUNET_CONTAINER_HeapNode *node,
1309                       void *element,
1310                       GNUNET_CONTAINER_HeapCostType cost)
1311 {
1312   struct FindReceiveContext *frc = cls;
1313   struct DefragContext *e = element;
1314
1315   if ( (frc->udp_addr_len == e->udp_addr_len) &&
1316        (0 == memcmp (frc->udp_addr,
1317                      e->udp_addr,
1318                      frc->udp_addr_len)) )
1319   {
1320     frc->rc = e;
1321     return GNUNET_NO;
1322   }
1323   return GNUNET_YES;
1324 }
1325
1326
1327 /**
1328  * Functions with this signature are called whenever we need
1329  * to close a session due to a disconnect or failure to
1330  * establish a connection.
1331  *
1332  * @param cls closure with the `struct Plugin`
1333  * @param s session to close down
1334  * @return #GNUNET_OK on success
1335  */
1336 static int
1337 udp_disconnect_session (void *cls,
1338                         struct Session *s)
1339 {
1340   struct Plugin *plugin = cls;
1341   struct UDP_MessageWrapper *udpw;
1342   struct UDP_MessageWrapper *next;
1343   struct FindReceiveContext frc;
1344
1345   GNUNET_assert (GNUNET_YES != s->in_destroy);
1346   LOG (GNUNET_ERROR_TYPE_DEBUG,
1347        "Session %p to peer `%s' address ended\n", s,
1348        GNUNET_i2s (&s->target),
1349        udp_address_to_string (NULL,
1350                               s->address->address,
1351                               s->address->address_length));
1352   /* stop timeout task */
1353   if (NULL != s->timeout_task)
1354   {
1355     GNUNET_SCHEDULER_cancel (s->timeout_task);
1356     s->timeout_task = NULL;
1357   }
1358   if (NULL != s->frag_ctx)
1359   {
1360     /* Remove fragmented message due to disconnect */
1361     fragmented_message_done (s->frag_ctx,
1362                              GNUNET_SYSERR);
1363   }
1364
1365   frc.rc = NULL;
1366   frc.udp_addr = s->address->address;
1367   frc.udp_addr_len = s->address->address_length;
1368   /* Lookup existing receive context for this address */
1369   if (NULL != plugin->defrag_ctxs)
1370   {
1371     GNUNET_CONTAINER_heap_iterate (plugin->defrag_ctxs,
1372                                    &find_receive_context,
1373                                    &frc);
1374     if (NULL != frc.rc)
1375     {
1376       struct DefragContext *d_ctx = frc.rc;
1377
1378       GNUNET_CONTAINER_heap_remove_node (d_ctx->hnode);
1379       GNUNET_DEFRAGMENT_context_destroy (d_ctx->defrag);
1380       GNUNET_free (d_ctx);
1381     }
1382   }
1383   next = plugin->ipv4_queue_head;
1384   while (NULL != (udpw = next))
1385   {
1386     next = udpw->next;
1387     if (udpw->session == s)
1388     {
1389       dequeue (plugin, udpw);
1390       call_continuation (udpw, GNUNET_SYSERR);
1391       GNUNET_free(udpw);
1392     }
1393   }
1394   next = plugin->ipv6_queue_head;
1395   while (NULL != (udpw = next))
1396   {
1397     next = udpw->next;
1398     if (udpw->session == s)
1399     {
1400       dequeue (plugin, udpw);
1401       call_continuation (udpw, GNUNET_SYSERR);
1402       GNUNET_free(udpw);
1403     }
1404   }
1405   notify_session_monitor (s->plugin,
1406                           s,
1407                           GNUNET_TRANSPORT_SS_DONE);
1408   plugin->env->session_end (plugin->env->cls,
1409                             s->address,
1410                             s);
1411
1412   if (NULL != s->frag_ctx)
1413   {
1414     if (NULL != s->frag_ctx->cont)
1415     {
1416       s->frag_ctx->cont (s->frag_ctx->cont_cls,
1417                          &s->target,
1418                          GNUNET_SYSERR,
1419                          s->frag_ctx->payload_size,
1420                          s->frag_ctx->on_wire_size);
1421       LOG (GNUNET_ERROR_TYPE_DEBUG,
1422            "Calling continuation for fragemented message to `%s' with result SYSERR\n",
1423            GNUNET_i2s (&s->target));
1424     }
1425   }
1426
1427   GNUNET_assert (GNUNET_YES ==
1428                  GNUNET_CONTAINER_multipeermap_remove (plugin->sessions,
1429                                                        &s->target,
1430                                                        s));
1431   GNUNET_STATISTICS_set (plugin->env->stats,
1432                          "# UDP sessions active",
1433                          GNUNET_CONTAINER_multipeermap_size (plugin->sessions),
1434                          GNUNET_NO);
1435   if (s->rc > 0)
1436   {
1437     s->in_destroy = GNUNET_YES;
1438   }
1439   else
1440   {
1441     GNUNET_HELLO_address_free (s->address);
1442     free_session (s);
1443   }
1444   return GNUNET_OK;
1445 }
1446
1447
1448 /**
1449  * Function that is called to get the keepalive factor.
1450  * #GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT is divided by this number to
1451  * calculate the interval between keepalive packets.
1452  *
1453  * @param cls closure with the `struct Plugin`
1454  * @return keepalive factor
1455  */
1456 static unsigned int
1457 udp_query_keepalive_factor (void *cls)
1458 {
1459   return 15;
1460 }
1461
1462
1463 /**
1464  * Destroy a session, plugin is being unloaded.
1465  *
1466  * @param cls the `struct Plugin`
1467  * @param key hash of public key of target peer
1468  * @param value a `struct PeerSession *` to clean up
1469  * @return #GNUNET_OK (continue to iterate)
1470  */
1471 static int
1472 disconnect_and_free_it (void *cls,
1473                         const struct GNUNET_PeerIdentity *key,
1474                         void *value)
1475 {
1476   struct Plugin *plugin = cls;
1477
1478   udp_disconnect_session (plugin, value);
1479   return GNUNET_OK;
1480 }
1481
1482
1483 /**
1484  * Disconnect from a remote node.  Clean up session if we have one for
1485  * this peer.
1486  *
1487  * @param cls closure for this call (should be handle to Plugin)
1488  * @param target the peeridentity of the peer to disconnect
1489  * @return #GNUNET_OK on success, #GNUNET_SYSERR if the operation failed
1490  */
1491 static void
1492 udp_disconnect (void *cls,
1493                 const struct GNUNET_PeerIdentity *target)
1494 {
1495   struct Plugin *plugin = cls;
1496
1497   LOG (GNUNET_ERROR_TYPE_DEBUG,
1498        "Disconnecting from peer `%s'\n",
1499        GNUNET_i2s (target));
1500   /* Clean up sessions */
1501   GNUNET_CONTAINER_multipeermap_get_multiple (plugin->sessions,
1502                                               target,
1503                                               &disconnect_and_free_it,
1504                                               plugin);
1505 }
1506
1507
1508 /**
1509  * Session was idle, so disconnect it
1510  *
1511  * @param cls the `struct Session` to time out
1512  * @param tc scheduler context
1513  */
1514 static void
1515 session_timeout (void *cls,
1516                  const struct GNUNET_SCHEDULER_TaskContext *tc)
1517 {
1518   struct Session *s = cls;
1519   struct Plugin *plugin = s->plugin;
1520   struct GNUNET_TIME_Relative left;
1521
1522   s->timeout_task = NULL;
1523   left = GNUNET_TIME_absolute_get_remaining (s->timeout);
1524   if (left.rel_value_us > 0)
1525   {
1526     /* not actually our turn yet, but let's at least update
1527        the monitor, it may think we're about to die ... */
1528     notify_session_monitor (s->plugin,
1529                             s,
1530                             GNUNET_TRANSPORT_SS_UPDATE);
1531     s->timeout_task = GNUNET_SCHEDULER_add_delayed (left,
1532                                                     &session_timeout,
1533                                                     s);
1534     return;
1535   }
1536   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1537               "Session %p was idle for %s, disconnecting\n",
1538               s,
1539               GNUNET_STRINGS_relative_time_to_string (UDP_SESSION_TIME_OUT,
1540                                                       GNUNET_YES));
1541   /* call session destroy function */
1542   udp_disconnect_session (plugin, s);
1543 }
1544
1545
1546 /**
1547  * Increment session timeout due to activity
1548  *
1549  * @param s session to reschedule timeout activity for
1550  */
1551 static void
1552 reschedule_session_timeout (struct Session *s)
1553 {
1554   if (GNUNET_YES == s->in_destroy)
1555     return;
1556   GNUNET_assert(NULL != s->timeout_task);
1557   s->timeout = GNUNET_TIME_relative_to_absolute (UDP_SESSION_TIME_OUT);
1558 }
1559
1560
1561 /**
1562  * FIXME.
1563  */
1564 static struct Session *
1565 create_session (struct Plugin *plugin,
1566                 const struct GNUNET_HELLO_Address *address)
1567 {
1568   struct Session *s;
1569
1570   s = GNUNET_new (struct Session);
1571   s->plugin = plugin;
1572   s->address = GNUNET_HELLO_address_copy (address);
1573   s->target = address->peer;
1574   s->last_expected_ack_delay = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS,
1575                                                               250);
1576   s->last_expected_msg_delay = GNUNET_TIME_UNIT_MILLISECONDS;
1577   s->flow_delay_from_other_peer = GNUNET_TIME_UNIT_ZERO_ABS;
1578   s->flow_delay_for_other_peer = GNUNET_TIME_UNIT_ZERO;
1579   s->timeout = GNUNET_TIME_relative_to_absolute (UDP_SESSION_TIME_OUT);
1580   s->timeout_task = GNUNET_SCHEDULER_add_delayed (UDP_SESSION_TIME_OUT,
1581                                                   &session_timeout, s);
1582   return s;
1583 }
1584
1585
1586 /**
1587  * Function obtain the network type for a session
1588  *
1589  * @param cls closure ('struct Plugin*')
1590  * @param session the session
1591  * @return the network type
1592  */
1593 static enum GNUNET_ATS_Network_Type
1594 udp_get_network (void *cls,
1595                  struct Session *session)
1596 {
1597   return ntohl (session->ats.value);
1598 }
1599
1600
1601 /**
1602  * Closure for #session_cmp_it().
1603  */
1604 struct SessionCompareContext
1605 {
1606   /**
1607    * Set to session matching the address.
1608    */
1609   struct Session *res;
1610
1611   /**
1612    * Address we are looking for.
1613    */
1614   const struct GNUNET_HELLO_Address *address;
1615 };
1616
1617
1618 /**
1619  * Find a session with a matching address.
1620  *
1621  * @param cls the `struct SessionCompareContext *`
1622  * @param key peer identity (unused)
1623  * @param value the `struct Session *`
1624  * @return #GNUNET_NO if we found the session, #GNUNET_OK if not
1625  */
1626 static int
1627 session_cmp_it (void *cls,
1628                 const struct GNUNET_PeerIdentity *key,
1629                 void *value)
1630 {
1631   struct SessionCompareContext *cctx = cls;
1632   const struct GNUNET_HELLO_Address *address = cctx->address;
1633   struct Session *s = value;
1634
1635   LOG (GNUNET_ERROR_TYPE_DEBUG,
1636        "Comparing address %s <-> %s\n",
1637        udp_address_to_string (NULL,
1638                               address->address,
1639                               address->address_length),
1640        udp_address_to_string (NULL,
1641                               s->address->address,
1642                               s->address->address_length));
1643   if (0 == GNUNET_HELLO_address_cmp(s->address, cctx->address))
1644   {
1645     cctx->res = s;
1646     return GNUNET_NO;
1647   }
1648   return GNUNET_YES;
1649 }
1650
1651
1652 /**
1653  * Locate an existing session the transport service is using to
1654  * send data to another peer.  Performs some basic sanity checks
1655  * on the address and then tries to locate a matching session.
1656  *
1657  * @param cls the plugin
1658  * @param address the address we should locate the session by
1659  * @return the session if it exists, or NULL if it is not found
1660  */
1661 static struct Session *
1662 udp_plugin_lookup_session (void *cls,
1663                            const struct GNUNET_HELLO_Address *address)
1664 {
1665   struct Plugin *plugin = cls;
1666   const struct IPv6UdpAddress *udp_a6;
1667   const struct IPv4UdpAddress *udp_a4;
1668   struct SessionCompareContext cctx;
1669
1670   if ( (NULL == address->address) ||
1671        ((address->address_length != sizeof (struct IPv4UdpAddress)) &&
1672         (address->address_length != sizeof (struct IPv6UdpAddress))))
1673   {
1674     LOG (GNUNET_ERROR_TYPE_WARNING,
1675          _("Trying to locate session for address of unexpected length %u (should be %u or %u)\n"),
1676          address->address_length,
1677          sizeof (struct IPv4UdpAddress),
1678          sizeof (struct IPv6UdpAddress));
1679     return NULL;
1680   }
1681
1682   if (address->address_length == sizeof(struct IPv4UdpAddress))
1683   {
1684     if (NULL == plugin->sockv4)
1685       return NULL;
1686     udp_a4 = (const struct IPv4UdpAddress *) address->address;
1687     if (0 == udp_a4->u4_port)
1688       return NULL;
1689   }
1690
1691   if (address->address_length == sizeof(struct IPv6UdpAddress))
1692   {
1693     if (NULL == plugin->sockv6)
1694       return NULL;
1695     udp_a6 = (const struct IPv6UdpAddress *) address->address;
1696     if (0 == udp_a6->u6_port)
1697       return NULL;
1698   }
1699
1700   /* check if session already exists */
1701   cctx.address = address;
1702   cctx.res = NULL;
1703   LOG (GNUNET_ERROR_TYPE_DEBUG,
1704        "Looking for existing session for peer `%s' `%s' \n",
1705        GNUNET_i2s (&address->peer),
1706        udp_address_to_string(NULL, address->address, address->address_length));
1707   GNUNET_CONTAINER_multipeermap_get_multiple (plugin->sessions,
1708                                               &address->peer,
1709                                               &session_cmp_it,
1710                                               &cctx);
1711   if (NULL != cctx.res)
1712   {
1713     LOG (GNUNET_ERROR_TYPE_DEBUG,
1714          "Found existing session %p\n",
1715          cctx.res);
1716     return cctx.res;
1717   }
1718   return NULL;
1719 }
1720
1721
1722 /**
1723  * Allocate a new session for the given endpoint address.
1724  * Note that this function does not inform the service
1725  * of the new session, this is the responsibility of the
1726  * caller (if needed).
1727  *
1728  * @param cls the `struct Plugin`
1729  * @param address address of the other peer to use
1730  * @param network_type network type the address belongs to
1731  * @return NULL on error, otherwise session handle
1732  */
1733 static struct Session *
1734 udp_plugin_create_session (void *cls,
1735                            const struct GNUNET_HELLO_Address *address,
1736                            enum GNUNET_ATS_Network_Type network_type)
1737 {
1738   struct Plugin *plugin = cls;
1739   struct Session *s;
1740
1741   s = create_session (plugin, address);
1742   s->ats.type = htonl (GNUNET_ATS_NETWORK_TYPE);
1743   s->ats.value = htonl (network_type);
1744
1745   if (NULL == s)
1746     return NULL; /* protocol not supported or address invalid */
1747   LOG (GNUNET_ERROR_TYPE_DEBUG,
1748        "Creating new session %p for peer `%s' address `%s'\n",
1749        s,
1750        GNUNET_i2s (&address->peer),
1751        udp_address_to_string (plugin,
1752                               address->address,
1753                               address->address_length));
1754   GNUNET_assert(GNUNET_OK ==
1755                 GNUNET_CONTAINER_multipeermap_put (plugin->sessions,
1756                                                    &s->target,
1757                                                    s,
1758                                                    GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE));
1759   GNUNET_STATISTICS_set (plugin->env->stats,
1760                          "# UDP sessions active",
1761                          GNUNET_CONTAINER_multipeermap_size (plugin->sessions),
1762                          GNUNET_NO);
1763   return s;
1764 }
1765
1766
1767 /**
1768  * Function that will be called whenever the transport service wants to
1769  * notify the plugin that a session is still active and in use and
1770  * therefore the session timeout for this session has to be updated
1771  *
1772  * @param cls closure
1773  * @param peer which peer was the session for
1774  * @param session which session is being updated
1775  */
1776 static void
1777 udp_plugin_update_session_timeout (void *cls,
1778                                    const struct GNUNET_PeerIdentity *peer,
1779                                    struct Session *session)
1780 {
1781   struct Plugin *plugin = cls;
1782
1783   if (GNUNET_YES !=
1784       GNUNET_CONTAINER_multipeermap_contains_value (plugin->sessions,
1785                                                     peer,
1786                                                     session))
1787   {
1788     GNUNET_break(0);
1789     return;
1790   }
1791   /* Reschedule session timeout */
1792   reschedule_session_timeout (session);
1793 }
1794
1795
1796 /**
1797  * Creates a new outbound session the transport service will use to
1798  * send data to the peer.
1799  *
1800  * @param cls the plugin
1801  * @param address the address
1802  * @return the session or NULL of max connections exceeded
1803  */
1804 static struct Session *
1805 udp_plugin_get_session (void *cls,
1806                         const struct GNUNET_HELLO_Address *address)
1807 {
1808   struct Plugin *plugin = cls;
1809   struct Session *s;
1810   enum GNUNET_ATS_Network_Type network_type;
1811   struct IPv4UdpAddress *udp_v4;
1812   struct IPv6UdpAddress *udp_v6;
1813
1814   if (NULL == address)
1815   {
1816     GNUNET_break(0);
1817     return NULL;
1818   }
1819   if ( (address->address_length != sizeof(struct IPv4UdpAddress)) &&
1820        (address->address_length != sizeof(struct IPv6UdpAddress)) )
1821     return NULL;
1822   if (NULL != (s = udp_plugin_lookup_session (cls,
1823                                               address)))
1824     return s;
1825
1826   if (sizeof (struct IPv4UdpAddress) == address->address_length)
1827   {
1828     struct sockaddr_in v4;
1829
1830     udp_v4 = (struct IPv4UdpAddress *) address->address;
1831     memset (&v4, '\0', sizeof (v4));
1832     v4.sin_family = AF_INET;
1833 #if HAVE_SOCKADDR_IN_SIN_LEN
1834     v4.sin_len = sizeof (struct sockaddr_in);
1835 #endif
1836     v4.sin_port = udp_v4->u4_port;
1837     v4.sin_addr.s_addr = udp_v4->ipv4_addr;
1838     network_type = plugin->env->get_address_type (plugin->env->cls,
1839                                                   (const struct sockaddr *) &v4,
1840                                                   sizeof (v4));
1841   }
1842   else if (sizeof (struct IPv6UdpAddress) == address->address_length)
1843   {
1844     struct sockaddr_in6 v6;
1845
1846     udp_v6 = (struct IPv6UdpAddress *) address->address;
1847     memset (&v6, '\0', sizeof (v6));
1848     v6.sin6_family = AF_INET6;
1849 #if HAVE_SOCKADDR_IN_SIN_LEN
1850     v6.sin6_len = sizeof (struct sockaddr_in6);
1851 #endif
1852     v6.sin6_port = udp_v6->u6_port;
1853     v6.sin6_addr = udp_v6->ipv6_addr;
1854     network_type = plugin->env->get_address_type (plugin->env->cls,
1855                                                   (const struct sockaddr *) &v6,
1856                                                   sizeof (v6));
1857   }
1858
1859   /* otherwise create new */
1860   return udp_plugin_create_session (cls, address, network_type);
1861 }
1862
1863
1864 /**
1865  * Enqueue a message for transmission.
1866  *
1867  * @param plugin the UDP plugin
1868  * @param udpw message wrapper to queue
1869  */
1870 static void
1871 enqueue (struct Plugin *plugin,
1872          struct UDP_MessageWrapper *udpw)
1873 {
1874   struct Session *session = udpw->session;
1875
1876   if (plugin->bytes_in_buffer + udpw->msg_size > INT64_MAX)
1877   {
1878     GNUNET_break (0);
1879   }
1880   else
1881   {
1882     GNUNET_STATISTICS_update (plugin->env->stats,
1883         "# UDP, total, bytes in buffers", udpw->msg_size, GNUNET_NO);
1884     plugin->bytes_in_buffer += udpw->msg_size;
1885   }
1886   GNUNET_STATISTICS_update (plugin->env->stats,
1887                             "# UDP, total, msgs in buffers",
1888                             1, GNUNET_NO);
1889   if (udpw->session->address->address_length == sizeof (struct IPv4UdpAddress))
1890     GNUNET_CONTAINER_DLL_insert(plugin->ipv4_queue_head,
1891                                 plugin->ipv4_queue_tail,
1892                                 udpw);
1893   else if (udpw->session->address->address_length == sizeof (struct IPv6UdpAddress))
1894     GNUNET_CONTAINER_DLL_insert (plugin->ipv6_queue_head,
1895                                  plugin->ipv6_queue_tail,
1896                                  udpw);
1897   else
1898   {
1899     GNUNET_break (0);
1900     return;
1901   }
1902   session->msgs_in_queue++;
1903   session->bytes_in_queue += udpw->msg_size;
1904 }
1905
1906
1907 /**
1908  * Fragment message was transmitted via UDP, let fragmentation know
1909  * to send the next fragment now.
1910  *
1911  * @param cls the `struct UDPMessageWrapper *` of the fragment
1912  * @param target destination peer (ignored)
1913  * @param result #GNUNET_OK on success (ignored)
1914  * @param payload bytes payload sent
1915  * @param physical bytes physical sent
1916  */
1917 static void
1918 send_next_fragment (void *cls,
1919                     const struct GNUNET_PeerIdentity *target,
1920                     int result,
1921                     size_t payload,
1922                     size_t physical)
1923 {
1924   struct UDP_MessageWrapper *udpw = cls;
1925
1926   GNUNET_FRAGMENT_context_transmission_done (udpw->frag_ctx->frag);
1927 }
1928
1929
1930 /**
1931  * Function that is called with messages created by the fragmentation
1932  * module.  In the case of the 'proc' callback of the
1933  * #GNUNET_FRAGMENT_context_create() function, this function must
1934  * eventually call #GNUNET_FRAGMENT_context_transmission_done().
1935  *
1936  * @param cls closure, the 'struct FragmentationContext'
1937  * @param msg the message that was created
1938  */
1939 static void
1940 enqueue_fragment (void *cls,
1941                   const struct GNUNET_MessageHeader *msg)
1942 {
1943   struct UDP_FragmentationContext *frag_ctx = cls;
1944   struct Plugin *plugin = frag_ctx->plugin;
1945   struct UDP_MessageWrapper * udpw;
1946   size_t msg_len = ntohs (msg->size);
1947
1948   LOG (GNUNET_ERROR_TYPE_DEBUG,
1949        "Enqueuing fragment with %u bytes\n",
1950        msg_len);
1951   frag_ctx->fragments_used++;
1952   udpw = GNUNET_malloc (sizeof (struct UDP_MessageWrapper) + msg_len);
1953   udpw->session = frag_ctx->session;
1954   udpw->msg_buf = (char *) &udpw[1];
1955   udpw->msg_size = msg_len;
1956   udpw->payload_size = msg_len; /*FIXME: minus fragment overhead */
1957   udpw->cont = &send_next_fragment;
1958   udpw->cont_cls = udpw;
1959   udpw->timeout = frag_ctx->timeout;
1960   udpw->frag_ctx = frag_ctx;
1961   udpw->msg_type = UMT_MSG_FRAGMENTED;
1962   memcpy (udpw->msg_buf, msg, msg_len);
1963   enqueue (plugin, udpw);
1964   schedule_select (plugin);
1965 }
1966
1967
1968 /**
1969  * Function that can be used by the transport service to transmit
1970  * a message using the plugin.   Note that in the case of a
1971  * peer disconnecting, the continuation MUST be called
1972  * prior to the disconnect notification itself.  This function
1973  * will be called with this peer's HELLO message to initiate
1974  * a fresh connection to another peer.
1975  *
1976  * @param cls closure
1977  * @param s which session must be used
1978  * @param msgbuf the message to transmit
1979  * @param msgbuf_size number of bytes in 'msgbuf'
1980  * @param priority how important is the message (most plugins will
1981  *                 ignore message priority and just FIFO)
1982  * @param to how long to wait at most for the transmission (does not
1983  *                require plugins to discard the message after the timeout,
1984  *                just advisory for the desired delay; most plugins will ignore
1985  *                this as well)
1986  * @param cont continuation to call once the message has
1987  *        been transmitted (or if the transport is ready
1988  *        for the next transmission call; or if the
1989  *        peer disconnected...); can be NULL
1990  * @param cont_cls closure for cont
1991  * @return number of bytes used (on the physical network, with overheads);
1992  *         -1 on hard errors (i.e. address invalid); 0 is a legal value
1993  *         and does NOT mean that the message was not transmitted (DV)
1994  */
1995 static ssize_t
1996 udp_plugin_send (void *cls,
1997                  struct Session *s,
1998                  const char *msgbuf,
1999                  size_t msgbuf_size,
2000                  unsigned int priority,
2001                  struct GNUNET_TIME_Relative to,
2002                  GNUNET_TRANSPORT_TransmitContinuation cont,
2003                  void *cont_cls)
2004 {
2005   struct Plugin *plugin = cls;
2006   size_t udpmlen = msgbuf_size + sizeof(struct UDPMessage);
2007   struct UDP_FragmentationContext * frag_ctx;
2008   struct UDP_MessageWrapper * udpw;
2009   struct UDPMessage *udp;
2010   char mbuf[udpmlen];
2011   GNUNET_assert(plugin != NULL);
2012   GNUNET_assert(s != NULL);
2013
2014   if ( (s->address->address_length == sizeof(struct IPv6UdpAddress)) &&
2015        (plugin->sockv6 == NULL) )
2016     return GNUNET_SYSERR;
2017   if ( (s->address->address_length == sizeof(struct IPv4UdpAddress)) &&
2018        (plugin->sockv4 == NULL) )
2019     return GNUNET_SYSERR;
2020   if (udpmlen >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
2021   {
2022     GNUNET_break(0);
2023     return GNUNET_SYSERR;
2024   }
2025   if (GNUNET_YES !=
2026       GNUNET_CONTAINER_multipeermap_contains_value (plugin->sessions,
2027                                                     &s->target,
2028                                                     s))
2029   {
2030     GNUNET_break(0);
2031     return GNUNET_SYSERR;
2032   }
2033   LOG (GNUNET_ERROR_TYPE_DEBUG,
2034        "UDP transmits %u-byte message to `%s' using address `%s'\n",
2035        udpmlen,
2036        GNUNET_i2s (&s->target),
2037        udp_address_to_string (NULL,
2038                               s->address->address,
2039                               s->address->address_length));
2040
2041   /* Message */
2042   udp = (struct UDPMessage *) mbuf;
2043   udp->header.size = htons (udpmlen);
2044   udp->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_MESSAGE);
2045   udp->reserved = htonl (0);
2046   udp->sender = *plugin->env->my_identity;
2047
2048   /* We do not update the session time out here!
2049    * Otherwise this session will not timeout since we send keep alive before
2050    * session can timeout
2051    *
2052    * For UDP we update session timeout only on receive, this will cover keep
2053    * alives, since remote peer will reply with keep alive response!
2054    */
2055   if (udpmlen <= UDP_MTU)
2056   {
2057     /* unfragmented message */
2058     udpw = GNUNET_malloc (sizeof (struct UDP_MessageWrapper) + udpmlen);
2059     udpw->session = s;
2060     udpw->msg_buf = (char *) &udpw[1];
2061     udpw->msg_size = udpmlen; /* message size with UDP overhead */
2062     udpw->payload_size = msgbuf_size; /* message size without UDP overhead */
2063     udpw->timeout = GNUNET_TIME_absolute_add (GNUNET_TIME_absolute_get (), to);
2064     udpw->cont = cont;
2065     udpw->cont_cls = cont_cls;
2066     udpw->frag_ctx = NULL;
2067     udpw->msg_type = UMT_MSG_UNFRAGMENTED;
2068     memcpy (udpw->msg_buf, udp, sizeof(struct UDPMessage));
2069     memcpy (&udpw->msg_buf[sizeof(struct UDPMessage)], msgbuf, msgbuf_size);
2070     enqueue (plugin, udpw);
2071
2072     GNUNET_STATISTICS_update (plugin->env->stats,
2073         "# UDP, unfragmented msgs, messages, attempt", 1, GNUNET_NO);
2074     GNUNET_STATISTICS_update (plugin->env->stats,
2075                               "# UDP, unfragmented msgs, bytes payload, attempt",
2076                               udpw->payload_size,
2077                               GNUNET_NO);
2078   }
2079   else
2080   {
2081     /* fragmented message */
2082     if (s->frag_ctx != NULL)
2083       return GNUNET_SYSERR;
2084     memcpy (&udp[1], msgbuf, msgbuf_size);
2085     frag_ctx = GNUNET_new (struct UDP_FragmentationContext);
2086     frag_ctx->plugin = plugin;
2087     frag_ctx->session = s;
2088     frag_ctx->cont = cont;
2089     frag_ctx->cont_cls = cont_cls;
2090     frag_ctx->timeout = GNUNET_TIME_absolute_add (GNUNET_TIME_absolute_get (),
2091         to);
2092     frag_ctx->payload_size = msgbuf_size; /* unfragmented message size without UDP overhead */
2093     frag_ctx->on_wire_size = 0; /* bytes with UDP and fragmentation overhead */
2094     frag_ctx->frag = GNUNET_FRAGMENT_context_create (plugin->env->stats,
2095                                                      UDP_MTU,
2096                                                      &plugin->tracker,
2097                                                      s->last_expected_msg_delay,
2098                                                      s->last_expected_ack_delay,
2099                                                      &udp->header,
2100                                                      &enqueue_fragment,
2101                                                      frag_ctx);
2102     s->frag_ctx = frag_ctx;
2103     GNUNET_STATISTICS_update (plugin->env->stats,
2104                               "# UDP, fragmented msgs, messages, pending",
2105                               1,
2106                               GNUNET_NO);
2107     GNUNET_STATISTICS_update (plugin->env->stats,
2108                               "# UDP, fragmented msgs, messages, attempt",
2109                               1,
2110                               GNUNET_NO);
2111     GNUNET_STATISTICS_update (plugin->env->stats,
2112                               "# UDP, fragmented msgs, bytes payload, attempt",
2113                               frag_ctx->payload_size,
2114                               GNUNET_NO);
2115   }
2116   notify_session_monitor (s->plugin,
2117                           s,
2118                           GNUNET_TRANSPORT_SS_UPDATE);
2119   schedule_select (plugin);
2120   return udpmlen;
2121 }
2122
2123
2124 /**
2125  * Our external IP address/port mapping has changed.
2126  *
2127  * @param cls closure, the `struct LocalAddrList`
2128  * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean
2129  *     the previous (now invalid) one
2130  * @param addr either the previous or the new public IP address
2131  * @param addrlen actual lenght of the address
2132  */
2133 static void
2134 udp_nat_port_map_callback (void *cls,
2135                            int add_remove,
2136                            const struct sockaddr *addr,
2137                            socklen_t addrlen)
2138 {
2139   struct Plugin *plugin = cls;
2140   struct GNUNET_HELLO_Address *address;
2141   struct IPv4UdpAddress u4;
2142   struct IPv6UdpAddress u6;
2143   void *arg;
2144   size_t args;
2145
2146   LOG (GNUNET_ERROR_TYPE_INFO,
2147        "NAT notification to %s address `%s'\n",
2148        (GNUNET_YES == add_remove) ? "add" : "remove",
2149        GNUNET_a2s (addr, addrlen));
2150
2151   /* convert 'address' to our internal format */
2152   switch (addr->sa_family)
2153   {
2154   case AF_INET:
2155     GNUNET_assert(addrlen == sizeof(struct sockaddr_in));
2156     memset (&u4, 0, sizeof(u4));
2157     u4.options = htonl (plugin->myoptions);
2158     u4.ipv4_addr = ((struct sockaddr_in *) addr)->sin_addr.s_addr;
2159     u4.u4_port = ((struct sockaddr_in *) addr)->sin_port;
2160     if (0 == ((struct sockaddr_in *) addr)->sin_port)
2161       return;
2162     arg = &u4;
2163     args = sizeof(struct IPv4UdpAddress);
2164     break;
2165   case AF_INET6:
2166     GNUNET_assert(addrlen == sizeof(struct sockaddr_in6));
2167     memset (&u6, 0, sizeof(u6));
2168     u6.options = htonl (plugin->myoptions);
2169     if (0 == ((struct sockaddr_in6 *) addr)->sin6_port)
2170       return;
2171     memcpy (&u6.ipv6_addr, &((struct sockaddr_in6 *) addr)->sin6_addr,
2172         sizeof(struct in6_addr));
2173     u6.u6_port = ((struct sockaddr_in6 *) addr)->sin6_port;
2174     arg = &u6;
2175     args = sizeof(struct IPv6UdpAddress);
2176     break;
2177   default:
2178     GNUNET_break(0);
2179     return;
2180   }
2181   /* modify our published address list */
2182   address = GNUNET_HELLO_address_allocate (plugin->env->my_identity,
2183                                            PLUGIN_NAME,
2184                                            arg, args,
2185                                            GNUNET_HELLO_ADDRESS_INFO_NONE);
2186   plugin->env->notify_address (plugin->env->cls, add_remove, address);
2187   GNUNET_HELLO_address_free (address);
2188 }
2189
2190
2191 /**
2192  * Message tokenizer has broken up an incomming message. Pass it on
2193  * to the service.
2194  *
2195  * @param cls the `struct Plugin *`
2196  * @param client the `struct SourceInformation *`
2197  * @param hdr the actual message
2198  * @return #GNUNET_OK (always)
2199  */
2200 static int
2201 process_inbound_tokenized_messages (void *cls,
2202                                     void *client,
2203                                     const struct GNUNET_MessageHeader *hdr)
2204 {
2205   struct Plugin *plugin = cls;
2206   struct SourceInformation *si = client;
2207   struct GNUNET_TIME_Relative delay;
2208
2209   GNUNET_assert (NULL != si->session);
2210   if (GNUNET_YES == si->session->in_destroy)
2211     return GNUNET_OK;
2212   /* setup ATS */
2213   GNUNET_break (ntohl (si->session->ats.value) != GNUNET_ATS_NET_UNSPECIFIED);
2214   reschedule_session_timeout (si->session);
2215   delay = plugin->env->receive (plugin->env->cls,
2216                                 si->session->address,
2217                                 si->session,
2218                                 hdr);
2219   plugin->env->update_address_metrics (plugin->env->cls,
2220                                        si->session->address,
2221                                        si->session,
2222                                        &si->session->ats, 1);
2223   si->session->flow_delay_for_other_peer = delay;
2224   return GNUNET_OK;
2225 }
2226
2227
2228 /**
2229  * We've received a UDP Message.  Process it (pass contents to main service).
2230  *
2231  * @param plugin plugin context
2232  * @param msg the message
2233  * @param udp_addr sender address
2234  * @param udp_addr_len number of bytes in @a udp_addr
2235  * @param network_type network type the address belongs to
2236  */
2237 static void
2238 process_udp_message (struct Plugin *plugin,
2239                      const struct UDPMessage *msg,
2240                      const union UdpAddress *udp_addr,
2241                      size_t udp_addr_len,
2242                      enum GNUNET_ATS_Network_Type network_type)
2243 {
2244   struct SourceInformation si;
2245   struct Session *s;
2246   struct GNUNET_HELLO_Address *address;
2247
2248   if (0 != ntohl (msg->reserved))
2249   {
2250     GNUNET_break_op(0);
2251     return;
2252   }
2253   if (ntohs (msg->header.size)
2254       < sizeof(struct GNUNET_MessageHeader) + sizeof(struct UDPMessage))
2255   {
2256     GNUNET_break_op(0);
2257     return;
2258   }
2259
2260   address = GNUNET_HELLO_address_allocate (&msg->sender,
2261                                            PLUGIN_NAME,
2262                                            udp_addr,
2263                                            udp_addr_len,
2264                                            GNUNET_HELLO_ADDRESS_INFO_NONE);
2265   if (NULL == (s = udp_plugin_lookup_session (plugin, address)))
2266   {
2267     s = udp_plugin_create_session (plugin,
2268                                    address,
2269                                    network_type);
2270     plugin->env->session_start (plugin->env->cls,
2271                                 address, s, NULL, 0);
2272     notify_session_monitor (s->plugin,
2273                             s,
2274                             GNUNET_TRANSPORT_SS_INIT);
2275     notify_session_monitor (s->plugin,
2276                             s,
2277                             GNUNET_TRANSPORT_SS_UP);
2278   }
2279   GNUNET_free (address);
2280
2281   /* iterate over all embedded messages */
2282   si.session = s;
2283   si.sender = msg->sender;
2284   s->rc++;
2285   GNUNET_SERVER_mst_receive (plugin->mst,
2286                              &si,
2287                              (const char *) &msg[1],
2288                              ntohs (msg->header.size) - sizeof(struct UDPMessage),
2289                              GNUNET_YES,
2290                              GNUNET_NO);
2291   s->rc--;
2292   if ((0 == s->rc) && (GNUNET_YES == s->in_destroy))
2293     free_session (s);
2294 }
2295
2296
2297 /**
2298  * Process a defragmented message.
2299  *
2300  * @param cls the `struct DefragContext *`
2301  * @param msg the message
2302  */
2303 static void
2304 fragment_msg_proc (void *cls,
2305                    const struct GNUNET_MessageHeader *msg)
2306 {
2307   struct DefragContext *rc = cls;
2308   const struct UDPMessage *um;
2309
2310   if (ntohs (msg->type) != GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_MESSAGE)
2311   {
2312     GNUNET_break(0);
2313     return;
2314   }
2315   if (ntohs (msg->size) < sizeof(struct UDPMessage))
2316   {
2317     GNUNET_break(0);
2318     return;
2319   }
2320   um = (const struct UDPMessage *) msg;
2321   rc->sender = um->sender;
2322   rc->have_sender = GNUNET_YES;
2323   process_udp_message (rc->plugin,
2324                        um,
2325                        rc->udp_addr,
2326                        rc->udp_addr_len,
2327                        rc->network_type);
2328 }
2329
2330
2331 /**
2332  * Transmit an acknowledgement.
2333  *
2334  * @param cls the `struct DefragContext *`
2335  * @param id message ID (unused)
2336  * @param msg ack to transmit
2337  */
2338 static void
2339 ack_proc (void *cls,
2340           uint32_t id,
2341           const struct GNUNET_MessageHeader *msg)
2342 {
2343   struct DefragContext *rc = cls;
2344   size_t msize = sizeof(struct UDP_ACK_Message) + ntohs (msg->size);
2345   struct UDP_ACK_Message *udp_ack;
2346   uint32_t delay = 0;
2347   struct UDP_MessageWrapper *udpw;
2348   struct Session *s;
2349   struct GNUNET_HELLO_Address *address;
2350
2351   if (GNUNET_NO == rc->have_sender)
2352   {
2353     /* tried to defragment but never succeeded, hence will not ACK */
2354     GNUNET_break_op (0);
2355     return;
2356   }
2357   address = GNUNET_HELLO_address_allocate (&rc->sender,
2358                                            PLUGIN_NAME,
2359                                            rc->udp_addr,
2360                                            rc->udp_addr_len,
2361                                            GNUNET_HELLO_ADDRESS_INFO_NONE);
2362   s = udp_plugin_lookup_session (rc->plugin,
2363                                  address);
2364   GNUNET_HELLO_address_free (address);
2365   if (NULL == s)
2366   {
2367     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
2368                 "Trying to transmit ACK to peer `%s' but no session found!\n",
2369                 udp_address_to_string (rc->plugin,
2370                                        rc->udp_addr,
2371                                        rc->udp_addr_len));
2372     GNUNET_CONTAINER_heap_remove_node (rc->hnode);
2373     GNUNET_DEFRAGMENT_context_destroy (rc->defrag);
2374     GNUNET_free (rc);
2375     return;
2376   }
2377   if (s->flow_delay_for_other_peer.rel_value_us <= UINT32_MAX)
2378     delay = s->flow_delay_for_other_peer.rel_value_us;
2379
2380   LOG (GNUNET_ERROR_TYPE_DEBUG,
2381        "Sending ACK to `%s' including delay of %s\n",
2382        udp_address_to_string (rc->plugin,
2383                               rc->udp_addr,
2384                               rc->udp_addr_len),
2385        GNUNET_STRINGS_relative_time_to_string (s->flow_delay_for_other_peer,
2386                                                GNUNET_YES));
2387   udpw = GNUNET_malloc (sizeof (struct UDP_MessageWrapper) + msize);
2388   udpw->msg_size = msize;
2389   udpw->payload_size = 0;
2390   udpw->session = s;
2391   udpw->timeout = GNUNET_TIME_UNIT_FOREVER_ABS;
2392   udpw->msg_buf = (char *) &udpw[1];
2393   udpw->msg_type = UMT_MSG_ACK;
2394   udp_ack = (struct UDP_ACK_Message *) udpw->msg_buf;
2395   udp_ack->header.size = htons ((uint16_t) msize);
2396   udp_ack->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_ACK);
2397   udp_ack->delay = htonl (delay);
2398   udp_ack->sender = *rc->plugin->env->my_identity;
2399   memcpy (&udp_ack[1], msg, ntohs (msg->size));
2400   enqueue (rc->plugin, udpw);
2401   notify_session_monitor (s->plugin,
2402                           s,
2403                           GNUNET_TRANSPORT_SS_UPDATE);
2404   schedule_select (rc->plugin);
2405 }
2406
2407
2408 /**
2409  * Handle an ACK message.
2410  *
2411  * @param plugin the UDP plugin
2412  * @param msg the (presumed) UDP ACK message
2413  * @param udp_addr sender address
2414  * @param udp_addr_len number of bytes in @a udp_addr
2415  */
2416 static void
2417 read_process_ack (struct Plugin *plugin,
2418                   const struct GNUNET_MessageHeader *msg,
2419                   const union UdpAddress *udp_addr,
2420                   socklen_t udp_addr_len)
2421 {
2422   const struct GNUNET_MessageHeader *ack;
2423   const struct UDP_ACK_Message *udp_ack;
2424   struct GNUNET_HELLO_Address *address;
2425   struct Session *s;
2426   struct GNUNET_TIME_Relative flow_delay;
2427
2428   if (ntohs (msg->size)
2429       < sizeof(struct UDP_ACK_Message) + sizeof(struct GNUNET_MessageHeader))
2430   {
2431     GNUNET_break_op(0);
2432     return;
2433   }
2434   udp_ack = (const struct UDP_ACK_Message *) msg;
2435   address = GNUNET_HELLO_address_allocate (&udp_ack->sender,
2436                                            PLUGIN_NAME,
2437                                            udp_addr,
2438                                            udp_addr_len,
2439                                            GNUNET_HELLO_ADDRESS_INFO_NONE);
2440   s = udp_plugin_lookup_session (plugin,
2441                                  address);
2442   GNUNET_HELLO_address_free (address);
2443   if ( (NULL == s) ||
2444        (NULL == s->frag_ctx) )
2445   {
2446     GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
2447                 "UDP session for ACK not found\n");
2448     return;
2449   }
2450
2451   flow_delay.rel_value_us = (uint64_t) ntohl (udp_ack->delay);
2452   LOG (GNUNET_ERROR_TYPE_DEBUG,
2453        "We received a sending delay of %s\n",
2454        GNUNET_STRINGS_relative_time_to_string (flow_delay,
2455                                                GNUNET_YES));
2456   s->flow_delay_from_other_peer = GNUNET_TIME_relative_to_absolute (flow_delay);
2457
2458   ack = (const struct GNUNET_MessageHeader *) &udp_ack[1];
2459   if (ntohs (ack->size) != ntohs (msg->size) - sizeof(struct UDP_ACK_Message))
2460   {
2461     GNUNET_break_op(0);
2462     return;
2463   }
2464
2465   if (GNUNET_OK !=
2466       GNUNET_FRAGMENT_process_ack (s->frag_ctx->frag,
2467                                    ack))
2468   {
2469     LOG(GNUNET_ERROR_TYPE_DEBUG,
2470         "UDP processes %u-byte acknowledgement from `%s' at `%s'\n",
2471         (unsigned int ) ntohs (msg->size),
2472         GNUNET_i2s (&udp_ack->sender),
2473         udp_address_to_string (plugin,
2474                                udp_addr,
2475                                udp_addr_len));
2476     /* Expect more ACKs to arrive */
2477     return;
2478   }
2479
2480   LOG (GNUNET_ERROR_TYPE_DEBUG,
2481        "Message full ACK'ed\n",
2482        (unsigned int ) ntohs (msg->size),
2483        GNUNET_i2s (&udp_ack->sender),
2484        udp_address_to_string (plugin,
2485                               udp_addr,
2486                               udp_addr_len));
2487
2488
2489   /* Remove fragmented message after successful sending */
2490   fragmented_message_done (s->frag_ctx,
2491                            GNUNET_OK);
2492 }
2493
2494
2495 /**
2496  * We received a fragment, process it.
2497  *
2498  * @param plugin our plugin
2499  * @param msg a message of type #GNUNET_MESSAGE_TYPE_FRAGMENT
2500  * @param udp_addr sender address
2501  * @param udp_addr_len number of bytes in @a udp_addr
2502  * @param network_type network type the address belongs to
2503  */
2504 static void
2505 read_process_fragment (struct Plugin *plugin,
2506                        const struct GNUNET_MessageHeader *msg,
2507                        const union UdpAddress *udp_addr,
2508                        size_t udp_addr_len,
2509                        enum GNUNET_ATS_Network_Type network_type)
2510 {
2511   struct DefragContext *d_ctx;
2512   struct GNUNET_TIME_Absolute now;
2513   struct FindReceiveContext frc;
2514
2515   frc.rc = NULL;
2516   frc.udp_addr = udp_addr;
2517   frc.udp_addr_len = udp_addr_len;
2518
2519   /* Lookup existing receive context for this address */
2520   GNUNET_CONTAINER_heap_iterate (plugin->defrag_ctxs,
2521                                  &find_receive_context,
2522                                  &frc);
2523   now = GNUNET_TIME_absolute_get ();
2524   d_ctx = frc.rc;
2525
2526   if (NULL == d_ctx)
2527   {
2528     /* Create a new defragmentation context */
2529     d_ctx = GNUNET_malloc (sizeof (struct DefragContext) + udp_addr_len);
2530     memcpy (&d_ctx[1],
2531             udp_addr,
2532             udp_addr_len);
2533     d_ctx->udp_addr = (const union UdpAddress *) &d_ctx[1];
2534     d_ctx->udp_addr_len = udp_addr_len;
2535     d_ctx->network_type = network_type;
2536     d_ctx->plugin = plugin;
2537     d_ctx->defrag = GNUNET_DEFRAGMENT_context_create (plugin->env->stats,
2538                                                       UDP_MTU,
2539                                                       UDP_MAX_MESSAGES_IN_DEFRAG,
2540                                                       d_ctx,
2541                                                       &fragment_msg_proc,
2542                                                       &ack_proc);
2543     d_ctx->hnode = GNUNET_CONTAINER_heap_insert (plugin->defrag_ctxs,
2544                                                  d_ctx,
2545         (GNUNET_CONTAINER_HeapCostType) now.abs_value_us);
2546     LOG (GNUNET_ERROR_TYPE_DEBUG,
2547          "Created new defragmentation context for %u-byte fragment from `%s'\n",
2548          (unsigned int ) ntohs (msg->size),
2549          udp_address_to_string (plugin,
2550                                 udp_addr,
2551                                 udp_addr_len));
2552   }
2553   else
2554   {
2555     LOG (GNUNET_ERROR_TYPE_DEBUG,
2556          "Found existing defragmentation context for %u-byte fragment from `%s'\n",
2557          (unsigned int ) ntohs (msg->size),
2558          udp_address_to_string (plugin,
2559                                 udp_addr,
2560                                 udp_addr_len));
2561   }
2562
2563   if (GNUNET_OK ==
2564       GNUNET_DEFRAGMENT_process_fragment (d_ctx->defrag, msg))
2565   {
2566     /* keep this 'rc' from expiring */
2567     GNUNET_CONTAINER_heap_update_cost (plugin->defrag_ctxs,
2568                                        d_ctx->hnode,
2569         (GNUNET_CONTAINER_HeapCostType) now.abs_value_us);
2570   }
2571   if (GNUNET_CONTAINER_heap_get_size (plugin->defrag_ctxs) >
2572       UDP_MAX_SENDER_ADDRESSES_WITH_DEFRAG)
2573   {
2574     /* remove 'rc' that was inactive the longest */
2575     d_ctx = GNUNET_CONTAINER_heap_remove_root (plugin->defrag_ctxs);
2576     GNUNET_assert (NULL != d_ctx);
2577     GNUNET_DEFRAGMENT_context_destroy (d_ctx->defrag);
2578     GNUNET_free (d_ctx);
2579   }
2580 }
2581
2582
2583 /**
2584  * Read and process a message from the given socket.
2585  *
2586  * @param plugin the overall plugin
2587  * @param rsock socket to read from
2588  */
2589 static void
2590 udp_select_read (struct Plugin *plugin,
2591                  struct GNUNET_NETWORK_Handle *rsock)
2592 {
2593   socklen_t fromlen;
2594   struct sockaddr_storage addr;
2595   char buf[65536] GNUNET_ALIGN;
2596   ssize_t size;
2597   const struct GNUNET_MessageHeader *msg;
2598   struct IPv4UdpAddress v4;
2599   struct IPv6UdpAddress v6;
2600   const struct sockaddr *sa;
2601   const struct sockaddr_in *sa4;
2602   const struct sockaddr_in6 *sa6;
2603   const union UdpAddress *int_addr;
2604   size_t int_addr_len;
2605   enum GNUNET_ATS_Network_Type network_type;
2606
2607   fromlen = sizeof(addr);
2608   memset (&addr, 0, sizeof(addr));
2609   size = GNUNET_NETWORK_socket_recvfrom (rsock, buf, sizeof(buf),
2610                                          (struct sockaddr *) &addr, &fromlen);
2611   sa = (const struct sockaddr *) &addr;
2612 #if MINGW
2613   /* On SOCK_DGRAM UDP sockets recvfrom might fail with a
2614    * WSAECONNRESET error to indicate that previous sendto() (yes, sendto!)
2615    * on this socket has failed.
2616    * Quote from MSDN:
2617    *   WSAECONNRESET - The virtual circuit was reset by the remote side
2618    *   executing a hard or abortive close. The application should close
2619    *   the socket; it is no longer usable. On a UDP-datagram socket this
2620    *   error indicates a previous send operation resulted in an ICMP Port
2621    *   Unreachable message.
2622    */
2623   if ( (-1 == size) && (ECONNRESET == errno) )
2624   return;
2625 #endif
2626   if (-1 == size)
2627   {
2628     LOG (GNUNET_ERROR_TYPE_DEBUG,
2629          "UDP failed to receive data: %s\n",
2630          STRERROR (errno));
2631     /* Connection failure or something. Not a protocol violation. */
2632     return;
2633   }
2634   if (size < sizeof(struct GNUNET_MessageHeader))
2635   {
2636     LOG (GNUNET_ERROR_TYPE_WARNING,
2637          "UDP got %u bytes from %s, which is not enough for a GNUnet message header\n",
2638          (unsigned int ) size,
2639          GNUNET_a2s (sa, fromlen));
2640     /* _MAY_ be a connection failure (got partial message) */
2641     /* But it _MAY_ also be that the other side uses non-GNUnet protocol. */
2642     GNUNET_break_op(0);
2643     return;
2644   }
2645   msg = (const struct GNUNET_MessageHeader *) buf;
2646   LOG (GNUNET_ERROR_TYPE_DEBUG,
2647        "UDP received %u-byte message from `%s' type %u\n",
2648        (unsigned int) size,
2649        GNUNET_a2s (sa,
2650                    fromlen),
2651        ntohs (msg->type));
2652   if (size != ntohs (msg->size))
2653   {
2654     LOG (GNUNET_ERROR_TYPE_WARNING,
2655          "UDP malformed message header from %s\n",
2656          (unsigned int) size,
2657          GNUNET_a2s (sa,
2658                      fromlen));
2659     GNUNET_break_op (0);
2660     return;
2661   }
2662   GNUNET_STATISTICS_update (plugin->env->stats,
2663                             "# UDP, total, bytes, received",
2664                             size,
2665                             GNUNET_NO);
2666   network_type = plugin->env->get_address_type (plugin->env->cls,
2667                                                 sa,
2668                                                 fromlen);
2669   switch (sa->sa_family)
2670   {
2671   case AF_INET:
2672     sa4 = (const struct sockaddr_in *) &addr;
2673     v4.options = 0;
2674     v4.ipv4_addr = sa4->sin_addr.s_addr;
2675     v4.u4_port = sa4->sin_port;
2676     int_addr = (union UdpAddress *) &v4;
2677     int_addr_len = sizeof (v4);
2678     break;
2679   case AF_INET6:
2680     sa6 = (const struct sockaddr_in6 *) &addr;
2681     v6.options = 0;
2682     v6.ipv6_addr = sa6->sin6_addr;
2683     v6.u6_port = sa6->sin6_port;
2684     int_addr = (union UdpAddress *) &v6;
2685     int_addr_len = sizeof (v6);
2686     break;
2687   default:
2688     GNUNET_break (0);
2689     return;
2690   }
2691
2692   switch (ntohs (msg->type))
2693   {
2694   case GNUNET_MESSAGE_TYPE_TRANSPORT_BROADCAST_BEACON:
2695     if (GNUNET_YES == plugin->enable_broadcasting_receiving)
2696       udp_broadcast_receive (plugin,
2697                              buf,
2698                              size,
2699                              int_addr,
2700                              int_addr_len,
2701                              network_type);
2702     return;
2703   case GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_MESSAGE:
2704     if (ntohs (msg->size) < sizeof(struct UDPMessage))
2705     {
2706       GNUNET_break_op(0);
2707       return;
2708     }
2709     process_udp_message (plugin,
2710                          (const struct UDPMessage *) msg,
2711                          int_addr,
2712                          int_addr_len,
2713                          network_type);
2714     return;
2715   case GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_ACK:
2716     read_process_ack (plugin,
2717                       msg,
2718                       int_addr,
2719                       int_addr_len);
2720     return;
2721   case GNUNET_MESSAGE_TYPE_FRAGMENT:
2722     read_process_fragment (plugin,
2723                            msg,
2724                            int_addr,
2725                            int_addr_len,
2726                            network_type);
2727     return;
2728   default:
2729     GNUNET_break_op(0);
2730     return;
2731   }
2732 }
2733
2734
2735 /**
2736  * FIXME.
2737  */
2738 static struct UDP_MessageWrapper *
2739 remove_timeout_messages_and_select (struct UDP_MessageWrapper *head,
2740                                     struct GNUNET_NETWORK_Handle *sock)
2741 {
2742   struct UDP_MessageWrapper *udpw = NULL;
2743   struct GNUNET_TIME_Relative remaining;
2744   struct Session *session;
2745   struct Plugin *plugin;
2746   int removed;
2747
2748   removed = GNUNET_NO;
2749   udpw = head;
2750   while (NULL != udpw)
2751   {
2752     session = udpw->session;
2753     plugin = session->plugin;
2754     /* Find messages with timeout */
2755     remaining = GNUNET_TIME_absolute_get_remaining (udpw->timeout);
2756     if (GNUNET_TIME_UNIT_ZERO.rel_value_us == remaining.rel_value_us)
2757     {
2758       /* Message timed out */
2759       switch (udpw->msg_type)
2760       {
2761       case UMT_MSG_UNFRAGMENTED:
2762         GNUNET_STATISTICS_update (plugin->env->stats,
2763                                   "# UDP, total, bytes, sent, timeout",
2764                                   udpw->msg_size,
2765                                   GNUNET_NO);
2766         GNUNET_STATISTICS_update (plugin->env->stats,
2767                                   "# UDP, total, messages, sent, timeout",
2768                                   1,
2769                                   GNUNET_NO);
2770         GNUNET_STATISTICS_update (plugin->env->stats,
2771                                   "# UDP, unfragmented msgs, messages, sent, timeout",
2772                                   1,
2773                                   GNUNET_NO);
2774         GNUNET_STATISTICS_update (plugin->env->stats,
2775                                   "# UDP, unfragmented msgs, bytes, sent, timeout",
2776                                   udpw->payload_size,
2777                                   GNUNET_NO);
2778         /* Not fragmented message */
2779         LOG (GNUNET_ERROR_TYPE_DEBUG,
2780              "Message for peer `%s' with size %u timed out\n",
2781              GNUNET_i2s (&udpw->session->target),
2782              udpw->payload_size);
2783         call_continuation (udpw, GNUNET_SYSERR);
2784         /* Remove message */
2785         removed = GNUNET_YES;
2786         dequeue (plugin, udpw);
2787         GNUNET_free(udpw);
2788         break;
2789       case UMT_MSG_FRAGMENTED:
2790         /* Fragmented message */
2791         GNUNET_STATISTICS_update (plugin->env->stats,
2792                                   "# UDP, total, bytes, sent, timeout",
2793                                   udpw->frag_ctx->on_wire_size,
2794                                   GNUNET_NO);
2795         GNUNET_STATISTICS_update (plugin->env->stats,
2796                                   "# UDP, total, messages, sent, timeout",
2797                                   1,
2798                                   GNUNET_NO);
2799         call_continuation (udpw, GNUNET_SYSERR);
2800         LOG (GNUNET_ERROR_TYPE_DEBUG,
2801              "Fragment for message for peer `%s' with size %u timed out\n",
2802              GNUNET_i2s (&udpw->session->target),
2803             udpw->frag_ctx->payload_size);
2804
2805         GNUNET_STATISTICS_update (plugin->env->stats,
2806                                   "# UDP, fragmented msgs, messages, sent, timeout",
2807                                   1,
2808                                   GNUNET_NO);
2809         GNUNET_STATISTICS_update (plugin->env->stats,
2810                                   "# UDP, fragmented msgs, bytes, sent, timeout",
2811                                   udpw->frag_ctx->payload_size,
2812                                   GNUNET_NO);
2813         /* Remove fragmented message due to timeout */
2814         fragmented_message_done (udpw->frag_ctx, GNUNET_SYSERR);
2815         break;
2816       case UMT_MSG_ACK:
2817         GNUNET_STATISTICS_update (plugin->env->stats,
2818                                   "# UDP, total, bytes, sent, timeout",
2819                                   udpw->msg_size,
2820                                   GNUNET_NO);
2821         GNUNET_STATISTICS_update (plugin->env->stats,
2822                                   "# UDP, total, messages, sent, timeout",
2823                                   1,
2824                                   GNUNET_NO);
2825         LOG (GNUNET_ERROR_TYPE_DEBUG,
2826              "ACK Message for peer `%s' with size %u timed out\n",
2827              GNUNET_i2s (&udpw->session->target),
2828              udpw->payload_size);
2829         call_continuation (udpw, GNUNET_SYSERR);
2830         removed = GNUNET_YES;
2831         dequeue (plugin, udpw);
2832         GNUNET_free(udpw);
2833         break;
2834       default:
2835         break;
2836       }
2837       if (sock == plugin->sockv4)
2838         udpw = plugin->ipv4_queue_head;
2839       else if (sock == plugin->sockv6)
2840         udpw = plugin->ipv6_queue_head;
2841       else
2842       {
2843         GNUNET_break(0); /* should never happen */
2844         udpw = NULL;
2845       }
2846       GNUNET_STATISTICS_update (plugin->env->stats,
2847                                 "# messages discarded due to timeout",
2848                                 1,
2849                                 GNUNET_NO);
2850     }
2851     else
2852     {
2853       /* Message did not time out, check flow delay */
2854       remaining = GNUNET_TIME_absolute_get_remaining (udpw->session->flow_delay_from_other_peer);
2855       if (GNUNET_TIME_UNIT_ZERO.rel_value_us == remaining.rel_value_us)
2856       {
2857         /* this message is not delayed */
2858         LOG (GNUNET_ERROR_TYPE_DEBUG,
2859              "Message for peer `%s' (%u bytes) is not delayed \n",
2860              GNUNET_i2s (&udpw->session->target),
2861              udpw->payload_size);
2862         break; /* Found message to send, break */
2863       }
2864       else
2865       {
2866         /* Message is delayed, try next */
2867         LOG (GNUNET_ERROR_TYPE_DEBUG,
2868              "Message for peer `%s' (%u bytes) is delayed for %s\n",
2869              GNUNET_i2s (&udpw->session->target), udpw->payload_size,
2870              GNUNET_STRINGS_relative_time_to_string (remaining, GNUNET_YES));
2871         udpw = udpw->next;
2872       }
2873     }
2874   }
2875   if (GNUNET_YES == removed)
2876     notify_session_monitor (session->plugin,
2877                             session,
2878                             GNUNET_TRANSPORT_SS_UPDATE);
2879   return udpw;
2880 }
2881
2882
2883 /**
2884  * FIXME.
2885  */
2886 static void
2887 analyze_send_error (struct Plugin *plugin,
2888                     const struct sockaddr *sa,
2889                     socklen_t slen, int error)
2890 {
2891   enum GNUNET_ATS_Network_Type type;
2892
2893   type = plugin->env->get_address_type (plugin->env->cls, sa, slen);
2894   if (((GNUNET_ATS_NET_LAN == type)
2895        || (GNUNET_ATS_NET_WAN == type))
2896       && ((ENETUNREACH == errno)|| (ENETDOWN == errno)))
2897   {
2898     if (slen == sizeof (struct sockaddr_in))
2899     {
2900       /* IPv4: "Network unreachable" or "Network down"
2901        *
2902        * This indicates we do not have connectivity
2903        */
2904       LOG (GNUNET_ERROR_TYPE_WARNING | GNUNET_ERROR_TYPE_BULK,
2905            _("UDP could not transmit message to `%s': "
2906              "Network seems down, please check your network configuration\n"),
2907            GNUNET_a2s (sa, slen));
2908     }
2909     if (slen == sizeof (struct sockaddr_in6))
2910     {
2911       /* IPv6: "Network unreachable" or "Network down"
2912        *
2913        * This indicates that this system is IPv6 enabled, but does not
2914        * have a valid global IPv6 address assigned or we do not have
2915        * connectivity
2916        */
2917       LOG (GNUNET_ERROR_TYPE_WARNING | GNUNET_ERROR_TYPE_BULK,
2918            _("UDP could not transmit IPv6 message! "
2919              "Please check your network configuration and disable IPv6 if your "
2920              "connection does not have a global IPv6 address\n"));
2921     }
2922   }
2923   else
2924   {
2925     LOG (GNUNET_ERROR_TYPE_WARNING,
2926          "UDP could not transmit message to `%s': `%s'\n",
2927          GNUNET_a2s (sa, slen), STRERROR (error));
2928   }
2929 }
2930
2931
2932 /**
2933  * FIXME.
2934  */
2935 static size_t
2936 udp_select_send (struct Plugin *plugin,
2937                  struct GNUNET_NETWORK_Handle *sock)
2938 {
2939   ssize_t sent;
2940   socklen_t slen;
2941   struct sockaddr *a;
2942   const struct IPv4UdpAddress *u4;
2943   struct sockaddr_in a4;
2944   const struct IPv6UdpAddress *u6;
2945   struct sockaddr_in6 a6;
2946   struct UDP_MessageWrapper *udpw;
2947
2948   /* Find message to send */
2949   udpw = remove_timeout_messages_and_select ((sock == plugin->sockv4)
2950                                              ? plugin->ipv4_queue_head
2951                                              : plugin->ipv6_queue_head,
2952                                              sock);
2953   if (NULL == udpw)
2954     return 0; /* No message to send */
2955
2956   if (sizeof (struct IPv4UdpAddress) == udpw->session->address->address_length)
2957   {
2958     u4 = udpw->session->address->address;
2959     memset (&a4, 0, sizeof(a4));
2960     a4.sin_family = AF_INET;
2961 #if HAVE_SOCKADDR_IN_SIN_LEN
2962     a4.sin_len = sizeof (a4);
2963 #endif
2964     a4.sin_port = u4->u4_port;
2965     memcpy (&a4.sin_addr, &u4->ipv4_addr, sizeof(struct in_addr));
2966     a = (struct sockaddr *) &a4;
2967     slen = sizeof (a4);
2968   }
2969   else if (sizeof (struct IPv6UdpAddress) == udpw->session->address->address_length)
2970   {
2971     u6 = udpw->session->address->address;
2972     memset (&a6, 0, sizeof(a6));
2973     a6.sin6_family = AF_INET6;
2974 #if HAVE_SOCKADDR_IN_SIN_LEN
2975     a6.sin6_len = sizeof (a6);
2976 #endif
2977     a6.sin6_port = u6->u6_port;
2978     memcpy (&a6.sin6_addr, &u6->ipv6_addr, sizeof(struct in6_addr));
2979     a = (struct sockaddr *) &a6;
2980     slen = sizeof (a6);
2981   }
2982   else
2983   {
2984     call_continuation (udpw, GNUNET_OK);
2985     dequeue (plugin, udpw);
2986     notify_session_monitor (plugin,
2987                             udpw->session,
2988                             GNUNET_TRANSPORT_SS_UPDATE);
2989     GNUNET_free (udpw);
2990     return GNUNET_SYSERR;
2991   }
2992
2993   sent = GNUNET_NETWORK_socket_sendto (sock,
2994                                        udpw->msg_buf,
2995                                        udpw->msg_size,
2996                                        a,
2997                                        slen);
2998   if (GNUNET_SYSERR == sent)
2999   {
3000     /* Failure */
3001     analyze_send_error (plugin, a, slen, errno);
3002     call_continuation (udpw, GNUNET_SYSERR);
3003     GNUNET_STATISTICS_update (plugin->env->stats,
3004         "# UDP, total, bytes, sent, failure", sent, GNUNET_NO);
3005     GNUNET_STATISTICS_update (plugin->env->stats,
3006         "# UDP, total, messages, sent, failure", 1, GNUNET_NO);
3007   }
3008   else
3009   {
3010     /* Success */
3011     LOG (GNUNET_ERROR_TYPE_DEBUG,
3012          "UDP transmitted %u-byte message to  `%s' `%s' (%d: %s)\n",
3013          (unsigned int) (udpw->msg_size),
3014          GNUNET_i2s (&udpw->session->target),
3015          GNUNET_a2s (a, slen),
3016          (int ) sent,
3017          (sent < 0) ? STRERROR (errno) : "ok");
3018     GNUNET_STATISTICS_update (plugin->env->stats,
3019                               "# UDP, total, bytes, sent, success",
3020                               sent,
3021                               GNUNET_NO);
3022     GNUNET_STATISTICS_update (plugin->env->stats,
3023                               "# UDP, total, messages, sent, success",
3024                               1,
3025                               GNUNET_NO);
3026     if (NULL != udpw->frag_ctx)
3027       udpw->frag_ctx->on_wire_size += udpw->msg_size;
3028     call_continuation (udpw, GNUNET_OK);
3029   }
3030   dequeue (plugin, udpw);
3031   notify_session_monitor (plugin,
3032                           udpw->session,
3033                           GNUNET_TRANSPORT_SS_UPDATE);
3034   GNUNET_free(udpw);
3035   return sent;
3036 }
3037
3038
3039 /**
3040  * We have been notified that our readset has something to read.  We don't
3041  * know which socket needs to be read, so we have to check each one
3042  * Then reschedule this function to be called again once more is available.
3043  *
3044  * @param cls the plugin handle
3045  * @param tc the scheduling context (for rescheduling this function again)
3046  */
3047 static void
3048 udp_plugin_select (void *cls,
3049                    const struct GNUNET_SCHEDULER_TaskContext *tc)
3050 {
3051   struct Plugin *plugin = cls;
3052
3053   plugin->select_task = NULL;
3054   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
3055     return;
3056   if ((0 != (tc->reason & GNUNET_SCHEDULER_REASON_READ_READY))
3057       && (NULL != plugin->sockv4)
3058       && (GNUNET_NETWORK_fdset_isset (tc->read_ready, plugin->sockv4)))
3059     udp_select_read (plugin, plugin->sockv4);
3060   if ((0 != (tc->reason & GNUNET_SCHEDULER_REASON_WRITE_READY))
3061       && (NULL != plugin->sockv4) && (NULL != plugin->ipv4_queue_head)
3062       && (GNUNET_NETWORK_fdset_isset (tc->write_ready, plugin->sockv4)))
3063     udp_select_send (plugin, plugin->sockv4);
3064   schedule_select (plugin);
3065 }
3066
3067
3068 /**
3069  * We have been notified that our readset has something to read.  We don't
3070  * know which socket needs to be read, so we have to check each one
3071  * Then reschedule this function to be called again once more is available.
3072  *
3073  * @param cls the plugin handle
3074  * @param tc the scheduling context (for rescheduling this function again)
3075  */
3076 static void
3077 udp_plugin_select_v6 (void *cls,
3078                       const struct GNUNET_SCHEDULER_TaskContext *tc)
3079 {
3080   struct Plugin *plugin = cls;
3081
3082   plugin->select_task_v6 = NULL;
3083   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
3084     return;
3085   if (((tc->reason & GNUNET_SCHEDULER_REASON_READ_READY) != 0)
3086       && (NULL != plugin->sockv6)
3087       && (GNUNET_NETWORK_fdset_isset (tc->read_ready, plugin->sockv6)))
3088     udp_select_read (plugin, plugin->sockv6);
3089   if ((0 != (tc->reason & GNUNET_SCHEDULER_REASON_WRITE_READY))
3090       && (NULL != plugin->sockv6) && (plugin->ipv6_queue_head != NULL )&&
3091       (GNUNET_NETWORK_fdset_isset (tc->write_ready, plugin->sockv6)) )udp_select_send (plugin, plugin->sockv6);
3092   schedule_select (plugin);
3093 }
3094
3095
3096 /**
3097  * Setup the UDP sockets (for IPv4 and IPv6) for the plugin.
3098  *
3099  * @param plugin the plugin to initialize
3100  * @param bind_v6 IPv6 address to bind to (can be NULL, for 'any')
3101  * @param bind_v4 IPv4 address to bind to (can be NULL, for 'any')
3102  * @return number of sockets that were successfully bound
3103  */
3104 static int
3105 setup_sockets (struct Plugin *plugin,
3106                const struct sockaddr_in6 *bind_v6,
3107                const struct sockaddr_in *bind_v4)
3108 {
3109   int tries;
3110   int sockets_created = 0;
3111   struct sockaddr_in6 server_addrv6;
3112   struct sockaddr_in server_addrv4;
3113   struct sockaddr *server_addr;
3114   struct sockaddr *addrs[2];
3115   socklen_t addrlens[2];
3116   socklen_t addrlen;
3117   int eno;
3118
3119   /* Create IPv6 socket */
3120   eno = EINVAL;
3121   if (GNUNET_YES == plugin->enable_ipv6)
3122   {
3123     plugin->sockv6 = GNUNET_NETWORK_socket_create (PF_INET6, SOCK_DGRAM, 0);
3124     if (NULL == plugin->sockv6)
3125     {
3126       LOG(GNUNET_ERROR_TYPE_WARNING,
3127           "Disabling IPv6 since it is not supported on this system!\n");
3128       plugin->enable_ipv6 = GNUNET_NO;
3129     }
3130     else
3131     {
3132       memset (&server_addrv6, '\0', sizeof(struct sockaddr_in6));
3133 #if HAVE_SOCKADDR_IN_SIN_LEN
3134       server_addrv6.sin6_len = sizeof (struct sockaddr_in6);
3135 #endif
3136       server_addrv6.sin6_family = AF_INET6;
3137       if (NULL != bind_v6)
3138         server_addrv6.sin6_addr = bind_v6->sin6_addr;
3139       else
3140         server_addrv6.sin6_addr = in6addr_any;
3141
3142       if (0 == plugin->port) /* autodetect */
3143         server_addrv6.sin6_port = htons (
3144             GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_STRONG, 33537)
3145                 + 32000);
3146       else
3147         server_addrv6.sin6_port = htons (plugin->port);
3148       addrlen = sizeof(struct sockaddr_in6);
3149       server_addr = (struct sockaddr *) &server_addrv6;
3150
3151       tries = 0;
3152       while (tries < 10)
3153       {
3154         LOG(GNUNET_ERROR_TYPE_DEBUG,
3155             "Binding to IPv6 `%s'\n",
3156             GNUNET_a2s (server_addr, addrlen));
3157         /* binding */
3158         if (GNUNET_OK
3159             == GNUNET_NETWORK_socket_bind (plugin->sockv6, server_addr,
3160                 addrlen))
3161           break;
3162         eno = errno;
3163         if (0 != plugin->port)
3164         {
3165           tries = 10; /* fail */
3166           break; /* bind failed on specific port */
3167         }
3168         /* autodetect */
3169         server_addrv6.sin6_port = htons (
3170             GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_STRONG, 33537)
3171                 + 32000);
3172         tries++;
3173       }
3174       if (tries >= 10)
3175       {
3176         GNUNET_NETWORK_socket_close (plugin->sockv6);
3177         plugin->enable_ipv6 = GNUNET_NO;
3178         plugin->sockv6 = NULL;
3179       }
3180
3181       if (plugin->sockv6 != NULL )
3182       {
3183         LOG (GNUNET_ERROR_TYPE_DEBUG,
3184              "IPv6 socket created on port %s\n",
3185              GNUNET_a2s (server_addr, addrlen));
3186         addrs[sockets_created] = (struct sockaddr *) &server_addrv6;
3187         addrlens[sockets_created] = sizeof(struct sockaddr_in6);
3188         sockets_created++;
3189       }
3190       else
3191       {
3192         LOG (GNUNET_ERROR_TYPE_ERROR,
3193              "Failed to bind UDP socket to %s: %s\n",
3194              GNUNET_a2s (server_addr, addrlen),
3195              STRERROR (eno));
3196       }
3197     }
3198   }
3199
3200   /* Create IPv4 socket */
3201   eno = EINVAL;
3202   plugin->sockv4 = GNUNET_NETWORK_socket_create (PF_INET, SOCK_DGRAM, 0);
3203   if (NULL == plugin->sockv4)
3204   {
3205     GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING,
3206                          "socket");
3207     LOG(GNUNET_ERROR_TYPE_WARNING,
3208         "Disabling IPv4 since it is not supported on this system!\n");
3209     plugin->enable_ipv4 = GNUNET_NO;
3210   }
3211   else
3212   {
3213     memset (&server_addrv4, '\0', sizeof(struct sockaddr_in));
3214 #if HAVE_SOCKADDR_IN_SIN_LEN
3215     server_addrv4.sin_len = sizeof (struct sockaddr_in);
3216 #endif
3217     server_addrv4.sin_family = AF_INET;
3218     if (NULL != bind_v4)
3219       server_addrv4.sin_addr = bind_v4->sin_addr;
3220     else
3221       server_addrv4.sin_addr.s_addr = INADDR_ANY;
3222
3223     if (0 == plugin->port)
3224       /* autodetect */
3225       server_addrv4.sin_port = htons (GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_STRONG,
3226                                                                 33537)
3227                                       + 32000);
3228     else
3229       server_addrv4.sin_port = htons (plugin->port);
3230
3231     addrlen = sizeof(struct sockaddr_in);
3232     server_addr = (struct sockaddr *) &server_addrv4;
3233
3234     tries = 0;
3235     while (tries < 10)
3236     {
3237       LOG (GNUNET_ERROR_TYPE_DEBUG,
3238            "Binding to IPv4 `%s'\n",
3239            GNUNET_a2s (server_addr, addrlen));
3240
3241       /* binding */
3242       if (GNUNET_OK ==
3243           GNUNET_NETWORK_socket_bind (plugin->sockv4,
3244                                       server_addr,
3245                                       addrlen))
3246         break;
3247       eno = errno;
3248       if (0 != plugin->port)
3249       {
3250         tries = 10; /* fail */
3251         break; /* bind failed on specific port */
3252       }
3253
3254       /* autodetect */
3255       server_addrv4.sin_port = htons (
3256           GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_STRONG, 33537)
3257               + 32000);
3258       tries++;
3259     }
3260
3261     if (tries >= 10)
3262     {
3263       GNUNET_NETWORK_socket_close (plugin->sockv4);
3264       plugin->enable_ipv4 = GNUNET_NO;
3265       plugin->sockv4 = NULL;
3266     }
3267
3268     if (NULL != plugin->sockv4)
3269     {
3270       LOG (GNUNET_ERROR_TYPE_DEBUG,
3271            "IPv4 socket created on port %s\n",
3272            GNUNET_a2s (server_addr, addrlen));
3273       addrs[sockets_created] = (struct sockaddr *) &server_addrv4;
3274       addrlens[sockets_created] = sizeof(struct sockaddr_in);
3275       sockets_created++;
3276     }
3277     else
3278     {
3279       LOG (GNUNET_ERROR_TYPE_ERROR,
3280            _("Failed to bind UDP socket to %s: %s\n"),
3281            GNUNET_a2s (server_addr, addrlen),
3282            STRERROR (eno));
3283     }
3284   }
3285
3286   if (0 == sockets_created)
3287   {
3288     LOG (GNUNET_ERROR_TYPE_WARNING,
3289          _("Failed to open UDP sockets\n"));
3290     return 0; /* No sockets created, return */
3291   }
3292
3293   /* Create file descriptors */
3294   if (plugin->enable_ipv4 == GNUNET_YES)
3295   {
3296     plugin->rs_v4 = GNUNET_NETWORK_fdset_create ();
3297     plugin->ws_v4 = GNUNET_NETWORK_fdset_create ();
3298     GNUNET_NETWORK_fdset_zero (plugin->rs_v4);
3299     GNUNET_NETWORK_fdset_zero (plugin->ws_v4);
3300     if (NULL != plugin->sockv4)
3301     {
3302       GNUNET_NETWORK_fdset_set (plugin->rs_v4, plugin->sockv4);
3303       GNUNET_NETWORK_fdset_set (plugin->ws_v4, plugin->sockv4);
3304     }
3305   }
3306
3307   if (plugin->enable_ipv6 == GNUNET_YES)
3308   {
3309     plugin->rs_v6 = GNUNET_NETWORK_fdset_create ();
3310     plugin->ws_v6 = GNUNET_NETWORK_fdset_create ();
3311     GNUNET_NETWORK_fdset_zero (plugin->rs_v6);
3312     GNUNET_NETWORK_fdset_zero (plugin->ws_v6);
3313     if (NULL != plugin->sockv6)
3314     {
3315       GNUNET_NETWORK_fdset_set (plugin->rs_v6, plugin->sockv6);
3316       GNUNET_NETWORK_fdset_set (plugin->ws_v6, plugin->sockv6);
3317     }
3318   }
3319
3320   schedule_select (plugin);
3321   plugin->nat = GNUNET_NAT_register (plugin->env->cfg,
3322                                      GNUNET_NO,
3323                                      plugin->port,
3324                                      sockets_created,
3325                                      (const struct sockaddr **) addrs,
3326                                      addrlens,
3327                                      &udp_nat_port_map_callback,
3328                                      NULL,
3329                                      plugin);
3330
3331   return sockets_created;
3332 }
3333
3334
3335 /**
3336  * Return information about the given session to the
3337  * monitor callback.
3338  *
3339  * @param cls the `struct Plugin` with the monitor callback (`sic`)
3340  * @param peer peer we send information about
3341  * @param value our `struct Session` to send information about
3342  * @return #GNUNET_OK (continue to iterate)
3343  */
3344 static int
3345 send_session_info_iter (void *cls,
3346                         const struct GNUNET_PeerIdentity *peer,
3347                         void *value)
3348 {
3349   struct Plugin *plugin = cls;
3350   struct Session *session = value;
3351
3352   notify_session_monitor (plugin,
3353                           session,
3354                           GNUNET_TRANSPORT_SS_INIT);
3355   notify_session_monitor (plugin,
3356                           session,
3357                           GNUNET_TRANSPORT_SS_UP);
3358   return GNUNET_OK;
3359 }
3360
3361
3362 /**
3363  * Begin monitoring sessions of a plugin.  There can only
3364  * be one active monitor per plugin (i.e. if there are
3365  * multiple monitors, the transport service needs to
3366  * multiplex the generated events over all of them).
3367  *
3368  * @param cls closure of the plugin
3369  * @param sic callback to invoke, NULL to disable monitor;
3370  *            plugin will being by iterating over all active
3371  *            sessions immediately and then enter monitor mode
3372  * @param sic_cls closure for @a sic
3373  */
3374 static void
3375 udp_plugin_setup_monitor (void *cls,
3376                           GNUNET_TRANSPORT_SessionInfoCallback sic,
3377                           void *sic_cls)
3378 {
3379   struct Plugin *plugin = cls;
3380
3381   plugin->sic = sic;
3382   plugin->sic_cls = sic_cls;
3383   if (NULL != sic)
3384   {
3385     GNUNET_CONTAINER_multipeermap_iterate (plugin->sessions,
3386                                            &send_session_info_iter,
3387                                            plugin);
3388     /* signal end of first iteration */
3389     sic (sic_cls, NULL, NULL);
3390   }
3391 }
3392
3393
3394 /**
3395  * The exported method. Makes the core api available via a global and
3396  * returns the udp transport API.
3397  *
3398  * @param cls our `struct GNUNET_TRANSPORT_PluginEnvironment`
3399  * @return our `struct GNUNET_TRANSPORT_PluginFunctions`
3400  */
3401 void *
3402 libgnunet_plugin_transport_udp_init (void *cls)
3403 {
3404   struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
3405   struct GNUNET_TRANSPORT_PluginFunctions *api;
3406   struct Plugin *p;
3407   unsigned long long port;
3408   unsigned long long aport;
3409   unsigned long long udp_max_bps;
3410   unsigned long long enable_v6;
3411   unsigned long long enable_broadcasting;
3412   unsigned long long enable_broadcasting_recv;
3413   char *bind4_address;
3414   char *bind6_address;
3415   char *fancy_interval;
3416   struct GNUNET_TIME_Relative interval;
3417   struct sockaddr_in server_addrv4;
3418   struct sockaddr_in6 server_addrv6;
3419   int res;
3420   int have_bind4;
3421   int have_bind6;
3422
3423   if (NULL == env->receive)
3424   {
3425     /* run in 'stub' mode (i.e. as part of gnunet-peerinfo), don't fully
3426      initialze the plugin or the API */
3427     api = GNUNET_new (struct GNUNET_TRANSPORT_PluginFunctions);
3428     api->cls = NULL;
3429     api->address_pretty_printer = &udp_plugin_address_pretty_printer;
3430     api->address_to_string = &udp_address_to_string;
3431     api->string_to_address = &udp_string_to_address;
3432     return api;
3433   }
3434
3435   /* Get port number: port == 0 : autodetect a port,
3436    * > 0 : use this port, not given : 2086 default */
3437   if (GNUNET_OK !=
3438       GNUNET_CONFIGURATION_get_value_number (env->cfg,
3439                                              "transport-udp",
3440                                              "PORT", &port))
3441     port = 2086;
3442   if (GNUNET_OK !=
3443       GNUNET_CONFIGURATION_get_value_number (env->cfg,
3444                                              "transport-udp",
3445                                              "ADVERTISED_PORT", &aport))
3446     aport = port;
3447   if (port > 65535)
3448   {
3449     LOG (GNUNET_ERROR_TYPE_WARNING,
3450          _("Given `%s' option is out of range: %llu > %u\n"),
3451          "PORT", port,
3452          65535);
3453     return NULL;
3454   }
3455
3456   /* Protocols */
3457   if (GNUNET_YES ==
3458       GNUNET_CONFIGURATION_get_value_yesno (env->cfg, "nat", "DISABLEV6"))
3459     enable_v6 = GNUNET_NO;
3460   else
3461     enable_v6 = GNUNET_YES;
3462
3463   /* Addresses */
3464   have_bind4 = GNUNET_NO;
3465   memset (&server_addrv4, 0, sizeof(server_addrv4));
3466   if (GNUNET_YES ==
3467       GNUNET_CONFIGURATION_get_value_string (env->cfg, "transport-udp",
3468                                              "BINDTO", &bind4_address))
3469   {
3470     LOG (GNUNET_ERROR_TYPE_DEBUG,
3471          "Binding udp plugin to specific address: `%s'\n",
3472          bind4_address);
3473     if (1 != inet_pton (AF_INET,
3474                         bind4_address,
3475                         &server_addrv4.sin_addr))
3476     {
3477       GNUNET_free (bind4_address);
3478       return NULL;
3479     }
3480     have_bind4 = GNUNET_YES;
3481   }
3482   GNUNET_free_non_null(bind4_address);
3483   have_bind6 = GNUNET_NO;
3484   memset (&server_addrv6, 0, sizeof(server_addrv6));
3485   if (GNUNET_YES ==
3486       GNUNET_CONFIGURATION_get_value_string (env->cfg, "transport-udp",
3487                                              "BINDTO6", &bind6_address))
3488   {
3489     LOG (GNUNET_ERROR_TYPE_DEBUG,
3490          "Binding udp plugin to specific address: `%s'\n",
3491          bind6_address);
3492     if (1 != inet_pton (AF_INET6,
3493                         bind6_address,
3494                         &server_addrv6.sin6_addr))
3495     {
3496       LOG (GNUNET_ERROR_TYPE_ERROR,
3497            _("Invalid IPv6 address: `%s'\n"),
3498            bind6_address);
3499       GNUNET_free (bind6_address);
3500       return NULL;
3501     }
3502     have_bind6 = GNUNET_YES;
3503   }
3504   GNUNET_free_non_null (bind6_address);
3505
3506   /* Enable neighbour discovery */
3507   enable_broadcasting = GNUNET_CONFIGURATION_get_value_yesno (env->cfg,
3508       "transport-udp", "BROADCAST");
3509   if (enable_broadcasting == GNUNET_SYSERR)
3510     enable_broadcasting = GNUNET_NO;
3511
3512   enable_broadcasting_recv = GNUNET_CONFIGURATION_get_value_yesno (env->cfg,
3513       "transport-udp", "BROADCAST_RECEIVE");
3514   if (enable_broadcasting_recv == GNUNET_SYSERR)
3515     enable_broadcasting_recv = GNUNET_YES;
3516
3517   if (GNUNET_SYSERR ==
3518       GNUNET_CONFIGURATION_get_value_string (env->cfg, "transport-udp",
3519                                              "BROADCAST_INTERVAL",
3520                                              &fancy_interval))
3521   {
3522     interval = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 10);
3523   }
3524   else
3525   {
3526     if (GNUNET_SYSERR ==
3527         GNUNET_STRINGS_fancy_time_to_relative (fancy_interval, &interval))
3528     {
3529       interval = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 30);
3530     }
3531     GNUNET_free(fancy_interval);
3532   }
3533
3534   /* Maximum datarate */
3535   if (GNUNET_OK !=
3536       GNUNET_CONFIGURATION_get_value_number (env->cfg, "transport-udp",
3537                                              "MAX_BPS", &udp_max_bps))
3538   {
3539     udp_max_bps = 1024 * 1024 * 50; /* 50 MB/s == infinity for practical purposes */
3540   }
3541
3542   p = GNUNET_new (struct Plugin);
3543   p->port = port;
3544   p->aport = aport;
3545   p->broadcast_interval = interval;
3546   p->enable_ipv6 = enable_v6;
3547   p->enable_ipv4 = GNUNET_YES; /* default */
3548   p->enable_broadcasting = enable_broadcasting;
3549   p->enable_broadcasting_receiving = enable_broadcasting_recv;
3550   p->env = env;
3551   p->sessions = GNUNET_CONTAINER_multipeermap_create (10, GNUNET_NO);
3552   p->defrag_ctxs = GNUNET_CONTAINER_heap_create (
3553       GNUNET_CONTAINER_HEAP_ORDER_MIN);
3554   p->mst = GNUNET_SERVER_mst_create (&process_inbound_tokenized_messages, p);
3555   GNUNET_BANDWIDTH_tracker_init (&p->tracker, NULL, NULL,
3556       GNUNET_BANDWIDTH_value_init ((uint32_t) udp_max_bps), 30);
3557   LOG(GNUNET_ERROR_TYPE_DEBUG,
3558       "Setting up sockets\n");
3559   res = setup_sockets (p,
3560                        (GNUNET_YES == have_bind6) ? &server_addrv6 : NULL,
3561                        (GNUNET_YES == have_bind4) ? &server_addrv4 : NULL);
3562   if ((res == 0) || ((p->sockv4 == NULL )&& (p->sockv6 == NULL)))
3563   {
3564     LOG (GNUNET_ERROR_TYPE_ERROR,
3565         _("Failed to create network sockets, plugin failed\n"));
3566     GNUNET_CONTAINER_multipeermap_destroy (p->sessions);
3567     GNUNET_CONTAINER_heap_destroy (p->defrag_ctxs);
3568     GNUNET_SERVER_mst_destroy (p->mst);
3569     GNUNET_free (p);
3570     return NULL;
3571   }
3572
3573   /* Setup broadcasting and receiving beacons */
3574   setup_broadcast (p, &server_addrv6, &server_addrv4);
3575
3576   api = GNUNET_new (struct GNUNET_TRANSPORT_PluginFunctions);
3577   api->cls = p;
3578   api->send = NULL;
3579   api->disconnect_session = &udp_disconnect_session;
3580   api->query_keepalive_factor = &udp_query_keepalive_factor;
3581   api->disconnect_peer = &udp_disconnect;
3582   api->address_pretty_printer = &udp_plugin_address_pretty_printer;
3583   api->address_to_string = &udp_address_to_string;
3584   api->string_to_address = &udp_string_to_address;
3585   api->check_address = &udp_plugin_check_address;
3586   api->get_session = &udp_plugin_get_session;
3587   api->send = &udp_plugin_send;
3588   api->get_network = &udp_get_network;
3589   api->update_session_timeout = &udp_plugin_update_session_timeout;
3590   api->setup_monitor = &udp_plugin_setup_monitor;
3591   return api;
3592 }
3593
3594
3595 /**
3596  * Function called on each entry in the defragmentation heap to
3597  * clean it up.
3598  *
3599  * @param cls NULL
3600  * @param node node in the heap (to be removed)
3601  * @param element a `struct DefragContext` to be cleaned up
3602  * @param cost unused
3603  * @return #GNUNET_YES
3604  */
3605 static int
3606 heap_cleanup_iterator (void *cls,
3607                        struct GNUNET_CONTAINER_HeapNode *node,
3608                        void *element,
3609                        GNUNET_CONTAINER_HeapCostType cost)
3610 {
3611   struct DefragContext *d_ctx = element;
3612
3613   GNUNET_CONTAINER_heap_remove_node (node);
3614   GNUNET_DEFRAGMENT_context_destroy (d_ctx->defrag);
3615   GNUNET_free (d_ctx);
3616   return GNUNET_YES;
3617 }
3618
3619
3620 /**
3621  * The exported method. Makes the core api available via a global and
3622  * returns the udp transport API.
3623  *
3624  * @param cls our `struct GNUNET_TRANSPORT_PluginEnvironment`
3625  * @return NULL
3626  */
3627 void *
3628 libgnunet_plugin_transport_udp_done (void *cls)
3629 {
3630   struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
3631   struct Plugin *plugin = api->cls;
3632   struct PrettyPrinterContext *cur;
3633   struct PrettyPrinterContext *next;
3634   struct UDP_MessageWrapper *udpw;
3635
3636   if (NULL == plugin)
3637   {
3638     GNUNET_free(api);
3639     return NULL;
3640   }
3641   stop_broadcast (plugin);
3642   if (plugin->select_task != NULL)
3643   {
3644     GNUNET_SCHEDULER_cancel (plugin->select_task);
3645     plugin->select_task = NULL;
3646   }
3647   if (plugin->select_task_v6 != NULL)
3648   {
3649     GNUNET_SCHEDULER_cancel (plugin->select_task_v6);
3650     plugin->select_task_v6 = NULL;
3651   }
3652
3653   /* Closing sockets */
3654   if (GNUNET_YES == plugin->enable_ipv4)
3655   {
3656     if (NULL != plugin->sockv4)
3657     {
3658       GNUNET_break (GNUNET_OK ==
3659                     GNUNET_NETWORK_socket_close (plugin->sockv4));
3660       plugin->sockv4 = NULL;
3661     }
3662     GNUNET_NETWORK_fdset_destroy (plugin->rs_v4);
3663     GNUNET_NETWORK_fdset_destroy (plugin->ws_v4);
3664   }
3665   if (GNUNET_YES == plugin->enable_ipv6)
3666   {
3667     if (NULL != plugin->sockv6)
3668     {
3669       GNUNET_break (GNUNET_OK ==
3670                     GNUNET_NETWORK_socket_close (plugin->sockv6));
3671       plugin->sockv6 = NULL;
3672
3673       GNUNET_NETWORK_fdset_destroy (plugin->rs_v6);
3674       GNUNET_NETWORK_fdset_destroy (plugin->ws_v6);
3675     }
3676   }
3677   if (NULL != plugin->nat)
3678   {
3679     GNUNET_NAT_unregister (plugin->nat);
3680     plugin->nat = NULL;
3681   }
3682   if (NULL != plugin->defrag_ctxs)
3683   {
3684     GNUNET_CONTAINER_heap_iterate (plugin->defrag_ctxs,
3685                                    &heap_cleanup_iterator, NULL);
3686     GNUNET_CONTAINER_heap_destroy (plugin->defrag_ctxs);
3687     plugin->defrag_ctxs = NULL;
3688   }
3689   if (NULL != plugin->mst)
3690   {
3691     GNUNET_SERVER_mst_destroy (plugin->mst);
3692     plugin->mst = NULL;
3693   }
3694
3695   /* Clean up leftover messages */
3696   udpw = plugin->ipv4_queue_head;
3697   while (NULL != udpw)
3698   {
3699     struct UDP_MessageWrapper *tmp = udpw->next;
3700     dequeue (plugin, udpw);
3701     call_continuation (udpw, GNUNET_SYSERR);
3702     GNUNET_free(udpw);
3703     udpw = tmp;
3704   }
3705   udpw = plugin->ipv6_queue_head;
3706   while (NULL != udpw)
3707   {
3708     struct UDP_MessageWrapper *tmp = udpw->next;
3709     dequeue (plugin, udpw);
3710     call_continuation (udpw, GNUNET_SYSERR);
3711     GNUNET_free(udpw);
3712     udpw = tmp;
3713   }
3714
3715   /* Clean up sessions */
3716   LOG (GNUNET_ERROR_TYPE_DEBUG,
3717        "Cleaning up sessions\n");
3718   GNUNET_CONTAINER_multipeermap_iterate (plugin->sessions,
3719                                          &disconnect_and_free_it, plugin);
3720   GNUNET_CONTAINER_multipeermap_destroy (plugin->sessions);
3721
3722   next = plugin->ppc_dll_head;
3723   for (cur = next; NULL != cur; cur = next)
3724   {
3725     GNUNET_break(0);
3726     next = cur->next;
3727     GNUNET_CONTAINER_DLL_remove (plugin->ppc_dll_head,
3728                                  plugin->ppc_dll_tail,
3729                                  cur);
3730     GNUNET_RESOLVER_request_cancel (cur->resolver_handle);
3731     GNUNET_free (cur);
3732   }
3733   GNUNET_free (plugin);
3734   GNUNET_free (api);
3735   return NULL;
3736 }
3737
3738 /* end of plugin_transport_udp.c */