src/ats/ats_api_scheduling.c

   1 /*
   2      This file is part of GNUnet.
   3      Copyright (C) 2010-2015 GNUnet e.V.
   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., 51 Franklin Street, Fifth Floor,
  18      Boston, MA 02110-1301, USA.
  19 */
  20 /**
  21  * @file ats/ats_api_scheduling.c
  22  * @brief automatic transport selection and outbound bandwidth determination
  23  * @author Christian Grothoff
  24  * @author Matthias Wachs
  25  *
  26  * TODO:
  27  * - we could avoid a linear scan over the
  28  *   active addresses in some cases, so if
  29  *   there is need, we can still optimize here
  30  * - we might want to split off the logic to
  31  *   determine LAN vs. WAN, as it has nothing
  32  *   to do with accessing the ATS service.
  33  */
  34 #include "platform.h"
  35 #include "gnunet_ats_service.h"
  36 #include "ats.h"
  37
  38 /**
  39  * How frequently do we scan the interfaces for changes to the addresses?
  40  */
  41 #define INTERFACE_PROCESSING_INTERVAL GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 2)
  42
  43 #define LOG(kind,...) GNUNET_log_from(kind, "ats-scheduling-api", __VA_ARGS__)
  44
  45 /**
  46  * Session ID we use if there is no session / slot.
  47  */
  48 #define NOT_FOUND 0
  49
  50
  51 /**
  52  * Information we track per address, incoming or outgoing.  It also
  53  * doesn't matter if we have a session, any address that ATS is
  54  * allowed to suggest right now should be tracked.
  55  */
  56 struct GNUNET_ATS_AddressRecord
  57 {
  58
  59   /**
  60    * Scheduling handle this address record belongs to.
  61    */
  62   struct GNUNET_ATS_SchedulingHandle *sh;
  63
  64   /**
  65    * Address data.
  66    */
  67   struct GNUNET_HELLO_Address *address;
  68
  69   /**
  70    * Session handle.  NULL if we have an address but no
  71    * active session for this address.
  72    */
  73   struct GNUNET_ATS_Session *session;
  74
  75   /**
  76    * Performance data about the address.
  77    */
  78   struct GNUNET_ATS_PropertiesNBO properties;
  79
  80   /**
  81    * Which slot (index) in the session array does
  82    * this record correspond to?
  83    * FIXME: a linear search on this is really crappy!
  84    * Maybe switch to a 64-bit global counter and be
  85    * done with it?  Or does that then cause too much
  86    * trouble on the ATS-service side?
  87    */
  88   uint32_t slot;
  89
  90   /**
  91    * We're about to destroy this address record, just ATS does
  92    * not know this yet.  Once ATS confirms its destruction,
  93    * we can clean up.
  94    */
  95   int in_destroy;
  96 };
  97
  98
  99 /**
 100  * Handle to the ATS subsystem for bandwidth/transport scheduling information.
 101  */
 102 struct GNUNET_ATS_SchedulingHandle
 103 {
 104
 105   /**
 106    * Our configuration.
 107    */
 108   const struct GNUNET_CONFIGURATION_Handle *cfg;
 109
 110   /**
 111    * Callback to invoke on suggestions.
 112    */
 113   GNUNET_ATS_AddressSuggestionCallback suggest_cb;
 114
 115   /**
 116    * Closure for @e suggest_cb.
 117    */
 118   void *suggest_cb_cls;
 119
 120   /**
 121    * Message queue for sending requests to the ATS service.
 122    */
 123   struct GNUNET_MQ_Handle *mq;
 124
 125   /**
 126    * Array of session objects (we need to translate them to numbers and back
 127    * for the protocol; the offset in the array is the session number on the
 128    * network).  Index 0 is always NULL and reserved to represent the NULL pointer.
 129    * Unused entries are also NULL.
 130    */
 131   struct GNUNET_ATS_AddressRecord **session_array;
 132
 133   /**
 134    * Task to trigger reconnect.
 135    */
 136   struct GNUNET_SCHEDULER_Task *task;
 137
 138   /**
 139    * Reconnect backoff delay.
 140    */
 141   struct GNUNET_TIME_Relative backoff;
 142
 143   /**
 144    * Size of the @e session_array.
 145    */
 146   unsigned int session_array_size;
 147
 148 };
 149
 150
 151 /**
 152  * Re-establish the connection to the ATS service.
 153  *
 154  * @param sh handle to use to re-connect.
 155  */
 156 static void
 157 reconnect (struct GNUNET_ATS_SchedulingHandle *sh);
 158
 159
 160 /**
 161  * Re-establish the connection to the ATS service.
 162  *
 163  * @param cls handle to use to re-connect.
 164  */
 165 static void
 166 reconnect_task (void *cls)
 167 {
 168   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 169
 170   sh->task = NULL;
 171   reconnect (sh);
 172 }
 173
 174
 175 /**
 176  * Disconnect from ATS and then reconnect.
 177  *
 178  * @param sh our handle
 179  */
 180 static void
 181 force_reconnect (struct GNUNET_ATS_SchedulingHandle *sh)
 182 {
 183   if (NULL != sh->mq)
 184   {
 185     GNUNET_MQ_destroy (sh->mq);
 186     sh->mq = NULL;
 187   }
 188   sh->suggest_cb (sh->suggest_cb_cls,
 189                   NULL, NULL, NULL,
 190                   GNUNET_BANDWIDTH_ZERO,
 191                   GNUNET_BANDWIDTH_ZERO);
 192   sh->backoff = GNUNET_TIME_STD_BACKOFF (sh->backoff);
 193   sh->task = GNUNET_SCHEDULER_add_delayed (sh->backoff,
 194                                            &reconnect_task,
 195                                            sh);
 196 }
 197
 198
 199 /**
 200  * Find the session object corresponding to the given session ID.
 201  *
 202  * @param sh our handle
 203  * @param session_id current session ID
 204  * @param peer peer the session belongs to
 205  * @return the session object (or NULL)
 206  */
 207 static struct GNUNET_ATS_AddressRecord *
 208 find_session (struct GNUNET_ATS_SchedulingHandle *sh,
 209               uint32_t session_id,
 210               const struct GNUNET_PeerIdentity *peer)
 211 {
 212   struct GNUNET_ATS_AddressRecord *ar;
 213
 214   if (session_id >= sh->session_array_size)
 215   {
 216     GNUNET_break (0);
 217     return NULL;
 218   }
 219   if (0 == session_id)
 220     return NULL;
 221   ar = sh->session_array[session_id];
 222   if (NULL == ar)
 223   {
 224     GNUNET_break (0);
 225     return NULL;
 226   }
 227   if (NULL == ar->address)
 228   {
 229     /* address was destroyed in the meantime, this can happen
 230        as we communicate asynchronously with the ATS service. */
 231     return NULL;
 232   }
 233   if (0 != memcmp (peer,
 234                    &ar->address->peer,
 235                    sizeof (struct GNUNET_PeerIdentity)))
 236   {
 237     GNUNET_break (0);
 238     return NULL;
 239   }
 240   return ar;
 241 }
 242
 243
 244 /**
 245  * Get an available session ID.
 246  *
 247  * @param sh our handle
 248  * @return an unused slot, but never NOT_FOUND (0)
 249  */
 250 static uint32_t
 251 find_empty_session_slot (struct GNUNET_ATS_SchedulingHandle *sh)
 252 {
 253   static uint32_t off;
 254   uint32_t i;
 255
 256   i = 0;
 257   while ( ( (NOT_FOUND == off) ||
 258             (NULL != sh->session_array[off % sh->session_array_size]) ) &&
 259           (i < sh->session_array_size) )
 260   {
 261     off++;
 262     i++;
 263   }
 264   if ( (NOT_FOUND != off % sh->session_array_size) &&
 265        (NULL == sh->session_array[off % sh->session_array_size]) )
 266     return off;
 267   i = sh->session_array_size;
 268   GNUNET_array_grow (sh->session_array,
 269                      sh->session_array_size,
 270                      sh->session_array_size * 2);
 271   return i;
 272 }
 273
 274
 275 /**
 276  * Get the ID for the given session object.
 277  *
 278  * @param sh our handle
 279  * @param session session object
 280  * @param address the address we are looking for
 281  * @return the session id or NOT_FOUND for error
 282  */
 283 static uint32_t
 284 find_session_id (struct GNUNET_ATS_SchedulingHandle *sh,
 285                  struct GNUNET_ATS_Session *session,
 286                  const struct GNUNET_HELLO_Address *address)
 287 {
 288   uint32_t i;
 289
 290   if (NULL == address)
 291   {
 292     GNUNET_break (0);
 293     return NOT_FOUND;
 294   }
 295   for (i = 1; i < sh->session_array_size; i++)
 296     if ( (NULL != sh->session_array[i]) &&
 297          (GNUNET_NO == sh->session_array[i]->in_destroy) &&
 298          ( (session == sh->session_array[i]->session) ||
 299            (NULL == sh->session_array[i]->session) ) &&
 300          (0 == memcmp (&address->peer,
 301                        &sh->session_array[i]->address->peer,
 302                        sizeof (struct GNUNET_PeerIdentity))) &&
 303          (0 == GNUNET_HELLO_address_cmp (address,
 304                                          sh->session_array[i]->address)) )
 305       return i;
 306   return NOT_FOUND;
 307 }
 308
 309
 310 /**
 311  * Release the session slot from the session table (ATS service is
 312  * also done using it).
 313  *
 314  * @param sh our handle
 315  * @param session_id identifies session that is no longer valid
 316  */
 317 static void
 318 release_session (struct GNUNET_ATS_SchedulingHandle *sh,
 319                  uint32_t session_id)
 320 {
 321   struct GNUNET_ATS_AddressRecord *ar;
 322
 323   if (NOT_FOUND == session_id)
 324     return;
 325   if (session_id >= sh->session_array_size)
 326   {
 327     GNUNET_break (0);
 328     force_reconnect (sh);
 329     return;
 330   }
 331   /* this slot should have been removed from remove_session before */
 332   ar = sh->session_array[session_id];
 333   if (NULL != ar->session)
 334   {
 335     GNUNET_break (0);
 336     force_reconnect (sh);
 337     return;
 338   }
 339   GNUNET_HELLO_address_free (ar->address);
 340   GNUNET_free (ar);
 341   sh->session_array[session_id] = NULL;
 342 }
 343
 344
 345 /**
 346  * Type of a function to call when we receive a session release
 347  * message from the service.
 348  *
 349  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 350  * @param srm message received
 351  */
 352 static void
 353 handle_ats_session_release (void *cls,
 354                             const struct GNUNET_ATS_SessionReleaseMessage *srm)
 355 {
 356   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 357
 358   /* Note: peer field in srm not necessary right now,
 359      but might be good to have in the future */
 360   release_session (sh,
 361                    ntohl (srm->session_id));
 362 }
 363
 364
 365 /**
 366  * Type of a function to call when we receive a address suggestion
 367  * message from the service.
 368  *
 369  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 370  * @param m message received
 371  */
 372 static void
 373 handle_ats_address_suggestion (void *cls,
 374                                const struct AddressSuggestionMessage *m)
 375 {
 376   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 377   struct GNUNET_ATS_AddressRecord *ar;
 378   uint32_t session_id;
 379
 380   session_id = ntohl (m->session_id);
 381   if (0 == session_id)
 382   {
 383     GNUNET_break (0);
 384     force_reconnect (sh);
 385     return;
 386   }
 387   ar = find_session (sh,
 388                      session_id,
 389                      &m->peer);
 390   if (NULL == ar)
 391   {
 392     GNUNET_break (0);
 393     force_reconnect (sh);
 394     return;
 395   }
 396   if (NULL == sh->suggest_cb)
 397     return;
 398   if (GNUNET_YES == ar->in_destroy)
 399   {
 400     /* ignore suggestion, as this address is dying, unless BW is 0,
 401        in that case signal 'disconnect' via BW 0 */
 402     if ( (0 == ntohl (m->bandwidth_out.value__)) &&
 403          (0 == ntohl (m->bandwidth_in.value__)) )
 404     {
 405       LOG (GNUNET_ERROR_TYPE_DEBUG,
 406            "ATS suggests disconnect from peer `%s' with BW %u/%u\n",
 407            GNUNET_i2s (&ar->address->peer),
 408            (unsigned int) ntohl (m->bandwidth_out.value__),
 409            (unsigned int) ntohl (m->bandwidth_in.value__));
 410       sh->suggest_cb (sh->suggest_cb_cls,
 411                       &m->peer,
 412                       NULL,
 413                       NULL,
 414                       m->bandwidth_out,
 415                       m->bandwidth_in);
 416     }
 417     return;
 418   }
 419   if ( (NULL == ar->session) &&
 420        (GNUNET_HELLO_address_check_option (ar->address,
 421                                            GNUNET_HELLO_ADDRESS_INFO_INBOUND)) )
 422   {
 423     GNUNET_break (0);
 424     return;
 425   }
 426   sh->backoff = GNUNET_TIME_UNIT_ZERO;
 427   LOG (GNUNET_ERROR_TYPE_DEBUG,
 428        "ATS suggests address slot %u for peer `%s' using plugin %s\n",
 429        ar->slot,
 430        GNUNET_i2s (&ar->address->peer),
 431        ar->address->transport_name);
 432   sh->suggest_cb (sh->suggest_cb_cls,
 433                   &m->peer,
 434                   ar->address,
 435                   ar->session,
 436                   m->bandwidth_out,
 437                   m->bandwidth_in);
 438 }
 439
 440
 441 /**
 442  * We encountered an error handling the MQ to the
 443  * ATS service.  Reconnect.
 444  *
 445  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 446  * @param error details about the error
 447  */
 448 static void
 449 error_handler (void *cls,
 450                enum GNUNET_MQ_Error error)
 451 {
 452   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 453
 454   LOG (GNUNET_ERROR_TYPE_DEBUG,
 455        "ATS connection died (code %d), reconnecting\n",
 456        (int) error);
 457   force_reconnect (sh);
 458 }
 459
 460
 461 /**
 462  * Generate and transmit the `struct AddressAddMessage` for the given
 463  * address record.
 464  *
 465  * @param sh the scheduling handle to use for transmission
 466  * @param ar the address to inform the ATS service about
 467  */
 468 static void
 469 send_add_address_message (struct GNUNET_ATS_SchedulingHandle *sh,
 470                           const struct GNUNET_ATS_AddressRecord *ar)
 471 {
 472   struct GNUNET_MQ_Envelope *ev;
 473   struct AddressAddMessage *m;
 474   char *pm;
 475   size_t namelen;
 476   size_t msize;
 477
 478   if (NULL == sh->mq)
 479     return; /* disconnected, skip for now */
 480   GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != ar->properties.scope);
 481   namelen = strlen (ar->address->transport_name) + 1;
 482   msize = ar->address->address_length + namelen;
 483   ev = GNUNET_MQ_msg_extra (m, msize, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_ADD);
 484   m->peer = ar->address->peer;
 485   m->address_length = htons (ar->address->address_length);
 486   m->address_local_info = htonl ((uint32_t) ar->address->local_info);
 487   m->plugin_name_length = htons (namelen);
 488   m->session_id = htonl (ar->slot);
 489   m->properties = ar->properties;
 490
 491   LOG (GNUNET_ERROR_TYPE_DEBUG,
 492        "Adding address for peer `%s', plugin `%s', session %p slot %u\n",
 493        GNUNET_i2s (&ar->address->peer),
 494        ar->address->transport_name,
 495        ar->session,
 496        ar->slot);
 497   pm = (char *) &m[1];
 498   memcpy (pm,
 499           ar->address->address,
 500           ar->address->address_length);
 501   if (NULL != ar->address->transport_name)
 502     memcpy (&pm[ar->address->address_length],
 503             ar->address->transport_name,
 504             namelen);
 505   GNUNET_MQ_send (sh->mq, ev);
 506 }
 507
 508
 509 /**
 510  * Re-establish the connection to the ATS service.
 511  *
 512  * @param sh handle to use to re-connect.
 513  */
 514 static void
 515 reconnect (struct GNUNET_ATS_SchedulingHandle *sh)
 516 {
 517   GNUNET_MQ_hd_fixed_size (ats_session_release,
 518                            GNUNET_MESSAGE_TYPE_ATS_SESSION_RELEASE,
 519                            struct GNUNET_ATS_SessionReleaseMessage);
 520   GNUNET_MQ_hd_fixed_size (ats_address_suggestion,
 521                            GNUNET_MESSAGE_TYPE_ATS_ADDRESS_SUGGESTION,
 522                            struct AddressSuggestionMessage);
 523   struct GNUNET_MQ_MessageHandler handlers[] = {
 524     make_ats_session_release_handler (sh),
 525     make_ats_address_suggestion_handler (sh),
 526     GNUNET_MQ_handler_end ()
 527   };
 528   struct GNUNET_MQ_Envelope *ev;
 529   struct ClientStartMessage *init;
 530   unsigned int i;
 531   struct GNUNET_ATS_AddressRecord *ar;
 532
 533   GNUNET_assert (NULL == sh->mq);
 534   sh->mq = GNUNET_CLIENT_connecT (sh->cfg,
 535                                   "ats",
 536                                   handlers,
 537                                   &error_handler,
 538                                   sh);
 539   if (NULL == sh->mq)
 540   {
 541     GNUNET_break (0);
 542     force_reconnect (sh);
 543     return;
 544   }
 545   ev = GNUNET_MQ_msg (init,
 546                       GNUNET_MESSAGE_TYPE_ATS_START);
 547   init->start_flag = htonl (START_FLAG_SCHEDULING);
 548   GNUNET_MQ_send (sh->mq, ev);
 549   if (NULL == sh->mq)
 550     return;
 551   for (i=0;i<sh->session_array_size;i++)
 552   {
 553     ar = sh->session_array[i];
 554     if (NULL == ar)
 555       continue;
 556     send_add_address_message (sh, ar);
 557     if (NULL == sh->mq)
 558       return;
 559   }
 560 }
 561
 562
 563 /**
 564  * Initialize the ATS subsystem.
 565  *
 566  * @param cfg configuration to use
 567  * @param suggest_cb notification to call whenever the suggestation changed
 568  * @param suggest_cb_cls closure for @a suggest_cb
 569  * @return ats context
 570  */
 571 struct GNUNET_ATS_SchedulingHandle *
 572 GNUNET_ATS_scheduling_init (const struct GNUNET_CONFIGURATION_Handle *cfg,
 573                             GNUNET_ATS_AddressSuggestionCallback suggest_cb,
 574                             void *suggest_cb_cls)
 575 {
 576   struct GNUNET_ATS_SchedulingHandle *sh;
 577
 578   sh = GNUNET_new (struct GNUNET_ATS_SchedulingHandle);
 579   sh->cfg = cfg;
 580   sh->suggest_cb = suggest_cb;
 581   sh->suggest_cb_cls = suggest_cb_cls;
 582   GNUNET_array_grow (sh->session_array,
 583                      sh->session_array_size,
 584                      4);
 585   reconnect (sh);
 586   return sh;
 587 }
 588
 589
 590 /**
 591  * Client is done with ATS scheduling, release resources.
 592  *
 593  * @param sh handle to release
 594  */
 595 void
 596 GNUNET_ATS_scheduling_done (struct GNUNET_ATS_SchedulingHandle *sh)
 597 {
 598   struct GNUNET_ATS_AddressRecord *ar;
 599   unsigned int i;
 600
 601   if (NULL != sh->mq)
 602   {
 603     GNUNET_MQ_destroy (sh->mq);
 604     sh->mq = NULL;
 605   }
 606   if (NULL != sh->task)
 607   {
 608     GNUNET_SCHEDULER_cancel (sh->task);
 609     sh->task = NULL;
 610   }
 611   for (i=0;i<sh->session_array_size;i++)
 612   {
 613     if (NULL != (ar = sh->session_array[i]))
 614     {
 615       GNUNET_HELLO_address_free (ar->address);
 616       GNUNET_free (ar);
 617       sh->session_array[i] = NULL;
 618     }
 619   }
 620   GNUNET_array_grow (sh->session_array,
 621                      sh->session_array_size,
 622                      0);
 623   GNUNET_free (sh);
 624 }
 625
 626
 627 /**
 628  * We have a new address ATS should know. Addresses have to be added
 629  * with this function before they can be: updated, set in use and
 630  * destroyed.
 631  *
 632  * @param sh handle
 633  * @param address the address
 634  * @param session session handle, can be NULL
 635  * @param prop performance data for the address
 636  * @return handle to the address representation inside ATS, NULL
 637  *         on error (i.e. ATS knows this exact address already)
 638  */
 639 struct GNUNET_ATS_AddressRecord *
 640 GNUNET_ATS_address_add (struct GNUNET_ATS_SchedulingHandle *sh,
 641                         const struct GNUNET_HELLO_Address *address,
 642                         struct GNUNET_ATS_Session *session,
 643                         const struct GNUNET_ATS_Properties *prop)
 644 {
 645   struct GNUNET_ATS_AddressRecord *ar;
 646   size_t namelen;
 647   size_t msize;
 648   uint32_t s;
 649
 650   if (NULL == address)
 651   {
 652     /* we need a valid address */
 653     GNUNET_break (0);
 654     return NULL;
 655   }
 656   GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != prop->scope);
 657   namelen = strlen (address->transport_name) + 1;
 658   msize = address->address_length + namelen;
 659   if ((msize + sizeof (struct AddressUpdateMessage) >= GNUNET_SERVER_MAX_MESSAGE_SIZE) ||
 660       (address->address_length >= GNUNET_SERVER_MAX_MESSAGE_SIZE) ||
 661       (namelen >= GNUNET_SERVER_MAX_MESSAGE_SIZE) )
 662   {
 663     /* address too large for us, this should not happen */
 664     GNUNET_break (0);
 665     return NULL;
 666   }
 667
 668   if (NOT_FOUND !=
 669       find_session_id (sh,
 670                        session,
 671                        address))
 672   {
 673     /* Already existing, nothing todo, but this should not happen */
 674     GNUNET_break (0);
 675     return NULL;
 676   }
 677   s = find_empty_session_slot (sh);
 678   ar = GNUNET_new (struct GNUNET_ATS_AddressRecord);
 679   ar->sh = sh;
 680   ar->slot = s;
 681   ar->session = session;
 682   ar->address = GNUNET_HELLO_address_copy (address);
 683   GNUNET_ATS_properties_hton (&ar->properties,
 684                               prop);
 685   sh->session_array[s] = ar;
 686   send_add_address_message (sh, ar);
 687   return ar;
 688 }
 689
 690
 691 /**
 692  * An address was used to initiate a session.
 693  *
 694  * @param ar address record to update information for
 695  * @param session session handle
 696  */
 697 void
 698 GNUNET_ATS_address_add_session (struct GNUNET_ATS_AddressRecord *ar,
 699                                 struct GNUNET_ATS_Session *session)
 700 {
 701   GNUNET_break (NULL == ar->session);
 702   ar->session = session;
 703 }
 704
 705
 706 /**
 707  * A session was destroyed, disassociate it from the
 708  * given address record.  If this was an incoming
 709  * addess, destroy the address as well.
 710  *
 711  * @param ar address record to update information for
 712  * @param session session handle
 713  * @return #GNUNET_YES if the @a ar was destroyed because
 714  *                     it was an incoming address,
 715  *         #GNUNET_NO if the @ar was kept because we can
 716  *                    use it still to establish a new session
 717  */
 718 int
 719 GNUNET_ATS_address_del_session (struct GNUNET_ATS_AddressRecord *ar,
 720                                 struct GNUNET_ATS_Session *session)
 721 {
 722   GNUNET_assert (session == ar->session);
 723   ar->session = NULL;
 724   if (GNUNET_HELLO_address_check_option (ar->address,
 725                                          GNUNET_HELLO_ADDRESS_INFO_INBOUND))
 726   {
 727     GNUNET_ATS_address_destroy (ar);
 728     return GNUNET_YES;
 729   }
 730   return GNUNET_NO;
 731 }
 732
 733
 734 /**
 735  * We have updated performance statistics for a given address.  Note
 736  * that this function can be called for addresses that are currently
 737  * in use as well as addresses that are valid but not actively in use.
 738  * Furthermore, the peer may not even be connected to us right now (in
 739  * which case the call may be ignored or the information may be stored
 740  * for later use).  Update bandwidth assignments.
 741  *
 742  * @param ar address record to update information for
 743  * @param prop performance data for the address
 744  */
 745 void
 746 GNUNET_ATS_address_update (struct GNUNET_ATS_AddressRecord *ar,
 747                            const struct GNUNET_ATS_Properties *prop)
 748 {
 749   struct GNUNET_ATS_SchedulingHandle *sh = ar->sh;
 750   struct GNUNET_MQ_Envelope *ev;
 751   struct AddressUpdateMessage *m;
 752
 753   LOG (GNUNET_ERROR_TYPE_DEBUG,
 754        "Updating address for peer `%s', plugin `%s', session %p slot %u\n",
 755        GNUNET_i2s (&ar->address->peer),
 756        ar->address->transport_name,
 757        ar->session,
 758        ar->slot);
 759   GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != prop->scope);
 760   GNUNET_ATS_properties_hton (&ar->properties,
 761                               prop);
 762   if (NULL == sh->mq)
 763     return; /* disconnected, skip for now */
 764   ev = GNUNET_MQ_msg (m, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_UPDATE);
 765   m->session_id = htonl (ar->slot);
 766   m->peer = ar->address->peer;
 767   m->properties = ar->properties;
 768   GNUNET_MQ_send (sh->mq,
 769                   ev);
 770 }
 771
 772
 773 /**
 774  * An address got destroyed, stop using it as a valid address.
 775  *
 776  * @param ar address to destroy
 777  */
 778 void
 779 GNUNET_ATS_address_destroy (struct GNUNET_ATS_AddressRecord *ar)
 780 {
 781   struct GNUNET_ATS_SchedulingHandle *sh = ar->sh;
 782   struct GNUNET_MQ_Envelope *ev;
 783   struct AddressDestroyedMessage *m;
 784
 785   LOG (GNUNET_ERROR_TYPE_DEBUG,
 786        "Deleting address for peer `%s', plugin `%s', slot %u session %p\n",
 787        GNUNET_i2s (&ar->address->peer),
 788        ar->address->transport_name,
 789        ar->slot,
 790        ar->session);
 791   GNUNET_break (NULL == ar->session);
 792   ar->session = NULL;
 793   ar->in_destroy = GNUNET_YES;
 794   if (NULL == sh->mq)
 795     return;
 796   ev = GNUNET_MQ_msg (m, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_DESTROYED);
 797   m->session_id = htonl (ar->slot);
 798   m->peer = ar->address->peer;
 799   GNUNET_MQ_send (sh->mq, ev);
 800 }
 801
 802
 803 /* end of ats_api_scheduling.c */