src/ats/gnunet-service-ats_addresses_simplistic.h

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2011 Christian Grothoff (and other contributing authors)
   4
   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.
   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      General Public License for more details.
  14
  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.
  19 */
  20
  21 /**
  22  * @file ats/gnunet-service-ats_addresses_simplistic.h
  23  * @brief ats simplistic ressource assignment
  24  * @author Matthias Wachs
  25  * @author Christian Grothoff
  26  */
  27 #include "platform.h"
  28 #include "gnunet_statistics_service.h"
  29 #include "gnunet-service-ats_addresses.h"
  30
  31 #define BIG_M_STRING "unlimited"
  32
  33 /**
  34  * Init the simplistic problem solving component
  35  *
  36  * @param cfg configuration handle
  37  * @param stats the GNUNET_STATISTICS handle
  38  * @return handle for the solver on success, NULL on fail
  39  */
  40 void *
  41 GAS_simplistic_init (const struct GNUNET_CONFIGURATION_Handle *cfg,
  42     const struct GNUNET_STATISTICS_Handle *stats,
  43     int *network,
  44     unsigned long long *out_dest, unsigned long long *in_dest, int dest_length);
  45
  46 /**
  47  * Shutdown the simplistic problem solving component
  48  *
  49  * @param solver the respective handle to shutdown
  50  */
  51 void
  52 GAS_simplistic_done (void * solver);
  53
  54
  55 /**
  56  * Updates a single address in the solve
  57  *
  58  * @param solver the solver Handle
  59  * @param addresses the address hashmap containing all addresses
  60  * @param address the update address
  61  */
  62 void
  63 GAS_simplistic_address_update (void *solver, struct GNUNET_CONTAINER_MultiHashMap * addresses, struct ATS_Address *address);
  64
  65
  66 /**
  67  * Remove an address from the solver
  68  *
  69  * @param solver the solver handle
  70  * @param addresses the address hashmap containing all addresses
  71  * @param address the address to remove
  72  */
  73 void
  74 GAS_simplistic_address_delete (void *solver, struct GNUNET_CONTAINER_MultiHashMap * addresses, struct ATS_Address *address);
  75
  76
  77 /**
  78  * Get the prefered address for a specific peer
  79  *
  80  * @param solver the solver handle
  81  * @param addresses the address hashmap containing all addresses
  82  * @param peer the identity of the peer
  83  */
  84 const struct ATS_Address *
  85 GAS_simplistic_get_preferred_address (void *solver,
  86                                struct GNUNET_CONTAINER_MultiHashMap * addresses,
  87                                const struct GNUNET_PeerIdentity *peer);
  88
  89
  90 /**
  91  * Changes the preferences for a peer in the problem
  92  *
  93  * @param solver the solver handle
  94  * @param peer the peer to change the preference for
  95  * @param kind the kind to change the preference
  96  * @param score the score
  97  */
  98 void
  99 GAS_simplistic_address_change_preference (void *solver,
 100                                    const struct GNUNET_PeerIdentity *peer,
 101                                    enum GNUNET_ATS_PreferenceKind kind,
 102                                    float score);
 103
 104
 105 /* end of gnunet-service-ats_addresses_simplistic.h */