src/core/gnunet-service-core_sessions.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2009-2013 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 core/gnunet-service-core_sessions.c
  23  * @brief code for managing of 'encrypted' sessions (key exchange done)
  24  * @author Christian Grothoff
  25  */
  26 #include "platform.h"
  27 #include "gnunet-service-core.h"
  28 #include "gnunet-service-core_neighbours.h"
  29 #include "gnunet-service-core_kx.h"
  30 #include "gnunet-service-core_typemap.h"
  31 #include "gnunet-service-core_sessions.h"
  32 #include "gnunet-service-core_clients.h"
  33 #include "gnunet_constants.h"
  34
  35 /**
  36  * How often do we transmit our typemap?
  37  */
  38 #define TYPEMAP_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 5)
  39
  40 /**
  41  * How often do we transmit our typemap on first attempt?
  42  */
  43 #define TYPEMAP_FREQUENCY_FIRST GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 5)
  44
  45
  46 /**
  47  * Message ready for encryption.  This struct is followed by the
  48  * actual content of the message.
  49  */
  50 struct SessionMessageEntry
  51 {
  52
  53   /**
  54    * We keep messages in a doubly linked list.
  55    */
  56   struct SessionMessageEntry *next;
  57
  58   /**
  59    * We keep messages in a doubly linked list.
  60    */
  61   struct SessionMessageEntry *prev;
  62
  63   /**
  64    * Deadline for transmission, 1s after we received it (if we
  65    * are not corking), otherwise "now".  Note that this message
  66    * does NOT expire past its deadline.
  67    */
  68   struct GNUNET_TIME_Absolute deadline;
  69
  70   /**
  71    * How long is the message? (number of bytes following the "struct
  72    * MessageEntry", but not including the size of "struct
  73    * MessageEntry" itself!)
  74    */
  75   size_t size;
  76
  77 };
  78
  79
  80 /**
  81  * Data kept per session.
  82  */
  83 struct Session
  84 {
  85   /**
  86    * Identity of the other peer.
  87    */
  88   struct GNUNET_PeerIdentity peer;
  89
  90   /**
  91    * Head of list of requests from clients for transmission to
  92    * this peer.
  93    */
  94   struct GSC_ClientActiveRequest *active_client_request_head;
  95
  96   /**
  97    * Tail of list of requests from clients for transmission to
  98    * this peer.
  99    */
 100   struct GSC_ClientActiveRequest *active_client_request_tail;
 101
 102   /**
 103    * Head of list of messages ready for encryption.
 104    */
 105   struct SessionMessageEntry *sme_head;
 106
 107   /**
 108    * Tail of list of messages ready for encryption.
 109    */
 110   struct SessionMessageEntry *sme_tail;
 111
 112   /**
 113    * Information about the key exchange with the other peer.
 114    */
 115   struct GSC_KeyExchangeInfo *kxinfo;
 116
 117   /**
 118    * Current type map for this peer.
 119    */
 120   struct GSC_TypeMap *tmap;
 121
 122   /**
 123    * Task to transmit corked messages with a delay.
 124    */
 125   GNUNET_SCHEDULER_TaskIdentifier cork_task;
 126
 127   /**
 128    * Task to transmit our type map.
 129    */
 130   GNUNET_SCHEDULER_TaskIdentifier typemap_task;
 131
 132   /**
 133    * Is the neighbour queue empty and thus ready for us
 134    * to transmit an encrypted message?
 135    */
 136   int ready_to_transmit;
 137
 138   /**
 139    * Is this the first time we're sending the typemap? If so,
 140    * we want to send it a bit faster the second time.  0 if
 141    * we are sending for the first time, 1 if not.
 142    */
 143   int first_typemap;
 144 };
 145
 146
 147 /**
 148  * Map of peer identities to 'struct Session'.
 149  */
 150 static struct GNUNET_CONTAINER_MultiHashMap *sessions;
 151
 152
 153 /**
 154  * Find the session for the given peer.
 155  *
 156  * @param peer identity of the peer
 157  * @return NULL if we are not connected, otherwise the
 158  *         session handle
 159  */
 160 static struct Session *
 161 find_session (const struct GNUNET_PeerIdentity *peer)
 162 {
 163   return GNUNET_CONTAINER_multihashmap_get (sessions, &peer->hashPubKey);
 164 }
 165
 166
 167 /**
 168  * End the session with the given peer (we are no longer
 169  * connected).
 170  *
 171  * @param pid identity of peer to kill session with
 172  */
 173 void
 174 GSC_SESSIONS_end (const struct GNUNET_PeerIdentity *pid)
 175 {
 176   struct Session *session;
 177   struct GSC_ClientActiveRequest *car;
 178   struct SessionMessageEntry *sme;
 179
 180   session = find_session (pid);
 181   if (NULL == session)
 182     return;
 183   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Destroying session for peer `%4s'\n",
 184               GNUNET_i2s (&session->peer));
 185   if (GNUNET_SCHEDULER_NO_TASK != session->cork_task)
 186   {
 187     GNUNET_SCHEDULER_cancel (session->cork_task);
 188     session->cork_task = GNUNET_SCHEDULER_NO_TASK;
 189   }
 190   while (NULL != (car = session->active_client_request_head))
 191   {
 192     GNUNET_CONTAINER_DLL_remove (session->active_client_request_head,
 193                                  session->active_client_request_tail, car);
 194     GSC_CLIENTS_reject_request (car);
 195   }
 196   while (NULL != (sme = session->sme_head))
 197   {
 198     GNUNET_CONTAINER_DLL_remove (session->sme_head, session->sme_tail, sme);
 199     GNUNET_free (sme);
 200   }
 201   GNUNET_SCHEDULER_cancel (session->typemap_task);
 202   GSC_CLIENTS_notify_clients_about_neighbour (&session->peer,
 203                                               session->tmap, NULL);
 204   GNUNET_assert (GNUNET_YES ==
 205                  GNUNET_CONTAINER_multihashmap_remove (sessions,
 206                                                        &session->
 207                                                        peer.hashPubKey,
 208                                                        session));
 209   GNUNET_STATISTICS_set (GSC_stats, gettext_noop ("# peers connected"),
 210                          GNUNET_CONTAINER_multihashmap_size (sessions),
 211                          GNUNET_NO);
 212   GSC_TYPEMAP_destroy (session->tmap);
 213   session->tmap = NULL;
 214   GNUNET_free (session);
 215 }
 216
 217
 218 /**
 219  * Transmit our current typemap message to the other peer.
 220  * (Done periodically in case an update got lost).
 221  *
 222  * @param cls the 'struct Session*'
 223  * @param tc unused
 224  */
 225 static void
 226 transmit_typemap_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 227 {
 228   struct Session *session = cls;
 229   struct GNUNET_MessageHeader *hdr;
 230   struct GNUNET_TIME_Relative delay;
 231
 232   if (0 == session->first_typemap)
 233   {
 234     delay = TYPEMAP_FREQUENCY_FIRST;
 235     session->first_typemap = 1;
 236   }
 237   else
 238   {
 239     delay = TYPEMAP_FREQUENCY;
 240   }
 241   /* randomize a bit to avoid spont. sync */
 242   delay.rel_value_us +=
 243       GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, 1000 * 1000);
 244   session->typemap_task =
 245       GNUNET_SCHEDULER_add_delayed (delay, &transmit_typemap_task, session);
 246   GNUNET_STATISTICS_update (GSC_stats,
 247                             gettext_noop ("# type map refreshes sent"), 1,
 248                             GNUNET_NO);
 249   hdr = GSC_TYPEMAP_compute_type_map_message ();
 250   GSC_KX_encrypt_and_transmit (session->kxinfo, hdr, ntohs (hdr->size));
 251   GNUNET_free (hdr);
 252 }
 253
 254
 255 /**
 256  * Create a session, a key exchange was just completed.
 257  *
 258  * @param peer peer that is now connected
 259  * @param kx key exchange that completed
 260  */
 261 void
 262 GSC_SESSIONS_create (const struct GNUNET_PeerIdentity *peer,
 263                      struct GSC_KeyExchangeInfo *kx)
 264 {
 265   struct Session *session;
 266
 267   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Creating session for peer `%4s'\n",
 268               GNUNET_i2s (peer));
 269   session = GNUNET_malloc (sizeof (struct Session));
 270   session->tmap = GSC_TYPEMAP_create ();
 271   session->peer = *peer;
 272   session->kxinfo = kx;
 273   session->typemap_task =
 274       GNUNET_SCHEDULER_add_now (&transmit_typemap_task, session);
 275   GNUNET_assert (GNUNET_OK ==
 276                  GNUNET_CONTAINER_multihashmap_put (sessions, &peer->hashPubKey,
 277                                                     session,
 278                                                     GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY));
 279   GNUNET_STATISTICS_set (GSC_stats, gettext_noop ("# peers connected"),
 280                          GNUNET_CONTAINER_multihashmap_size (sessions),
 281                          GNUNET_NO);
 282   GSC_CLIENTS_notify_clients_about_neighbour (peer,
 283                                               NULL, session->tmap);
 284 }
 285
 286
 287 /**
 288  * Notify the given client about the session (client is new).
 289  *
 290  * @param cls the 'struct GSC_Client'
 291  * @param key peer identity
 292  * @param value the 'struct Session'
 293  * @return GNUNET_OK (continue to iterate)
 294  */
 295 static int
 296 notify_client_about_session (void *cls, const struct GNUNET_HashCode * key,
 297                              void *value)
 298 {
 299   struct GSC_Client *client = cls;
 300   struct Session *session = value;
 301
 302   GSC_CLIENTS_notify_client_about_neighbour (client, &session->peer,
 303                                              NULL,      /* old TMAP: none */
 304                                              session->tmap);
 305   return GNUNET_OK;
 306 }
 307
 308
 309 /**
 310  * We have a new client, notify it about all current sessions.
 311  *
 312  * @param client the new client
 313  */
 314 void
 315 GSC_SESSIONS_notify_client_about_sessions (struct GSC_Client *client)
 316 {
 317   /* notify new client about existing sessions */
 318   GNUNET_CONTAINER_multihashmap_iterate (sessions, &notify_client_about_session,
 319                                          client);
 320 }
 321
 322
 323 /**
 324  * Try to perform a transmission on the given session.  Will solicit
 325  * additional messages if the 'sme' queue is not full enough.
 326  *
 327  * @param session session to transmit messages from
 328  */
 329 static void
 330 try_transmission (struct Session *session);
 331
 332
 333 /**
 334  * Queue a request from a client for transmission to a particular peer.
 335  *
 336  * @param car request to queue; this handle is then shared between
 337  *         the caller (CLIENTS subsystem) and SESSIONS and must not
 338  *         be released by either until either 'GNUNET_SESSIONS_dequeue',
 339  *         'GNUNET_SESSIONS_transmit' or 'GNUNET_CLIENTS_failed'
 340  *         have been invoked on it
 341  */
 342 void
 343 GSC_SESSIONS_queue_request (struct GSC_ClientActiveRequest *car)
 344 {
 345   struct Session *session;
 346
 347   session = find_session (&car->target);
 348   if (session == NULL)
 349   {
 350     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
 351                 "Dropped client request for transmission (am disconnected)\n");
 352     GNUNET_break (0);           /* should have been rejected earlier */
 353     GSC_CLIENTS_reject_request (car);
 354     return;
 355   }
 356   if (car->msize > GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE)
 357   {
 358     GNUNET_break (0);
 359     GSC_CLIENTS_reject_request (car);
 360     return;
 361   }
 362   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
 363               "Received client transmission request. queueing\n");
 364   GNUNET_CONTAINER_DLL_insert (session->active_client_request_head,
 365                                session->active_client_request_tail, car);
 366   try_transmission (session);
 367 }
 368
 369
 370 /**
 371  * Dequeue a request from a client from transmission to a particular peer.
 372  *
 373  * @param car request to dequeue; this handle will then be 'owned' by
 374  *        the caller (CLIENTS sysbsystem)
 375  */
 376 void
 377 GSC_SESSIONS_dequeue_request (struct GSC_ClientActiveRequest *car)
 378 {
 379   struct Session *s;
 380
 381   if (0 ==
 382       memcmp (&car->target, &GSC_my_identity,
 383               sizeof (struct GNUNET_PeerIdentity)))
 384     return;
 385   s = find_session (&car->target);
 386   GNUNET_assert (NULL != s);
 387   GNUNET_CONTAINER_DLL_remove (s->active_client_request_head,
 388                                s->active_client_request_tail, car);
 389 }
 390
 391
 392 /**
 393  * Discard all expired active transmission requests from clients.
 394  *
 395  * @param session session to clean up
 396  */
 397 static void
 398 discard_expired_requests (struct Session *session)
 399 {
 400   struct GSC_ClientActiveRequest *pos;
 401   struct GSC_ClientActiveRequest *nxt;
 402   struct GNUNET_TIME_Absolute now;
 403
 404   now = GNUNET_TIME_absolute_get ();
 405   pos = NULL;
 406   nxt = session->active_client_request_head;
 407   while (NULL != nxt)
 408   {
 409     pos = nxt;
 410     nxt = pos->next;
 411     if ((pos->deadline.abs_value_us < now.abs_value_us) &&
 412         (GNUNET_YES != pos->was_solicited))
 413     {
 414       GNUNET_STATISTICS_update (GSC_stats,
 415                                 gettext_noop
 416                                 ("# messages discarded (expired prior to transmission)"),
 417                                 1, GNUNET_NO);
 418       GNUNET_CONTAINER_DLL_remove (session->active_client_request_head,
 419                                    session->active_client_request_tail, pos);
 420       GSC_CLIENTS_reject_request (pos);
 421     }
 422   }
 423 }
 424
 425
 426 /**
 427  * Solicit messages for transmission.
 428  *
 429  * @param session session to solict messages for
 430  */
 431 static void
 432 solicit_messages (struct Session *session)
 433 {
 434   struct GSC_ClientActiveRequest *car;
 435   struct GSC_ClientActiveRequest *nxt;
 436   size_t so_size;
 437
 438   discard_expired_requests (session);
 439   so_size = 0;
 440   nxt = session->active_client_request_head;
 441   while (NULL != (car = nxt))
 442   {
 443     nxt = car->next;
 444     if (so_size + car->msize > GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE)
 445       break;
 446     so_size += car->msize;
 447     if (car->was_solicited == GNUNET_YES)
 448       continue;
 449     car->was_solicited = GNUNET_YES;
 450     GSC_CLIENTS_solicit_request (car);
 451   }
 452 }
 453
 454
 455 /**
 456  * Some messages were delayed (corked), but the timeout has now expired.
 457  * Send them now.
 458  *
 459  * @param cls 'struct Session' with the messages to transmit now
 460  * @param tc scheduler context (unused)
 461  */
 462 static void
 463 pop_cork_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 464 {
 465   struct Session *session = cls;
 466
 467   session->cork_task = GNUNET_SCHEDULER_NO_TASK;
 468   try_transmission (session);
 469 }
 470
 471
 472 /**
 473  * Try to perform a transmission on the given session. Will solicit
 474  * additional messages if the 'sme' queue is not full enough.
 475  *
 476  * @param session session to transmit messages from
 477  */
 478 static void
 479 try_transmission (struct Session *session)
 480 {
 481   struct SessionMessageEntry *pos;
 482   size_t msize;
 483   struct GNUNET_TIME_Absolute now;
 484   struct GNUNET_TIME_Absolute min_deadline;
 485
 486   if (GNUNET_YES != session->ready_to_transmit)
 487     return;
 488   msize = 0;
 489   min_deadline = GNUNET_TIME_UNIT_FOREVER_ABS;
 490   /* check 'ready' messages */
 491   pos = session->sme_head;
 492   while ((NULL != pos) &&
 493          (msize + pos->size <= GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE))
 494   {
 495     GNUNET_assert (pos->size < GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE);
 496     msize += pos->size;
 497     min_deadline = GNUNET_TIME_absolute_min (min_deadline, pos->deadline);
 498     pos = pos->next;
 499   }
 500   now = GNUNET_TIME_absolute_get ();
 501   if ((msize == 0) ||
 502       ((msize < GNUNET_CONSTANTS_MAX_ENCRYPTED_MESSAGE_SIZE / 2) &&
 503        (min_deadline.abs_value_us > now.abs_value_us)))
 504   {
 505     /* not enough ready yet, try to solicit more */
 506     solicit_messages (session);
 507     if (msize > 0)
 508     {
 509       /* if there is data to send, just not yet, make sure we do transmit
 510        * it once the deadline is reached */
 511       if (session->cork_task != GNUNET_SCHEDULER_NO_TASK)
 512         GNUNET_SCHEDULER_cancel (session->cork_task);
 513       session->cork_task =
 514           GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_absolute_get_remaining
 515                                         (min_deadline), &pop_cork_task,
 516                                         session);
 517     }
 518     return;
 519   }
 520   /* create plaintext buffer of all messages, encrypt and transmit */
 521   {
 522     static unsigned long long total_bytes;
 523     static unsigned int total_msgs;
 524     char pbuf[msize];           /* plaintext */
 525     size_t used;
 526
 527     used = 0;
 528     while ((NULL != (pos = session->sme_head)) && (used + pos->size <= msize))
 529     {
 530       memcpy (&pbuf[used], &pos[1], pos->size);
 531       used += pos->size;
 532       GNUNET_CONTAINER_DLL_remove (session->sme_head, session->sme_tail, pos);
 533       GNUNET_free (pos);
 534     }
 535     /* compute average payload size */
 536     total_bytes += used;
 537     total_msgs++;
 538     if (0 == total_msgs)
 539     {
 540       /* 2^32 messages, wrap around... */
 541       total_msgs = 1;
 542       total_bytes = used;
 543     }
 544     GNUNET_STATISTICS_set (GSC_stats, "# avg payload per encrypted message",
 545                            total_bytes / total_msgs, GNUNET_NO);
 546     /* now actually transmit... */
 547     session->ready_to_transmit = GNUNET_NO;
 548     GSC_KX_encrypt_and_transmit (session->kxinfo, pbuf, used);
 549   }
 550 }
 551
 552
 553 /**
 554  * Send a message to the neighbour now.
 555  *
 556  * @param cls the message
 557  * @param key neighbour's identity
 558  * @param value 'struct Neighbour' of the target
 559  * @return always GNUNET_OK
 560  */
 561 static int
 562 do_send_message (void *cls, const struct GNUNET_HashCode * key, void *value)
 563 {
 564   const struct GNUNET_MessageHeader *hdr = cls;
 565   struct Session *session = value;
 566   struct SessionMessageEntry *m;
 567   uint16_t size;
 568
 569   size = ntohs (hdr->size);
 570   m = GNUNET_malloc (sizeof (struct SessionMessageEntry) + size);
 571   memcpy (&m[1], hdr, size);
 572   m->size = size;
 573   GNUNET_CONTAINER_DLL_insert (session->sme_head, session->sme_tail, m);
 574   try_transmission (session);
 575   return GNUNET_OK;
 576 }
 577
 578
 579 /**
 580  * Broadcast a message to all neighbours.
 581  *
 582  * @param msg message to transmit
 583  */
 584 void
 585 GSC_SESSIONS_broadcast (const struct GNUNET_MessageHeader *msg)
 586 {
 587   if (NULL == sessions)
 588     return;
 589   GNUNET_CONTAINER_multihashmap_iterate (sessions, &do_send_message,
 590                                          (void *) msg);
 591 }
 592
 593
 594 /**
 595  * Traffic is being solicited for the given peer.  This means that the
 596  * message queue on the transport-level (NEIGHBOURS subsystem) is now
 597  * empty and it is now OK to transmit another (non-control) message.
 598  *
 599  * @param pid identity of peer ready to receive data
 600  */
 601 void
 602 GSC_SESSIONS_solicit (const struct GNUNET_PeerIdentity *pid)
 603 {
 604   struct Session *session;
 605
 606   session = find_session (pid);
 607   if (NULL == session)
 608     return;
 609   session->ready_to_transmit = GNUNET_YES;
 610   try_transmission (session);
 611 }
 612
 613
 614 /**
 615  * Transmit a message to a particular peer.
 616  *
 617  * @param car original request that was queued and then solicited;
 618  *            this handle will now be 'owned' by the SESSIONS subsystem
 619  * @param msg message to transmit
 620  * @param cork is corking allowed?
 621  */
 622 void
 623 GSC_SESSIONS_transmit (struct GSC_ClientActiveRequest *car,
 624                        const struct GNUNET_MessageHeader *msg, int cork)
 625 {
 626   struct Session *session;
 627   struct SessionMessageEntry *sme;
 628   size_t msize;
 629
 630   session = find_session (&car->target);
 631   if (NULL == session)
 632     return;
 633   msize = ntohs (msg->size);
 634   sme = GNUNET_malloc (sizeof (struct SessionMessageEntry) + msize);
 635   memcpy (&sme[1], msg, msize);
 636   sme->size = msize;
 637   if (GNUNET_YES == cork)
 638     sme->deadline =
 639         GNUNET_TIME_relative_to_absolute (GNUNET_CONSTANTS_MAX_CORK_DELAY);
 640   GNUNET_CONTAINER_DLL_insert_tail (session->sme_head, session->sme_tail, sme);
 641   try_transmission (session);
 642 }
 643
 644
 645 /**
 646  * Helper function for GSC_SESSIONS_handle_client_iterate_peers.
 647  *
 648  * @param cls the 'struct GNUNET_SERVER_TransmitContext' to queue replies
 649  * @param key identity of the connected peer
 650  * @param value the 'struct Neighbour' for the peer
 651  * @return GNUNET_OK (continue to iterate)
 652  */
 653 #include "core.h"
 654 static int
 655 queue_connect_message (void *cls, const struct GNUNET_HashCode * key, void *value)
 656 {
 657   struct GNUNET_SERVER_TransmitContext *tc = cls;
 658   struct Session *session = value;
 659   struct ConnectNotifyMessage cnm;
 660
 661   /* FIXME: code duplication with clients... */
 662   cnm.header.size = htons (sizeof (struct ConnectNotifyMessage));
 663   cnm.header.type = htons (GNUNET_MESSAGE_TYPE_CORE_NOTIFY_CONNECT);
 664   cnm.peer = session->peer;
 665   GNUNET_SERVER_transmit_context_append_message (tc, &cnm.header);
 666   return GNUNET_OK;
 667 }
 668
 669
 670 /**
 671  * Handle CORE_ITERATE_PEERS request. For this request type, the client
 672  * does not have to have transmitted an INIT request.  All current peers
 673  * are returned, regardless of which message types they accept.
 674  *
 675  * @param cls unused
 676  * @param client client sending the iteration request
 677  * @param message iteration request message
 678  */
 679 void
 680 GSC_SESSIONS_handle_client_iterate_peers (void *cls,
 681                                           struct GNUNET_SERVER_Client *client,
 682                                           const struct GNUNET_MessageHeader
 683                                           *message)
 684 {
 685   struct GNUNET_MessageHeader done_msg;
 686   struct GNUNET_SERVER_TransmitContext *tc;
 687
 688   tc = GNUNET_SERVER_transmit_context_create (client);
 689   GNUNET_CONTAINER_multihashmap_iterate (sessions, &queue_connect_message, tc);
 690   done_msg.size = htons (sizeof (struct GNUNET_MessageHeader));
 691   done_msg.type = htons (GNUNET_MESSAGE_TYPE_CORE_ITERATE_PEERS_END);
 692   GNUNET_SERVER_transmit_context_append_message (tc, &done_msg);
 693   GNUNET_SERVER_transmit_context_run (tc, GNUNET_TIME_UNIT_FOREVER_REL);
 694 }
 695
 696
 697 /**
 698  * We've received a typemap message from a peer, update ours.
 699  * Notifies clients about the session.
 700  *
 701  * @param peer peer this is about
 702  * @param msg typemap update message
 703  */
 704 void
 705 GSC_SESSIONS_set_typemap (const struct GNUNET_PeerIdentity *peer,
 706                           const struct GNUNET_MessageHeader *msg)
 707 {
 708   struct Session *session;
 709   struct GSC_TypeMap *nmap;
 710
 711   nmap = GSC_TYPEMAP_get_from_message (msg);
 712   if (NULL == nmap)
 713     return;                     /* malformed */
 714   session = find_session (peer);
 715   if (NULL == session)
 716   {
 717     GNUNET_break (0);
 718     return;
 719   }
 720   GSC_CLIENTS_notify_clients_about_neighbour (peer,
 721                                               session->tmap, nmap);
 722   GSC_TYPEMAP_destroy (session->tmap);
 723   session->tmap = nmap;
 724 }
 725
 726
 727 /**
 728  * The given peer send a message of the specified type.  Make sure the
 729  * respective bit is set in its type-map and that clients are notified
 730  * about the session.
 731  *
 732  * @param peer peer this is about
 733  * @param type type of the message
 734  */
 735 void
 736 GSC_SESSIONS_add_to_typemap (const struct GNUNET_PeerIdentity *peer,
 737                              uint16_t type)
 738 {
 739   struct Session *session;
 740   struct GSC_TypeMap *nmap;
 741
 742   if (0 == memcmp (peer, &GSC_my_identity, sizeof (struct GNUNET_PeerIdentity)))
 743     return;
 744   session = find_session (peer);
 745   GNUNET_assert (NULL != session);
 746   if (GNUNET_YES == GSC_TYPEMAP_test_match (session->tmap, &type, 1))
 747     return;                     /* already in it */
 748   nmap = GSC_TYPEMAP_extend (session->tmap, &type, 1);
 749   GSC_CLIENTS_notify_clients_about_neighbour (peer,
 750                                               session->tmap, nmap);
 751   GSC_TYPEMAP_destroy (session->tmap);
 752   session->tmap = nmap;
 753 }
 754
 755
 756 /**
 757  * Initialize sessions subsystem.
 758  */
 759 void
 760 GSC_SESSIONS_init ()
 761 {
 762   sessions = GNUNET_CONTAINER_multihashmap_create (128, GNUNET_NO);
 763 }
 764
 765
 766 /**
 767  * Helper function for GSC_SESSIONS_handle_client_iterate_peers.
 768  *
 769  * @param cls NULL
 770  * @param key identity of the connected peer
 771  * @param value the 'struct Session' for the peer
 772  * @return GNUNET_OK (continue to iterate)
 773  */
 774 static int
 775 free_session_helper (void *cls, const struct GNUNET_HashCode * key, void *value)
 776 {
 777   struct Session *session = value;
 778
 779   GSC_SESSIONS_end (&session->peer);
 780   return GNUNET_OK;
 781 }
 782
 783
 784 /**
 785  * Shutdown sessions subsystem.
 786  */
 787 void
 788 GSC_SESSIONS_done ()
 789 {
 790   if (NULL != sessions)
 791   {
 792     GNUNET_CONTAINER_multihashmap_iterate (sessions, &free_session_helper, NULL);
 793     GNUNET_CONTAINER_multihashmap_destroy (sessions);
 794     sessions = NULL;
 795   }
 796 }
 797
 798 /* end of gnunet-service-core_sessions.c */