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_assert (msize < GNUNET_SERVER_MAX_MESSAGE_SIZE);
89 msg = (struct PeerInformationMessage *) buf;
90 msg->header.size = htons (msize);
91 msg->header.type = htons (GNUNET_MESSAGE_TYPE_ATS_PEER_INFORMATION);
94 msg->address_length = htons (plugin_addr_len);
95 msg->address_active = ntohl ((uint32_t) active);
96 msg->plugin_name_length = htons (plugin_name_length);
97 msg->bandwidth_out = bandwidth_out;
98 msg->bandwidth_in = bandwidth_in;
100 GNUNET_ATS_properties_hton (&msg->properties,
103 memset (&msg->properties,
105 sizeof (struct GNUNET_ATS_Properties));
106 msg->address_local_info = htonl (local_address_info);
107 addrp = (char *) &msg[1];
108 memcpy (addrp, plugin_addr, plugin_addr_len);
109 strcpy (&addrp[plugin_addr_len], plugin_name);
112 GNUNET_SERVER_notification_context_broadcast (nc_pic,
118 uc = GNUNET_SERVER_client_get_user_context (client,
119 struct GNUNET_SERVER_NotificationContext *);
126 GNUNET_SERVER_notification_context_unicast (nc,
135 * Transmit the given performance information to all performance
138 * @param peer peer for which this is an address suggestion
139 * @param plugin_name 0-termintated string specifying the transport plugin
140 * @param plugin_addr binary address for the plugin to use
141 * @param plugin_addr_len number of bytes in @a plugin_addr
142 * @param active #GNUNET_YES if this address is actively used
143 * to maintain a connection to a peer;
144 * #GNUNET_NO if the address is not actively used;
145 * #GNUNET_SYSERR if this address is no longer available for ATS
146 * @param prop performance data for the address
147 * @param local_address_info information about the local flags for the address
148 * @param bandwidth_out assigned outbound bandwidth
149 * @param bandwidth_in assigned inbound bandwidth
152 GAS_performance_notify_all_clients (const struct GNUNET_PeerIdentity *peer,
153 const char *plugin_name,
154 const void *plugin_addr,
155 size_t plugin_addr_len,
157 const struct GNUNET_ATS_Properties *prop,
158 enum GNUNET_HELLO_AddressInfo local_address_info,
159 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
160 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
172 GNUNET_STATISTICS_update (GSA_stats,
173 "# performance updates given to clients",
180 * Iterator for called from #GAS_addresses_get_peer_info()
182 * @param cls closure with the `struct GNUNET_SERVER_Client *` to inform.
183 * @param id the peer id
184 * @param plugin_name plugin name
185 * @param plugin_addr address
186 * @param plugin_addr_len length of @a plugin_addr
187 * @param active is address actively used
188 * @param prop performance information
189 * @param local_address_info information about the local flags for the address
190 * @param bandwidth_out current outbound bandwidth assigned to address
191 * @param bandwidth_in current inbound bandwidth assigned to address
194 peerinfo_it (void *cls,
195 const struct GNUNET_PeerIdentity *id,
196 const char *plugin_name,
197 const void *plugin_addr,
198 size_t plugin_addr_len,
200 const struct GNUNET_ATS_Properties *prop,
201 enum GNUNET_HELLO_AddressInfo local_address_info,
202 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_out,
203 struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
205 struct GNUNET_SERVER_Client *client = cls;
209 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
210 "Callback for peer `%s' plugin `%s' BW out %u, BW in %u \n",
213 (unsigned int) ntohl (bandwidth_out.value__),
214 (unsigned int) ntohl (bandwidth_in.value__));
215 notify_client (client,
229 * Register a new performance client.
231 * @param client handle of the new client
232 * @param flag flag specifying the type of the client
235 GAS_performance_add_client (struct GNUNET_SERVER_Client *client,
238 if (START_FLAG_PERFORMANCE_WITH_PIC == flag)
240 GNUNET_SERVER_notification_context_add (nc_pic,
242 GNUNET_SERVER_client_set_user_context (client,
244 GAS_addresses_get_peer_info (NULL,
250 GNUNET_SERVER_notification_context_add (nc_no_pic,
252 GNUNET_SERVER_client_set_user_context (client,
259 * Initialize performance subsystem.
261 * @param server handle to our server
264 GAS_performance_init (struct GNUNET_SERVER_Handle *server)
266 nc_no_pic = GNUNET_SERVER_notification_context_create (server, 32);
267 nc_pic = GNUNET_SERVER_notification_context_create (server, 32);
272 * Shutdown performance subsystem.
275 GAS_performance_done ()
277 GNUNET_SERVER_notification_context_destroy (nc_no_pic);
279 GNUNET_SERVER_notification_context_destroy (nc_pic);
283 /* end of gnunet-service-ats_performance.c */