src/ats/gnunet-service-ats_scheduling.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 ats/gnunet-service-ats_scheduling.c
  23  * @brief ats service, interaction with 'scheduling' API
  24  * @author Matthias Wachs
  25  * @author Christian Grothoff
  26  */
  27 #include "platform.h"
  28 #include "gnunet-service-ats.h"
  29 #include "gnunet-service-ats_addresses.h"
  30 #include "gnunet-service-ats_scheduling.h"
  31 #include "ats.h"
  32
  33
  34 /**
  35  * Context for sending messages to clients.
  36  */
  37 static struct GNUNET_SERVER_NotificationContext *nc;
  38
  39 /**
  40  * Actual handle to the client.
  41  */
  42 static struct GNUNET_SERVER_Client *my_client;
  43
  44
  45 /**
  46  * Register a new scheduling client.
  47  *
  48  * @param client handle of the new client
  49  * @return GNUNET_OK on success, GNUNET_SYSERR on error
  50  */
  51 int
  52 GAS_scheduling_add_client (struct GNUNET_SERVER_Client *client)
  53 {
  54   if (my_client != NULL)
  55   {
  56     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
  57                 "This ATS already has a scheduling client, refusing new scheduling client for now.\n");
  58     return GNUNET_SYSERR;
  59   }
  60   my_client = client;
  61   GNUNET_SERVER_notification_context_add (nc, client);
  62   GNUNET_SERVER_client_keep (client);
  63   return GNUNET_OK;
  64 }
  65
  66
  67 /**
  68  * Unregister a client (which may have been a scheduling client,
  69  * but this is not assured).
  70  *
  71  * @param client handle of the (now dead) client
  72  */
  73 void
  74 GAS_scheduling_remove_client (struct GNUNET_SERVER_Client *client)
  75 {
  76   if (my_client != client)
  77     return;
  78   GAS_addresses_destroy_all ();
  79   GNUNET_SERVER_client_drop (client);
  80   my_client = NULL;
  81 }
  82
  83
  84 /**
  85  * Transmit the given address suggestion and bandwidth update to all scheduling
  86  * clients.
  87  *
  88  * @param peer peer for which this is an address suggestion
  89  * @param plugin_name 0-termintated string specifying the transport plugin
  90  * @param plugin_addr binary address for the plugin to use
  91  * @param plugin_addr_len number of bytes in plugin_addr
  92  * @param session_id session ID to use for the given client (other clients will see 0)
  93  * @param atsi performance data for the address
  94  * @param atsi_count number of performance records in 'ats'
  95  * @param bandwidth_out assigned outbound bandwidth
  96  * @param bandwidth_in assigned inbound bandwidth
  97  */
  98 void
  99 GAS_scheduling_transmit_address_suggestion (const struct GNUNET_PeerIdentity
 100                                             *peer, const char *plugin_name,
 101                                             const void *plugin_addr,
 102                                             size_t plugin_addr_len,
 103                                             uint32_t session_id,
 104                                             const struct GNUNET_ATS_Information
 105                                             *atsi, uint32_t atsi_count,
 106                                             struct GNUNET_BANDWIDTH_Value32NBO
 107                                             bandwidth_out,
 108                                             struct GNUNET_BANDWIDTH_Value32NBO
 109                                             bandwidth_in)
 110 {
 111   struct AddressSuggestionMessage *msg;
 112   size_t plugin_name_length = strlen (plugin_name) + 1;
 113   size_t msize =
 114       sizeof (struct AddressSuggestionMessage) +
 115       atsi_count * sizeof (struct GNUNET_ATS_Information) + plugin_addr_len +
 116       plugin_name_length;
 117   char buf[msize] GNUNET_ALIGN;
 118   struct GNUNET_ATS_Information *atsp;
 119   char *addrp;
 120
 121   if (my_client == NULL)
 122     return;
 123   GNUNET_STATISTICS_update (GSA_stats, "# address suggestions made", 1,
 124                             GNUNET_NO);
 125   GNUNET_assert (msize < GNUNET_SERVER_MAX_MESSAGE_SIZE);
 126   GNUNET_assert (atsi_count <
 127                  GNUNET_SERVER_MAX_MESSAGE_SIZE /
 128                  sizeof (struct GNUNET_ATS_Information));
 129   msg = (struct AddressSuggestionMessage *) buf;
 130   msg->header.size = htons (msize);
 131   msg->header.type = htons (GNUNET_MESSAGE_TYPE_ATS_ADDRESS_SUGGESTION);
 132   msg->ats_count = htonl (atsi_count);
 133   msg->peer = *peer;
 134   msg->address_length = htons (plugin_addr_len);
 135   msg->plugin_name_length = htons (plugin_name_length);
 136   msg->session_id = htonl (session_id);
 137   msg->bandwidth_out = bandwidth_out;
 138   msg->bandwidth_in = bandwidth_in;
 139   atsp = (struct GNUNET_ATS_Information *) &msg[1];
 140   memcpy (atsp, atsi, sizeof (struct GNUNET_ATS_Information) * atsi_count);
 141   addrp = (char *) &atsp[atsi_count];
 142   memcpy (addrp, plugin_addr, plugin_addr_len);
 143   strcpy (&addrp[plugin_addr_len], plugin_name);
 144
 145   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
 146               "ATS sends quota for peer `%s': (in/out) %u/%u\n",
 147               GNUNET_i2s (peer), ntohl (bandwidth_in.value__),
 148               ntohl (bandwidth_out.value__));
 149
 150   GNUNET_SERVER_notification_context_unicast (nc, my_client, &msg->header,
 151                                               GNUNET_YES);
 152 }
 153
 154
 155 /**
 156  * Handle 'request address' messages from clients.
 157  *
 158  * @param cls unused, NULL
 159  * @param client client that sent the request
 160  * @param message the request message
 161  */
 162 void
 163 GAS_handle_request_address (void *cls, struct GNUNET_SERVER_Client *client,
 164                             const struct GNUNET_MessageHeader *message)
 165 {
 166   const struct RequestAddressMessage *msg =
 167       (const struct RequestAddressMessage *) message;
 168
 169   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' message\n",
 170               "REQUEST_ADDRESS");
 171   GNUNET_STATISTICS_update (GSA_stats, "# address requests received", 1,
 172                             GNUNET_NO);
 173   GNUNET_break (0 == ntohl (msg->reserved));
 174   GAS_addresses_request_address (&msg->peer);
 175   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 176 }
 177
 178
 179 /**
 180  * Handle 'request address' messages from clients.
 181  *
 182  * @param cls unused, NULL
 183  * @param client client that sent the request
 184  * @param message the request message
 185  */
 186 void
 187 GAS_handle_request_address_cancel (void *cls,
 188                                    struct GNUNET_SERVER_Client *client,
 189                                    const struct GNUNET_MessageHeader *message)
 190 {
 191   const struct RequestAddressMessage *msg =
 192       (const struct RequestAddressMessage *) message;
 193
 194   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' message\n",
 195               "REQUEST_ADDRESS_CANCEL");
 196   GNUNET_break (0 == ntohl (msg->reserved));
 197
 198   /* TODO */
 199
 200   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 201 }
 202
 203
 204 /**
 205  * Handle 'address update' messages from clients.
 206  *
 207  * @param cls unused, NULL
 208  * @param client client that sent the request
 209  * @param message the request message
 210  */
 211 void
 212 GAS_handle_address_update (void *cls, struct GNUNET_SERVER_Client *client,
 213                            const struct GNUNET_MessageHeader *message)
 214 {
 215   const struct AddressUpdateMessage *m;
 216   const struct GNUNET_ATS_Information *atsi;
 217   const char *address;
 218   const char *plugin_name;
 219   uint16_t address_length;
 220   uint16_t plugin_name_length;
 221   uint32_t ats_count;
 222   uint16_t size;
 223
 224   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' message\n",
 225               "ADDRESS_UPDATE");
 226   size = ntohs (message->size);
 227   if (size < sizeof (struct AddressUpdateMessage))
 228   {
 229     GNUNET_break (0);
 230     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 231     return;
 232   }
 233   m = (const struct AddressUpdateMessage *) message;
 234   ats_count = ntohl (m->ats_count);
 235   address_length = ntohs (m->address_length);
 236   plugin_name_length = ntohs (m->plugin_name_length);
 237   atsi = (const struct GNUNET_ATS_Information *) &m[1];
 238   address = (const char *) &atsi[ats_count];
 239   if (plugin_name_length != 0)
 240     plugin_name = &address[address_length];
 241   else
 242     plugin_name = "";
 243
 244   if ((address_length + plugin_name_length +
 245        ats_count * sizeof (struct GNUNET_ATS_Information) +
 246        sizeof (struct AddressUpdateMessage) != ntohs (message->size)) ||
 247       (ats_count >
 248        GNUNET_SERVER_MAX_MESSAGE_SIZE / sizeof (struct GNUNET_ATS_Information)) ||
 249        ((plugin_name_length > 0) && (plugin_name[plugin_name_length - 1] != '\0')))
 250   {
 251     GNUNET_break (0);
 252     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 253     return;
 254   }
 255   GNUNET_STATISTICS_update (GSA_stats, "# address updates received", 1,
 256                             GNUNET_NO);
 257   GAS_addresses_update (&m->peer, plugin_name, address, address_length,
 258                         ntohl (m->session_id), atsi, ats_count);
 259   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 260 }
 261
 262
 263 /**
 264  * Handle 'address in use' messages from clients.
 265  *
 266  * @param cls unused, NULL
 267  * @param client client that sent the request
 268  * @param message the request message
 269  */
 270 void
 271 GAS_handle_address_in_use (void *cls, struct GNUNET_SERVER_Client *client,
 272                            const struct GNUNET_MessageHeader *message)
 273 {
 274   const struct AddressUseMessage *m;
 275   const char *address;
 276   const char *plugin_name;
 277   int res;
 278   uint16_t address_length;
 279   uint16_t plugin_name_length;
 280
 281   uint16_t size;
 282   uint16_t in_use;
 283
 284   size = ntohs (message->size);
 285   if (size < sizeof (struct AddressUseMessage))
 286   {
 287     GNUNET_break (0);
 288     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 289     return;
 290   }
 291   m = (const struct AddressUseMessage *) message;
 292
 293   address_length = ntohs (m->address_length);
 294   plugin_name_length = ntohs (m->plugin_name_length);
 295
 296   address = (const char *) &m[1];
 297   if (plugin_name_length != 0)
 298     plugin_name = &address[address_length];
 299   else
 300     plugin_name = "";
 301
 302   if ((address_length + plugin_name_length +
 303        sizeof (struct AddressUseMessage) != ntohs (message->size)) ||
 304       ((plugin_name_length > 0) &&
 305       (plugin_name[plugin_name_length - 1] != '\0')))
 306   {
 307     GNUNET_break (0);
 308     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 309     return;
 310   }
 311
 312   in_use = ntohs (m->in_use);
 313   res = GAS_addresses_in_use (&m->peer,
 314                              plugin_name,
 315                              address,
 316                              address_length,
 317                              ntohl (m->session_id),
 318                              in_use);
 319
 320   if (res == GNUNET_OK)
 321     GNUNET_SERVER_receive_done (client, GNUNET_OK);
 322   else
 323   {
 324     GNUNET_break (0);
 325     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 326   }
 327
 328 }
 329
 330 /**
 331  * Handle 'address destroyed' messages from clients.
 332  *
 333  * @param cls unused, NULL
 334  * @param client client that sent the request
 335  * @param message the request message
 336  */
 337 void
 338 GAS_handle_address_destroyed (void *cls, struct GNUNET_SERVER_Client *client,
 339                               const struct GNUNET_MessageHeader *message)
 340 {
 341   const struct AddressDestroyedMessage *m;
 342   struct SessionReleaseMessage srm;
 343   const char *address;
 344   const char *plugin_name;
 345   uint16_t address_length;
 346   uint16_t plugin_name_length;
 347   uint16_t size;
 348
 349   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' message of size %u %u\n",
 350               "ADDRESS_DESTROYED", ntohs (message->size),
 351               sizeof (struct AddressDestroyedMessage));
 352   size = ntohs (message->size);
 353   if ((size < sizeof (struct AddressDestroyedMessage)) || (client != my_client))
 354   {
 355     GNUNET_break (0);
 356     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 357     return;
 358   }
 359   m = (const struct AddressDestroyedMessage *) message;
 360   GNUNET_break (0 == ntohl (m->reserved));
 361   address_length = ntohs (m->address_length);
 362   plugin_name_length = ntohs (m->plugin_name_length);
 363   address = (const char *) &m[1];
 364   if (plugin_name_length != 0)
 365     plugin_name = &address[address_length];
 366   else
 367     plugin_name = "";
 368   if ((address_length + plugin_name_length +
 369        sizeof (struct AddressDestroyedMessage) != ntohs (message->size)))
 370   {
 371     GNUNET_break (0);
 372     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 373     return;
 374   }
 375   if ((plugin_name_length == 0) ||
 376       (plugin_name[plugin_name_length - 1] != '\0'))
 377   {
 378     GNUNET_break (0);
 379     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 380     return;
 381   }
 382   GNUNET_STATISTICS_update (GSA_stats, "# addresses destroyed", 1, GNUNET_NO);
 383   GAS_addresses_destroy (&m->peer, plugin_name, address, address_length,
 384                          ntohl (m->session_id));
 385   if (0 != ntohl (m->session_id))
 386   {
 387     srm.header.type = ntohs (GNUNET_MESSAGE_TYPE_ATS_SESSION_RELEASE);
 388     srm.header.size = ntohs (sizeof (struct SessionReleaseMessage));
 389     srm.session_id = m->session_id;
 390     srm.peer = m->peer;
 391     GNUNET_SERVER_notification_context_unicast (nc, client, &srm.header,
 392                                                 GNUNET_NO);
 393   }
 394   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 395 }
 396
 397
 398 /**
 399  * Initialize scheduling subsystem.
 400  *
 401  * @param server handle to our server
 402  */
 403 void
 404 GAS_scheduling_init (struct GNUNET_SERVER_Handle *server)
 405 {
 406   nc = GNUNET_SERVER_notification_context_create (server, 128);
 407 }
 408
 409
 410 /**
 411  * Shutdown scheduling subsystem.
 412  */
 413 void
 414 GAS_scheduling_done ()
 415 {
 416   GNUNET_SERVER_notification_context_destroy (nc);
 417   nc = NULL;
 418 }
 419
 420
 421 /* end of gnunet-service-ats_scheduling.c */