GNUnet  0.11.x
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2011 GNUnet e.V.
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.
10  GNUnet is distributed in the hope that it will be useful, but
11  WITHOUT ANY WARRANTY; without even the implied warranty of
13  Affero General Public License for more details.
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <>.
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
26 #include "platform.h"
27 #include "gnunet_util_lib.h"
28 #include "gnunet-service-ats.h"
37 #include "ats.h"
52 static void
53 handle_ats_start (void *cls,
54  const struct ClientStartMessage *msg)
55 {
56  struct GNUNET_SERVICE_Client *client = cls;
57  enum StartFlag flag;
59  flag = ntohl (msg->start_flag);
61  "Received ATS_START (%d) message\n",
62  (int) flag);
63  switch (flag)
64  {
66  if (GNUNET_OK !=
68  {
70  return;
71  }
72  break;
76  flag);
77  break;
81  flag);
82  break;
85  /* This client won't receive messages from us, no need to 'add' */
86  break;
88  default:
89  GNUNET_break (0);
91  return;
92  }
94 }
103 static void
105  const struct ReservationRequestMessage *message)
106 {
107  struct GNUNET_SERVICE_Client *client = cls;
110  message);
112 }
122 static int
123 check_feedback (void *cls,
124  const struct FeedbackPreferenceMessage *message)
125 {
126  uint16_t msize;
127  uint32_t nump;
130  "Received PREFERENCE_FEEDBACK message\n");
131  msize = ntohs (message->header.size);
132  nump = ntohl (message->num_feedback);
133  if (msize !=
134  sizeof(struct FeedbackPreferenceMessage)
135  + nump * sizeof(struct PreferenceInformation))
136  {
137  GNUNET_break (0);
138  return GNUNET_SYSERR;
139  }
140  return GNUNET_OK;
141 }
150 static void
151 handle_feedback (void *cls,
152  const struct FeedbackPreferenceMessage *msg)
153 {
154  struct GNUNET_SERVICE_Client *client = cls;
155  const struct PreferenceInformation *pi;
156  uint32_t nump;
158  nump = ntohl (msg->num_feedback);
159  if (GNUNET_NO ==
161  &msg->peer))
162  {
164  "Received PREFERENCE FEEDBACK for unknown peer `%s'\n",
165  GNUNET_i2s (&msg->peer));
167  return;
168  }
170  GNUNET_STATISTICS_update (GSA_stats,
171  "# preference feedbacks requests processed",
172  1,
173  GNUNET_NO);
174  pi = (const struct PreferenceInformation *) &msg[1];
175  for (uint32_t i = 0; i < nump; i++)
176  {
178  "Received PREFERENCE FEEDBACK for peer `%s'\n",
179  GNUNET_i2s (&msg->peer));
181  &msg->peer,
183  (enum GNUNET_ATS_PreferenceKind) ntohl (
184  pi[i].preference_kind),
185  pi[i].preference_value);
186  }
188 }
197 static void
199  const struct AddressListRequestMessage *message)
200 {
201  struct GNUNET_SERVICE_Client *client = cls;
204  message);
206 }
215 static void
217  const struct RequestAddressMessage *message)
218 {
219  struct GNUNET_SERVICE_Client *client = cls;
222  message);
224 }
233 static void
235  const struct RequestAddressMessage *message)
236 {
237  struct GNUNET_SERVICE_Client *client = cls;
240  message);
242 }
251 static int
252 check_address_add (void *cls,
253  const struct AddressAddMessage *m)
254 {
255  const char *address;
256  const char *plugin_name;
257  uint16_t address_length;
258  uint16_t plugin_name_length;
259  uint16_t size;
261  size = ntohs (m->header.size);
262  address_length = ntohs (m->address_length);
263  plugin_name_length = ntohs (m->plugin_name_length);
264  address = (const char *) &m[1];
265  if (plugin_name_length != 0)
266  plugin_name = &address[address_length];
267  else
268  plugin_name = "";
270  if ((address_length + plugin_name_length
271  + sizeof(struct AddressAddMessage) != size) ||
272  ((plugin_name_length > 0) &&
273  (plugin_name[plugin_name_length - 1] != '\0')))
274  {
275  GNUNET_break (0);
276  return GNUNET_SYSERR;
277  }
278  return GNUNET_OK;
279 }
288 static void
290  const struct AddressAddMessage *message)
291 {
292  struct GNUNET_SERVICE_Client *client = cls;
294  GAS_handle_address_add (message);
296 }
305 static void
307  const struct AddressUpdateMessage *message)
308 {
309  struct GNUNET_SERVICE_Client *client = cls;
311  GAS_handle_address_update (message);
313 }
322 static void
324  const struct AddressDestroyedMessage *message)
325 {
326  struct GNUNET_SERVICE_Client *client = cls;
330 }
340 static int
342  const struct ChangePreferenceMessage *message)
343 {
344  uint16_t msize;
345  uint32_t nump;
347  msize = ntohs (message->header.size);
348  nump = ntohl (message->num_preferences);
349  if ((msize !=
350  sizeof(struct ChangePreferenceMessage)
351  + nump * sizeof(struct PreferenceInformation)) ||
352  (UINT16_MAX / sizeof(struct PreferenceInformation) < nump))
353  {
354  GNUNET_break (0);
355  return GNUNET_SYSERR;
356  }
357  return GNUNET_OK;
358 }
367 static void
369  const struct ChangePreferenceMessage *message)
370 {
371  struct GNUNET_SERVICE_Client *client = cls;
374  message);
376 }
388 static void *
389 client_connect_cb (void *cls,
390  struct GNUNET_SERVICE_Client *client,
391  struct GNUNET_MQ_Handle *mq)
392 {
393  return client;
394 }
405 static void
407  struct GNUNET_SERVICE_Client *client,
408  void *app_ctx)
409 {
410  if (NULL == client)
411  return;
415 }
423 static void
424 cleanup_task (void *cls)
425 {
427  "ATS shutdown initiated\n");
430  GAS_plugin_done ();
435  if (NULL != GSA_stats)
436  {
438  GSA_stats = NULL;
439  }
440 }
450 static void
451 run (void *cls,
452  const struct GNUNET_CONFIGURATION_Handle *cfg,
454 {
455  GSA_stats = GNUNET_STATISTICS_create ("ats",
456  cfg);
462  if (GNUNET_OK !=
463  GAS_plugin_init (cfg))
464  {
465  GNUNET_break (0);
471  if (NULL != GSA_stats)
472  {
473  GNUNET_STATISTICS_destroy (GSA_stats,
474  GNUNET_NO);
475  GSA_stats = NULL;
476  }
477  return;
478  }
481  NULL);
482 }
489  ("ats",
491  &run,
494  NULL,
495  GNUNET_MQ_hd_fixed_size (ats_start,
497  struct ClientStartMessage,
498  NULL),
499  GNUNET_MQ_hd_fixed_size (request_address,
501  struct RequestAddressMessage,
502  NULL),
503  GNUNET_MQ_hd_fixed_size (request_address_cancel,
505  struct RequestAddressMessage,
506  NULL),
507  GNUNET_MQ_hd_fixed_size (request_address_list,
510  NULL),
511  GNUNET_MQ_hd_var_size (address_add,
513  struct AddressAddMessage,
514  NULL),
515  GNUNET_MQ_hd_fixed_size (address_update,
517  struct AddressUpdateMessage,
518  NULL),
519  GNUNET_MQ_hd_fixed_size (address_destroyed,
522  NULL),
523  GNUNET_MQ_hd_fixed_size (reservation_request,
526  NULL),
527  GNUNET_MQ_hd_var_size (preference_change,
530  NULL),
531  GNUNET_MQ_hd_var_size (feedback,
534  NULL),
538 /* end of gnunet-service-ats.c */
Type of the &#39;struct AddressDestroyedMessage&#39; sent by clients to ATS to inform ATS about an address be...
Connectivity client to ATS service: we would like to have address suggestions for this peer...
Definition: ats.h:87
void GAS_normalization_stop()
Stop the normalization component and free all items.
void GAS_handle_reservation_request(struct GNUNET_SERVICE_Client *client, const struct ReservationRequestMessage *msg)
Handle &#39;reservation request&#39; messages from clients.
uint16_t address_length
Number of bytes in the address that follows this struct.
Definition: ats.h:121
void GAS_handle_address_destroyed(const struct AddressDestroyedMessage *m)
Handle &#39;address destroyed&#39; messages from clients.
static struct GNUNET_SERVICE_Handle * service
Handle to our service instance.
Type of the &#39;struct ClientStartMessage&#39; sent by clients to ATS to identify the type of the client...
static int check_preference_change(void *cls, const struct ChangePreferenceMessage *message)
Check that &#39;change preference&#39; message is well-formed.
static void handle_reservation_request(void *cls, const struct ReservationRequestMessage *message)
Handle &#39;reservation request&#39; messages from clients.
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
void GAS_handle_address_update(const struct AddressUpdateMessage *m)
Handle &#39;address update&#39; messages from clients.
Handle to a service.
Definition: service.c:116
uint32_t start_flag
NBO value of an enum StartFlag.
Definition: ats.h:79
Flag used to indicate which type of client is connecting to the ATS service.
Definition: ats.h:37
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_shutdown(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run on shutdown, that is when a CTRL-C signal is received, or when GNUNET_SCHEDULER_shutdown() is being invoked.
Definition: scheduler.c:1331
void GAS_reservations_done()
Shutdown reservations subsystem.
void GAS_plugin_notify_feedback(struct GNUNET_SERVICE_Client *application, const struct GNUNET_PeerIdentity *peer, const struct GNUNET_TIME_Relative scope, enum GNUNET_ATS_PreferenceKind kind, float score_abs)
Tell the solver that the given client has expressed its appreciation for the past performance of a gi...
void GAS_preference_init()
Initialize preferences subsystem.
struct GNUNET_STATISTICS_Handle * GNUNET_STATISTICS_create(const char *subsystem, const struct GNUNET_CONFIGURATION_Handle *cfg)
Get handle for the statistics service.
void GAS_connectivity_remove_client(struct GNUNET_SERVICE_Client *client)
Unregister a client (which may have been a connectivity client, but this is not assured).
static void handle_request_address(void *cls, const struct RequestAddressMessage *message)
Handle &#39;request address&#39; messages from clients.
uint32_t preference_kind
An enum GNUNET_ATS_PreferenceKind in NBO.
Definition: ats.h:424
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
ats service address: management of ATS properties and preferences normalization
struct GNUNET_MessageHeader header
Definition: ats.h:442
ats service plugin management
Performance monitoring client that does NOT want to learn about changes in performance characteristic...
Definition: ats.h:54
static void handle_request_address_list(void *cls, const struct AddressListRequestMessage *message)
Handle &#39;request address list&#39; messages from clients.
static void client_disconnect_cb(void *cls, struct GNUNET_SERVICE_Client *client, void *app_ctx)
A client disconnected from us.
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
void GNUNET_STATISTICS_destroy(struct GNUNET_STATISTICS_Handle *h, int sync_first)
Destroy a handle (free all state associated with it).
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
static struct GNUNET_PEERINFO_Handle * pi
Handle to peerinfo service.
static void handle_feedback(void *cls, const struct FeedbackPreferenceMessage *msg)
Handle &#39;preference feedback&#39; messages from clients.
Handle for the service.
uint32_t num_feedback
Number of feedback values included.
Definition: ats.h:473
void GAS_connectivity_init()
Shutdown connectivity subsystem.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
Type of the &#39;struct AddressListRequestMessage&#39; sent by client to ATS to request information about add...
void GAS_reservations_init()
Initialize reservations subsystem.
static void run(void *cls, const struct GNUNET_CONFIGURATION_Handle *cfg, struct GNUNET_SERVICE_Handle *service)
Process template requests.
static void handle_address_add(void *cls, const struct AddressAddMessage *message)
Handle &#39;address add&#39; messages from clients.
ats service, interaction with &#39;performance&#39; API
void GAS_preference_client_disconnect(struct GNUNET_SERVICE_Client *client)
A performance client disconnected.
Message used to notify ATS that the performance characteristics for an address have changed...
Definition: ats.h:161
static int check_address_add(void *cls, const struct AddressAddMessage *m)
Handle &#39;address add&#39; messages from clients.
Handle to a client that is connected to a service.
Definition: service.c:250
static struct GNUNET_ARM_MonitorHandle * m
Monitor connection with ARM.
Definition: gnunet-arm.c:104
ats service, inbound bandwidth reservation management
This is a scheduling client (aka transport service)
Definition: ats.h:42
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
int GAS_scheduling_add_client(struct GNUNET_SERVICE_Client *client)
Register a new scheduling client.
int GAS_plugin_init(const struct GNUNET_CONFIGURATION_Handle *cfg)
Initialize plugins subsystem.
void GAS_scheduling_remove_client(struct GNUNET_SERVICE_Client *client)
Unregister a client (which may have been a scheduling client, but this is not assured).
static void handle_preference_change(void *cls, const struct ChangePreferenceMessage *message)
Handle &#39;change preference&#39; messages from clients.
void GAS_performance_add_client(struct GNUNET_SERVICE_Client *client, enum StartFlag flag)
Register a new performance client.
Type of the &#39;struct RequestAddressMessage&#39; sent by clients to ATS to request an address to help conne...
GNUNET_SERVICE_MAIN("ats", GNUNET_SERVICE_OPTION_NONE, &run, &client_connect_cb, &client_disconnect_cb, NULL, GNUNET_MQ_hd_fixed_size(ats_start, GNUNET_MESSAGE_TYPE_ATS_START, struct ClientStartMessage, NULL), GNUNET_MQ_hd_fixed_size(request_address, GNUNET_MESSAGE_TYPE_ATS_REQUEST_ADDRESS, struct RequestAddressMessage, NULL), GNUNET_MQ_hd_fixed_size(request_address_cancel, GNUNET_MESSAGE_TYPE_ATS_REQUEST_ADDRESS_CANCEL, struct RequestAddressMessage, NULL), GNUNET_MQ_hd_fixed_size(request_address_list, GNUNET_MESSAGE_TYPE_ATS_ADDRESSLIST_REQUEST, struct AddressListRequestMessage, NULL), GNUNET_MQ_hd_var_size(address_add, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_ADD, struct AddressAddMessage, NULL), GNUNET_MQ_hd_fixed_size(address_update, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_UPDATE, struct AddressUpdateMessage, NULL), GNUNET_MQ_hd_fixed_size(address_destroyed, GNUNET_MESSAGE_TYPE_ATS_ADDRESS_DESTROYED, struct AddressDestroyedMessage, NULL), GNUNET_MQ_hd_fixed_size(reservation_request, GNUNET_MESSAGE_TYPE_ATS_RESERVATION_REQUEST, struct ReservationRequestMessage, NULL), GNUNET_MQ_hd_var_size(preference_change, GNUNET_MESSAGE_TYPE_ATS_PREFERENCE_CHANGE, struct ChangePreferenceMessage, NULL), GNUNET_MQ_hd_var_size(feedback, GNUNET_MESSAGE_TYPE_ATS_PREFERENCE_FEEDBACK, struct FeedbackPreferenceMessage, NULL), GNUNET_MQ_handler_end())
Define "main" method using service macro.
static void handle_request_address_cancel(void *cls, const struct RequestAddressMessage *message)
Cancel &#39;request address&#39; messages from clients.
struct GNUNET_TIME_Relative GNUNET_TIME_relative_ntoh(struct GNUNET_TIME_RelativeNBO a)
Convert relative time from network byte order.
Definition: time.c:454
struct GNUNET_PeerIdentity peer
Peer this feedback is for.
Definition: ats.h:483
void GNUNET_SERVICE_client_drop(struct GNUNET_SERVICE_Client *c)
Ask the server to disconnect from the given client.
Definition: service.c:2325
void GAS_preference_done()
Shutdown preferences subsystem.
uint16_t plugin_name_length
Number of bytes in the plugin name that follows this struct.
Definition: ats.h:126
static void * client_connect_cb(void *cls, struct GNUNET_SERVICE_Client *client, struct GNUNET_MQ_Handle *mq)
A client connected to us.
static void handle_ats_start(void *cls, const struct ClientStartMessage *msg)
We have received a struct ClientStartMessage from a client.
void GAS_performance_init()
Initialize performance subsystem.
static unsigned int size
Size of the "table".
Definition: peer.c:67
Client to service: please give us an overview of the addresses.
Definition: ats.h:341
uint32_t num_preferences
How many struct PreferenceInformation entries follow this struct?
Definition: ats.h:448
Type of the &#39;struct ChangePreferenceMessage&#39; sent by clients to ATS to ask for allocation preference ...
void GAS_plugin_done()
Shutdown address subsystem.
Connection suggestion handle.
Definition: ats.h:59
struct GNUNET_CONTAINER_MultiPeerMap * GSA_addresses
A multihashmap to store all addresses.
ats service, interaction with &#39;connecivity&#39; API
static void cleanup_task(void *cls)
Task run during shutdown.
manage preferences expressed by clients
ats service address management
void GAS_connectivity_done()
Shutdown connectivity subsystem.
static void handle_address_update(void *cls, const struct AddressUpdateMessage *message)
Handle &#39;address update&#39; messages from clients.
Handle to a message queue.
Definition: mq.c:85
void GAS_handle_preference_change(struct GNUNET_SERVICE_Client *client, const struct ChangePreferenceMessage *msg)
Handle &#39;preference change&#39; messages from clients.
void GAS_handle_address_add(const struct AddressAddMessage *m)
Handle &#39;address add&#39; messages from clients.
void GAS_handle_request_address(struct GNUNET_SERVICE_Client *client, const struct RequestAddressMessage *msg)
void GAS_handle_request_address_cancel(struct GNUNET_SERVICE_Client *client, const struct RequestAddressMessage *msg)
Message containing application feedback for a peer.
Definition: ats.h:463
struct GNUNET_MessageHeader header
Definition: ats.h:116
Type of the &#39;struct RequestAddressMessage&#39; sent by clients to ATS to request an address to help conne...
struct GNUNET_TIME_RelativeNBO scope
Relative time describing for which time interval this feedback is.
Definition: ats.h:478
struct GNUNET_STATISTICS_Handle * GSA_stats
Handle for statistics.
configuration data
void GAS_normalization_start()
Start the normalization component.
struct GNUNET_MQ_Handle * mq
Definition: 003.c:5
#define GNUNET_log(kind,...)
Variable-size entry in a struct ChangePreferenceMessage or struct FeedbackPreferenceMessage.
Definition: ats.h:419
Client to ATS: I have a performance preference for a peer.
Definition: ats.h:437
struct GNUNET_MessageHeader header
Definition: ats.h:468
static void handle_address_destroyed(void *cls, const struct AddressDestroyedMessage *message)
Handle &#39;address destroyed&#39; messages from clients.
Type of the &#39;struct ReservationRequestMessage&#39; sent by clients to ATS to ask for inbound bandwidth re...
void GAS_performance_done()
Shutdown performance subsystem.
void GAS_addresses_init()
Initialize address subsystem.
static int check_feedback(void *cls, const struct FeedbackPreferenceMessage *message)
Check &#39;preference feedback&#39; message is well-formed.
ats service, interaction with &#39;scheduling&#39; API
void GAS_addresses_done()
Shutdown address subsystem.
Type of the &#39;struct AddressUpdateMessage&#39; sent by client to ATS to add a new address.
Message sent by ATS client to ATS service when an address was destroyed and must thus henceforth no l...
Definition: ats.h:192
Enum defining all known preference categories.
float preference_value
Degree of preference (or appreciation) for this preference_kind being expressed.
Definition: ats.h:430
int GNUNET_CONTAINER_multipeermap_contains(const struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key)
Check if the map contains any value under the given key (including values that are NULL)...
static char * address
GNS address for this phone.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
void GNUNET_SERVICE_client_continue(struct GNUNET_SERVICE_Client *c)
Continue receiving further messages from the given client.
Definition: service.c:2244
Type of the &#39;struct ChangePreferenceMessage&#39; sent by clients to ATS to ask for allocation preference ...
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
static char * plugin_name
Name of our plugin.
automatic transport selection messages
Type of the &#39;struct AddressUpdateMessage&#39; sent by clients to ATS to inform ATS about performance chan...
First message any client sends to ATS, used to self-identify (what type of client this is)...
Definition: ats.h:69
Performance monitoring client that wants to learn about changes in performance characteristics.
Definition: ats.h:48
void GAS_handle_request_address_list(struct GNUNET_SERVICE_Client *client, const struct AddressListRequestMessage *alrm)
Handle &#39;address list request&#39; messages from clients.
Scheduling client to ATS service: here is another address you can use.
Definition: ats.h:111