(no commit message)
[oweals/gnunet.git] / src / transport / plugin_transport_http.c
1 /*
2      This file is part of GNUnet
3      (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors)
4
5      GNUnet is free software; you can redistribute it and/or modify
6      it under the terms of the GNU General Public License as published
7      by the Free Software Foundation; either version 2, or (at your
8      option) any later version.
9
10      GNUnet is distributed in the hope that it will be useful, but
11      WITHOUT ANY WARRANTY; without even the implied warranty of
12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13      General Public License for more details.
14
15      You should have received a copy of the GNU General Public License
16      along with GNUnet; see the file COPYING.  If not, write to the
17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18      Boston, MA 02111-1307, USA.
19 */
20
21 /**
22  * @file transport/plugin_transport_template.c
23  * @brief template for a new transport service
24  * @author Christian Grothoff
25  */
26
27 #include "platform.h"
28 #include "gnunet_protocols.h"
29 #include "gnunet_connection_lib.h"
30 #include "gnunet_server_lib.h"
31 #include "gnunet_service_lib.h"
32 #include "gnunet_statistics_service.h"
33 #include "gnunet_transport_service.h"
34 #include "gnunet_resolver_service.h"
35 #include "plugin_transport.h"
36 #include "microhttpd.h"
37 #include <curl/curl.h>
38
39 #define DEBUG_HTTP GNUNET_NO
40
41 /**
42  * Text of the response sent back after the last bytes of a PUT
43  * request have been received (just to formally obey the HTTP
44  * protocol).
45  */
46 #define HTTP_PUT_RESPONSE "Thank you!"
47
48 /**
49  * After how long do we expire an address that we
50  * learned from another peer if it is not reconfirmed
51  * by anyone?
52  */
53 #define LEARNED_ADDRESS_EXPIRATION GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_HOURS, 6)
54
55 /**
56  * Page returned if request invalid
57  */
58 #define HTTP_ERROR_RESPONSE "<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML 2.0//EN\"><HTML><HEAD><TITLE>404 Not Found</TITLE></HEAD><BODY><H1>Not Found</H1>The requested URL was not found on this server.<P><HR><ADDRESS></ADDRESS></BODY></HTML>"
59
60
61 /**
62  * Encapsulation of all of the state of the plugin.
63  */
64 struct Plugin;
65
66
67 /**
68  * Session handle for connections.
69  */
70 struct Session
71 {
72
73   /**
74    * Stored in a linked list.
75    */
76   struct Session *next;
77
78   /**
79    * Pointer to the global plugin struct.
80    */
81   struct Plugin *plugin;
82
83   /**
84    * Continuation function to call once the transmission buffer
85    * has again space available.  NULL if there is no
86    * continuation to call.
87    */
88   GNUNET_TRANSPORT_TransmitContinuation transmit_cont;
89
90   /**
91    * Closure for transmit_cont.
92    */
93   void *transmit_cont_cls;
94
95   /**
96    * To whom are we talking to (set to our identity
97    * if we are still waiting for the welcome message)
98    */
99   struct GNUNET_PeerIdentity sender;
100
101   /**
102    * Sender's url
103    */
104   char * url;
105
106   /**
107    * Sender's ip address to distinguish between incoming connections
108    */
109   char * ip;
110
111   /**
112    * Sender's ip address to distinguish between incoming connections
113    */
114   struct sockaddr_in * addr;
115
116   /**
117    * Did we initiate the connection (GNUNET_YES) or the other peer (GNUNET_NO)?
118    */
119   unsigned int is_client;
120
121   /**
122    * Is the connection active (GNUNET_YES) or terminated (GNUNET_NO)?
123    */
124   unsigned int is_active;
125
126   /**
127    * At what time did we reset last_received last?
128    */
129   struct GNUNET_TIME_Absolute last_quota_update;
130
131   /**
132    * How many bytes have we received since the "last_quota_update"
133    * timestamp?
134    */
135   uint64_t last_received;
136
137   /**
138    * Number of bytes per ms that this peer is allowed
139    * to send to us.
140    */
141   uint32_t quota;
142
143 };
144
145 /**
146  * Encapsulation of all of the state of the plugin.
147  */
148 struct Plugin
149 {
150   /**
151    * Our environment.
152    */
153   struct GNUNET_TRANSPORT_PluginEnvironment *env;
154
155   /**
156    * List of open sessions.
157    */
158   struct Session *sessions;
159
160   /**
161    * Number of active sessions
162    */
163
164   unsigned int session_count;
165
166 };
167
168 /**
169  * Daemon for listening for new IPv4 connections.
170  */
171 static struct MHD_Daemon *http_daemon_v4;
172
173 /**
174  * Daemon for listening for new IPv6connections.
175  */
176 static struct MHD_Daemon *http_daemon_v6;
177
178 /**
179  * Our primary task for http daemon handling IPv4 connections
180  */
181 static GNUNET_SCHEDULER_TaskIdentifier http_task_v4;
182
183 /**
184  * Our primary task for http daemon handling IPv6 connections
185  */
186 static GNUNET_SCHEDULER_TaskIdentifier http_task_v6;
187
188
189 /**
190  * Information about this plugin
191  */
192 static struct Plugin *plugin;
193
194 /**
195  * cURL Multihandle
196  */
197 static CURLM *multi_handle;
198
199 /**
200  * Our hostname
201  */
202 static char * hostname;
203
204 /**
205  * Our ASCII encoded, hashed peer identity
206  * This string is used to distinguish between connections and is added to the urls
207  */
208 static struct GNUNET_CRYPTO_HashAsciiEncoded my_ascii_hash_ident;
209
210
211 /**
212  * Finds a http session in our linked list using peer identity as a key
213  * @param peer peeridentity
214  * @return http session corresponding to peer identity
215  */
216 static struct Session * find_session_by_pi( const struct GNUNET_PeerIdentity *peer )
217 {
218   struct Session * cur;
219   GNUNET_HashCode hc_peer;
220   GNUNET_HashCode hc_current;
221
222   cur = plugin->sessions;
223   hc_peer = peer->hashPubKey;
224   while (cur != NULL)
225   {
226     hc_current = cur->sender.hashPubKey;
227     if ( 0 == GNUNET_CRYPTO_hash_cmp( &hc_peer, &hc_current))
228       return cur;
229     cur = plugin->sessions->next;
230   }
231   return NULL;
232 }
233
234 #if 0
235 /**
236  * Finds a http session in our linked list using peer identity as a key
237  * @param peer peeridentity
238  * @return http session corresponding to peer identity
239  */
240 static struct Session * find_session_by_ip( char * ip )
241 {
242   /*
243   struct Session * cur;
244
245   cur = plugin->sessions;
246   while (cur != NULL)
247   {
248     hc_current = cur->sender.hashPubKey;
249     if ( 0 == GNUNET_CRYPTO_hash_cmp( &hc_peer, &hc_current))
250       return cur;
251     cur = plugin->sessions->next;
252   }
253   */
254   return NULL;
255 }
256 #endif
257
258 #if 0
259 /**
260  * Creates a http session in our linked list by ip address
261  * Only ip is set here, all other fields have to be set by calling method
262  * @param peer peeridentity
263  * @return created http session
264  */
265 static struct Session * create_session_by_ip ( struct sockaddr_in * addr )
266 {
267   struct Session * cur;
268   struct Session * last_in_list;
269   /* Create a new session object */
270   cur = GNUNET_malloc (sizeof (struct Session));
271   // FIXME: memcpy( &(cur->ip), , sizeof( struct GNUNET_PeerIdentity ) );
272
273   cur->next = NULL;
274
275   /* Insert into linked list */
276   last_in_list = plugin->sessions;
277   while (last_in_list->next != NULL)
278   {
279     last_in_list = last_in_list->next;
280   }
281   last_in_list->next = cur;
282
283   return cur;
284 }
285 #endif
286
287 /**
288  * Callback called by MHD when a connection is terminated
289  */
290 static void requestCompletedCallback (void *cls, struct MHD_Connection * connection, void **httpSessionCache)
291 {
292   struct Session * cs;
293
294   cs = *httpSessionCache;
295   if (cs != NULL)
296   {
297     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Connection from peer `%s' was terminated\n",GNUNET_i2s(&cs->sender));
298     /* session set to inactive */
299     cs->is_active = GNUNET_NO;
300   }
301   return;
302 }
303
304 /**
305  * Check if we are allowed to connect to the given IP.
306  */
307 static int
308 acceptPolicyCallback (void *cls,
309                       const struct sockaddr *addr, socklen_t addr_len)
310 {
311   /* Every connection is accepted, nothing more to do here */
312   return MHD_YES;
313 }
314
315
316 /**
317  * Process GET or PUT request received via MHD.  For
318  * GET, queue response that will send back our pending
319  * messages.  For PUT, process incoming data and send
320  * to GNUnet core.  In either case, check if a session
321  * already exists and create a new one if not.
322  */
323 static int
324 accessHandlerCallback (void *cls,
325                        struct MHD_Connection *session,
326                        const char *url,
327                        const char *method,
328                        const char *version,
329                        const char *upload_data,
330                        size_t * upload_data_size, void **httpSessionCache)
331 {
332   struct MHD_Response *response;
333   struct Session * cs;
334   struct Session * cs_temp;
335   const union MHD_ConnectionInfo * conn_info;
336   struct sockaddr_in  *addrin;
337   struct sockaddr_in6 *addrin6;
338   char * address = NULL;
339   struct GNUNET_PeerIdentity pi_in;
340   int res = GNUNET_NO;
341
342   if ( NULL == *httpSessionCache)
343   {
344     /* check url for peer identity */
345     res = GNUNET_CRYPTO_hash_from_string ( &url[1], &(pi_in.hashPubKey));
346     if ( GNUNET_SYSERR == res )
347     {
348       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Peer has no valid ident\n");
349       response = MHD_create_response_from_data (strlen (HTTP_ERROR_RESPONSE),HTTP_ERROR_RESPONSE, MHD_NO, MHD_NO);
350       res = MHD_queue_response (session, MHD_HTTP_NOT_FOUND, response);
351       MHD_destroy_response (response);
352       return MHD_YES;
353     }
354
355     conn_info = MHD_get_connection_info(session, MHD_CONNECTION_INFO_CLIENT_ADDRESS );
356     /* Incoming IPv4 connection */
357     if ( AF_INET == conn_info->client_addr->sin_family)
358     {
359       address = GNUNET_malloc (INET_ADDRSTRLEN);
360       addrin = conn_info->client_addr;
361       inet_ntop(addrin->sin_family, &(addrin->sin_addr),address,INET_ADDRSTRLEN);
362     }
363     /* Incoming IPv6 connection */
364     if ( AF_INET6 == conn_info->client_addr->sin_family)
365     {
366       address = GNUNET_malloc (INET6_ADDRSTRLEN);
367       addrin6 = (struct sockaddr_in6 *) conn_info->client_addr;
368       inet_ntop(addrin6->sin6_family, &(addrin6->sin6_addr),address,INET6_ADDRSTRLEN);
369     }
370
371     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"HTTP Daemon has an incoming `%s' request from peer `%s' from `[%s]:%u'\n",method, GNUNET_h2s(&pi_in.hashPubKey),address,conn_info->client_addr->sin_port);
372
373     /* find session for address */
374     cs = NULL;
375     if (plugin->session_count > 0)
376     {
377       cs = plugin->sessions;
378       while ( NULL != cs)
379       {
380
381         /* Comparison based on ip address */
382         // res = (0 == memcmp(&(conn_info->client_addr->sin_addr),&(cs->addr->sin_addr), sizeof (struct in_addr))) ? GNUNET_YES : GNUNET_NO;
383
384         /* Comparison based on ip address, port number and address family */
385         // res = (0 == memcmp((conn_info->client_addr),(cs->addr), sizeof (struct sockaddr_in))) ? GNUNET_YES : GNUNET_NO;
386
387         /* Comparison based on PeerIdentity */
388         res = (0 == memcmp(&pi_in,&(cs->sender), sizeof (struct GNUNET_PeerIdentity))) ? GNUNET_YES : GNUNET_NO;
389
390         if ( GNUNET_YES  == res)
391         {
392           /* existing session for this address found */
393           GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Session `%s' found\n",address);
394           break;
395         }
396         cs = cs->next;
397       }
398     }
399
400     if (cs == NULL )
401     {
402       /* create new session object */
403       cs = GNUNET_malloc ( sizeof( struct Session) );
404       cs->addr = GNUNET_malloc ( sizeof (struct sockaddr_in) );
405
406       cs->ip = address;
407       memcpy(cs->addr, conn_info->client_addr, sizeof (struct sockaddr_in));
408       memcpy(&cs->sender, &pi_in, sizeof (struct GNUNET_PeerIdentity));
409       cs->next = NULL;
410       cs->is_active = GNUNET_YES;
411
412       /* Insert session into linked list */
413       if ( plugin->sessions == NULL)
414       {
415         plugin->sessions = cs;
416         plugin->session_count = 1;
417       }
418       cs_temp = plugin->sessions;
419       while ( cs_temp->next != NULL )
420       {
421         cs_temp = cs_temp->next;
422       }
423       if (cs_temp != cs )
424       {
425         cs_temp->next = cs;
426         plugin->session_count++;
427       }
428       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"New Session `%s' inserted, count %u \n", address, plugin->session_count);
429     }
430     /* Set closure */
431     if (*httpSessionCache == NULL)
432       *httpSessionCache = cs;
433   }
434   else
435     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Session already known");
436
437   /* Is it a PUT or a GET request */
438   if ( 0 == strcmp (MHD_HTTP_METHOD_PUT, method) )
439   {
440     /* PUT method here */
441     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Got PUT Request with size %lu \n",(*upload_data_size));
442     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"URL: `%s'\n",url);
443     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"PUT Request: `%s'\n",upload_data);
444     /* No data left */
445     *upload_data_size = 0;
446     response = MHD_create_response_from_data (strlen (HTTP_PUT_RESPONSE),HTTP_PUT_RESPONSE, MHD_NO, MHD_NO);
447     MHD_queue_response (session, MHD_HTTP_OK, response);
448     MHD_destroy_response (response);
449   }
450   if ( 0 == strcmp (MHD_HTTP_METHOD_GET, method) )
451   {
452     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Got GET Request\n");
453     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"URL: `%s'\n",url);
454
455     response = MHD_create_response_from_data (strlen (HTTP_PUT_RESPONSE),HTTP_PUT_RESPONSE, MHD_NO, MHD_NO);
456     MHD_queue_response (session, MHD_HTTP_OK, response);
457     MHD_destroy_response (response);
458   }
459
460   return MHD_YES;
461 }
462
463
464 /**
465  * Call MHD to process pending requests and then go back
466  * and schedule the next run.
467  */
468 static void http_daemon_run (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc);
469
470 /**
471  * Function that queries MHD's select sets and
472  * starts the task waiting for them.
473  */
474 static GNUNET_SCHEDULER_TaskIdentifier
475 http_daemon_prepare (struct MHD_Daemon *daemon_handle)
476 {
477   GNUNET_SCHEDULER_TaskIdentifier ret;
478   fd_set rs;
479   fd_set ws;
480   fd_set es;
481   struct GNUNET_NETWORK_FDSet *wrs;
482   struct GNUNET_NETWORK_FDSet *wws;
483   struct GNUNET_NETWORK_FDSet *wes;
484   int max;
485   unsigned long long timeout;
486   int haveto;
487   struct GNUNET_TIME_Relative tv;
488
489   FD_ZERO(&rs);
490   FD_ZERO(&ws);
491   FD_ZERO(&es);
492   wrs = GNUNET_NETWORK_fdset_create ();
493   wes = GNUNET_NETWORK_fdset_create ();
494   wws = GNUNET_NETWORK_fdset_create ();
495   max = -1;
496   GNUNET_assert (MHD_YES ==
497                  MHD_get_fdset (daemon_handle,
498                                 &rs,
499                                 &ws,
500                                 &es,
501                                 &max));
502   haveto = MHD_get_timeout (daemon_handle, &timeout);
503   if (haveto == MHD_YES)
504     tv.value = (uint64_t) timeout;
505   else
506     tv = GNUNET_TIME_UNIT_FOREVER_REL;
507   GNUNET_NETWORK_fdset_copy_native (wrs, &rs, max);
508   GNUNET_NETWORK_fdset_copy_native (wws, &ws, max);
509   GNUNET_NETWORK_fdset_copy_native (wes, &es, max);
510   ret = GNUNET_SCHEDULER_add_select (plugin->env->sched,
511                                      GNUNET_SCHEDULER_PRIORITY_HIGH,
512                                      GNUNET_SCHEDULER_NO_TASK,
513                                      tv,
514                                      wrs,
515                                      wws,
516                                      &http_daemon_run,
517                                      daemon_handle);
518   GNUNET_NETWORK_fdset_destroy (wrs);
519   GNUNET_NETWORK_fdset_destroy (wws);
520   GNUNET_NETWORK_fdset_destroy (wes);
521   return ret;
522 }
523
524 /**
525  * Call MHD to process pending requests and then go back
526  * and schedule the next run.
527  */
528 static void
529 http_daemon_run (void *cls,
530             const struct GNUNET_SCHEDULER_TaskContext *tc)
531 {
532   struct MHD_Daemon *daemon_handle = cls;
533
534   if (daemon_handle == http_daemon_v4)
535     http_task_v4 = GNUNET_SCHEDULER_NO_TASK;
536
537   if (daemon_handle == http_daemon_v6)
538     http_task_v6 = GNUNET_SCHEDULER_NO_TASK;
539
540   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
541     return;
542
543
544
545   GNUNET_assert (MHD_YES == MHD_run (daemon_handle));
546   if (daemon_handle == http_daemon_v4)
547     http_task_v4 = http_daemon_prepare (daemon_handle);
548   if (daemon_handle == http_daemon_v6)
549     http_task_v6 = http_daemon_prepare (daemon_handle);
550   return;
551 }
552
553 static size_t read_callback(void *ptr, size_t size, size_t nmemb, void *stream)
554 {
555   size_t retcode;
556   /*
557   fprintf(stdout, "*** Read callback: size %u, size nmemb: %u \n", size, nmemb);
558   retcode = fread(ptr, size, nmemb, stream);
559    */
560   retcode = 0;
561   return retcode;
562 }
563
564 /**
565  * Function that can be used by the transport service to transmit
566  * a message using the plugin.
567  *
568  * @param cls closure
569  * @param target who should receive this message
570  * @param priority how important is the message
571  * @param msgbuf the message to transmit
572  * @param msgbuf_size number of bytes in 'msgbuf'
573  * @param timeout when should we time out
574  * @param session which session must be used (or NULL for "any")
575  * @param addr the address to use (can be NULL if the plugin
576  *                is "on its own" (i.e. re-use existing TCP connection))
577  * @param addrlen length of the address in bytes
578  * @param force_address GNUNET_YES if the plugin MUST use the given address,
579  *                otherwise the plugin may use other addresses or
580  *                existing connections (if available)
581  * @param cont continuation to call once the message has
582  *        been transmitted (or if the transport is ready
583  *        for the next transmission call; or if the
584  *        peer disconnected...)
585  * @param cont_cls closure for cont
586  * @return number of bytes used (on the physical network, with overheads);
587  *         -1 on hard errors (i.e. address invalid); 0 is a legal value
588  *         and does NOT mean that the message was not transmitted (DV)
589  */
590 static ssize_t
591 template_plugin_send (void *cls,
592                       const struct GNUNET_PeerIdentity *
593                       target,
594                       const char *msgbuf,
595                       size_t msgbuf_size,
596                       unsigned int priority,
597                       struct GNUNET_TIME_Relative timeout,
598                       struct Session *session,
599                       const void *addr,
600                       size_t addrlen,
601                       int force_address,
602                       GNUNET_TRANSPORT_TransmitContinuation
603                       cont, void *cont_cls)
604 {
605   struct Session* ses;
606   struct Session* ses_temp;
607   int bytes_sent = 0;
608   /*  struct Plugin *plugin = cls; */
609   CURL *curl_handle;
610   /* CURLcode res; */
611
612   /* find session for peer */
613
614
615   ses = find_session_by_pi (target);
616
617   if ( ses == NULL)
618   {
619     /* create new session object */
620     ses = GNUNET_malloc ( sizeof( struct Session) );
621     ses->addr = GNUNET_malloc ( sizeof (struct sockaddr_in) );
622
623     //ses->ip = address;
624     // memcpy(ses->addr, conn_info->client_addr, sizeof (struct sockaddr_in));
625     memcpy(&ses->sender, &target, sizeof (struct GNUNET_PeerIdentity));
626     ses->next = NULL;
627     ses->is_active = GNUNET_YES;
628
629     /* Insert session into linked list */
630     if ( plugin->sessions == NULL)
631     {
632       plugin->sessions = ses;
633       plugin->session_count = 1;
634     }
635     ses_temp = plugin->sessions;
636     while ( ses_temp->next != NULL )
637     {
638       ses_temp = ses_temp->next;
639     }
640     if (ses_temp != ses )
641     {
642       ses_temp->next = ses;
643       plugin->session_count++;
644     }
645     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"New Session `%s' inserted, count %u \n", GNUNET_i2s(target), plugin->session_count);  }
646
647   char *url = "";
648
649   curl_handle = curl_easy_init();
650   if( NULL == curl_handle)
651   {
652     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Getting cURL handle failed\n");
653     return -1;
654   }
655   curl_easy_setopt(curl_handle, CURLOPT_VERBOSE, 1L);
656   curl_easy_setopt(curl_handle, CURLOPT_READFUNCTION, read_callback);
657   curl_easy_setopt(curl_handle, CURLOPT_UPLOAD, 1L);
658   curl_easy_setopt(curl_handle, CURLOPT_PUT, 1L);
659   curl_easy_setopt(curl_handle, CURLOPT_URL, url);
660   curl_easy_setopt(curl_handle, CURLOPT_READDATA, msgbuf);
661   curl_easy_setopt(curl_handle, CURLOPT_INFILESIZE_LARGE,
662                   (curl_off_t)msgbuf_size);
663
664
665
666   return bytes_sent;
667 }
668
669
670
671 /**
672  * Function that can be used to force the plugin to disconnect
673  * from the given peer and cancel all previous transmissions
674  * (and their continuationc).
675  *
676  * @param cls closure
677  * @param target peer from which to disconnect
678  */
679 static void
680 template_plugin_disconnect (void *cls,
681                             const struct GNUNET_PeerIdentity *target)
682 {
683   // struct Plugin *plugin = cls;
684   // FIXME
685 }
686
687
688 /**
689  * Convert the transports address to a nice, human-readable
690  * format.
691  *
692  * @param cls closure
693  * @param type name of the transport that generated the address
694  * @param addr one of the addresses of the host, NULL for the last address
695  *        the specific address format depends on the transport
696  * @param addrlen length of the address
697  * @param numeric should (IP) addresses be displayed in numeric form?
698  * @param timeout after how long should we give up?
699  * @param asc function to call on each string
700  * @param asc_cls closure for asc
701  */
702 static void
703 template_plugin_address_pretty_printer (void *cls,
704                                         const char *type,
705                                         const void *addr,
706                                         size_t addrlen,
707                                         int numeric,
708                                         struct GNUNET_TIME_Relative timeout,
709                                         GNUNET_TRANSPORT_AddressStringCallback
710                                         asc, void *asc_cls)
711 {
712   asc (asc_cls, NULL);
713 }
714
715
716
717 /**
718  * Another peer has suggested an address for this
719  * peer and transport plugin.  Check that this could be a valid
720  * address.  If so, consider adding it to the list
721  * of addresses.
722  *
723  * @param cls closure
724  * @param addr pointer to the address
725  * @param addrlen length of addr
726  * @return GNUNET_OK if this is a plausible address for this peer
727  *         and transport
728  */
729 static int
730 template_plugin_address_suggested (void *cls,
731                                   void *addr, size_t addrlen)
732 {
733   /* struct Plugin *plugin = cls; */
734
735   /* check if the address is plausible; if so,
736      add it to our list! */
737   return GNUNET_OK;
738 }
739
740
741 /**
742  * Function called for a quick conversion of the binary address to
743  * a numeric address.  Note that the caller must not free the
744  * address and that the next call to this function is allowed
745  * to override the address again.
746  *
747  * @param cls closure
748  * @param addr binary address
749  * @param addrlen length of the address
750  * @return string representing the same address
751  */
752 static const char*
753 template_plugin_address_to_string (void *cls,
754                                    const void *addr,
755                                    size_t addrlen)
756 {
757   GNUNET_break (0);
758   return NULL;
759 }
760
761 /**
762  * Exit point from the plugin.
763  */
764 void *
765 libgnunet_plugin_transport_http_done (void *cls)
766 {
767   struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
768   struct Plugin *plugin = api->cls;
769   struct Session * cs;
770   struct Session * cs_next;
771
772   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Unloading http plugin...\n");
773
774   if ( http_task_v4 != GNUNET_SCHEDULER_NO_TASK)
775   {
776     GNUNET_SCHEDULER_cancel(plugin->env->sched, http_task_v4);
777     http_task_v4 = GNUNET_SCHEDULER_NO_TASK;
778   }
779
780   if ( http_task_v6 != GNUNET_SCHEDULER_NO_TASK)
781   {
782     GNUNET_SCHEDULER_cancel(plugin->env->sched, http_task_v6);
783     http_task_v6 = GNUNET_SCHEDULER_NO_TASK;
784   }
785
786   if (http_daemon_v4 != NULL)
787   {
788     MHD_stop_daemon (http_daemon_v4);
789     http_daemon_v4 = NULL;
790   }
791   if (http_daemon_v6 != NULL)
792   {
793     MHD_stop_daemon (http_daemon_v6);
794     http_daemon_v6 = NULL;
795   }
796
797   curl_multi_cleanup(multi_handle);
798
799   /* free all sessions */
800   cs = plugin->sessions;
801   while ( NULL != cs)
802     {
803       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Freeing session to `%s'\n",cs->ip);
804       cs_next = cs->next;
805       GNUNET_free (cs->ip);
806       GNUNET_free (cs->addr);
807       GNUNET_free (cs);
808       plugin->session_count--;
809       cs = cs_next;
810     }
811
812   GNUNET_free (plugin);
813   GNUNET_free (api);
814   return NULL;
815 }
816
817
818 /**
819  * Entry point for the plugin.
820  */
821 void *
822 libgnunet_plugin_transport_http_init (void *cls)
823 {
824   struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
825   struct GNUNET_TRANSPORT_PluginFunctions *api;
826
827   long long unsigned int port;
828
829   plugin = GNUNET_malloc (sizeof (struct Plugin));
830   plugin->env = env;
831   plugin->sessions = NULL;
832   api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
833   api->cls = plugin;
834   api->send = &template_plugin_send;
835   api->disconnect = &template_plugin_disconnect;
836   api->address_pretty_printer = &template_plugin_address_pretty_printer;
837   api->check_address = &template_plugin_address_suggested;
838   api->address_to_string = &template_plugin_address_to_string;
839
840   hostname = GNUNET_RESOLVER_local_fqdn_get ();
841
842   /* Hashing our identity to use it in URLs */
843   GNUNET_CRYPTO_hash_to_enc ( &(plugin->env->my_identity->hashPubKey), &my_ascii_hash_ident);
844
845   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Starting http plugin...\n");
846   /* Reading port number from config file */
847   if ((GNUNET_OK !=
848        GNUNET_CONFIGURATION_get_value_number (env->cfg,
849                                               "transport-http",
850                                               "PORT",
851                                               &port)) ||
852       (port > 65535) )
853     {
854       GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR,
855                        "http",
856                        _
857                        ("Require valid port number for transport plugin `%s' in configuration!\n"),
858                        "transport-http");
859       libgnunet_plugin_transport_http_done (api);
860       return NULL;
861     }
862
863   if ((http_daemon_v4 == NULL) && (http_daemon_v6 == NULL) && (port != 0))
864     {
865     http_daemon_v6 = MHD_start_daemon (MHD_USE_IPv6,
866                                        port,
867                                        &acceptPolicyCallback,
868                                        NULL , &accessHandlerCallback, NULL,
869                                        MHD_OPTION_CONNECTION_LIMIT, (unsigned int) 16,
870                                        MHD_OPTION_PER_IP_CONNECTION_LIMIT, (unsigned int) 1,
871                                        MHD_OPTION_CONNECTION_TIMEOUT, (unsigned int) 16,
872                                        MHD_OPTION_CONNECTION_MEMORY_LIMIT, (size_t) (16 * 1024),
873                                        MHD_OPTION_NOTIFY_COMPLETED, &requestCompletedCallback, NULL,
874                                        MHD_OPTION_END);
875     http_daemon_v4 = MHD_start_daemon (MHD_NO_FLAG,
876                                        port,
877                                        &acceptPolicyCallback,
878                                        NULL , &accessHandlerCallback, NULL,
879                                        MHD_OPTION_CONNECTION_LIMIT, (unsigned int) 16,
880                                        MHD_OPTION_PER_IP_CONNECTION_LIMIT, (unsigned int) 1,
881                                        MHD_OPTION_CONNECTION_TIMEOUT, (unsigned int) 16,
882                                        MHD_OPTION_CONNECTION_MEMORY_LIMIT, (size_t) (16 * 1024),
883                                        MHD_OPTION_NOTIFY_COMPLETED, &requestCompletedCallback, NULL,
884                                        MHD_OPTION_END);
885     }
886   if (http_daemon_v4 != NULL)
887     http_task_v4 = http_daemon_prepare (http_daemon_v4);
888   if (http_daemon_v6 != NULL)
889     http_task_v6 = http_daemon_prepare (http_daemon_v6);
890
891   if (http_task_v4 != GNUNET_SCHEDULER_NO_TASK)
892     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Starting MHD with IPv4 on port %u\n",port);
893   if (http_task_v6 != GNUNET_SCHEDULER_NO_TASK)
894     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,"Starting MHD with IPv4 and IPv6 on port %u\n",port);
895
896   /* Initializing cURL */
897   multi_handle = curl_multi_init();
898
899   return api;
900 }
901
902 /* end of plugin_transport_template.c */