adapt to new API
[oweals/gnunet.git] / src / fs / gnunet-service-fs_cp.c
1 /*
2      This file is part of GNUnet.
3      (C) 2011 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 fs/gnunet-service-fs_cp.c
23  * @brief API to handle 'connected peers'
24  * @author Christian Grothoff
25  */
26 #include "platform.h"
27 #include "gnunet_load_lib.h"
28 #include "gnunet-service-fs.h"
29 #include "gnunet-service-fs_cp.h"
30 #include "gnunet-service-fs_pe.h"
31 #include "gnunet-service-fs_pr.h"
32 #include "gnunet-service-fs_push.h"
33
34 /**
35  * How often do we flush trust values to disk?
36  */
37 #define TRUST_FLUSH_FREQ GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 5)
38
39 /**
40  * After how long do we discard a reply?
41  */
42 #define REPLY_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 2)
43
44
45 /**
46  * Handle to cancel a transmission request.
47  */
48 struct GSF_PeerTransmitHandle
49 {
50
51   /**
52    * Kept in a doubly-linked list.
53    */
54   struct GSF_PeerTransmitHandle *next;
55
56   /**
57    * Kept in a doubly-linked list.
58    */
59   struct GSF_PeerTransmitHandle *prev;
60
61   /**
62    * Handle for an active request for transmission to this
63    * peer, or NULL (if core queue was full).
64    */
65   struct GNUNET_CORE_TransmitHandle *cth;
66
67   /**
68    * Time when this transmission request was issued.
69    */
70   struct GNUNET_TIME_Absolute transmission_request_start_time;
71
72   /**
73    * Timeout for this request.
74    */
75   struct GNUNET_TIME_Absolute timeout;
76
77   /**
78    * Task called on timeout, or 0 for none.
79    */
80   GNUNET_SCHEDULER_TaskIdentifier timeout_task;
81
82   /**
83    * Function to call to get the actual message.
84    */
85   GSF_GetMessageCallback gmc;
86
87   /**
88    * Peer this request targets.
89    */
90   struct GSF_ConnectedPeer *cp;
91
92   /**
93    * Closure for 'gmc'.
94    */
95   void *gmc_cls;
96
97   /**
98    * Size of the message to be transmitted.
99    */
100   size_t size;
101
102   /**
103    * GNUNET_YES if this is a query, GNUNET_NO for content.
104    */
105   int is_query;
106
107   /**
108    * Priority of this request.
109    */
110   uint32_t priority;
111
112 };
113
114
115 /**
116  * A connected peer.
117  */
118 struct GSF_ConnectedPeer 
119 {
120
121   /**
122    * Performance data for this peer.
123    */
124   struct GSF_PeerPerformanceData ppd;
125
126   /**
127    * Time until when we blocked this peer from migrating
128    * data to us.
129    */
130   struct GNUNET_TIME_Absolute last_migration_block;
131
132   /**
133    * Task scheduled to revive migration to this peer.
134    */
135   GNUNET_SCHEDULER_TaskIdentifier mig_revive_task;
136
137   /**
138    * Messages (replies, queries, content migration) we would like to
139    * send to this peer in the near future.  Sorted by priority, head.
140    */
141   struct GSF_PeerTransmitHandle *pth_head;
142
143   /**
144    * Messages (replies, queries, content migration) we would like to
145    * send to this peer in the near future.  Sorted by priority, tail.
146    */
147   struct GSF_PeerTransmitHandle *pth_tail;
148
149   /**
150    * Migration stop message in our queue, or NULL if we have none pending.
151    */
152   struct GSF_PeerTransmitHandle *migration_pth;
153
154   /**
155    * Context of our GNUNET_CORE_peer_change_preference call (or NULL).
156    * NULL if we have successfully reserved 32k, otherwise non-NULL.
157    */
158   struct GNUNET_CORE_InformationRequestContext *irc;
159
160   /**
161    * Active requests from this neighbour.
162    */
163   struct GNUNET_CONTAINER_MultiHashMap *request_map;
164
165   /**
166    * Increase in traffic preference still to be submitted
167    * to the core service for this peer.
168    */
169   uint64_t inc_preference;
170
171   /**
172    * Trust rating for this peer on disk.
173    */
174   uint32_t disk_trust;
175
176   /**
177    * Which offset in "last_p2p_replies" will be updated next?
178    * (we go round-robin).
179    */
180   unsigned int last_p2p_replies_woff;
181
182   /**
183    * Which offset in "last_client_replies" will be updated next?
184    * (we go round-robin).
185    */
186   unsigned int last_client_replies_woff;
187
188   /**
189    * Current offset into 'last_request_times' ring buffer.
190    */
191   unsigned int last_request_times_off;
192
193 };
194
195
196 /**
197  * Map from peer identities to 'struct GSF_ConnectPeer' entries.
198  */
199 static struct GNUNET_CONTAINER_MultiHashMap *cp_map;
200
201 /**
202  * Where do we store trust information?
203  */
204 static char *trustDirectory;
205
206
207 /**
208  * Get the filename under which we would store the GNUNET_HELLO_Message
209  * for the given host and protocol.
210  * @return filename of the form DIRECTORY/HOSTID
211  */
212 static char *
213 get_trust_filename (const struct GNUNET_PeerIdentity *id)
214 {
215   struct GNUNET_CRYPTO_HashAsciiEncoded fil;
216   char *fn;
217
218   GNUNET_CRYPTO_hash_to_enc (&id->hashPubKey, &fil);
219   GNUNET_asprintf (&fn, "%s%s%s", trustDirectory, DIR_SEPARATOR_STR, &fil);
220   return fn;
221 }
222
223
224 /**
225  * Find latency information in 'atsi'.
226  *
227  * @param atsi performance data
228  * @return connection latency
229  */
230 static struct GNUNET_TIME_Relative
231 get_latency (const struct GNUNET_TRANSPORT_ATS_Information *atsi)
232 {
233   if (atsi == NULL)
234     return GNUNET_TIME_UNIT_SECONDS;
235   while ( (ntohl (atsi->type) != GNUNET_TRANSPORT_ATS_ARRAY_TERMINATOR) &&
236           (ntohl (atsi->type) != GNUNET_TRANSPORT_ATS_QUALITY_NET_DELAY) )
237     atsi++;
238   if (ntohl (atsi->type) == GNUNET_TRANSPORT_ATS_ARRAY_TERMINATOR) 
239     {
240       GNUNET_break (0);
241       /* how can we not have latency data? */
242       return GNUNET_TIME_UNIT_SECONDS;
243     }
244   return GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS,
245                                         ntohl (atsi->value));
246 }
247
248
249 /**
250  * Update the performance information kept for the given peer.
251  *
252  * @param cp peer record to update
253  * @param atsi transport performance data
254  */
255 static void
256 update_atsi (struct GSF_ConnectedPeer *cp,
257              const struct GNUNET_TRANSPORT_ATS_Information *atsi)
258 {
259   struct GNUNET_TIME_Relative latency;
260
261   latency = get_latency (atsi);
262   GNUNET_LOAD_value_set_decline (cp->ppd.transmission_delay,
263                                  latency);
264   /* LATER: merge atsi into cp's performance data (if we ever care...) */
265 }
266
267
268 /**
269  * Return the performance data record for the given peer
270  * 
271  * @param cp peer to query
272  * @return performance data record for the peer
273  */
274 struct GSF_PeerPerformanceData *
275 GSF_get_peer_performance_data_ (struct GSF_ConnectedPeer *cp)
276 {
277   return &cp->ppd;
278 }
279
280
281 /**
282  * Core is ready to transmit to a peer, get the message.
283  *
284  * @param cls the 'struct GSF_PeerTransmitHandle' of the message
285  * @param size number of bytes core is willing to take
286  * @param buf where to copy the message
287  * @return number of bytes copied to buf
288  */
289 static size_t
290 peer_transmit_ready_cb (void *cls,
291                         size_t size,
292                         void *buf)
293 {
294   struct GSF_PeerTransmitHandle *pth = cls;
295   struct GSF_ConnectedPeer *cp;
296   size_t ret;
297
298   if (pth->timeout_task != GNUNET_SCHEDULER_NO_TASK)
299     {
300       GNUNET_SCHEDULER_cancel (pth->timeout_task);
301       pth->timeout_task = GNUNET_SCHEDULER_NO_TASK;
302     }
303   cp = pth->cp;
304   GNUNET_CONTAINER_DLL_remove (cp->pth_head,
305                                cp->pth_tail,
306                                pth);
307   if (GNUNET_YES == pth->is_query)
308     {
309       cp->ppd.last_request_times[(cp->last_request_times_off++) % MAX_QUEUE_PER_PEER] = GNUNET_TIME_absolute_get ();
310       GNUNET_assert (0 < cp->ppd.pending_queries--);    
311     }
312   else if (GNUNET_NO == pth->is_query)
313     {
314       GNUNET_assert (0 < cp->ppd.pending_replies--);
315     }
316   GNUNET_LOAD_update (cp->ppd.transmission_delay,
317                       GNUNET_TIME_absolute_get_duration (pth->transmission_request_start_time).rel_value);  
318   ret = pth->gmc (pth->gmc_cls, 
319                   0, NULL);
320   GNUNET_free (pth);  
321   return ret;
322 }
323
324
325 /**
326  * Function called by core upon success or failure of our bandwidth reservation request.
327  *
328  * @param cls the 'struct GSF_ConnectedPeer' of the peer for which we made the request
329  * @param peer identifies the peer
330  * @param bandwidth_out available amount of outbound bandwidth
331  * @param amount set to the amount that was actually reserved or unreserved;
332  *               either the full requested amount or zero (no partial reservations)
333  * @param preference current traffic preference for the given peer
334  */
335 static void
336 core_reserve_callback (void *cls,
337                        const struct GNUNET_PeerIdentity *peer,
338                        struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
339                        int amount,
340                        uint64_t preference)
341 {
342   struct GSF_ConnectedPeer *cp = cls;
343   struct GSF_PeerTransmitHandle *pth;
344   uint64_t ip;
345
346   cp->irc = NULL;
347   if (0 == amount)
348     {
349       /* failed; retry! (how did we get here!?) */
350       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
351                   _("Failed to reserve bandwidth to peer `%s'\n"),
352                   GNUNET_i2s (peer));
353       ip = cp->inc_preference;
354       cp->inc_preference = 0;
355       cp->irc = GNUNET_CORE_peer_change_preference (GSF_core,
356                                                     peer,
357                                                     GNUNET_TIME_UNIT_FOREVER_REL,
358                                                     GNUNET_BANDWIDTH_VALUE_MAX,
359                                                     DBLOCK_SIZE,
360                                                     ip,
361                                                     &core_reserve_callback,
362                                                     cp);
363       return;
364     }
365   pth = cp->pth_head;
366   if ( (NULL != pth) &&
367        (NULL == pth->cth) )
368     {
369       /* reservation success, try transmission now! */
370       pth->cth = GNUNET_CORE_notify_transmit_ready (GSF_core,
371                                                     GNUNET_YES,
372                                                     pth->priority,
373                                                     GNUNET_TIME_absolute_get_remaining (pth->timeout),
374                                                     peer,
375                                                     pth->size,
376                                                     &peer_transmit_ready_cb,
377                                                     pth);
378     }
379 }
380
381
382 /**
383  * A peer connected to us.  Setup the connected peer
384  * records.
385  *
386  * @param peer identity of peer that connected
387  * @param atsi performance data for the connection
388  * @return handle to connected peer entry
389  */
390 struct GSF_ConnectedPeer *
391 GSF_peer_connect_handler_ (const struct GNUNET_PeerIdentity *peer,
392                            const struct GNUNET_TRANSPORT_ATS_Information *atsi)
393 {
394   struct GSF_ConnectedPeer *cp;
395   char *fn;
396   uint32_t trust;
397
398   cp = GNUNET_malloc (sizeof (struct GSF_ConnectedPeer));
399   cp->ppd.pid = GNUNET_PEER_intern (peer);
400   cp->ppd.transmission_delay = GNUNET_LOAD_value_init (GNUNET_TIME_UNIT_ZERO);
401   cp->irc = GNUNET_CORE_peer_change_preference (GSF_core,
402                                                 peer,
403                                                 GNUNET_TIME_UNIT_FOREVER_REL,
404                                                 GNUNET_BANDWIDTH_VALUE_MAX,
405                                                 DBLOCK_SIZE,
406                                                 0,
407                                                 &core_reserve_callback,
408                                                 cp);
409   fn = get_trust_filename (peer);
410   if ((GNUNET_DISK_file_test (fn) == GNUNET_YES) &&
411       (sizeof (trust) == GNUNET_DISK_fn_read (fn, &trust, sizeof (trust))))
412     cp->disk_trust = cp->ppd.trust = ntohl (trust);
413   GNUNET_free (fn);
414   cp->request_map = GNUNET_CONTAINER_multihashmap_create (128);
415   GNUNET_break (GNUNET_OK ==
416                 GNUNET_CONTAINER_multihashmap_put (cp_map,
417                                                    &peer->hashPubKey,
418                                                    cp,
419                                                    GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY));
420   update_atsi (cp, atsi);
421   GSF_push_start_ (cp);
422   return cp;
423 }
424
425
426 /**
427  * It may be time to re-start migrating content to this
428  * peer.  Check, and if so, restart migration.
429  *
430  * @param cls the 'struct GSF_ConnectedPeer'
431  * @param tc scheduler context
432  */
433 static void
434 revive_migration (void *cls,
435                   const struct GNUNET_SCHEDULER_TaskContext *tc)
436 {
437   struct GSF_ConnectedPeer *cp = cls;
438   struct GNUNET_TIME_Relative bt;
439   
440   cp->mig_revive_task = GNUNET_SCHEDULER_NO_TASK;
441   bt = GNUNET_TIME_absolute_get_remaining (cp->ppd.migration_blocked_until);
442   if (0 != bt.rel_value)
443     {
444       /* still time left... */
445       cp->mig_revive_task 
446         = GNUNET_SCHEDULER_add_delayed (bt,
447                                         &revive_migration,
448                                         cp);
449       return;
450     }
451   GSF_push_start_ (cp);
452 }
453
454
455 /**
456  * Get a handle for a connected peer.
457  *
458  * @param peer peer's identity
459  */
460 struct GSF_ConnectedPeer *
461 GSF_peer_get_ (const struct GNUNET_PeerIdentity *peer)
462 {
463   return GNUNET_CONTAINER_multihashmap_get (cp_map,
464                                             &peer->hashPubKey);
465 }
466
467
468 /**
469  * Handle P2P "MIGRATION_STOP" message.
470  *
471  * @param cls closure, always NULL
472  * @param other the other peer involved (sender or receiver, NULL
473  *        for loopback messages where we are both sender and receiver)
474  * @param message the actual message
475  * @param atsi performance information
476  * @return GNUNET_OK to keep the connection open,
477  *         GNUNET_SYSERR to close it (signal serious error)
478  */
479 int
480 GSF_handle_p2p_migration_stop_ (void *cls,
481                                 const struct GNUNET_PeerIdentity *other,
482                                 const struct GNUNET_MessageHeader *message,
483                                 const struct GNUNET_TRANSPORT_ATS_Information *atsi)
484 {
485   struct GSF_ConnectedPeer *cp; 
486   const struct MigrationStopMessage *msm;
487   struct GNUNET_TIME_Relative bt;
488
489   msm = (const struct MigrationStopMessage*) message;
490   cp = GNUNET_CONTAINER_multihashmap_get (cp_map,
491                                           &other->hashPubKey);
492   if (cp == NULL)
493     {
494       GNUNET_break (0);
495       return GNUNET_OK;
496     }
497   bt = GNUNET_TIME_relative_ntoh (msm->duration);
498   cp->ppd.migration_blocked_until = GNUNET_TIME_relative_to_absolute (bt);
499   if (cp->mig_revive_task == GNUNET_SCHEDULER_NO_TASK)
500     {
501       GSF_push_stop_ (cp);
502       cp->mig_revive_task 
503         = GNUNET_SCHEDULER_add_delayed (bt,
504                                         &revive_migration,
505                                         cp);
506     }
507   update_atsi (cp, atsi);
508   return GNUNET_OK;
509 }
510
511
512 /**
513  * Copy reply and free put message.
514  *
515  * @param cls the 'struct PutMessage'
516  * @param buf_size number of bytes available in buf
517  * @param buf where to copy the message, NULL on error (peer disconnect)
518  * @return number of bytes copied to 'buf', can be 0 (without indicating an error)
519  */
520 static size_t 
521 copy_reply (void *cls,
522             size_t buf_size,
523             void *buf)
524 {
525   struct PutMessage *pm = cls;
526   size_t size;
527
528   if (buf != NULL)
529     {
530       GNUNET_assert (buf_size >= ntohs (pm->header.size));
531       size = ntohs (pm->header.size);
532       memcpy (buf, pm, size); 
533       GNUNET_STATISTICS_update (GSF_stats,
534                                 gettext_noop ("# replies transmitted to other peers"),
535                                 1,
536                                 GNUNET_NO); 
537     }
538   else
539     {
540       size = 0;
541       GNUNET_STATISTICS_update (GSF_stats,
542                                 gettext_noop ("# replies dropped"),
543                                 1,
544                                 GNUNET_NO); 
545     }
546   GNUNET_free (pm);
547   return size;
548 }
549
550
551 /**
552  * Handle a reply to a pending request.  Also called if a request
553  * expires (then with data == NULL).  The handler may be called
554  * many times (depending on the request type), but will not be
555  * called during or after a call to GSF_pending_request_cancel 
556  * and will also not be called anymore after a call signalling
557  * expiration.
558  *
559  * @param cls 'struct GSF_ConnectedPeer' of the peer that would
560  *            have liked an answer to the request
561  * @param pr handle to the original pending request
562  * @param expiration when does 'data' expire?
563  * @param data response data, NULL on request expiration
564  * @param data_len number of bytes in data
565  */
566 static void
567 handle_p2p_reply (void *cls,
568                   struct GSF_PendingRequest *pr,
569                   struct GNUNET_TIME_Absolute expiration,
570                   const void *data,
571                   size_t data_len)
572 {
573   struct GSF_ConnectedPeer *cp = cls;
574   struct GSF_PendingRequestData *prd;
575   struct PutMessage *pm;
576   size_t msize;
577
578   prd = GSF_pending_request_get_data_ (pr);
579   if (NULL == data)
580     {
581       GNUNET_STATISTICS_update (GSF_stats,
582                                 gettext_noop ("# P2P searches active"),
583                                 -1,
584                                 GNUNET_NO);
585       GNUNET_break (GNUNET_OK ==
586                     GNUNET_CONTAINER_multihashmap_remove (cp->request_map,
587                                                           &prd->query,
588                                                           pr));
589       return;
590     }  
591 #if DEBUG_FS
592   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
593               "Transmitting result for query `%s'\n",
594               GNUNET_h2s (&prd->query));
595 #endif  
596   GNUNET_STATISTICS_update (GSF_stats,
597                             gettext_noop ("# replies received for other peers"),
598                             1,
599                             GNUNET_NO); 
600   msize = sizeof (struct PutMessage) + data_len;
601   if (msize >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
602     {
603       GNUNET_break (0);
604       return;
605     }
606   pm = GNUNET_malloc (sizeof (msize));
607   pm->header.type = htons (GNUNET_MESSAGE_TYPE_FS_PUT);
608   pm->header.size = htons (msize);
609   pm->type = htonl (prd->type);
610   pm->expiration = GNUNET_TIME_absolute_hton (expiration);
611   memcpy (&pm[1], data, data_len);
612   (void) GSF_peer_transmit_ (cp, GNUNET_NO,
613                              UINT32_MAX,
614                              REPLY_TIMEOUT,
615                              msize,
616                              &copy_reply,
617                              pm);
618 }
619
620
621 /**
622  * Increase the host credit by a value.
623  *
624  * @param cp which peer to change the trust value on
625  * @param value is the int value by which the
626  *  host credit is to be increased or decreased
627  * @returns the actual change in trust (positive or negative)
628  */
629 static int
630 change_host_trust (struct GSF_ConnectedPeer *cp, int value)
631 {
632   if (value == 0)
633     return 0;
634   GNUNET_assert (cp != NULL);
635   if (value > 0)
636     {
637       if (cp->ppd.trust + value < cp->ppd.trust)
638         {
639           value = UINT32_MAX - cp->ppd.trust;
640           cp->ppd.trust = UINT32_MAX;
641         }
642       else
643         cp->ppd.trust += value;
644     }
645   else
646     {
647       if (cp->ppd.trust < -value)
648         {
649           value = -cp->ppd.trust;
650           cp->ppd.trust = 0;
651         }
652       else
653         cp->ppd.trust += value;
654     }
655   return value;
656 }
657
658
659 /**
660  * We've received a request with the specified priority.  Bound it
661  * according to how much we trust the given peer.
662  * 
663  * @param prio_in requested priority
664  * @param cp the peer making the request
665  * @return effective priority
666  */
667 static int32_t
668 bound_priority (uint32_t prio_in,
669                 struct GSF_ConnectedPeer *cp)
670 {
671 #define N ((double)128.0)
672   uint32_t ret;
673   double rret;
674   int ld;
675
676   ld = GSF_test_get_load_too_high_ (0);
677   if (ld == GNUNET_SYSERR)
678     {
679       GNUNET_STATISTICS_update (GSF_stats,
680                                 gettext_noop ("# requests done for free (low load)"),
681                                 1,
682                                 GNUNET_NO);
683       return 0; /* excess resources */
684     }
685   if (prio_in > INT32_MAX)
686     prio_in = INT32_MAX;
687   ret = - change_host_trust (cp, - (int) prio_in);
688   if (ret > 0)
689     {
690       if (ret > GSF_current_priorities + N)
691         rret = GSF_current_priorities + N;
692       else
693         rret = ret;
694       GSF_current_priorities 
695         = (GSF_current_priorities * (N-1) + rret)/N;
696     }
697   if ( (ld == GNUNET_YES) && (ret > 0) )
698     {
699       /* try with charging */
700       ld = GSF_test_get_load_too_high_ (ret);
701     }
702   if (ld == GNUNET_YES)
703     {
704       GNUNET_STATISTICS_update (GSF_stats,
705                                 gettext_noop ("# request dropped, priority insufficient"),
706                                 1,
707                                 GNUNET_NO);
708       /* undo charge */
709       change_host_trust (cp, (int) ret);
710       return -1; /* not enough resources */
711     }
712   else
713     {
714       GNUNET_STATISTICS_update (GSF_stats,
715                                 gettext_noop ("# requests done for a price (normal load)"),
716                                 1,
717                                 GNUNET_NO);
718     }
719 #undef N
720   return ret;
721 }
722
723
724 /**
725  * The priority level imposes a bound on the maximum
726  * value for the ttl that can be requested.
727  *
728  * @param ttl_in requested ttl
729  * @param prio given priority
730  * @return ttl_in if ttl_in is below the limit,
731  *         otherwise the ttl-limit for the given priority
732  */
733 static int32_t
734 bound_ttl (int32_t ttl_in, uint32_t prio)
735 {
736   unsigned long long allowed;
737
738   if (ttl_in <= 0)
739     return ttl_in;
740   allowed = ((unsigned long long) prio) * TTL_DECREMENT / 1000; 
741   if (ttl_in > allowed)      
742     {
743       if (allowed >= (1 << 30))
744         return 1 << 30;
745       return allowed;
746     }
747   return ttl_in;
748 }
749
750
751 /**
752  * Handle P2P "QUERY" message.  Creates the pending request entry
753  * and sets up all of the data structures to that we will
754  * process replies properly.  Does not initiate forwarding or
755  * local database lookups.
756  *
757  * @param other the other peer involved (sender or receiver, NULL
758  *        for loopback messages where we are both sender and receiver)
759  * @param message the actual message
760  * @return pending request handle, NULL on error
761  */
762 struct GSF_PendingRequest *
763 GSF_handle_p2p_query_ (const struct GNUNET_PeerIdentity *other,
764                        const struct GNUNET_MessageHeader *message)
765 {
766   struct GSF_PendingRequest *pr;
767   struct GSF_PendingRequestData *prd;
768   struct GSF_ConnectedPeer *cp;
769   struct GSF_ConnectedPeer *cps;
770   const GNUNET_HashCode *namespace;
771   const struct GNUNET_PeerIdentity *target;
772   enum GSF_PendingRequestOptions options;                            
773   uint16_t msize;
774   const struct GetMessage *gm;
775   unsigned int bits;
776   const GNUNET_HashCode *opt;
777   uint32_t bm;
778   size_t bfsize;
779   uint32_t ttl_decrement;
780   int32_t priority;
781   int32_t ttl;
782   enum GNUNET_BLOCK_Type type;
783   GNUNET_PEER_Id spid;
784
785   msize = ntohs(message->size);
786   if (msize < sizeof (struct GetMessage))
787     {
788       GNUNET_break_op (0);
789       return NULL;
790     }
791   gm = (const struct GetMessage*) message;
792 #if DEBUG_FS
793   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
794               "Received request for `%s'\n",
795               GNUNET_h2s (&gm->query));
796 #endif
797   type = ntohl (gm->type);
798   bm = ntohl (gm->hash_bitmap);
799   bits = 0;
800   while (bm > 0)
801     {
802       if (1 == (bm & 1))
803         bits++;
804       bm >>= 1;
805     }
806   if (msize < sizeof (struct GetMessage) + bits * sizeof (GNUNET_HashCode))
807     {
808       GNUNET_break_op (0);
809       return NULL;
810     }  
811   opt = (const GNUNET_HashCode*) &gm[1];
812   bfsize = msize - sizeof (struct GetMessage) - bits * sizeof (GNUNET_HashCode);
813   /* bfsize must be power of 2, check! */
814   if (0 != ( (bfsize - 1) & bfsize))
815     {
816       GNUNET_break_op (0);
817       return NULL;
818     }
819   GSF_cover_query_count++;
820   bm = ntohl (gm->hash_bitmap);
821   bits = 0;
822   cps = GNUNET_CONTAINER_multihashmap_get (cp_map,
823                                            &other->hashPubKey);
824   if (NULL == cps)
825     {
826       /* peer must have just disconnected */
827       GNUNET_STATISTICS_update (GSF_stats,
828                                 gettext_noop ("# requests dropped due to initiator not being connected"),
829                                 1,
830                                 GNUNET_NO);
831       return NULL;
832     }
833   if (0 != (bm & GET_MESSAGE_BIT_RETURN_TO))
834     cp = GNUNET_CONTAINER_multihashmap_get (cp_map,
835                                             &opt[bits++]);
836   else
837     cp = cps;
838   if (cp == NULL)
839     {
840 #if DEBUG_FS
841       if (0 != (bm & GET_MESSAGE_BIT_RETURN_TO))
842         GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
843                     "Failed to find RETURN-TO peer `%4s' in connection set. Dropping query.\n",
844                     GNUNET_i2s ((const struct GNUNET_PeerIdentity*) &opt[bits-1]));
845       
846       else
847         GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
848                     "Failed to find peer `%4s' in connection set. Dropping query.\n",
849                     GNUNET_i2s (other));
850 #endif
851       GNUNET_STATISTICS_update (GSF_stats,
852                                 gettext_noop ("# requests dropped due to missing reverse route"),
853                                 1,
854                                 GNUNET_NO);
855       return NULL;
856     }
857   /* note that we can really only check load here since otherwise
858      peers could find out that we are overloaded by not being
859      disconnected after sending us a malformed query... */
860   priority = bound_priority (ntohl (gm->priority), cps);
861   if (priority < 0)
862     {
863 #if DEBUG_FS
864       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
865                   "Dropping query from `%s', this peer is too busy.\n",
866                   GNUNET_i2s (other));
867 #endif
868       return NULL;
869     }
870 #if DEBUG_FS 
871   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
872               "Received request for `%s' of type %u from peer `%4s' with flags %u\n",
873               GNUNET_h2s (&gm->query),
874               (unsigned int) type,
875               GNUNET_i2s (other),
876               (unsigned int) bm);
877 #endif
878   namespace = (0 != (bm & GET_MESSAGE_BIT_SKS_NAMESPACE)) ? &opt[bits++] : NULL;
879   target = (0 != (bm & GET_MESSAGE_BIT_TRANSMIT_TO)) ? ((const struct GNUNET_PeerIdentity*) &opt[bits++]) : NULL;
880   options = 0;
881   spid = 0;
882   if ( (GNUNET_LOAD_get_load (cp->ppd.transmission_delay) > 3 * (1 + priority)) ||
883        (GNUNET_LOAD_get_average (cp->ppd.transmission_delay) > 
884         GNUNET_CONSTANTS_MAX_CORK_DELAY.rel_value * 2 + GNUNET_LOAD_get_average (GSF_rt_entry_lifetime)) )
885     {
886       /* don't have BW to send to peer, or would likely take longer than we have for it,
887          so at best indirect the query */
888       priority = 0;
889       options |= GSF_PRO_FORWARD_ONLY;
890       spid = GNUNET_PEER_intern (other);
891     }
892   ttl = bound_ttl (ntohl (gm->ttl), priority);
893   /* decrement ttl (always) */
894   ttl_decrement = 2 * TTL_DECREMENT +
895     GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK,
896                               TTL_DECREMENT);
897   if ( (ttl < 0) &&
898        (((int32_t)(ttl - ttl_decrement)) > 0) )
899     {
900 #if DEBUG_FS
901       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
902                   "Dropping query from `%s' due to TTL underflow (%d - %u).\n",
903                   GNUNET_i2s (other),
904                   ttl,
905                   ttl_decrement);
906 #endif
907       GNUNET_STATISTICS_update (GSF_stats,
908                                 gettext_noop ("# requests dropped due TTL underflow"),
909                                 1,
910                                 GNUNET_NO);
911       /* integer underflow => drop (should be very rare)! */      
912       return NULL;
913     } 
914   ttl -= ttl_decrement;
915
916   /* test if the request already exists */
917   pr = GNUNET_CONTAINER_multihashmap_get (cp->request_map,
918                                           &gm->query);
919   if (pr != NULL) 
920     {      
921       prd = GSF_pending_request_get_data_ (pr);
922       if ( (prd->type == type) &&
923            ( (type != GNUNET_BLOCK_TYPE_FS_SBLOCK) ||
924              (0 == memcmp (&prd->namespace,
925                            namespace,
926                            sizeof (GNUNET_HashCode))) ) )
927         {
928           if (prd->ttl.abs_value >= GNUNET_TIME_absolute_get().abs_value + ttl)
929             {
930               /* existing request has higher TTL, drop new one! */
931               prd->priority += priority;
932 #if DEBUG_FS
933               GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
934                           "Have existing request with higher TTL, dropping new request.\n",
935                           GNUNET_i2s (other));
936 #endif
937               GNUNET_STATISTICS_update (GSF_stats,
938                                         gettext_noop ("# requests dropped due to higher-TTL request"),
939                                         1,
940                                         GNUNET_NO);
941               return NULL;
942             }
943           /* existing request has lower TTL, drop old one! */
944           priority += prd->priority;
945           GSF_pending_request_cancel_ (pr);
946           GNUNET_assert (GNUNET_YES ==
947                          GNUNET_CONTAINER_multihashmap_remove (cp->request_map,
948                                                                &gm->query,
949                                                                pr));
950         }
951     }
952   
953   pr = GSF_pending_request_create_ (options,
954                                     type,
955                                     &gm->query,
956                                     namespace,
957                                     target,
958                                     (bfsize > 0) ? (const char*)&opt[bits] : NULL,
959                                     bfsize,
960                                     ntohl (gm->filter_mutator),
961                                     1 /* anonymity */,
962                                     (uint32_t) priority,
963                                     ttl,
964                                     spid,
965                                     NULL, 0, /* replies_seen */
966                                     &handle_p2p_reply,
967                                     cp);
968   GNUNET_break (GNUNET_OK ==
969                 GNUNET_CONTAINER_multihashmap_put (cp->request_map,
970                                                    &gm->query,
971                                                    pr,
972                                                    GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE));
973   GNUNET_STATISTICS_update (GSF_stats,
974                             gettext_noop ("# P2P searches received"),
975                             1,
976                             GNUNET_NO);
977   GNUNET_STATISTICS_update (GSF_stats,
978                             gettext_noop ("# P2P searches active"),
979                             1,
980                             GNUNET_NO);
981   return pr;
982 }
983
984
985 /**
986  * Function called if there has been a timeout trying to satisfy
987  * a transmission request.
988  *
989  * @param cls the 'struct GSF_PeerTransmitHandle' of the request 
990  * @param tc scheduler context
991  */
992 static void
993 peer_transmit_timeout (void *cls,
994                        const struct GNUNET_SCHEDULER_TaskContext *tc)
995 {
996   struct GSF_PeerTransmitHandle *pth = cls;
997   struct GSF_ConnectedPeer *cp;
998   
999   pth->timeout_task = GNUNET_SCHEDULER_NO_TASK;
1000   cp = pth->cp;
1001   GNUNET_CONTAINER_DLL_remove (cp->pth_head,
1002                                cp->pth_tail,
1003                                pth);
1004   if (GNUNET_YES == pth->is_query)
1005     GNUNET_assert (0 < cp->ppd.pending_queries--);    
1006   else if (GNUNET_NO == pth->is_query)
1007     GNUNET_assert (0 < cp->ppd.pending_replies--);
1008   GNUNET_LOAD_update (cp->ppd.transmission_delay,
1009                       UINT64_MAX);
1010   pth->gmc (pth->gmc_cls, 
1011             0, NULL);
1012   GNUNET_free (pth);
1013 }
1014
1015
1016 /**
1017  * Transmit a message to the given peer as soon as possible.
1018  * If the peer disconnects before the transmission can happen,
1019  * the callback is invoked with a 'NULL' buffer.
1020  *
1021  * @param cp target peer
1022  * @param is_query is this a query (GNUNET_YES) or content (GNUNET_NO) or neither (GNUNET_SYSERR)
1023  * @param priority how important is this request?
1024  * @param timeout when does this request timeout (call gmc with error)
1025  * @param size number of bytes we would like to send to the peer
1026  * @param gmc function to call to get the message
1027  * @param gmc_cls closure for gmc
1028  * @return handle to cancel request
1029  */
1030 struct GSF_PeerTransmitHandle *
1031 GSF_peer_transmit_ (struct GSF_ConnectedPeer *cp,
1032                     int is_query,
1033                     uint32_t priority,
1034                     struct GNUNET_TIME_Relative timeout,
1035                     size_t size,
1036                     GSF_GetMessageCallback gmc,
1037                     void *gmc_cls)
1038 {
1039   struct GSF_PeerTransmitHandle *pth;
1040   struct GSF_PeerTransmitHandle *pos;
1041   struct GSF_PeerTransmitHandle *prev;
1042   struct GNUNET_PeerIdentity target;
1043   uint64_t ip;
1044   int is_ready;
1045
1046   pth = GNUNET_malloc (sizeof (struct GSF_PeerTransmitHandle));
1047   pth->transmission_request_start_time = GNUNET_TIME_absolute_get ();
1048   pth->timeout = GNUNET_TIME_relative_to_absolute (timeout);
1049   pth->gmc = gmc;
1050   pth->gmc_cls = gmc_cls;
1051   pth->size = size;
1052   pth->is_query = is_query;
1053   pth->priority = priority;
1054   pth->cp = cp;
1055   /* insertion sort (by priority, descending) */
1056   prev = NULL;
1057   pos = cp->pth_head;
1058   while ( (pos != NULL) &&
1059           (pos->priority > priority) )
1060     {
1061       prev = pos;
1062       pos = pos->next;
1063     }
1064   if (prev == NULL)
1065     GNUNET_CONTAINER_DLL_insert (cp->pth_head,
1066                                  cp->pth_tail,
1067                                  pth);
1068   else
1069     GNUNET_CONTAINER_DLL_insert_after (cp->pth_head,
1070                                        cp->pth_tail,
1071                                        prev,
1072                                        pth);
1073   GNUNET_PEER_resolve (cp->ppd.pid,
1074                        &target);
1075   if (GNUNET_YES == is_query)
1076     {
1077       /* query, need reservation */
1078       cp->ppd.pending_queries++;
1079       if (NULL == cp->irc)
1080         {
1081           /* reservation already done! */
1082           is_ready = GNUNET_YES;
1083           ip = cp->inc_preference;
1084           cp->inc_preference = 0;
1085           cp->irc = GNUNET_CORE_peer_change_preference (GSF_core,
1086                                                         &target,
1087                                                         GNUNET_TIME_UNIT_FOREVER_REL,
1088                                                         GNUNET_BANDWIDTH_VALUE_MAX,
1089                                                         DBLOCK_SIZE,
1090                                                         ip,
1091                                                         &core_reserve_callback,
1092                                                         cp);      
1093         }
1094       else
1095         {
1096           /* still waiting for reservation */
1097           is_ready = GNUNET_NO;
1098         }
1099     }
1100   else if (GNUNET_NO == is_query)
1101     {
1102       /* no reservation needed for content */
1103       cp->ppd.pending_replies++;
1104       is_ready = GNUNET_YES;
1105     }
1106   else
1107     {
1108       /* not a query or content, no reservation needed */
1109       is_ready = GNUNET_YES;
1110     }
1111   if (is_ready)
1112     {
1113       pth->cth = GNUNET_CORE_notify_transmit_ready (GSF_core,
1114                                                     GNUNET_YES,
1115                                                     priority,
1116                                                     timeout,
1117                                                     &target,
1118                                                     size,
1119                                                     &peer_transmit_ready_cb,
1120                                                     pth);
1121       /* pth->cth could be NULL here, that's OK, we'll try again
1122          later... */
1123     }
1124   if (pth->cth == NULL)
1125     {
1126       /* if we're waiting for reservation OR if we could not do notify_transmit_ready,
1127          install a timeout task to be on the safe side */
1128       pth->timeout_task = GNUNET_SCHEDULER_add_delayed (timeout,
1129                                                         &peer_transmit_timeout,
1130                                                         pth);
1131     }
1132   return pth;
1133 }
1134
1135
1136 /**
1137  * Cancel an earlier request for transmission.
1138  *
1139  * @param pth request to cancel
1140  */
1141 void
1142 GSF_peer_transmit_cancel_ (struct GSF_PeerTransmitHandle *pth)
1143 {
1144   struct GSF_ConnectedPeer *cp;
1145
1146   if (pth->timeout_task != GNUNET_SCHEDULER_NO_TASK)
1147     {
1148       GNUNET_SCHEDULER_cancel (pth->timeout_task);
1149       pth->timeout_task = GNUNET_SCHEDULER_NO_TASK;
1150     }
1151   if (NULL != pth->cth)
1152     {
1153       GNUNET_CORE_notify_transmit_ready_cancel (pth->cth);
1154       pth->cth = NULL;
1155     }
1156   cp = pth->cp;
1157   GNUNET_CONTAINER_DLL_remove (cp->pth_head,
1158                                cp->pth_tail,
1159                                pth);
1160   if (GNUNET_YES == pth->is_query)
1161     GNUNET_assert (0 < cp->ppd.pending_queries--);    
1162   else if (GNUNET_NO == pth->is_query)
1163     GNUNET_assert (0 < cp->ppd.pending_replies--);
1164   GNUNET_free (pth);
1165 }
1166
1167
1168 /**
1169  * Report on receiving a reply; update the performance record of the given peer.
1170  *
1171  * @param cp responding peer (will be updated)
1172  * @param request_time time at which the original query was transmitted
1173  * @param request_priority priority of the original request
1174  */
1175 void
1176 GSF_peer_update_performance_ (struct GSF_ConnectedPeer *cp,
1177                               struct GNUNET_TIME_Absolute request_time,
1178                               uint32_t request_priority)
1179 {
1180   struct GNUNET_TIME_Relative delay;
1181
1182   delay = GNUNET_TIME_absolute_get_duration (request_time);  
1183   cp->ppd.avg_reply_delay.rel_value = (cp->ppd.avg_reply_delay.rel_value * (RUNAVG_DELAY_N-1) + delay.rel_value) / RUNAVG_DELAY_N;
1184   cp->ppd.avg_priority = (cp->ppd.avg_priority * (RUNAVG_DELAY_N-1) + request_priority) / RUNAVG_DELAY_N;
1185 }
1186
1187
1188 /**
1189  * Report on receiving a reply in response to an initiating client.
1190  * Remember that this peer is good for this client.
1191  *
1192  * @param cp responding peer (will be updated)
1193  * @param initiator_client local client on responsible for query
1194  */
1195 void
1196 GSF_peer_update_responder_client_ (struct GSF_ConnectedPeer *cp,
1197                                    struct GSF_LocalClient *initiator_client)
1198 {
1199   cp->ppd.last_client_replies[cp->last_client_replies_woff++ % CS2P_SUCCESS_LIST_SIZE] = initiator_client;
1200 }
1201
1202
1203 /**
1204  * Report on receiving a reply in response to an initiating peer.
1205  * Remember that this peer is good for this initiating peer.
1206  *
1207  * @param cp responding peer (will be updated)
1208  * @param initiator_peer other peer responsible for query
1209  */
1210 void
1211 GSF_peer_update_responder_peer_ (struct GSF_ConnectedPeer *cp,
1212                                  const struct GSF_ConnectedPeer *initiator_peer)
1213 {
1214   GNUNET_PEER_change_rc (cp->ppd.last_p2p_replies[cp->last_p2p_replies_woff % P2P_SUCCESS_LIST_SIZE], -1);
1215   cp->ppd.last_p2p_replies[cp->last_p2p_replies_woff++ % P2P_SUCCESS_LIST_SIZE] = initiator_peer->ppd.pid;
1216   GNUNET_PEER_change_rc (initiator_peer->ppd.pid, 1);
1217 }
1218
1219
1220 /**
1221  * Method called whenever a given peer has a status change.
1222  *
1223  * @param cls closure
1224  * @param peer peer identity this notification is about
1225  * @param bandwidth_in available amount of inbound bandwidth
1226  * @param bandwidth_out available amount of outbound bandwidth
1227  * @param timeout absolute time when this peer will time out
1228  *        unless we see some further activity from it
1229  * @param atsi status information
1230  */
1231 void
1232 GSF_peer_status_handler_ (void *cls,
1233                           const struct GNUNET_PeerIdentity *peer,
1234                           struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in,
1235                           struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
1236                           struct GNUNET_TIME_Absolute timeout,
1237                           const struct GNUNET_TRANSPORT_ATS_Information *atsi)
1238 {
1239   struct GSF_ConnectedPeer *cp;
1240
1241   cp = GNUNET_CONTAINER_multihashmap_get (cp_map,
1242                                           &peer->hashPubKey);
1243   GNUNET_assert (NULL != cp);
1244   update_atsi (cp, atsi);
1245 }
1246
1247
1248 /**
1249  * Cancel all requests associated with the peer.
1250  *
1251  * @param cls unused
1252  * @param query hash code of the request
1253  * @param value the 'struct GSF_PendingRequest'
1254  * @return GNUNET_YES (continue to iterate)
1255  */
1256 static int
1257 cancel_pending_request (void *cls,
1258                         const GNUNET_HashCode *query,
1259                         void *value)
1260 {
1261   struct GSF_PendingRequest *pr = value;
1262
1263   GSF_pending_request_cancel_ (pr);
1264   return GNUNET_OK;
1265 }
1266
1267
1268 /**
1269  * A peer disconnected from us.  Tear down the connected peer
1270  * record.
1271  *
1272  * @param cls unused
1273  * @param peer identity of peer that connected
1274  */
1275 void
1276 GSF_peer_disconnect_handler_ (void *cls,
1277                               const struct GNUNET_PeerIdentity *peer)
1278 {
1279   struct GSF_ConnectedPeer *cp;
1280   struct GSF_PeerTransmitHandle *pth;
1281
1282   cp = GNUNET_CONTAINER_multihashmap_get (cp_map,
1283                                           &peer->hashPubKey);
1284   if (NULL == cp)
1285     return; /* must have been disconnect from core with
1286                'peer' == my_id, ignore */
1287   GNUNET_CONTAINER_multihashmap_remove (cp_map,
1288                                         &peer->hashPubKey,
1289                                         cp);
1290   if (NULL != cp->migration_pth)
1291     {
1292       GSF_peer_transmit_cancel_ (cp->migration_pth);
1293       cp->migration_pth = NULL;
1294     }
1295   if (NULL != cp->irc)
1296     {
1297       GNUNET_CORE_peer_change_preference_cancel (cp->irc);
1298       cp->irc = NULL;
1299     }
1300   GNUNET_CONTAINER_multihashmap_iterate (cp->request_map,
1301                                          &cancel_pending_request,
1302                                          cp);
1303   GNUNET_CONTAINER_multihashmap_destroy (cp->request_map);
1304   cp->request_map = NULL;
1305   GSF_plan_notify_peer_disconnect_ (cp);
1306   GNUNET_LOAD_value_free (cp->ppd.transmission_delay);
1307   GNUNET_PEER_decrement_rcs (cp->ppd.last_p2p_replies, P2P_SUCCESS_LIST_SIZE);
1308   while (NULL != (pth = cp->pth_head))
1309     {
1310       if (NULL != pth->cth)
1311         {
1312           GNUNET_CORE_notify_transmit_ready_cancel (pth->cth);
1313           pth->cth = NULL;
1314         }
1315       GNUNET_CONTAINER_DLL_remove (cp->pth_head,
1316                                    cp->pth_tail,
1317                                    pth);
1318       GNUNET_free (pth);
1319     }
1320   GNUNET_PEER_change_rc (cp->ppd.pid, -1);
1321   if (GNUNET_SCHEDULER_NO_TASK != cp->mig_revive_task)
1322     {
1323       GNUNET_SCHEDULER_cancel (cp->mig_revive_task);
1324       cp->mig_revive_task = GNUNET_SCHEDULER_NO_TASK;
1325     }
1326   GNUNET_free (cp);
1327 }
1328
1329
1330 /**
1331  * Closure for 'call_iterator'.
1332  */
1333 struct IterationContext
1334 {
1335   /**
1336    * Function to call on each entry.
1337    */
1338   GSF_ConnectedPeerIterator it;
1339
1340   /**
1341    * Closure for 'it'.
1342    */
1343   void *it_cls;
1344 };
1345
1346
1347 /**
1348  * Function that calls the callback for each peer.
1349  *
1350  * @param cls the 'struct IterationContext*'
1351  * @param key identity of the peer
1352  * @param value the 'struct GSF_ConnectedPeer*'
1353  * @return GNUNET_YES to continue iteration
1354  */
1355 static int
1356 call_iterator (void *cls,
1357                const GNUNET_HashCode *key,
1358                void *value)
1359 {
1360   struct IterationContext *ic = cls;
1361   struct GSF_ConnectedPeer *cp = value;
1362   
1363   ic->it (ic->it_cls,
1364           (const struct GNUNET_PeerIdentity*) key,
1365           cp,
1366           &cp->ppd);
1367   return GNUNET_YES;
1368 }
1369
1370
1371 /**
1372  * Iterate over all connected peers.
1373  *
1374  * @param it function to call for each peer
1375  * @param it_cls closure for it
1376  */
1377 void
1378 GSF_iterate_connected_peers_ (GSF_ConnectedPeerIterator it,
1379                               void *it_cls)
1380 {
1381   struct IterationContext ic;
1382
1383   ic.it = it;
1384   ic.it_cls = it_cls;
1385   GNUNET_CONTAINER_multihashmap_iterate (cp_map,
1386                                          &call_iterator,
1387                                          &ic);
1388 }
1389
1390
1391 /**
1392  * Obtain the identity of a connected peer.
1393  *
1394  * @param cp peer to reserve bandwidth from
1395  * @param id identity to set (written to)
1396  */
1397 void
1398 GSF_connected_peer_get_identity_ (const struct GSF_ConnectedPeer *cp,
1399                                   struct GNUNET_PeerIdentity *id)
1400 {
1401   GNUNET_PEER_resolve (cp->ppd.pid,
1402                        id);
1403 }
1404
1405
1406 /**
1407  * Assemble a migration stop message for transmission.
1408  *
1409  * @param cls the 'struct GSF_ConnectedPeer' to use
1410  * @param size number of bytes we're allowed to write to buf
1411  * @param buf where to copy the message
1412  * @return number of bytes copied to buf
1413  */
1414 static size_t
1415 create_migration_stop_message (void *cls,
1416                                size_t size,
1417                                void *buf)
1418 {
1419   struct GSF_ConnectedPeer *cp = cls;
1420   struct MigrationStopMessage msm;
1421
1422   cp->migration_pth = NULL;
1423   if (NULL == buf)
1424     return 0;
1425   GNUNET_assert (size > sizeof (struct MigrationStopMessage));
1426   msm.header.size = htons (sizeof (struct MigrationStopMessage));
1427   msm.header.type = htons (GNUNET_MESSAGE_TYPE_FS_MIGRATION_STOP);
1428   msm.duration = GNUNET_TIME_relative_hton (GNUNET_TIME_absolute_get_remaining (cp->last_migration_block));
1429   memcpy (buf, &msm, sizeof (struct MigrationStopMessage));
1430   return sizeof (struct MigrationStopMessage);
1431 }
1432
1433
1434 /**
1435  * Ask a peer to stop migrating data to us until the given point
1436  * in time.
1437  * 
1438  * @param cp peer to ask
1439  * @param block_time until when to block
1440  */
1441 void
1442 GSF_block_peer_migration_ (struct GSF_ConnectedPeer *cp,
1443                            struct GNUNET_TIME_Relative block_time)
1444 {
1445   if (GNUNET_TIME_absolute_get_duration (cp->last_migration_block).rel_value > block_time.rel_value)
1446     return; /* already blocked */
1447   cp->last_migration_block = GNUNET_TIME_relative_to_absolute (block_time);
1448   if (cp->migration_pth != NULL)
1449     GSF_peer_transmit_cancel_ (cp->migration_pth);
1450   cp->migration_pth 
1451     = GSF_peer_transmit_ (cp,
1452                           GNUNET_SYSERR,
1453                           UINT32_MAX,
1454                           GNUNET_TIME_UNIT_FOREVER_REL,
1455                           sizeof (struct MigrationStopMessage),
1456                           &create_migration_stop_message,
1457                           cp);
1458 }
1459
1460
1461 /**
1462  * Write host-trust information to a file - flush the buffer entry!
1463  *
1464  * @param cls closure, not used
1465  * @param key host identity
1466  * @param value the 'struct GSF_ConnectedPeer' to flush
1467  * @return GNUNET_OK to continue iteration
1468  */
1469 static int
1470 flush_trust (void *cls,
1471              const GNUNET_HashCode *key,
1472              void *value)
1473 {
1474   struct GSF_ConnectedPeer *cp = value;
1475   char *fn;
1476   uint32_t trust;
1477   struct GNUNET_PeerIdentity pid;
1478
1479   if (cp->ppd.trust == cp->disk_trust)
1480     return GNUNET_OK;                     /* unchanged */
1481   GNUNET_PEER_resolve (cp->ppd.pid,
1482                        &pid);
1483   fn = get_trust_filename (&pid);
1484   if (cp->ppd.trust == 0)
1485     {
1486       if ((0 != UNLINK (fn)) && (errno != ENOENT))
1487         GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING |
1488                                   GNUNET_ERROR_TYPE_BULK, "unlink", fn);
1489     }
1490   else
1491     {
1492       trust = htonl (cp->ppd.trust);
1493       if (sizeof(uint32_t) == GNUNET_DISK_fn_write (fn, &trust, 
1494                                                     sizeof(uint32_t),
1495                                                     GNUNET_DISK_PERM_USER_READ | GNUNET_DISK_PERM_USER_WRITE
1496                                                     | GNUNET_DISK_PERM_GROUP_READ | GNUNET_DISK_PERM_OTHER_READ))
1497         cp->disk_trust = cp->ppd.trust;
1498     }
1499   GNUNET_free (fn);
1500   return GNUNET_OK;
1501 }
1502
1503
1504 /**
1505  * Notify core about a preference we have for the given peer
1506  * (to allocate more resources towards it).  The change will
1507  * be communicated the next time we reserve bandwidth with
1508  * core (not instantly).
1509  *
1510  * @param cp peer to reserve bandwidth from
1511  * @param pref preference change
1512  */
1513 void
1514 GSF_connected_peer_change_preference_ (struct GSF_ConnectedPeer *cp,
1515                                        uint64_t pref)
1516 {
1517   cp->inc_preference += pref;
1518 }
1519
1520
1521 /**
1522  * Call this method periodically to flush trust information to disk.
1523  *
1524  * @param cls closure, not used
1525  * @param tc task context, not used
1526  */
1527 static void
1528 cron_flush_trust (void *cls,
1529                   const struct GNUNET_SCHEDULER_TaskContext *tc)
1530 {
1531
1532   if (NULL == cp_map)
1533     return;
1534   GNUNET_CONTAINER_multihashmap_iterate (cp_map,
1535                                          &flush_trust,
1536                                          NULL);
1537   if (NULL == tc)
1538     return;
1539   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
1540     return;
1541   GNUNET_SCHEDULER_add_delayed (TRUST_FLUSH_FREQ, 
1542                                 &cron_flush_trust, 
1543                                 NULL);
1544 }
1545
1546
1547 /**
1548  * Initialize peer management subsystem.
1549  */
1550 void
1551 GSF_connected_peer_init_ ()
1552 {
1553   cp_map = GNUNET_CONTAINER_multihashmap_create (128);
1554   GNUNET_assert (GNUNET_OK ==
1555                  GNUNET_CONFIGURATION_get_value_filename (GSF_cfg,
1556                                                           "fs",
1557                                                           "TRUST",
1558                                                           &trustDirectory));
1559   GNUNET_DISK_directory_create (trustDirectory);
1560   GNUNET_SCHEDULER_add_with_priority (GNUNET_SCHEDULER_PRIORITY_HIGH,
1561                                       &cron_flush_trust, NULL);
1562 }
1563
1564
1565 /**
1566  * Iterator to free peer entries.
1567  *
1568  * @param cls closure, unused
1569  * @param key current key code
1570  * @param value value in the hash map (peer entry)
1571  * @return GNUNET_YES (we should continue to iterate)
1572  */
1573 static int 
1574 clean_peer (void *cls,
1575             const GNUNET_HashCode * key,
1576             void *value)
1577 {
1578   GSF_peer_disconnect_handler_ (NULL, 
1579                                 (const struct GNUNET_PeerIdentity*) key);
1580   return GNUNET_YES;
1581 }
1582
1583
1584 /**
1585  * Shutdown peer management subsystem.
1586  */
1587 void
1588 GSF_connected_peer_done_ ()
1589 {
1590   cron_flush_trust (NULL, NULL);
1591   GNUNET_CONTAINER_multihashmap_iterate (cp_map,
1592                                          &clean_peer,
1593                                          NULL);
1594   GNUNET_CONTAINER_multihashmap_destroy (cp_map);
1595   cp_map = NULL;
1596   GNUNET_free (trustDirectory);
1597   trustDirectory = NULL;
1598 }
1599
1600
1601 /**
1602  * Iterator to remove references to LC entry.
1603  *
1604  * @param cls the 'struct GSF_LocalClient*' to look for
1605  * @param key current key code
1606  * @param value value in the hash map (peer entry)
1607  * @return GNUNET_YES (we should continue to iterate)
1608  */
1609 static int 
1610 clean_local_client (void *cls,
1611                     const GNUNET_HashCode * key,
1612                     void *value)
1613 {
1614   const struct GSF_LocalClient *lc = cls;
1615   struct GSF_ConnectedPeer *cp = value;
1616   unsigned int i;
1617
1618   for (i=0;i<CS2P_SUCCESS_LIST_SIZE;i++)
1619     if (cp->ppd.last_client_replies[i] == lc)
1620       cp->ppd.last_client_replies[i] = NULL;
1621   return GNUNET_YES;
1622 }
1623
1624
1625 /**
1626  * Notification that a local client disconnected.  Clean up all of our
1627  * references to the given handle.
1628  *
1629  * @param lc handle to the local client (henceforth invalid)
1630  */
1631 void
1632 GSF_handle_local_client_disconnect_ (const struct GSF_LocalClient *lc)
1633 {
1634   if (NULL == cp_map)
1635     return; /* already cleaned up */
1636   GNUNET_CONTAINER_multihashmap_iterate (cp_map,
1637                                          &clean_local_client,
1638                                          (void*) lc);
1639 }
1640
1641
1642 /* end of gnunet-service-fs_cp.c */