2 This file is part of GNUnet.
3 (C) 2011 Christian Grothoff (and other contributing authors)
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.
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.
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.
22 * @file ats/gnunet-service-ats_scheduling.c
23 * @brief ats service, interaction with 'scheduling' API
24 * @author Matthias Wachs
25 * @author Christian Grothoff
28 #include "gnunet-service-ats_addresses.h"
29 #include "gnunet-service-ats_scheduling.h"
34 * We keep clients that are interested in scheduling in a linked list.
35 * This list typically has only one entry (for the
36 * gnunet-service-transport process); however, it is possible that
37 * there is more than one (at least briefly) because after a crash a
38 * new one may connect before we've been notified to clean up the old
41 struct SchedulingClient
44 * Next in doubly-linked list.
46 struct SchedulingClient * next;
49 * Previous in doubly-linked list.
51 struct SchedulingClient * prev;
54 * Actual handle to the client.
56 struct GNUNET_SERVER_Client *client;
62 * Head of linked list of all clients to this service.
64 static struct SchedulingClient *sc_head;
67 * Tail of linked list of all clients to this service.
69 static struct SchedulingClient *sc_tail;
72 * Context for sending messages to clients.
74 static struct GNUNET_SERVER_NotificationContext *nc;
78 * Find the scheduling client associated with the given
81 * @param client server handle
82 * @return internal handle
84 static struct SchedulingClient *
85 find_client (struct GNUNET_SERVER_Client *client)
87 struct SchedulingClient * sc;
89 for (sc = sc_head; sc != NULL; sc = sc->next)
90 if (sc->client == client)
97 * Register a new scheduling client.
99 * @param client handle of the new client
102 GAS_scheduling_add_client (struct GNUNET_SERVER_Client *client)
104 struct SchedulingClient *sc;
106 GNUNET_break (NULL == find_client (client));
107 sc = GNUNET_malloc (sizeof (struct SchedulingClient));
109 GNUNET_SERVER_notification_context_add (nc, client);
110 GNUNET_SERVER_client_keep (client);
111 GNUNET_CONTAINER_DLL_insert(sc_head, sc_tail, sc);
117 * Unregister a client (which may have been a scheduling client,
118 * but this is not assured).
120 * @param client handle of the (now dead) client
123 GAS_scheduling_remove_client (struct GNUNET_SERVER_Client *client)
125 struct SchedulingClient * sc;
127 sc = find_client (client);
130 GNUNET_CONTAINER_DLL_remove (sc_head, sc_tail, sc);
131 GAS_address_client_disconnected (client);
132 GNUNET_SERVER_client_drop (client);
138 * Transmit the given address suggestion and bandwidth update to all scheduling
141 * @param peer peer for which this is an address suggestion
142 * @param plugin_name 0-termintated string specifying the transport plugin
143 * @param plugin_addr binary address for the plugin to use
144 * @param plugin_addr_len number of bytes in plugin_addr
145 * @param session_client which client gave us this session_id?
146 * @param session_id session ID to use for the given client (other clients will see 0)
147 * @param atsi performance data for the address
148 * @param atsi_count number of performance records in 'ats'
149 * @param bandwidth_out assigned outbound bandwidth
150 * @param bandwidth_in assigned inbound bandwidth
153 GAS_scheduling_transmit_address_suggestion (const struct GNUNET_PeerIdentity *peer,
154 const char *plugin_name,
155 const void *plugin_addr, size_t plugin_addr_len,
156 struct GNUNET_SERVER_Client *session_client,
158 const struct GNUNET_ATS_Information *atsi,
160 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
161 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
163 struct SchedulingClient *sc;
164 struct AddressSuggestionMessage *msg;
165 size_t plugin_name_length = strlen (plugin_name) + 1;
166 size_t msize = sizeof (struct AddressSuggestionMessage) + atsi_count * sizeof (struct GNUNET_ATS_Information)
167 + plugin_addr_len + plugin_name_length;
169 struct GNUNET_ATS_Information *atsp;
172 GNUNET_assert (msize < GNUNET_SERVER_MAX_MESSAGE_SIZE);
173 GNUNET_assert (atsi_count < GNUNET_SERVER_MAX_MESSAGE_SIZE / sizeof (struct GNUNET_ATS_Information));
174 msg = (struct AddressSuggestionMessage*) buf;
175 msg->header.size = htons (msize);
176 msg->header.type = htons (GNUNET_MESSAGE_TYPE_ATS_ADDRESS_SUGGESTION);
177 msg->ats_count = htonl (atsi_count);
179 msg->address_length = htons (plugin_addr_len);
180 msg->plugin_name_length = htons (plugin_name_length);
181 /* session ID is set only if 'client' is the same... */
182 msg->bandwidth_out = bandwidth_out;
183 msg->bandwidth_in = bandwidth_in;
184 atsp = (struct GNUNET_ATS_Information* ) &msg[1];
185 memcpy (atsp, atsi, sizeof (struct GNUNET_ATS_Information) * atsi_count);
186 addrp = (char*) &atsp[atsi_count];
187 memcpy (addrp, plugin_addr, plugin_addr_len);
188 strcpy (&addrp[plugin_addr_len], plugin_name);
189 for (sc = sc_head; sc != NULL; sc = sc->next)
191 if (sc->client == session_client)
192 msg->session_id = htonl (session_id);
194 msg->session_id = htonl (0);
195 GNUNET_SERVER_notification_context_unicast (nc,
204 * Handle 'request address' messages from clients.
206 * @param cls unused, NULL
207 * @param client client that sent the request
208 * @param message the request message
211 GAS_handle_request_address (void *cls, struct GNUNET_SERVER_Client *client,
212 const struct GNUNET_MessageHeader *message)
215 const struct RequestAddressMessage * msg = (const struct RequestAddressMessage *) message;
217 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' message\n", "REQUEST_ADDRESS");
218 GNUNET_break (0 == ntohl (msg->reserved));
219 GAS_addresses_request_address (&msg->peer);
220 GNUNET_SERVER_receive_done (client, GNUNET_OK);
225 * Handle 'address update' messages from clients.
227 * @param cls unused, NULL
228 * @param client client that sent the request
229 * @param message the request message
232 GAS_handle_address_update (void *cls, struct GNUNET_SERVER_Client *client,
233 const struct GNUNET_MessageHeader *message)
236 const struct AddressUpdateMessage * m;
237 const struct GNUNET_ATS_Information *atsi;
239 const char *plugin_name;
240 uint16_t address_length;
241 uint16_t plugin_name_length;
245 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
246 "Received `%s' message\n",
248 size = ntohs (message->size);
249 if (size <= sizeof (struct AddressUpdateMessage))
252 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
255 m = (const struct AddressUpdateMessage*) message;
256 ats_count = ntohl (m->ats_count);
257 address_length = ntohs (m->address_length);
258 plugin_name_length = ntohs (m->plugin_name_length);
259 atsi = (const struct GNUNET_ATS_Information*) &m[1];
260 address = (const char*) &atsi[ats_count];
261 if (plugin_name_length != 0)
262 plugin_name = &address[address_length];
265 if ( (address_length +
267 ats_count * sizeof (struct GNUNET_ATS_Information) +
268 sizeof (struct AddressUpdateMessage) != ntohs (message->size)) ||
269 (ats_count > GNUNET_SERVER_MAX_MESSAGE_SIZE / sizeof (struct GNUNET_ATS_Information)) ||
270 (plugin_name[plugin_name_length - 1] != '\0') )
273 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
276 GAS_address_update (&m->peer,
281 ntohl (m->session_id),
284 GNUNET_SERVER_receive_done (client, GNUNET_OK);
289 * Handle 'address destroyed' messages from clients.
291 * @param cls unused, NULL
292 * @param client client that sent the request
293 * @param message the request message
296 GAS_handle_address_destroyed (void *cls, struct GNUNET_SERVER_Client *client,
297 const struct GNUNET_MessageHeader *message)
300 const struct AddressDestroyedMessage * m;
302 const char *plugin_name;
303 uint16_t address_length;
304 uint16_t plugin_name_length;
307 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
308 "Received `%s' message of size %u %u\n",
309 "ADDRESS_DESTROYED", ntohs (message->size), sizeof (struct AddressDestroyedMessage));
310 size = ntohs (message->size);
311 if (size < sizeof (struct AddressDestroyedMessage))
314 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
317 m = (const struct AddressDestroyedMessage*) message;
318 GNUNET_break (0 == ntohl (m->reserved));
319 address_length = ntohs (m->address_length);
320 plugin_name_length = ntohs (m->plugin_name_length);
321 address = (const char*) &m[1];
322 if (plugin_name_length != 0)
323 plugin_name = &address[address_length];
327 if ( (address_length +
329 sizeof (struct AddressDestroyedMessage) != ntohs (message->size)))
332 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
336 if (plugin_name_length != 0)
337 if (plugin_name[plugin_name_length - 1] != '\0')
340 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
344 GAS_address_destroyed (&m->peer,
349 ntohl (m->session_id));
350 GNUNET_SERVER_receive_done (client, GNUNET_OK);
355 * Initialize scheduling subsystem.
357 * @param server handle to our server
360 GAS_scheduling_init (struct GNUNET_SERVER_Handle *server)
362 nc = GNUNET_SERVER_notification_context_create (server, 128);
367 * Shutdown scheduling subsystem.
370 GAS_scheduling_done ()
372 GNUNET_SERVER_notification_context_destroy (nc);
377 /* end of gnunet-service-ats_scheduling.c */