1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
/*
This file is part of GNUnet.
(C) 2011 Christian Grothoff (and other contributing authors)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 3, or (at your
option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
/**
* @file ats/gnunet-service-ats_normalization.h
* @brief ats service address: management of ATS properties and preferences normalization
* @author Matthias Wachs
* @author Christian Grothoff
*/
#include "platform.h"
#include "gnunet_ats_service.h"
#define PREF_AGING_INTERVAL GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 10)
#define PREF_AGING_FACTOR 0.95
#define PREF_EPSILON 0.1
#define DEFAULT_REL_PREFERENCE 1.0
#define DEFAULT_ABS_PREFERENCE 0.0
#define DEFAULT_REL_QUALITY 1.0
typedef void
(*GAS_Normalization_preference_changed_cb) (void *cls,
const struct GNUNET_PeerIdentity *peer,
enum GNUNET_ATS_PreferenceKind kind,
double pref_rel);
typedef void
(*GAS_Normalization_property_changed_cb) (void *cls,
struct ATS_Address *peer,
uint32_t type,
double prop_rel);
/**
* Get the normalized preference values for a specific peer
*
* @param id the peer @return pointer to the values, can be indexed
* with GNUNET_ATS_PreferenceKind, NULL if peer does not exist
*/
const double *
GAS_normalization_get_preferences_by_peer (const struct GNUNET_PeerIdentity *id);
/**
* Get the normalized properties values for a specific peer or
* the default values if
*
* @param address the address
* @return pointer to the values, can be indexed with GNUNET_ATS_PreferenceKind,
* default preferences if peer does not exist
*/
const double *
GAS_normalization_get_properties (struct ATS_Address *address);
/**
* Get the normalized preference values for a specific client and peer
*
* @param client client
* @param peer the peer
* @param pref the preference type
* @return the value
*/
const double
GAS_normalization_get_preferences_by_client (const void *client,
struct GNUNET_PeerIdentity *peer, enum GNUNET_ATS_PreferenceKind pref);
/**
* Normalize an updated preference value
*
* @param src the client with this preference
* @param peer the peer to change the preference for
* @param kind the kind to change the preference
* @param score_abs the normalized score
*/
void
GAS_normalization_normalize_preference (void *src,
const struct GNUNET_PeerIdentity *peer,
enum GNUNET_ATS_PreferenceKind kind,
float score_abs);
/**
* Update and normalize a atsi performance information
*
* @param addresses hashmap containing all addresses
* @param address the address to update
* @param atsi the array of performance information
* @param atsi_count the number of atsi information in the array
*/
void
GAS_normalization_normalize_property (struct GNUNET_CONTAINER_MultiPeerMap *addresses,
struct ATS_Address *address,
const struct GNUNET_ATS_Information *atsi,
uint32_t atsi_count);
/**
* A performance client disconnected
*
* @param client the disconnecting client
*/
void
GAS_normalization_preference_client_disconnect (void *client);
/**
* Start the normalization component
*
* @param pref_ch_cb callback to call on relative preference changing
* @param pref_ch_cb_cls cls for the preference callback
* @param property_ch_cb callback to call on relative property changing
* @param property_ch_cb_cls cls for the property callback
*/
void
GAS_normalization_start (GAS_Normalization_preference_changed_cb pref_ch_cb,
void *pref_ch_cb_cls,
GAS_Normalization_property_changed_cb property_ch_cb,
void *property_ch_cb_cls);
/**
* Stop the normalization component and free all items
*/
void
GAS_normalization_stop ();
/* end of gnunet-service-ats_normalization.h */
|
