#include "gnunet_ats_service.h"
#include "gnunet-service-ats.h"
#include "gnunet-service-ats_addresses.h"
+#include "gnunet-service-ats_normalization.h"
#include "gnunet-service-ats_performance.h"
#include "gnunet-service-ats_scheduling.h"
#include "gnunet-service-ats_reservations.h"
#if HAVE_LIBGLPK
-#include "gnunet-service-ats_addresses_mlp.h"
+#include "gnunet-service-ats-solver_mlp.h"
#endif
-#include "gnunet-service-ats_addresses_simplistic.h"
+#include "gnunet-service-ats-solver_proportional.h"
+#include "gnunet-service-ats-solver_ril.h"
/**
- * ATS addresses : ATS address management
+ * NOTE: Do not change this documentation. This documentation is based on
+ * gnunet.org:/vcs/fsnsg/ats-paper.git/tech-doku/ats-tech-guide.tex
+ * use build_txt.sh to generate plaintext output
*
- * - General
+ * 1 ATS addresses : ATS address management
*
- * This ATS addresses ("addresses") component manages the addresses known to ATS
- * service and suggests addresses to transport service when it is interested in
- * address suggestion for a peer. ATS addresses also instantiates the bandwidth assignment
- * mechanism (solver), notifies it about changes to addresses and forwards changes
- * to bandwidth assignments to transport, depending if transport is interested
- * in this change.
+ * This ATS addresses ("addresses") component manages the addresses known to
+ * ATS service and suggests addresses to transport service when it is
+ * interested in address suggestion for a peer. ATS addresses also
+ * instantiates the bandwidth assignment mechanism (solver), notifies it
+ * about changes to addresses and forwards changes to bandwidth assignments
+ * to transport, depending if transport is interested in this change.
*
- * - Initialization
- * During initialization a hashmap to store addresses is created. The most
- * important step is to load the configured solver using configuration
- * "[ats]:MODE". Current solvers are MODE_SIMPLISTIC, MODE_MLP. Interaction
- * is done using a solver API
+ * 1.1 Input data
*
- * - Solver API
+ * 1.1.1 Addresses
*
- * Solver functions:
- * s_init: init the solver with required information
- * s_add: add a new address
- * s_update: update an address
- * s_get: get prefered address for a peer
- * s_del: delete an address
- * s_pref: change preference value for a peer
- * s_done: shutdown solver
- * Callbacks:
- * addresses provides a bandwidth_changed_cb callback to the solver which is
- * called when bandwidth assigned to peer has changed
+ * Addresses are added by specifying peer ID, plugin, address, address length
+ * and session, if available. ATS information can be specified if available.
*
- * - Shutdown
- * During shutdown all addresses are freed and the solver told to shutdown
+ * 1.1.2 Networks
*
- * - Address management and suggestions:
+ * ATS specifies a fix set of networks an address can belong to. For each
+ * network an inbound and outbound quota will be specified. The available
+ * networks and addtional helper varaibles are defined in
+ * gnunet_ats_service.h. At the moment 5 networks are defined:
+ * * GNUNET_ATS_NET_UNSPECIFIED
+ * * GNUNET_ATS_NET_LOOPBACK
+ * * GNUNET_ATS_NET_LAN
+ * * GNUNET_ATS_NET_WAN
+ * * GNUNET_ATS_NET_WLAN
*
- * Transport service notifies ATS about changes to the addresses known to him.
+ * The total number of networks defined is stored in
+ * GNUNET_ATS_NetworkTypeCount GNUNET_ATS_NetworkType can be used array
+ * initializer for an int array, while GNUNET_ATS_NetworkType is an
+ * initializer for a char array containing a string description of all
+ * networks
*
- * When transport learns a new address it tells ATS about it using
- * GAS_address_add. It creates a new address object and tells the solver using
- * s_add to
- * add it. ATS informationen are extracted given t
+ * 1.1.3 Quotas
*
+ * An inbound and outbound quota for each of the networks mentioned in 1.1.2
+ * is loaded from ats configuration during initialization. This quota defines
+ * to total amount of inbound and outbound traffic allowed for a specific
+ * network. The configuration values used are in section ats:
+ * * "NETWORK"_QUOTA_IN = <value>
+ * * "NETWORK"_QUOTA_IN = <value>
*
+ * You can specify quotas by setting the <value> to a:
+ * * unrestricted: unlimited
+ * * number of bytes: e.g. 10240
+ * * fancy value: e.g. 64 Kib
*
- * - Bandwidth assignment
+ * unlimited is defined as GNUNET_ATS_MaxBandwidthString and equivalent to
+ * the value GNUNET_ATS_MaxBandwidth Important predefined values for quotas
+ * are:
+ * * GNUNET_ATS_DefaultBandwidth: 65536
+ * * GNUNET_ATS_MaxBandwidth: UINT32_MAX
+ * * GNUNET_CONSTANTS_DEFAULT_BW_IN_OUT: 1024
*
- * The addresses are used to perform resource allocation operations. ATS
- * addresses takes care of instantiating the solver configured and notifies the
- * respective solver about address changes and receives changes to the bandwidth
- * assignment from the solver. The current bandwidth assignment is sent to
- * transport.
+ * Details of loading quotas and default values will be described on
*
+ * 1.1.4 Preference values
*
+ * 1.2 Data structures used
*
- * Address lifecycle:
+ * Addresse uses struct ATS_Address for each address. The structs are stored
+ * in a linked list and provides a pointer void *solver_information for the
+ * solver to store address specific information. It provides the int values
+ * active which is set to GNUNET_YES if the address is select for transport
+ * use and used, representing that transport service is actively using this
+ * address. Address information are stored in peer, addr, addr_len, plugin.
*
- * Adding addresses:
+ * 1.3 Initialization
*
- * - If you add a new address without a session, a new address will be added
- * - If you add this address again now with a session a, the existing address
- * will be updated with this session
- * - If you add this address again now with a session b, a new address object
- * with this session will be added
-
- * Destroying addresses:
+ * During initialization a hashmap to store addresses is created. The quotas
+ * for all networks defined for ATS are loaded from configuration. For each
+ * network first the logic will check if the string
+ * GNUNET_ATS_MaxBandwidthString is configured, if not it will try to convert
+ * the configured value as a fancy size and if this fails it will try to use
+ * it as a value_number. If no configuration value is found it will assign
+ * GNUNET_ATS_DefaultBandwidth. The most important step is to load the
+ * configured solver using configuration "[ats]:MODE". Current solvers are
+ * MODE_PROPORTIONAL, MODE_MLP. Interaction is done using a solver API
+ *
+ * 1.4 Solver API
+ *
+ * Solver functions:
+ * * s_init: init the solver with required information
+ * * s_add: add a new address
+ * * s_update: update ATS values or session for an address
+ * * s_get: get prefered address for a peer
+ * * s_del: delete an address
+ * * s_pref: change preference value for a peer
+ * * s_done: shutdown solver
+ *
+ * Callbacks: addresses provides a bandwidth_changed_cb callback to the
+ * solver which is called when bandwidth assigned to peer has changed
+ *
+ * 1.5 Shutdown
+ *
+ * During shutdown all addresses are freed and the solver told to shutdown
+ *
+ * 1.6 Addresses and sessions
+ *
+ * Addresses consist of the address itself and a numerical session. When a
+ * new address without a session is added it has no session, so it gets
+ * session 0 assigned. When an address with a session is added and an address
+ * object with session 0 is found, this object is updated with the session
+ * otherwise a new address object with this session assigned is created.
+ *
+ * 1.6.1 Terminology
+ *
+ * Addresses a1,a2 with session s1, s2 are "exact" if:
+ * (a1 == a2)&&(s1 == s2)
+ * Addresses a1,a2 with session s1, s2 are "equivalent" if:
+ * (a1 == a2)&&((s1 == s2)||(s1 == 0)||(s2 == 0)
+ *
+ * 1.7 Address management
+ *
+ * Transport service notifies ATS about changes to the addresses known to
+ * him.
+ *
+ * 1.7.1 Adding an address
+ *
+ * When transport learns a new address it tells ATS and ATS is telling
+ * addresses about it using GAS_address_add. If not known to addresses it
+ * creates a new address object and calls solver's s_add. ATS information are
+ * deserialized and solver is notified about the session and ATS information
+ * using s_update.
+ *
+ * 1.7.2 Updating an address
+ *
+ * Addresses does an lookup up for the existing address with the given
+ * session. If disassembles included ATS information and notifies the solver
+ * using s_update about the update.
+ *
+ * 1.7.3 Deleting an address
+ *
+ * Addresses does an lookup for the exact address and session and if removes
+ * this address. If session != 0 the session is set to 0 and the address is
+ * kept. If session == 0, the addresses is removed.
+ *
+ * 1.7.4 Requesting an address suggestion
+ *
+ * The address client issues a request address message to be notified about
+ * address suggestions for a specific peer. Addresses asks the solver with
+ * s_get. If no address is available, it will not send a response, otherwise
+ * it will respond with the choosen address.
*
- * - If you destroy an address without a session, the address itself and all
- * address instances with an session will be removed
- * - If you destroy an address with a session, the session for this address
- * will be removed
+ * 1.7.5 Address suggestions
*
- * Conclusion
- * Addresses without a session will be updated with a new session and if the
- * the session is destroyed the session is removed and address itself still
- * exists for suggestion
+ * Addresses will notify the client automatically on any bandwidth_changed_cb
+ * by the solver if a address suggestion request is pending. If no address is
+ * available it will not respond at all If the client is not interested
+ * anymore, it has to cancel the address suggestion request.
*
+ * 1.7.6 Suggestions blocks and reset
+ *
+ * After suggesting an address it is blocked for ATS_BLOCKING_DELTA sec. to
+ * prevent the client from being thrashed. If the client requires immediately
+ * it can reset this block using GAS_addresses_handle_backoff_reset.
+ *
+ * 1.7.7 Marking address in use
+ *
+ * The client can notify addresses that it successfully uses an address and
+ * wants this address to be kept by calling GSA_address_in_use. Adresses will
+ * mark the address as used an notify the solver about the use.
+ *
+ * 1.7.8 Address lifecycle
+ *
+ * * (add address)
+ * * (updated address) || (address in use)
+ * * (delete address)
+ *
+ * 1.8 Bandwidth assignment
+ *
+ * The addresses are used to perform resource allocation operations. ATS
+ * addresses takes care of instantiating the solver configured and notifies
+ * the respective solver about address changes and receives changes to the
+ * bandwidth assignment from the solver. The current bandwidth assignment is
+ * sent to transport. The specific solvers will be described in the specific
+ * section.
+ *
+ * 1.9 Changing peer preferences
+ *
+ * The bandwidth assigned to a peer can be influenced by setting a preference
+ * for a peer. The prefernce will be given to to the solver with s_pref which
+ * has to take care of the preference value
+
*/
enum ATS_Mode
{
/*
- * Simplistic mode:
+ * proportional mode:
*
* Assign each peer an equal amount of bandwidth (bw)
*
* bw_per_peer = bw_total / #active addresses
*/
- MODE_SIMPLISTIC,
+ MODE_PROPORTIONAL,
/*
* MLP mode:
* Solve ressource assignment as an optimization problem
* Uses an mixed integer programming solver
*/
- MODE_MLP
+ MODE_MLP,
+
+ /*
+ * Reinforcement Learning mode:
+ *
+ * Solve resource assignment using a learning agent
+ */
+ MODE_RIL
};
+
/**
* Pending Address suggestion requests
*/
struct GNUNET_PeerIdentity id;
};
+
/**
* Handle for ATS address component
*/
*/
GAS_solver_address_add s_add;
+
+ GAS_solver_address_property_changed s_address_update_property;
+
+ GAS_solver_address_session_changed s_address_update_session;
+
+ GAS_solver_address_inuse_changed s_address_update_inuse;
+
+ GAS_solver_address_network_changed s_address_update_network;
+
/**
- * Update address in solver
+ * Get address from solver
*/
- GAS_solver_address_update s_update;
+ GAS_solver_get_preferred_address s_get;
/**
* Get address from solver
*/
- GAS_solver_get_preferred_address s_get;
+ GAS_solver_stop_get_preferred_address s_get_stop;
/**
* Delete address in solver
GAS_solver_address_delete s_del;
/**
- * Change preference for quality in solver
+ * Change relative preference for quality in solver
*/
GAS_solver_address_change_preference s_pref;
+ /**
+ * Give feedback about the current assignment
+ */
+ GAS_solver_address_feedback_preference s_feedback;
+
+ /**
+ * Start a bulk operation
+ */
+ GAS_solver_bulk_start s_bulk_start;
+
+ /**
+ * Bulk operation done
+ */
+ GAS_solver_bulk_stop s_bulk_stop;
+
/**
* Shutdown solver
*/
};
+/**
+ * Disassemble ATS information and update performance information in address
+ *
+ * Updates existing information and adds new information
+ *
+ * @param dest destination address
+ * @param update source ATS information
+ * @param update_count number of ATS information
+ * @param delta_dest ats performance information which were updated
+ * including previous value
+ * @param delta_count number of ATS information in the delta
+ * @return GNUNET_YES if address was address updated, GNUNET_NO otherwise
+ */
static unsigned int
-assemble_ats_information (const struct ATS_Address *aa, struct GNUNET_ATS_Information **dest)
+disassemble_ats_information (struct ATS_Address *dest,
+ const struct GNUNET_ATS_Information *update,
+ uint32_t update_count,
+ struct GNUNET_ATS_Information **delta_dest,
+ uint32_t *delta_count)
{
- unsigned int ats_count = GNUNET_ATS_PropertyCount - 1;
- struct GNUNET_ATS_Information *ats = GNUNET_malloc (ats_count * sizeof (struct GNUNET_ATS_Information));
- (*dest) = ats;
-
- ats[0].type = ntohl(GNUNET_ATS_UTILIZATION_UP);
- ats[0].value = aa->atsp_utilization_out.value__;
- ats[1].type = ntohl(GNUNET_ATS_UTILIZATION_DOWN);
- ats[1].value = aa->atsp_utilization_in.value__;
- ats[2].type = ntohl(GNUNET_ATS_NETWORK_TYPE);
- ats[2].value = ntohl(aa->atsp_network_type);
- ats[3].type = ntohl(GNUNET_ATS_QUALITY_NET_DELAY);
- ats[3].value = ntohl(aa->atsp_latency.rel_value);
- ats[4].type = ntohl(GNUNET_ATS_QUALITY_NET_DISTANCE);
- ats[4].value = ntohl(aa->atsp_distance);
- ats[5].type = ntohl(GNUNET_ATS_COST_WAN);
- ats[5].value = ntohl (aa->atsp_cost_wan);
- ats[6].type = ntohl(GNUNET_ATS_COST_LAN);
- ats[6].value = ntohl (aa->atsp_cost_lan);
- ats[7].type = ntohl(GNUNET_ATS_COST_WLAN);
- ats[7].value = ntohl (aa->atsp_cost_wlan);
- return ats_count;
-}
-static unsigned int
-disassemble_ats_information (const struct GNUNET_ATS_Information *src,
- uint32_t ats_count,
- struct ATS_Address *dest)
-{
- int i;
- int res = 0;
- for (i = 0; i < ats_count; i++)
- switch (ntohl (src[i].type))
+ int c1;
+ int c2;
+ int found;
+ int change;
+
+ struct GNUNET_ATS_Information add_atsi[update_count];
+ struct GNUNET_ATS_Information delta_atsi[update_count];
+ struct GNUNET_ATS_Information *tmp_atsi;
+ uint32_t add_atsi_count;
+ uint32_t delta_atsi_count;
+
+ change = GNUNET_NO;
+ add_atsi_count = 0;
+ delta_atsi_count = 0;
+
+ if (0 == update_count)
+ return GNUNET_NO;
+
+ if (NULL == dest->atsi)
+ {
+ /* Create performance information */
+ dest->atsi = GNUNET_malloc (update_count * sizeof (struct GNUNET_ATS_Information));
+ dest->atsi_count = update_count;
+ memcpy (dest->atsi, update, update_count * sizeof (struct GNUNET_ATS_Information));
+ (*delta_dest) = GNUNET_malloc (update_count * sizeof (struct GNUNET_ATS_Information));
+ for (c1 = 0; c1 < update_count; c1 ++)
{
- case GNUNET_ATS_UTILIZATION_UP:
- dest->atsp_utilization_out.value__ = src[i].value;
- res ++;
- break;
- case GNUNET_ATS_UTILIZATION_DOWN:
- dest->atsp_utilization_in.value__ = src[i].value;
- res ++;
- break;
- case GNUNET_ATS_QUALITY_NET_DELAY:
- dest->atsp_latency.rel_value = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_QUALITY_NET_DISTANCE:
- dest->atsp_distance = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_COST_WAN:
- dest->atsp_cost_wan = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_COST_LAN:
- dest->atsp_cost_lan = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_COST_WLAN:
- dest->atsp_cost_wlan = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_NETWORK_TYPE:
- dest->atsp_network_type = ntohl (src[i].value);
- res ++;
- break;
- case GNUNET_ATS_ARRAY_TERMINATOR:
- break;
- default:
- GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
- "Received unsupported ATS type %u\n", ntohl (src[i].type));
- GNUNET_break (0);
- break;
+ (*delta_dest)[c1].type = update[c1].type;
+ (*delta_dest)[c1].value = htonl(GNUNET_ATS_VALUE_UNDEFINED);
}
- return res;
+ (*delta_count) = update_count;
+ return GNUNET_YES;
+ }
+
+ for (c1 = 0; c1 < update_count; c1++)
+ {
+ /* Update existing performance information */
+ found = GNUNET_NO;
+ for (c2 = 0; c2 < dest->atsi_count; c2++)
+ {
+ if (update[c1].type == dest->atsi[c2].type)
+ {
+ if (update[c1].value != dest->atsi[c2].value)
+ {
+ /* Save previous value in delta */
+ delta_atsi[delta_atsi_count] = dest->atsi[c2];
+ delta_atsi_count ++;
+ /* Set new value */
+ dest->atsi[c2].value = update[c1].value;
+ change = GNUNET_YES;
+ }
+ found = GNUNET_YES;
+ break;
+ }
+ }
+ if (GNUNET_NO == found)
+ {
+ add_atsi[add_atsi_count] = update[c1];
+ add_atsi_count ++;
+ delta_atsi[delta_atsi_count].type = update[c1].type;
+ delta_atsi[delta_atsi_count].value = htonl (GNUNET_ATS_VALUE_UNDEFINED);
+ delta_atsi_count ++;
+ }
+ }
+
+ if (add_atsi_count > 0)
+ {
+ /* Extend ats performance information */
+
+ tmp_atsi = GNUNET_malloc ((dest->atsi_count + add_atsi_count) *
+ (sizeof (struct GNUNET_ATS_Information)));
+ memcpy (tmp_atsi, dest->atsi, dest->atsi_count * sizeof (struct GNUNET_ATS_Information));
+ memcpy (&tmp_atsi[dest->atsi_count], add_atsi, add_atsi_count * sizeof (struct GNUNET_ATS_Information));
+ GNUNET_free (dest->atsi);
+ dest->atsi = tmp_atsi;
+ dest->atsi_count = dest->atsi_count + add_atsi_count;
+ change = GNUNET_YES;
+ }
+
+ if (delta_atsi_count > 0)
+ {
+ /* Copy delta */
+ (*delta_dest) = GNUNET_malloc (delta_atsi_count * sizeof (struct GNUNET_ATS_Information));
+ memcpy ((*delta_dest), delta_atsi, delta_atsi_count * sizeof (struct GNUNET_ATS_Information));
+ (*delta_count) = delta_atsi_count;
+ }
+
+ return change;
}
/**
* Free the given address
+ *
* @param addr address to destroy
*/
static void
free_address (struct ATS_Address *addr)
{
GNUNET_free (addr->plugin);
+ GNUNET_free_non_null (addr->atsi);
GNUNET_free (addr);
}
/**
* Create a ATS_address with the given information
+ *
* @param peer peer
* @param plugin_name plugin
* @param plugin_addr address
uint32_t session_id)
{
struct ATS_Address *aa = NULL;
+ int c1;
+ int c2;
aa = GNUNET_malloc (sizeof (struct ATS_Address) + plugin_addr_len);
aa->peer = *peer;
aa->active = GNUNET_NO;
aa->used = GNUNET_NO;
aa->solver_information = NULL;
+ aa->atsi = NULL;
+ aa->atsi_count = 0;
aa->assigned_bw_in = GNUNET_BANDWIDTH_value_init(0);
aa->assigned_bw_out = GNUNET_BANDWIDTH_value_init(0);
- return aa;
-}
+ for (c1 = 0; c1 < GNUNET_ATS_QualityPropertiesCount; c1 ++)
+ {
+ aa->atsin[c1].avg_queue_index = 0;
+ for (c2 = 0; c2 < GAS_normalization_queue_length; c2++)
+ aa->atsin[c1].atsi_abs[c2] = GNUNET_ATS_VALUE_UNDEFINED;
+ }
-/**
- * Destroy the given address.
- *
- * @param handle the address handle
- * @param addr address to destroy
- * @return GNUNET_YES if bandwidth allocations should be recalcualted
- */
-static int
-destroy_address (struct GAS_Addresses_Handle *handle, struct ATS_Address *addr)
-{
- int ret;
-
- ret = GNUNET_NO;
- GNUNET_assert (GNUNET_YES ==
- GNUNET_CONTAINER_multihashmap_remove (handle->addresses,
- &addr->peer.hashPubKey,
- addr));
- free_address (addr);
- return ret;
+ return aa;
}
struct ATS_Address *base_address;
};
+/**
+ * Comapre addresses
+ *
+ * @param cls a CompareAddressContext containin the source address
+ * @param key peer id
+ * @param value the address to compare with
+ * @return GNUNET_YES to continue, GNUNET_NO if address is founce
+ */
static int
compare_address_it (void *cls, const struct GNUNET_HashCode * key, void *value)
}
+/**
+ * Find the exact address
+ *
+ * @param handle the address handle to use
+ * @param peer peer
+ * @param plugin_name transport plugin name
+ * @param plugin_addr plugin address
+ * @param plugin_addr_len length of the plugin address
+ * @param session_id session id, can be 0
+ * @return an ATS_address or NULL
+ */
+
static struct ATS_Address *
-lookup_address (struct GAS_Addresses_Handle *handle,
+find_exact_address (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer,
const char *plugin_name,
const void *plugin_addr,
size_t plugin_addr_len,
- uint32_t session_id,
- const struct GNUNET_ATS_Information *atsi,
- uint32_t atsi_count)
+ uint32_t session_id)
{
struct ATS_Address *aa;
struct ATS_Address *ea;
ea = find_equivalent_address (handle, peer, aa);
free_address (aa);
if (ea == NULL)
- {
return NULL;
- }
else if (ea->session_id != session_id)
- {
return NULL;
- }
return ea;
}
+/**
+ * Extract an ATS performance info from an address
+ *
+ * @param address the address
+ * @param type the type to extract in HBO
+ * @return the value in HBO or GNUNET_ATS_VALUE_UNDEFINED in HBO if value does not exist
+ */
+static int
+get_performance_info (struct ATS_Address *address, uint32_t type)
+{
+ int c1;
+ GNUNET_assert (NULL != address);
+
+ if ((NULL == address->atsi) || (0 == address->atsi_count))
+ return GNUNET_ATS_VALUE_UNDEFINED;
+
+ for (c1 = 0; c1 < address->atsi_count; c1++)
+ {
+ if (ntohl(address->atsi[c1].type) == type)
+ return ntohl(address->atsi[c1].value);
+ }
+ return GNUNET_ATS_VALUE_UNDEFINED;
+}
+
+
+/**
+ * Add a new address for a peer.
+ *
+ * @param handle the address handle to use
+ * @param peer peer
+ * @param plugin_name transport plugin name
+ * @param plugin_addr plugin address
+ * @param plugin_addr_len length of the plugin address
+ * @param session_id session id, can be 0
+ * @param atsi performance information for this address
+ * @param atsi_count number of performance information contained
+ */
void
GAS_addresses_add (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer,
- const char *plugin_name, const void *plugin_addr,
- size_t plugin_addr_len, uint32_t session_id,
+ const char *plugin_name,
+ const void *plugin_addr,
+ size_t plugin_addr_len,
+ uint32_t session_id,
const struct GNUNET_ATS_Information *atsi,
uint32_t atsi_count)
{
- struct ATS_Address *aa;
- struct ATS_Address *ea;
- unsigned int ats_res;
+ struct ATS_Address *new_address;
+ struct ATS_Address *existing_address;
+ struct GNUNET_ATS_Information *atsi_delta;
+ uint32_t atsi_delta_count;
+ uint32_t addr_net;
+ uint32_t previous_session;
+ int c1;
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
"Received `%s' for peer `%s'\n",
GNUNET_assert (NULL != handle->addresses);
- aa = create_address (peer, plugin_name, plugin_addr, plugin_addr_len,
+ new_address = create_address (peer, plugin_name, plugin_addr, plugin_addr_len,
session_id);
- if (atsi_count != (ats_res = disassemble_ats_information(atsi, atsi_count, aa)))
- {
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "While adding address: had %u ATS elements to add, could only add %u\n",
- atsi_count, ats_res);
- }
+ atsi_delta = NULL;
+ disassemble_ats_information (new_address, atsi, atsi_count, &atsi_delta, &atsi_delta_count);
+ GNUNET_free_non_null (atsi_delta);
+ addr_net = get_performance_info (new_address, GNUNET_ATS_NETWORK_TYPE);
+ if (GNUNET_ATS_VALUE_UNDEFINED == addr_net)
+ addr_net = GNUNET_ATS_NET_UNSPECIFIED;
/* Get existing address or address with session == 0 */
- ea = find_equivalent_address (handle, peer, aa);
- if (ea == NULL)
+ existing_address = find_equivalent_address (handle, peer, new_address);
+ if (existing_address == NULL)
{
- /* We have a new address */
+ /* Add a new address */
GNUNET_assert (GNUNET_OK ==
GNUNET_CONTAINER_multihashmap_put (handle->addresses,
- &peer->hashPubKey, aa,
- GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE));
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Added new address for peer `%s' session id %u, %p\n",
- GNUNET_i2s (peer), session_id, aa);
+ &peer->hashPubKey, new_address,
+ GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE));
+
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO, "Adding new address %p for peer `%s', length %u, session id %u, %s\n",
+ new_address, GNUNET_i2s (peer), plugin_addr_len, session_id, GNUNET_ATS_print_network_type(addr_net));
+
/* Tell solver about new address */
- handle->s_add (handle->solver, handle->addresses, aa);
+ handle->s_add (handle->solver, new_address, addr_net);
+
+ handle->s_bulk_start (handle->solver);
+ GAS_normalization_normalize_property (handle->addresses, new_address, atsi, atsi_count);
+ handle->s_bulk_stop (handle->solver);
+
+ /* Notify performance clients about new address */
+ GAS_performance_notify_all_clients (&new_address->peer,
+ new_address->plugin,
+ new_address->addr, new_address->addr_len,
+ new_address->session_id,
+ new_address->atsi, new_address->atsi_count,
+ new_address->assigned_bw_out,
+ new_address->assigned_bw_in);
return;
}
- GNUNET_free (aa->plugin);
- GNUNET_free (aa);
- if (ea->session_id != 0)
+ /* We have an existing address we can use, clean up new */
+ GNUNET_free (new_address->plugin);
+ GNUNET_free_non_null (new_address->atsi);
+ GNUNET_free (new_address);
+ new_address = NULL;
+
+ if (0 != existing_address->session_id)
{
- /* This address with the same session is already existing
- * Should not happen */
- GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
- "Added already existing address for peer `%s' `%s' %p with new session %u\n",
- GNUNET_i2s (peer), plugin_name, session_id);
+ /* Should not happen */
GNUNET_break (0);
return;
}
- /* We have an address without an session, update this address */
-
- /* Notify solver about update with atsi information and session */
- handle->s_update (handle->solver, handle->addresses, ea, session_id, ea->used, atsi, atsi_count);
+ addr_net = get_performance_info (existing_address, GNUNET_ATS_NETWORK_TYPE);
+ if (GNUNET_ATS_VALUE_UNDEFINED == addr_net)
+ addr_net = GNUNET_ATS_NET_UNSPECIFIED;
- /* Do the update */
- ea->session_id = session_id;
- if (atsi_count != (ats_res = disassemble_ats_information(atsi, atsi_count, ea)))
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ "Found existing address for peer `%s' %p with new session %u in network %s\n",
+ GNUNET_i2s (peer),
+ existing_address,
+ session_id,
+ GNUNET_ATS_print_network_type (addr_net));
+ /* We have an address without an session, update this address */
+ atsi_delta = NULL;
+ atsi_delta_count = 0;
+ if (GNUNET_YES == disassemble_ats_information (existing_address, atsi, atsi_count, &atsi_delta, &atsi_delta_count))
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "While updating address: had %u ATS elements to add, could only add %u\n",
- atsi_count, ats_res);
+ /* Notify performance clients about properties */
+ GAS_performance_notify_all_clients (&existing_address->peer,
+ existing_address->plugin,
+ existing_address->addr, existing_address->addr_len,
+ existing_address->session_id,
+ existing_address->atsi, existing_address->atsi_count,
+ existing_address->assigned_bw_out,
+ existing_address->assigned_bw_in);
+
+ for (c1 = 0; c1 < atsi_delta_count; c1++)
+ {
+ if ((GNUNET_ATS_NETWORK_TYPE == ntohl (atsi_delta[c1].type)) &&
+ (addr_net != ntohl (atsi_delta[c1].value)))
+ {
+ /* Network type changed */
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO, "Address for peer `%s' %p changed from network %s to %s\n",
+ GNUNET_i2s (peer), existing_address,
+ GNUNET_ATS_print_network_type (addr_net),
+ GNUNET_ATS_print_network_type (ntohl (atsi_delta[c1].value)));
+ handle->s_address_update_network (handle->solver, existing_address,
+ ntohl (atsi_delta[c1].value),
+ get_performance_info (existing_address, GNUNET_ATS_NETWORK_TYPE));
+ addr_net = get_performance_info (existing_address, GNUNET_ATS_NETWORK_TYPE);
+ }
+ }
+ /* Notify solver about update with atsi information and session */
+ handle->s_bulk_start (handle->solver);
+ GAS_normalization_normalize_property (handle->addresses, existing_address, atsi, atsi_count);
+ handle->s_bulk_stop (handle->solver);
}
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Updated existing address for peer `%s' %p with new session %u\n",
- GNUNET_i2s (peer), ea, session_id);
+ GNUNET_free_non_null (atsi_delta);
+
+ /* Notify solver about new session */
+ if (existing_address->session_id == session_id)
+ return; /* possible, can both be 0 since address is revalidated */
+
+ previous_session = existing_address->session_id;
+ existing_address->session_id = session_id;
+ handle->s_address_update_session (handle->solver, existing_address,
+ previous_session, session_id);
+
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
+ "Updated existing address for peer `%s' %p length %u with new session %u in network %s\n",
+ GNUNET_i2s (peer),
+ existing_address,
+ existing_address->addr_len,
+ session_id,
+ GNUNET_ATS_print_network_type(addr_net));
}
+/**
+ * Update an address with a session or performance information for a peer.
+ *
+ * If an address was added without a session it will be updated with the
+ * session
+ *
+ * @param handle the address handle to use
+ * @param peer peer
+ * @param plugin_name transport plugin name
+ * @param plugin_addr plugin address
+ * @param plugin_addr_len length of the plugin address
+ * @param session_id session id, can be 0
+ * @param atsi performance information for this address
+ * @param atsi_count number of performance information contained
+ */
void
GAS_addresses_update (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer,
uint32_t atsi_count)
{
struct ATS_Address *aa;
- uint32_t ats_res;
+ struct GNUNET_ATS_Information *atsi_delta;
+ uint32_t atsi_delta_count;
+ uint32_t prev_session;
+ int c1;
if (GNUNET_NO == handle->running)
return;
GNUNET_assert (NULL != handle->addresses);
/* Get existing address */
- aa = lookup_address (handle, peer, plugin_name, plugin_addr, plugin_addr_len,
- session_id, atsi, atsi_count);
+ aa = find_exact_address (handle, peer, plugin_name,
+ plugin_addr, plugin_addr_len, session_id);
if (aa == NULL)
+ {
+ /* GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Tried to update unknown address for peer `%s' `%s' session id %u\n", */
+ /* GNUNET_i2s (peer), plugin_name, session_id); */
+ /* GNUNET_break (0); */
+ return;
+ }
+
+ if (NULL == aa->solver_information)
{
GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Tried to update unknown address for peer `%s' `%s' session id %u\n",
- GNUNET_i2s (peer), plugin_name, session_id);
- GNUNET_break (0);
+ GNUNET_i2s (peer), plugin_name, session_id);
return;
}
"ADDRESS UPDATE",
GNUNET_i2s (peer), aa);
- /* Tell solver about update */
- handle->s_update (handle->solver, handle->addresses, aa, session_id, aa->used, atsi, atsi_count);
-
/* Update address */
- if (atsi_count != (ats_res = disassemble_ats_information (atsi, atsi_count, aa)))
+ if (session_id != aa->session_id)
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "While adding address: had %u ATS elements to add, could only add %u\n",
- atsi_count, ats_res);
+ /* Session changed */
+ prev_session = aa->session_id;
+ aa->session_id = session_id;
+ handle->s_address_update_session (handle->solver, aa, prev_session, aa->session_id);
}
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Updated %u ATS elements for address %p\n",
- ats_res, aa);
+
+ atsi_delta = NULL;
+ atsi_delta_count = 0;
+ if (GNUNET_YES == disassemble_ats_information (aa, atsi, atsi_count, &atsi_delta, &atsi_delta_count))
+ {
+ /* ATS properties changed */
+ for (c1 = 0; c1 < atsi_delta_count; c1++)
+ {
+ if (GNUNET_ATS_NETWORK_TYPE == ntohl (atsi_delta[c1].type))
+ {
+ /* Network type changed */
+ handle->s_address_update_network (handle->solver, aa,
+ ntohl (atsi_delta[c1].value),
+ get_performance_info (aa, GNUNET_ATS_NETWORK_TYPE));
+ }
+ }
+
+ /* Notify performance clients about updated address */
+ GAS_performance_notify_all_clients (&aa->peer,
+ aa->plugin,
+ aa->addr, aa->addr_len,
+ aa->session_id,
+ aa->atsi, aa->atsi_count,
+ aa->assigned_bw_out,
+ aa->assigned_bw_in);
+
+ handle->s_bulk_start (handle->solver);
+ GAS_normalization_normalize_property (handle->addresses, aa, atsi, atsi_count);
+ handle->s_bulk_stop (handle->solver);
+ }
+ GNUNET_free_non_null (atsi_delta);
}
(0 == memcmp (des->addr, aa->addr, aa->addr_len)))
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Deleting full address for peer `%s' session %u %p\n",
GNUNET_i2s (&aa->peer), aa->session_id, aa);
/* Notify solver about deletion */
- handle->s_del (handle->solver, handle->addresses, aa, GNUNET_NO);
- destroy_address (handle, aa);
+ GNUNET_assert (GNUNET_YES ==
+ GNUNET_CONTAINER_multihashmap_remove (handle->addresses,
+ &aa->peer.hashPubKey, aa));
+ handle->s_del (handle->solver, aa, GNUNET_NO);
+ free_address (aa);
dc->result = GNUNET_NO;
return GNUNET_OK; /* Continue iteration */
}
if ((aa->session_id != 0) &&
(0 != strcmp (des->plugin, aa->plugin)))
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
"Different plugins during removal: `%s' vs `%s' \n",
des->plugin, aa->plugin);
GNUNET_break (0);
if (aa->addr_len == 0)
{
/* Inbound connection died, delete full address */
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Deleting inbound address for peer `%s': `%s' session %u\n",
GNUNET_i2s (&aa->peer), aa->plugin, aa->session_id);
/* Notify solver about deletion */
- handle->s_del (handle->solver, handle->addresses, aa, GNUNET_NO);
- destroy_address (handle, aa);
+ GNUNET_assert (GNUNET_YES ==
+ GNUNET_CONTAINER_multihashmap_remove (handle->addresses,
+ &aa->peer.hashPubKey, aa));
+ handle->s_del (handle->solver, aa, GNUNET_NO);
+ free_address (aa);
dc->result = GNUNET_NO;
return GNUNET_OK; /* Continue iteration */
}
else
{
/* Session died */
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Deleting session for peer `%s': `%s' %u\n",
GNUNET_i2s (&aa->peer), aa->plugin, aa->session_id);
/* Notify solver to delete session */
- handle->s_del (handle->solver, handle->addresses, aa, GNUNET_YES);
+ handle->s_del (handle->solver, aa, GNUNET_YES);
aa->session_id = 0;
+ aa->active = GNUNET_NO;
return GNUNET_OK;
}
}
return GNUNET_OK;
}
+
+/**
+ * Remove an address or just a session for a peer.
+ *
+ * @param handle the address handle to use
+ * @param peer peer
+ * @param plugin_name transport plugin name
+ * @param plugin_addr plugin address
+ * @param plugin_addr_len length of the plugin address
+ * @param session_id session id, can be 0
+ */
void
GAS_addresses_destroy (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer,
- const char *plugin_name, const void *plugin_addr,
- size_t plugin_addr_len, uint32_t session_id)
+ const char *plugin_name,
+ const void *plugin_addr,
+ size_t plugin_addr_len,
+ uint32_t session_id)
{
struct ATS_Address *ea;
struct DestroyContext dc;
-
if (GNUNET_NO == handle->running)
return;
/* Get existing address */
- ea = lookup_address (handle, peer, plugin_name, plugin_addr, plugin_addr_len,
- session_id, NULL, 0);
-
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Received `%s' for peer `%s' address %p session %u\n",
- "ADDRESS DESTROY",
- GNUNET_i2s (peer), ea, session_id);
-
+ ea = find_exact_address (handle, peer, plugin_name, plugin_addr,
+ plugin_addr_len, session_id);
if (ea == NULL)
{
GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "Tried to destroy unknown address for peer `%s' `%s' session id %u\n",
return;
}
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ "Received `%s' for peer `%s' address %p session %u\n",
+ "ADDRESS DESTROY",
+ GNUNET_i2s (peer), ea, session_id);
+
GNUNET_break (0 < strlen (plugin_name));
dc.handle = handle;
dc.aa = create_address (peer, plugin_name, plugin_addr, plugin_addr_len, session_id);
}
+/**
+ * Notification about active use of an address.
+ * in_use == GNUNET_YES:
+ * This address is used to maintain an active connection with a peer.
+ * in_use == GNUNET_NO:
+ * This address is no longer used to maintain an active connection with a peer.
+ *
+ * Note: can only be called with in_use == GNUNET_NO if called with GNUNET_YES
+ * before
+ *
+ * @param handle the address handle to use
+ * @param peer peer
+ * @param plugin_name transport plugin name
+ * @param plugin_addr plugin address
+ * @param plugin_addr_len length of the plugin address
+ * @param session_id session id, can be 0
+ * @param in_use GNUNET_YES if GNUNET_NO
+ * @return GNUNET_SYSERR on failure (address unknown ...)
+ */
int
GAS_addresses_in_use (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer,
- const char *plugin_name, const void *plugin_addr,
- size_t plugin_addr_len, uint32_t session_id, int in_use)
+ const char *plugin_name,
+ const void *plugin_addr,
+ size_t plugin_addr_len,
+ uint32_t session_id,
+ int in_use)
{
struct ATS_Address *ea;
-
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
"Received `%s' for peer `%s'\n",
"ADDRESS IN USE",
if (GNUNET_NO == handle->running)
return GNUNET_SYSERR;
- ea = lookup_address (handle, peer, plugin_name,
- plugin_addr, plugin_addr_len,
- session_id, NULL, 0);
+ ea = find_exact_address (handle, peer, plugin_name,
+ plugin_addr, plugin_addr_len, session_id);
if (NULL == ea)
{
GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
- "Trying to set unknown address `%s', %s %u %s \n",
+ "Trying to set unknown address `%s' `%s' `%u' to %s \n",
GNUNET_i2s (peer),
plugin_name, session_id,
(GNUNET_NO == in_use) ? "NO" : "YES");
}
/* Tell solver about update */
- handle->s_update (handle->solver, handle->addresses, ea, session_id, in_use, NULL, 0);
ea->used = in_use;
-
+ handle->s_address_update_inuse (handle->solver, ea, ea->used);
return GNUNET_OK;
}
* Cancel address suggestions for a peer
*
* @param handle the address handle
- * @param peer the respective peer
+ * @param peer the peer id
*/
void
GAS_addresses_request_address_cancel (struct GAS_Addresses_Handle *handle,
"No address requests pending for peer `%s', cannot remove!\n", GNUNET_i2s (peer));
return;
}
+ handle->s_get_stop (handle->solver, peer);
GAS_addresses_handle_backoff_reset (handle, peer);
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
"Removed request pending for peer `%s\n", GNUNET_i2s (peer));
GNUNET_free (cur);
}
+/*
+static int
+addrinfo_it (void *cls, const struct GNUNET_HashCode *key, void *value)
+{
+ static int count = 0;
+ struct GNUNET_PeerIdentity *id = cls;
+ struct ATS_Address *aa = value;
+
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
+ "[%u] Peer `%s' %s length %u session %u active %s\n",
+ count, GNUNET_i2s (id), aa->plugin, aa->addr_len, aa->session_id,
+ (GNUNET_YES == aa->active) ? "active" : "inactive");
+
+ count ++;
+ return GNUNET_OK;
+}
+*/
/**
- * Add an address suggestions for a peer
+ * Request address suggestions for a peer
*
* @param handle the address handle
- * @param peer the respective peer
+ * @param peer the peer id
*/
void
GAS_addresses_request_address (struct GAS_Addresses_Handle *handle,
{
struct GAS_Addresses_Suggestion_Requests *cur = handle->r_head;
struct ATS_Address *aa;
- struct GNUNET_ATS_Information *ats;
- unsigned int ats_count;
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Received `%s' for peer `%s'\n",
"REQUEST ADDRESS",
GNUNET_i2s (peer));
GNUNET_CONTAINER_DLL_insert (handle->r_head, handle->r_tail, cur);
}
+ /*
+ * Debuging information about addresses
+ *
+ * GNUNET_CONTAINER_multihashmap_get_multiple(handle->addresses,
+ * &peer->hashPubKey, &addrinfo_it, (void *) peer);
+ */
+
/* Get prefered address from solver */
- aa = (struct ATS_Address *) handle->s_get (handle->solver, handle->addresses, peer);
+ aa = (struct ATS_Address *) handle->s_get (handle->solver, peer);
if (NULL == aa)
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Cannot suggest address for peer `%s'\n", GNUNET_i2s (peer));
return;
}
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
"Suggesting address %p for peer `%s'\n", aa, GNUNET_i2s (peer));
- ats_count = assemble_ats_information (aa, &ats);
GAS_scheduling_transmit_address_suggestion (peer,
aa->plugin,
aa->addr, aa->addr_len,
aa->session_id,
- ats, ats_count,
+ aa->atsi, aa->atsi_count,
aa->assigned_bw_out,
aa->assigned_bw_in);
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
"Address %p ready for suggestion, block interval now %llu \n",
aa, aa->block_interval);
-
- GNUNET_free (ats);
}
+/**
+ * Iterator to reset address blocking
+ *
+ * @param cls not used
+ * @param key the peer
+ * @param value the address to reset
+ * @return GNUNET_OK to continue
+ */
static int
-reset_address_it (void *cls, const struct GNUNET_HashCode * key, void *value)
+reset_address_it (void *cls, const struct GNUNET_HashCode *key, void *value)
{
struct ATS_Address *aa = value;
}
+/**
+ * Reset suggestion backoff for a peer
+ *
+ * Suggesting addresses is blocked for ATS_BLOCKING_DELTA. Blocking can be
+ * reset using this function
+ *
+ * @param handle the address handle
+ * @param peer the peer id
+ */
void
GAS_addresses_handle_backoff_reset (struct GAS_Addresses_Handle *handle,
const struct GNUNET_PeerIdentity *peer)
}
+/**
+ * The preference changed for a peer
+ *
+ * @param cls the address handle
+ * @param peer the peer
+ * @param kind the ATS kind
+ * @param pref_rel the new relative preference value
+ */
+static void
+normalized_preference_changed_cb (void *cls,
+ const struct GNUNET_PeerIdentity *peer,
+ enum GNUNET_ATS_PreferenceKind kind,
+ double pref_rel)
+{
+ GNUNET_assert (NULL != cls);
+ struct GAS_Addresses_Handle *handle = cls;
+
+ /* Tell solver about update */
+ handle->s_pref (handle->solver, peer, kind, pref_rel);
+}
+
+
+/**
+ * The relative value for a property changed
+ *
+ * @param cls the address handle
+ * @param address the peer
+ * @param type the ATS type
+ * @param prop_rel the new relative preference value
+ */
+static void
+normalized_property_changed_cb (void *cls,
+ struct ATS_Address *address,
+ uint32_t type,
+ double prop_rel)
+{
+ struct GAS_Addresses_Handle *ah = (struct GAS_Addresses_Handle *) cls;
+ GNUNET_assert (NULL != ah);
+
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ "Normalized property %s for peer `%s' changed to %.3f \n",
+ GNUNET_ATS_print_property_type (type),
+ GNUNET_i2s (&address->peer),
+ prop_rel);
+
+ ah->s_address_update_property (ah->solver, address, type, 0, prop_rel);
+}
+
+
+/**
+ * Function allowing the solver to obtain normalized preference
+ * values from solver
+ *
+ * @param cls unused
+ * @param id the peer to return the normalized properties for
+ * @return array of double values with |GNUNET_ATS_PreferenceCount| elements
+ */
+const double *
+get_preferences_cb (void *cls, const struct GNUNET_PeerIdentity *id)
+{
+ return GAS_normalization_get_preferences (id);
+}
+
+/**
+ * Function allowing the solver to obtain normalized property
+ * values for an address from solver
+ *
+ * @param cls unused
+ * @param address the address
+ * @return array of double values with |GNUNET_ATS_QualityPropertiesCount| elements
+ */
+const double *
+get_property_cb (void *cls, const struct ATS_Address *address)
+{
+ return GAS_normalization_get_properties ((struct ATS_Address *) address);
+}
+
+/**
+ * Change the preference for a peer
+ *
+ * @param handle the address handle
+ * @param client the client sending this request
+ * @param peer the peer id
+ * @param kind the preference kind to change
+ * @param score_abs the new preference score
+ */
void
GAS_addresses_change_preference (struct GAS_Addresses_Handle *handle,
void *client,
const struct GNUNET_PeerIdentity *peer,
enum GNUNET_ATS_PreferenceKind kind,
- float score)
+ float score_abs)
{
GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Received `%s' for peer `%s' for client %p\n",
- "CHANGE PREFERENCE",
- GNUNET_i2s (peer), client);
+ "Received `%s' for peer `%s' for client %p\n",
+ "CHANGE PREFERENCE",
+ GNUNET_i2s (peer), client);
if (GNUNET_NO == handle->running)
return;
return;
}
- /* Tell solver about update */
- handle->s_pref (handle->solver, client, peer, kind, score);
+ handle->s_bulk_start (handle->solver);
+ /* Tell normalization about change, normalization will call callback if preference changed */
+ GAS_normalization_normalize_preference (client, peer, kind, score_abs);
+ handle->s_bulk_stop (handle->solver);
+}
+
+
+/**
+ * Change the preference for a peer
+ *
+ * @param handle the address handle
+ * @param application the client sending this request
+ * @param peer the peer id
+ * @param scope the time interval for this feedback: [now - scope .. now]
+ * @param kind the preference kind to change
+ * @param score_abs the new preference score
+ */
+void
+GAS_addresses_preference_feedback (struct GAS_Addresses_Handle *handle,
+ void *application,
+ const struct GNUNET_PeerIdentity *peer,
+ const struct GNUNET_TIME_Relative scope,
+ enum GNUNET_ATS_PreferenceKind kind,
+ float score_abs)
+{
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ "Received `%s' for peer `%s' for client %p\n",
+ "PREFERENCE FEEDBACK",
+ GNUNET_i2s (peer), application);
+
+ if (GNUNET_NO == handle->running)
+ return;
+
+ if (GNUNET_NO == GNUNET_CONTAINER_multihashmap_contains (handle->addresses,
+ &peer->hashPubKey))
+ {
+ GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
+ "Received `%s' for unknown peer `%s' from client %p\n",
+ "PREFERENCE FEEDBACK",
+ GNUNET_i2s (peer), application);
+ return;
+ }
+
+ handle->s_feedback (handle->solver, application, peer, scope, kind, score_abs);
}
* @return number of networks loaded
*/
static unsigned int
-load_quotas (const struct GNUNET_CONFIGURATION_Handle *cfg, unsigned long long *out_dest, unsigned long long *in_dest, int dest_length)
+load_quotas (const struct GNUNET_CONFIGURATION_Handle *cfg,
+ unsigned long long *out_dest,
+ unsigned long long *in_dest,
+ int dest_length)
{
char *network_str[GNUNET_ATS_NetworkTypeCount] = GNUNET_ATS_NetworkTypeString;
char * entry_in = NULL;
if (GNUNET_OK == GNUNET_CONFIGURATION_get_value_string(cfg, "ats", entry_out, "a_out_str))
{
res = GNUNET_NO;
- if (0 == strcmp(quota_out_str, BIG_M_STRING))
+ if (0 == strcmp(quota_out_str, GNUNET_ATS_MaxBandwidthString))
{
out_dest[c] = GNUNET_ATS_MaxBandwidth;
res = GNUNET_YES;
if (GNUNET_OK == GNUNET_CONFIGURATION_get_value_string(cfg, "ats", entry_in, "a_in_str))
{
res = GNUNET_NO;
- if (0 == strcmp(quota_in_str, BIG_M_STRING))
+ if (0 == strcmp(quota_in_str, GNUNET_ATS_MaxBandwidthString))
{
in_dest[c] = GNUNET_ATS_MaxBandwidth;
res = GNUNET_YES;
}
+/**
+ * Callback for solver to notify about assignment changes
+ *
+ * @param cls the GAS_Addresses_Handle
+ * @param address the address with changes
+ */
static void
bandwidth_changed_cb (void *cls, struct ATS_Address *address)
{
GNUNET_assert (handle != NULL);
GNUNET_assert (address != NULL);
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Bandwidth assignment changed for peer %s \n", GNUNET_i2s(&address->peer));
- struct GNUNET_ATS_Information *ats;
- unsigned int ats_count;
-
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Bandwidth assignment changed for peer %s \n",
+ GNUNET_i2s(&address->peer));
+
+ /* Notify performance clients about changes to address */
+ GAS_performance_notify_all_clients (&address->peer,
+ address->plugin,
+ address->addr, address->addr_len,
+ address->session_id,
+ address->atsi, address->atsi_count,
+ address->assigned_bw_out,
+ address->assigned_bw_in);
cur = handle->r_head;
while (NULL != cur)
{
}
if (NULL == cur)
{
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Nobody is interested in peer `%s' :(\n",GNUNET_i2s (&address->peer));
return;
}
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Sending bandwidth update for peer `%s'\n",GNUNET_i2s (&address->peer));
+ if ((0 == ntohl (address->assigned_bw_in.value__)) &&
+ (0 == ntohl (address->assigned_bw_out.value__)))
+ {
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
+ "Telling transport to disconnect peer `%s'\n",
+ GNUNET_i2s (&address->peer));
+ }
+ else
+ {
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
+ "Sending bandwidth update for peer `%s': %llu %llu\n",
+ GNUNET_i2s (&address->peer),
+ address->assigned_bw_out,
+ address->assigned_bw_out);
+ }
- ats_count = assemble_ats_information (address, &ats);
+ /* *Notify scheduling clients about suggestion */
GAS_scheduling_transmit_address_suggestion (&address->peer,
address->plugin,
address->addr, address->addr_len,
address->session_id,
- ats, ats_count,
+ address->atsi, address->atsi_count,
address->assigned_bw_out,
address->assigned_bw_in);
- GNUNET_free (ats);
}
/**
- * Initialize address subsystem.
+ * Initialize address subsystem. The addresses subsystem manages the addresses
+ * known and current performance information. It has a solver component
+ * responsible for the resource allocation. It tells the solver about changes
+ * and receives updates when the solver changes the resource allocation.
*
* @param cfg configuration to use
* @param stats the statistics handle to use
+ * @return an address handle
*/
struct GAS_Addresses_Handle *
GAS_addresses_init (const struct GNUNET_CONFIGURATION_Handle *cfg,
/* Figure out configured solution method */
if (GNUNET_SYSERR == GNUNET_CONFIGURATION_get_value_string (cfg, "ats", "MODE", &mode_str))
{
- GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "No ressource assignment method configured, using simplistic approch\n");
- ah->ats_mode = MODE_SIMPLISTIC;
+ GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "No resource assignment method configured, using proportional approach\n");
+ ah->ats_mode = MODE_PROPORTIONAL;
}
else
{
for (c = 0; c < strlen (mode_str); c++)
mode_str[c] = toupper (mode_str[c]);
- if (0 == strcmp (mode_str, "SIMPLISTIC"))
+ if (0 == strcmp (mode_str, "PROPORTIONAL"))
{
- ah->ats_mode = MODE_SIMPLISTIC;
+ ah->ats_mode = MODE_PROPORTIONAL;
}
else if (0 == strcmp (mode_str, "MLP"))
{
ah->ats_mode = MODE_MLP;
#if !HAVE_LIBGLPK
- GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Assignment method `%s' configured, but GLPK is not availabe, please install \n", mode_str);
- ah->ats_mode = MODE_SIMPLISTIC;
+ GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Assignment method `%s' configured, but GLPK is not available, please install \n", mode_str);
+ ah->ats_mode = MODE_PROPORTIONAL;
#endif
}
+ else if (0 == strcmp (mode_str, "RIL"))
+ {
+ ah->ats_mode = MODE_RIL;
+ }
else
{
- GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Invalid ressource assignment method `%s' configured, using simplistic approch\n", mode_str);
- ah->ats_mode = MODE_SIMPLISTIC;
+ GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Invalid resource assignment method `%s' configured, using proportional approach\n", mode_str);
+ ah->ats_mode = MODE_PROPORTIONAL;
}
GNUNET_free (mode_str);
}
case MODE_MLP:
/* Init the MLP solver with default values */
#if HAVE_LIBGLPK
- ah->ats_mode = MODE_MLP;
ah->s_init = &GAS_mlp_init;
ah->s_add = &GAS_mlp_address_add;
- ah->s_update = &GAS_mlp_address_update;
+ ah->s_address_update_property = &GAS_mlp_address_property_changed;
+ ah->s_address_update_session = &GAS_mlp_address_session_changed;
+ ah->s_address_update_inuse = &GAS_mlp_address_inuse_changed;
+ ah->s_address_update_network = &GAS_mlp_address_change_network;
ah->s_get = &GAS_mlp_get_preferred_address;
+ ah->s_get_stop = &GAS_mlp_stop_get_preferred_address;
ah->s_pref = &GAS_mlp_address_change_preference;
+ ah->s_feedback = &GAS_mlp_address_preference_feedback;
ah->s_del = &GAS_mlp_address_delete;
+ ah->s_bulk_start = &GAS_mlp_bulk_start;
+ ah->s_bulk_stop = &GAS_mlp_bulk_stop;
ah->s_done = &GAS_mlp_done;
#else
GNUNET_free (ah);
return NULL;
#endif
break;
- case MODE_SIMPLISTIC:
- /* Init the simplistic solver with default values */
- ah->ats_mode = MODE_SIMPLISTIC;
- ah->s_init = &GAS_simplistic_init;
- ah->s_add = &GAS_simplistic_address_add;
- ah->s_update = &GAS_simplistic_address_update;
- ah->s_get = &GAS_simplistic_get_preferred_address;
- ah->s_pref = &GAS_simplistic_address_change_preference;
- ah->s_del = &GAS_simplistic_address_delete;
- ah->s_done = &GAS_simplistic_done;
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "ATS started in %s mode\n", "SIMPLISTIC");
+ case MODE_PROPORTIONAL:
+ /* Init the proportional solver with default values */
+ ah->s_init = &GAS_proportional_init;
+ ah->s_add = &GAS_proportional_address_add;
+ ah->s_address_update_property = &GAS_proportional_address_property_changed;
+ ah->s_address_update_session = &GAS_proportional_address_session_changed;
+ ah->s_address_update_inuse = &GAS_proportional_address_inuse_changed;
+ ah->s_address_update_network = &GAS_proportional_address_change_network;
+ ah->s_get = &GAS_proportional_get_preferred_address;
+ ah->s_get_stop = &GAS_proportional_stop_get_preferred_address;
+ ah->s_pref = &GAS_proportional_address_change_preference;
+ ah->s_feedback = &GAS_proportional_address_preference_feedback;
+ ah->s_del = &GAS_proportional_address_delete;
+ ah->s_bulk_start = &GAS_proportional_bulk_start;
+ ah->s_bulk_stop = &GAS_proportional_bulk_stop;
+ ah->s_done = &GAS_proportional_done;
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "ATS started in %s mode\n", "PROPORTIONAL");
break;
+ case MODE_RIL:
+ /* Init the ril solver with default values */
+ ah->s_init = &GAS_ril_init;
+ ah->s_add = &GAS_ril_address_add;
+ ah->s_address_update_property = &GAS_ril_address_property_changed;
+ ah->s_address_update_session = &GAS_ril_address_session_changed;
+ ah->s_address_update_inuse = &GAS_ril_address_inuse_changed;
+ ah->s_address_update_network = &GAS_ril_address_change_network;
+ ah->s_get = &GAS_ril_get_preferred_address;
+ ah->s_get_stop = &GAS_ril_stop_get_preferred_address;
+ ah->s_pref = &GAS_ril_address_change_preference;
+ ah->s_feedback = &GAS_ril_address_preference_feedback;
+ ah->s_del = &GAS_ril_address_delete;
+ ah->s_bulk_start = &GAS_ril_bulk_start;
+ ah->s_bulk_stop = &GAS_ril_bulk_stop;
+ ah->s_done = &GAS_ril_done;
+ GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "ATS started in %s mode\n", "RIL");
+ break;
default:
return NULL;
break;
GNUNET_assert (NULL != ah->s_init);
GNUNET_assert (NULL != ah->s_add);
- GNUNET_assert (NULL != ah->s_update);
+ GNUNET_assert (NULL != ah->s_address_update_inuse);
+ GNUNET_assert (NULL != ah->s_address_update_property);
+ GNUNET_assert (NULL != ah->s_address_update_session);
+ GNUNET_assert (NULL != ah->s_address_update_network);
GNUNET_assert (NULL != ah->s_get);
+ GNUNET_assert (NULL != ah->s_get_stop);
GNUNET_assert (NULL != ah->s_pref);
+ GNUNET_assert (NULL != ah->s_feedback);
GNUNET_assert (NULL != ah->s_del);
GNUNET_assert (NULL != ah->s_done);
+ GNUNET_assert (NULL != ah->s_bulk_start);
+ GNUNET_assert (NULL != ah->s_bulk_stop);
+ GAS_normalization_start (&normalized_preference_changed_cb, ah,
+ &normalized_property_changed_cb, ah);
quota_count = load_quotas(cfg, quotas_in, quotas_out, GNUNET_ATS_NetworkTypeCount);
- ah->solver = ah->s_init (cfg, stats, quotas, quotas_in, quotas_out, quota_count, &bandwidth_changed_cb, ah);
+ ah->solver = ah->s_init (cfg, stats, ah->addresses,
+ quotas, quotas_in, quotas_out, quota_count,
+ &bandwidth_changed_cb, ah,
+ &get_preferences_cb, NULL,
+ &get_property_cb, NULL);
if (NULL == ah->solver)
{
- GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Failed to initialize solver!\n");
+ GNUNET_log (GNUNET_ERROR_TYPE_ERROR, _("Failed to initialize solver!\n"));
GNUNET_free (ah);
return NULL;
}
/**
- * Free memory of address.
+ * Destroy all addresses iterator
*
* @param cls NULL
* @param key peer identity (unused)
* @return GNUNET_OK (continue to iterate)
*/
static int
-free_address_it (void *cls, const struct GNUNET_HashCode * key, void *value)
+destroy_all_address_it (void *cls, const struct GNUNET_HashCode * key, void *value)
{
struct GAS_Addresses_Handle *handle = cls;
struct ATS_Address *aa = value;
- handle->s_del (handle->solver, handle->addresses, aa, GNUNET_NO);
- destroy_address (handle, aa);
+
+ /* Remove */
+ GNUNET_assert (GNUNET_YES == GNUNET_CONTAINER_multihashmap_remove (handle->addresses, key, value));
+ /* Notify */
+ handle->s_del (handle->solver, aa, GNUNET_NO);
+ /* Destroy */
+ free_address (aa);
+
return GNUNET_OK;
}
+/**
+ * Remove all addresses
+ *
+ * @param handle the address handle to use
+ */
void
GAS_addresses_destroy_all (struct GAS_Addresses_Handle *handle)
{
if (GNUNET_NO == handle->running)
return;
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
- "Received `%s'\n",
- "DESTROY ALL");
-
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
+ "Destroying all addresses\n");
+ handle->s_bulk_start (handle->solver);
if (handle->addresses != NULL)
- GNUNET_CONTAINER_multihashmap_iterate (handle->addresses, &free_address_it, handle);
+ GNUNET_CONTAINER_multihashmap_iterate (handle->addresses, &destroy_all_address_it, handle);
+ handle->s_bulk_start (handle->solver);
}
/**
* Shutdown address subsystem.
+ *
+ * @param handle the address handle to shutdown
*/
void
GAS_addresses_done (struct GAS_Addresses_Handle *handle)
{
struct GAS_Addresses_Suggestion_Requests *cur;
- GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
+ GNUNET_log (GNUNET_ERROR_TYPE_INFO,
"Shutting down addresses\n");
GNUNET_assert (NULL != handle);
GAS_addresses_destroy_all (handle);
handle->s_done (handle->solver);
GNUNET_free (handle);
/* Stop configured solution method */
-
+ GAS_normalization_stop ();
}
+
struct PeerIteratorContext
{
GNUNET_ATS_Peer_Iterator it;
struct GNUNET_CONTAINER_MultiHashMap *peers_returned;
};
+
+/**
+ * Iterator to iterate over all peers
+ *
+ * @param cls a PeerIteratorContext
+ * @param key the peer id
+ * @param value the ATS_address
+ * @return GNUNET_OK to continue
+ */
static int
peer_it (void *cls,
const struct GNUNET_HashCode * key,
return GNUNET_OK;
}
+
/**
- * Return all peers currently known to ATS
+ * Return information all peers currently known to ATS
*
- * @param handle the address handle
- * @param p_it the iterator to call for every peer, callbach with id == NULL
- * when done
+ * @param handle the address handle to use
+ * @param p_it the iterator to call for every peer
* @param p_it_cls the closure for the iterator
*/
void
-GAS_addresses_iterate_peers (struct GAS_Addresses_Handle *handle, GNUNET_ATS_Peer_Iterator p_it, void *p_it_cls)
+GAS_addresses_iterate_peers (struct GAS_Addresses_Handle *handle,
+ GNUNET_ATS_Peer_Iterator p_it,
+ void *p_it_cls)
{
struct PeerIteratorContext ip_ctx;
unsigned int size;
p_it (p_it_cls, NULL);
}
+
struct PeerInfoIteratorContext
{
GNUNET_ATS_PeerInfo_Iterator it;
};
+/**
+ * Iterator to iterate over a peer's addresses
+ *
+ * @param cls a PeerInfoIteratorContext
+ * @param key the peer id
+ * @param value the ATS_address
+ * @return GNUNET_OK to continue
+ */
static int
peerinfo_it (void *cls,
const struct GNUNET_HashCode * key,
{
struct PeerInfoIteratorContext *pi_ctx = cls;
struct ATS_Address *addr = (struct ATS_Address *) value;
- struct GNUNET_ATS_Information *ats;
- uint32_t ats_count;
if (NULL != pi_ctx->it)
{
- ats_count = assemble_ats_information (addr, &ats);
-
pi_ctx->it (pi_ctx->it_cls,
&addr->peer,
addr->plugin,
addr->addr, addr->addr_len,
addr->active,
- ats, ats_count,
+ addr->atsi, addr->atsi_count,
addr->assigned_bw_out,
addr->assigned_bw_in);
- GNUNET_free (ats);
}
return GNUNET_YES;
}
/**
- * Return all peers currently known to ATS
+ * Return information all peers currently known to ATS
*
- * @param handle the address handle
+ * @param handle the address handle to use
* @param peer the respective peer
* @param pi_it the iterator to call for every peer
* @param pi_it_cls the closure for the iterator