2 This file is part of GNUnet.
3 Copyright (C) 2011-2015 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., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
21 * @file ats/gnunet-service-ats_performance.c
22 * @brief ats service, interaction with 'performance' API
23 * @author Matthias Wachs
24 * @author Christian Grothoff
27 * - simplify functions by passing a `struct GNUNET_HELLO_Address`
30 #include "gnunet-service-ats.h"
31 #include "gnunet-service-ats_addresses.h"
32 #include "gnunet-service-ats_performance.h"
37 * Context for sending messages to performance clients without PIC.
39 static struct GNUNET_SERVER_NotificationContext *nc_no_pic;
42 * Context for sending messages to performance clients with PIC.
44 static struct GNUNET_SERVER_NotificationContext *nc_pic;
48 * Transmit the given performance information to all performance
51 * @param pc client to send to, NULL for all
52 * @param peer peer for which this is an address suggestion
53 * @param plugin_name 0-termintated string specifying the transport plugin
54 * @param plugin_addr binary address for the plugin to use
55 * @param plugin_addr_len number of bytes in plugin_addr
56 * @param active #GNUNET_YES if this address is actively used
57 * to maintain a connection to a peer;
58 * #GNUNET_NO if the address is not actively used;
59 * #GNUNET_SYSERR if this address is no longer available for ATS
60 * @param prop performance data for the address
61 * @param local_address_info information about the local flags for the address
62 * @param bandwidth_out assigned outbound bandwidth
63 * @param bandwidth_in assigned inbound bandwidth
66 notify_client (struct GNUNET_SERVER_Client *client,
67 const struct GNUNET_PeerIdentity *peer,
68 const char *plugin_name,
69 const void *plugin_addr,
70 size_t plugin_addr_len,
72 const struct GNUNET_ATS_Properties *prop,
73 enum GNUNET_HELLO_AddressInfo local_address_info,
74 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
75 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
77 struct PeerInformationMessage *msg;
78 size_t plugin_name_length = strlen (plugin_name) + 1;
80 sizeof (struct PeerInformationMessage) +
83 char buf[msize] GNUNET_ALIGN;
84 struct GNUNET_SERVER_NotificationContext **uc;
85 struct GNUNET_SERVER_NotificationContext *nc;
88 GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != prop->scope);
89 GNUNET_assert (msize < GNUNET_SERVER_MAX_MESSAGE_SIZE);
90 msg = (struct PeerInformationMessage *) buf;
91 msg->header.size = htons (msize);
92 msg->header.type = htons (GNUNET_MESSAGE_TYPE_ATS_PEER_INFORMATION);
95 msg->address_length = htons (plugin_addr_len);
96 msg->address_active = ntohl ((uint32_t) active);
97 msg->plugin_name_length = htons (plugin_name_length);
98 msg->bandwidth_out = bandwidth_out;
99 msg->bandwidth_in = bandwidth_in;
101 GNUNET_ATS_properties_hton (&msg->properties,
104 memset (&msg->properties,
106 sizeof (struct GNUNET_ATS_Properties));
107 msg->address_local_info = htonl (local_address_info);
108 addrp = (char *) &msg[1];
109 memcpy (addrp, plugin_addr, plugin_addr_len);
110 strcpy (&addrp[plugin_addr_len], plugin_name);
113 GNUNET_SERVER_notification_context_broadcast (nc_pic,
119 uc = GNUNET_SERVER_client_get_user_context (client,
120 struct GNUNET_SERVER_NotificationContext *);
127 GNUNET_SERVER_notification_context_unicast (nc,
136 * Transmit the given performance information to all performance
139 * @param peer peer for which this is an address suggestion
140 * @param plugin_name 0-termintated string specifying the transport plugin
141 * @param plugin_addr binary address for the plugin to use
142 * @param plugin_addr_len number of bytes in @a plugin_addr
143 * @param active #GNUNET_YES if this address is actively used
144 * to maintain a connection to a peer;
145 * #GNUNET_NO if the address is not actively used;
146 * #GNUNET_SYSERR if this address is no longer available for ATS
147 * @param prop performance data for the address
148 * @param local_address_info information about the local flags for the address
149 * @param bandwidth_out assigned outbound bandwidth
150 * @param bandwidth_in assigned inbound bandwidth
153 GAS_performance_notify_all_clients (const struct GNUNET_PeerIdentity *peer,
154 const char *plugin_name,
155 const void *plugin_addr,
156 size_t plugin_addr_len,
158 const struct GNUNET_ATS_Properties *prop,
159 enum GNUNET_HELLO_AddressInfo local_address_info,
160 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
161 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
163 GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != prop->scope);
174 GNUNET_STATISTICS_update (GSA_stats,
175 "# performance updates given to clients",
182 * Iterator for called from #GAS_addresses_get_peer_info()
184 * @param cls closure with the `struct GNUNET_SERVER_Client *` to inform.
185 * @param id the peer id
186 * @param plugin_name plugin name
187 * @param plugin_addr address
188 * @param plugin_addr_len length of @a plugin_addr
189 * @param active is address actively used
190 * @param prop performance information
191 * @param local_address_info information about the local flags for the address
192 * @param bandwidth_out current outbound bandwidth assigned to address
193 * @param bandwidth_in current inbound bandwidth assigned to address
196 peerinfo_it (void *cls,
197 const struct GNUNET_PeerIdentity *id,
198 const char *plugin_name,
199 const void *plugin_addr,
200 size_t plugin_addr_len,
202 const struct GNUNET_ATS_Properties *prop,
203 enum GNUNET_HELLO_AddressInfo local_address_info,
204 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
205 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
207 struct GNUNET_SERVER_Client *client = cls;
211 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
212 "Callback for peer `%s' plugin `%s' BW out %u, BW in %u \n",
215 (unsigned int) ntohl (bandwidth_out.value__),
216 (unsigned int) ntohl (bandwidth_in.value__));
217 GNUNET_break (GNUNET_ATS_NET_UNSPECIFIED != prop->scope);
218 notify_client (client,
232 * Register a new performance client.
234 * @param client handle of the new client
235 * @param flag flag specifying the type of the client
238 GAS_performance_add_client (struct GNUNET_SERVER_Client *client,
241 if (START_FLAG_PERFORMANCE_WITH_PIC == flag)
243 GNUNET_SERVER_notification_context_add (nc_pic,
245 GNUNET_SERVER_client_set_user_context (client,
247 GAS_addresses_get_peer_info (NULL,
253 GNUNET_SERVER_notification_context_add (nc_no_pic,
255 GNUNET_SERVER_client_set_user_context (client,
262 * Initialize performance subsystem.
264 * @param server handle to our server
267 GAS_performance_init (struct GNUNET_SERVER_Handle *server)
269 nc_no_pic = GNUNET_SERVER_notification_context_create (server, 32);
270 nc_pic = GNUNET_SERVER_notification_context_create (server, 32);
275 * Shutdown performance subsystem.
278 GAS_performance_done ()
280 GNUNET_SERVER_notification_context_destroy (nc_no_pic);
282 GNUNET_SERVER_notification_context_destroy (nc_pic);
286 /* end of gnunet-service-ats_performance.c */