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 it
   6      under the terms of the GNU Affero General Public License as published
   7      by the Free Software Foundation, either version 3 of the License,
   8      or (at your 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      Affero General Public License for more details.
  14
  15      You should have received a copy of the GNU Affero General Public License
  16      along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18      SPDX-License-Identifier: AGPL3.0-or-later
  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 != GNUNET_memcmp (peer,
 234                    &ar->address->peer))
 235   {
 236     GNUNET_break (0);
 237     return NULL;
 238   }
 239   return ar;
 240 }
 241
 242
 243 /**
 244  * Get an available session ID.
 245  *
 246  * @param sh our handle
 247  * @return an unused slot, but never NOT_FOUND (0)
 248  */
 249 static uint32_t
 250 find_empty_session_slot (struct GNUNET_ATS_SchedulingHandle *sh)
 251 {
 252   static uint32_t off;
 253   uint32_t i;
 254
 255   GNUNET_assert (0 != sh->session_array_size);
 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 == GNUNET_memcmp (&address->peer,
 301                        &sh->session_array[i]->address->peer)) &&
 302          (0 == GNUNET_HELLO_address_cmp (address,
 303                                          sh->session_array[i]->address)) )
 304       return i;
 305   return NOT_FOUND;
 306 }
 307
 308
 309 /**
 310  * Release the session slot from the session table (ATS service is
 311  * also done using it).
 312  *
 313  * @param sh our handle
 314  * @param session_id identifies session that is no longer valid
 315  */
 316 static void
 317 release_session (struct GNUNET_ATS_SchedulingHandle *sh,
 318                  uint32_t session_id)
 319 {
 320   struct GNUNET_ATS_AddressRecord *ar;
 321
 322   if (NOT_FOUND == session_id)
 323     return;
 324   if (session_id >= sh->session_array_size)
 325   {
 326     GNUNET_break (0);
 327     force_reconnect (sh);
 328     return;
 329   }
 330   /* this slot should have been removed from remove_session before */
 331   ar = sh->session_array[session_id];
 332   if (NULL != ar->session)
 333   {
 334     GNUNET_break (0);
 335     force_reconnect (sh);
 336     return;
 337   }
 338   GNUNET_HELLO_address_free (ar->address);
 339   GNUNET_free (ar);
 340   sh->session_array[session_id] = NULL;
 341 }
 342
 343
 344 /**
 345  * Type of a function to call when we receive a session release
 346  * message from the service.
 347  *
 348  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 349  * @param srm message received
 350  */
 351 static void
 352 handle_ats_session_release (void *cls,
 353                             const struct GNUNET_ATS_SessionReleaseMessage *srm)
 354 {
 355   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 356
 357   /* Note: peer field in srm not necessary right now,
 358      but might be good to have in the future */
 359   release_session (sh,
 360                    ntohl (srm->session_id));
 361 }
 362
 363
 364 /**
 365  * Type of a function to call when we receive a address suggestion
 366  * message from the service.
 367  *
 368  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 369  * @param m message received
 370  */
 371 static void
 372 handle_ats_address_suggestion (void *cls,
 373                                const struct AddressSuggestionMessage *m)
 374 {
 375   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 376   struct GNUNET_ATS_AddressRecord *ar;
 377   uint32_t session_id;
 378
 379   session_id = ntohl (m->session_id);
 380   if (0 == session_id)
 381   {
 382     GNUNET_break (0);
 383     force_reconnect (sh);
 384     return;
 385   }
 386   ar = find_session (sh,
 387                      session_id,
 388                      &m->peer);
 389   if (NULL == ar)
 390   {
 391     GNUNET_break (0);
 392     force_reconnect (sh);
 393     return;
 394   }
 395   if (NULL == sh->suggest_cb)
 396     return;
 397   if (GNUNET_YES == ar->in_destroy)
 398   {
 399     /* ignore suggestion, as this address is dying, unless BW is 0,
 400        in that case signal 'disconnect' via BW 0 */
 401     if ( (0 == ntohl (m->bandwidth_out.value__)) &&
 402          (0 == ntohl (m->bandwidth_in.value__)) )
 403     {
 404       LOG (GNUNET_ERROR_TYPE_DEBUG,
 405            "ATS suggests disconnect from peer `%s' with BW %u/%u\n",
 406            GNUNET_i2s (&ar->address->peer),
 407            (unsigned int) ntohl (m->bandwidth_out.value__),
 408            (unsigned int) ntohl (m->bandwidth_in.value__));
 409       sh->suggest_cb (sh->suggest_cb_cls,
 410                       &m->peer,
 411                       NULL,
 412                       NULL,
 413                       m->bandwidth_out,
 414                       m->bandwidth_in);
 415     }
 416     return;
 417   }
 418   if ( (NULL == ar->session) &&
 419        (GNUNET_HELLO_address_check_option (ar->address,
 420                                            GNUNET_HELLO_ADDRESS_INFO_INBOUND)) )
 421   {
 422     GNUNET_break (0);
 423     return;
 424   }
 425   sh->backoff = GNUNET_TIME_UNIT_ZERO;
 426   LOG (GNUNET_ERROR_TYPE_DEBUG,
 427        "ATS suggests address slot %u for peer `%s' using plugin %s\n",
 428        ar->slot,
 429        GNUNET_i2s (&ar->address->peer),
 430        ar->address->transport_name);
 431   sh->suggest_cb (sh->suggest_cb_cls,
 432                   &m->peer,
 433                   ar->address,
 434                   ar->session,
 435                   m->bandwidth_out,
 436                   m->bandwidth_in);
 437 }
 438
 439
 440 /**
 441  * We encountered an error handling the MQ to the
 442  * ATS service.  Reconnect.
 443  *
 444  * @param cls the `struct GNUNET_ATS_SchedulingHandle`
 445  * @param error details about the error
 446  */
 447 static void
 448 error_handler (void *cls,
 449                enum GNUNET_MQ_Error error)
 450 {
 451   struct GNUNET_ATS_SchedulingHandle *sh = cls;
 452
 453   LOG (GNUNET_ERROR_TYPE_DEBUG,
 454        "ATS connection died (code %d), reconnecting\n",
 455        (int) error);
 456   force_reconnect (sh);
 457 }
 458
 459
 460 /**
 461  * Generate and transmit the `struct AddressAddMessage` for the given
 462  * address record.
 463  *
 464  * @param sh the scheduling handle to use for transmission
 465  * @param ar the address to inform the ATS service about
 466  */
 467 static void
 468 send_add_address_message (struct GNUNET_ATS_SchedulingHandle *sh,
 469                           const struct GNUNET_ATS_AddressRecord *ar)
 470 {
 471   struct GNUNET_MQ_Envelope *ev;
 472   struct AddressAddMessage *m;
 473   char *pm;
 474   size_t namelen;
 475   size_t msize;
 476
 477   if (NULL == sh->mq)
 478     return; /* disconnected, skip for now */
 479   GNUNET_break (GNUNET_NT_UNSPECIFIED != ar->properties.scope);
 480   namelen = strlen (ar->address->transport_name) + 1;
 481   msize = ar->address->address_length + namelen;
 482   ev = GNUNET_MQ_msg_extra (m, msize, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_ADD);
 483   m->peer = ar->address->peer;
 484   m->address_length = htons (ar->address->address_length);
 485   m->address_local_info = htonl ((uint32_t) ar->address->local_info);
 486   m->plugin_name_length = htons (namelen);
 487   m->session_id = htonl (ar->slot);
 488   m->properties = ar->properties;
 489
 490   LOG (GNUNET_ERROR_TYPE_DEBUG,
 491        "Adding address for peer `%s', plugin `%s', session %p slot %u\n",
 492        GNUNET_i2s (&ar->address->peer),
 493        ar->address->transport_name,
 494        ar->session,
 495        ar->slot);
 496   pm = (char *) &m[1];
 497   GNUNET_memcpy (pm,
 498           ar->address->address,
 499           ar->address->address_length);
 500   if (NULL != ar->address->transport_name)
 501     GNUNET_memcpy (&pm[ar->address->address_length],
 502             ar->address->transport_name,
 503             namelen);
 504   GNUNET_MQ_send (sh->mq, ev);
 505 }
 506
 507
 508 /**
 509  * Re-establish the connection to the ATS service.
 510  *
 511  * @param sh handle to use to re-connect.
 512  */
 513 static void
 514 reconnect (struct GNUNET_ATS_SchedulingHandle *sh)
 515 {
 516   struct GNUNET_MQ_MessageHandler handlers[] = {
 517     GNUNET_MQ_hd_fixed_size (ats_session_release,
 518                              GNUNET_MESSAGE_TYPE_ATS_SESSION_RELEASE,
 519                              struct GNUNET_ATS_SessionReleaseMessage,
 520                              sh),
 521     GNUNET_MQ_hd_fixed_size (ats_address_suggestion,
 522                              GNUNET_MESSAGE_TYPE_ATS_ADDRESS_SUGGESTION,
 523                              struct AddressSuggestionMessage,
 524                              sh),
 525     GNUNET_MQ_handler_end ()
 526   };
 527   struct GNUNET_MQ_Envelope *ev;
 528   struct ClientStartMessage *init;
 529   unsigned int i;
 530   struct GNUNET_ATS_AddressRecord *ar;
 531
 532   GNUNET_assert (NULL == sh->mq);
 533   sh->mq = GNUNET_CLIENT_connect (sh->cfg,
 534                                   "ats",
 535                                   handlers,
 536                                   &error_handler,
 537                                   sh);
 538   if (NULL == sh->mq)
 539   {
 540     GNUNET_break (0);
 541     force_reconnect (sh);
 542     return;
 543   }
 544   ev = GNUNET_MQ_msg (init,
 545                       GNUNET_MESSAGE_TYPE_ATS_START);
 546   init->start_flag = htonl (START_FLAG_SCHEDULING);
 547   GNUNET_MQ_send (sh->mq, ev);
 548   if (NULL == sh->mq)
 549     return;
 550   for (i=0;i<sh->session_array_size;i++)
 551   {
 552     ar = sh->session_array[i];
 553     if (NULL == ar)
 554       continue;
 555     send_add_address_message (sh, ar);
 556     if (NULL == sh->mq)
 557       return;
 558   }
 559 }
 560
 561
 562 /**
 563  * Initialize the ATS subsystem.
 564  *
 565  * @param cfg configuration to use
 566  * @param suggest_cb notification to call whenever the suggestation changed
 567  * @param suggest_cb_cls closure for @a suggest_cb
 568  * @return ats context
 569  */
 570 struct GNUNET_ATS_SchedulingHandle *
 571 GNUNET_ATS_scheduling_init (const struct GNUNET_CONFIGURATION_Handle *cfg,
 572                             GNUNET_ATS_AddressSuggestionCallback suggest_cb,
 573                             void *suggest_cb_cls)
 574 {
 575   struct GNUNET_ATS_SchedulingHandle *sh;
 576
 577   sh = GNUNET_new (struct GNUNET_ATS_SchedulingHandle);
 578   sh->cfg = cfg;
 579   sh->suggest_cb = suggest_cb;
 580   sh->suggest_cb_cls = suggest_cb_cls;
 581   GNUNET_array_grow (sh->session_array,
 582                      sh->session_array_size,
 583                      4);
 584   reconnect (sh);
 585   return sh;
 586 }
 587
 588
 589 /**
 590  * Client is done with ATS scheduling, release resources.
 591  *
 592  * @param sh handle to release
 593  */
 594 void
 595 GNUNET_ATS_scheduling_done (struct GNUNET_ATS_SchedulingHandle *sh)
 596 {
 597   struct GNUNET_ATS_AddressRecord *ar;
 598   unsigned int i;
 599
 600   if (NULL != sh->mq)
 601   {
 602     GNUNET_MQ_destroy (sh->mq);
 603     sh->mq = NULL;
 604   }
 605   if (NULL != sh->task)
 606   {
 607     GNUNET_SCHEDULER_cancel (sh->task);
 608     sh->task = NULL;
 609   }
 610   for (i=0;i<sh->session_array_size;i++)
 611   {
 612     if (NULL != (ar = sh->session_array[i]))
 613     {
 614       GNUNET_HELLO_address_free (ar->address);
 615       GNUNET_free (ar);
 616       sh->session_array[i] = NULL;
 617     }
 618   }
 619   GNUNET_array_grow (sh->session_array,
 620                      sh->session_array_size,
 621                      0);
 622   GNUNET_free (sh);
 623 }
 624
 625
 626 /**
 627  * We have a new address ATS should know. Addresses have to be added
 628  * with this function before they can be: updated, set in use and
 629  * destroyed.
 630  *
 631  * @param sh handle
 632  * @param address the address
 633  * @param session session handle, can be NULL
 634  * @param prop performance data for the address
 635  * @return handle to the address representation inside ATS, NULL
 636  *         on error (i.e. ATS knows this exact address already)
 637  */
 638 struct GNUNET_ATS_AddressRecord *
 639 GNUNET_ATS_address_add (struct GNUNET_ATS_SchedulingHandle *sh,
 640                         const struct GNUNET_HELLO_Address *address,
 641                         struct GNUNET_ATS_Session *session,
 642                         const struct GNUNET_ATS_Properties *prop)
 643 {
 644   struct GNUNET_ATS_AddressRecord *ar;
 645   size_t namelen;
 646   size_t msize;
 647   uint32_t s;
 648
 649   if (NULL == address)
 650   {
 651     /* we need a valid address */
 652     GNUNET_break (0);
 653     return NULL;
 654   }
 655   GNUNET_break (GNUNET_NT_UNSPECIFIED != prop->scope);
 656   namelen = strlen (address->transport_name) + 1;
 657   msize = address->address_length + namelen;
 658   if ((msize + sizeof (struct AddressUpdateMessage) >= GNUNET_MAX_MESSAGE_SIZE) ||
 659       (address->address_length >= GNUNET_MAX_MESSAGE_SIZE) ||
 660       (namelen >= GNUNET_MAX_MESSAGE_SIZE) )
 661   {
 662     /* address too large for us, this should not happen */
 663     GNUNET_break (0);
 664     return NULL;
 665   }
 666
 667   if (NOT_FOUND !=
 668       find_session_id (sh,
 669                        session,
 670                        address))
 671   {
 672     /* Already existing, nothing todo, but this should not happen */
 673     GNUNET_break (0);
 674     return NULL;
 675   }
 676   s = find_empty_session_slot (sh);
 677   ar = GNUNET_new (struct GNUNET_ATS_AddressRecord);
 678   ar->sh = sh;
 679   ar->slot = s;
 680   ar->session = session;
 681   ar->address = GNUNET_HELLO_address_copy (address);
 682   GNUNET_ATS_properties_hton (&ar->properties,
 683                               prop);
 684   sh->session_array[s] = ar;
 685   send_add_address_message (sh, ar);
 686   return ar;
 687 }
 688
 689
 690 /**
 691  * An address was used to initiate a session.
 692  *
 693  * @param ar address record to update information for
 694  * @param session session handle
 695  */
 696 void
 697 GNUNET_ATS_address_add_session (struct GNUNET_ATS_AddressRecord *ar,
 698                                 struct GNUNET_ATS_Session *session)
 699 {
 700   GNUNET_break (NULL == ar->session);
 701   ar->session = session;
 702 }
 703
 704
 705 /**
 706  * A session was destroyed, disassociate it from the
 707  * given address record.  If this was an incoming
 708  * addess, destroy the address as well.
 709  *
 710  * @param ar address record to update information for
 711  * @param session session handle
 712  * @return #GNUNET_YES if the @a ar was destroyed because
 713  *                     it was an incoming address,
 714  *         #GNUNET_NO if the @ar was kept because we can
 715  *                    use it still to establish a new session
 716  */
 717 int
 718 GNUNET_ATS_address_del_session (struct GNUNET_ATS_AddressRecord *ar,
 719                                 struct GNUNET_ATS_Session *session)
 720 {
 721   GNUNET_assert (session == ar->session);
 722   ar->session = NULL;
 723   if (GNUNET_HELLO_address_check_option (ar->address,
 724                                          GNUNET_HELLO_ADDRESS_INFO_INBOUND))
 725   {
 726     GNUNET_ATS_address_destroy (ar);
 727     return GNUNET_YES;
 728   }
 729   return GNUNET_NO;
 730 }
 731
 732
 733 /**
 734  * We have updated performance statistics for a given address.  Note
 735  * that this function can be called for addresses that are currently
 736  * in use as well as addresses that are valid but not actively in use.
 737  * Furthermore, the peer may not even be connected to us right now (in
 738  * which case the call may be ignored or the information may be stored
 739  * for later use).  Update bandwidth assignments.
 740  *
 741  * @param ar address record to update information for
 742  * @param prop performance data for the address
 743  */
 744 void
 745 GNUNET_ATS_address_update (struct GNUNET_ATS_AddressRecord *ar,
 746                            const struct GNUNET_ATS_Properties *prop)
 747 {
 748   struct GNUNET_ATS_SchedulingHandle *sh = ar->sh;
 749   struct GNUNET_MQ_Envelope *ev;
 750   struct AddressUpdateMessage *m;
 751
 752   LOG (GNUNET_ERROR_TYPE_DEBUG,
 753        "Updating address for peer `%s', plugin `%s', session %p slot %u\n",
 754        GNUNET_i2s (&ar->address->peer),
 755        ar->address->transport_name,
 756        ar->session,
 757        ar->slot);
 758   GNUNET_break (GNUNET_NT_UNSPECIFIED != prop->scope);
 759   GNUNET_ATS_properties_hton (&ar->properties,
 760                               prop);
 761   if (NULL == sh->mq)
 762     return; /* disconnected, skip for now */
 763   ev = GNUNET_MQ_msg (m, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_UPDATE);
 764   m->session_id = htonl (ar->slot);
 765   m->peer = ar->address->peer;
 766   m->properties = ar->properties;
 767   GNUNET_MQ_send (sh->mq,
 768                   ev);
 769 }
 770
 771
 772 /**
 773  * An address got destroyed, stop using it as a valid address.
 774  *
 775  * @param ar address to destroy
 776  */
 777 void
 778 GNUNET_ATS_address_destroy (struct GNUNET_ATS_AddressRecord *ar)
 779 {
 780   struct GNUNET_ATS_SchedulingHandle *sh = ar->sh;
 781   struct GNUNET_MQ_Envelope *ev;
 782   struct AddressDestroyedMessage *m;
 783
 784   LOG (GNUNET_ERROR_TYPE_DEBUG,
 785        "Deleting address for peer `%s', plugin `%s', slot %u session %p\n",
 786        GNUNET_i2s (&ar->address->peer),
 787        ar->address->transport_name,
 788        ar->slot,
 789        ar->session);
 790   GNUNET_break (NULL == ar->session);
 791   ar->session = NULL;
 792   ar->in_destroy = GNUNET_YES;
 793   if (NULL == sh->mq)
 794     return;
 795   ev = GNUNET_MQ_msg (m, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_DESTROYED);
 796   m->session_id = htonl (ar->slot);
 797   m->peer = ar->address->peer;
 798   GNUNET_MQ_send (sh->mq, ev);
 799 }
 800
 801
 802 /* end of ats_api_scheduling.c */