src/ats/gnunet-service-ats_connectivity.h

   1 /*
   2      This file is part of GNUnet.
   3      Copyright (C) 2011-2015 GNUnet e.V.
   4
   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.
   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      Affero General Public License for more details.
  14 */
  15 /**
  16  * @file ats/gnunet-service-ats_connectivity.h
  17  * @brief ats service, interaction with 'connecivity' API
  18  * @author Matthias Wachs
  19  * @author Christian Grothoff
  20  */
  21 #ifndef GNUNET_SERVICE_ATS_CONNECTIVITY_H
  22 #define GNUNET_SERVICE_ATS_CONNECTIVITY_H
  23
  24 #include "ats.h"
  25
  26
  27 /**
  28  * Is the given peer in the list of peers for which we
  29  * have an address request?
  30  *
  31  * @param cls unused, NULL
  32  * @param peer peer to query for
  33  * @return #GNUNET_YES if so, #GNUNET_NO if not
  34  */
  35 unsigned int
  36 GAS_connectivity_has_peer (void *cls,
  37                            const struct GNUNET_PeerIdentity *peer);
  38
  39
  40 /**
  41  * Handle 'request address' messages from clients.
  42  *
  43  * @param client client that sent the request
  44  * @param msg the request message
  45  */
  46 void
  47 GAS_handle_request_address (struct GNUNET_SERVICE_Client *client,
  48                             const struct RequestAddressMessage *msg);
  49
  50
  51 /**
  52  * Cancel 'request address' messages from clients.
  53  *
  54  * @param client client that sent the request
  55  * @param msg the request message
  56  */
  57 void
  58 GAS_handle_request_address_cancel (struct GNUNET_SERVICE_Client *client,
  59                                    const struct RequestAddressMessage *msg);
  60
  61
  62 /**
  63  * Unregister a client (which may have been a connectivity client,
  64  * but this is not assured).
  65  *
  66  * @param client handle of the (now dead) client
  67  */
  68 void
  69 GAS_connectivity_remove_client (struct GNUNET_SERVICE_Client *client);
  70
  71
  72 /**
  73  * Initialize connectivity subsystem.
  74  */
  75 void
  76 GAS_connectivity_init (void);
  77
  78
  79 /**
  80  * Shutdown connectivity subsystem.
  81  */
  82 void
  83 GAS_connectivity_done (void);
  84
  85
  86 #endif
  87 /* end of gnunet-service-ats_connectivity.h */