[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r27762 - gnunet/src/ats
From: |
gnunet |
Subject: |
[GNUnet-SVN] r27762 - gnunet/src/ats |
Date: |
Fri, 5 Jul 2013 16:00:50 +0200 |
Author: wachs
Date: 2013-07-05 16:00:50 +0200 (Fri, 05 Jul 2013)
New Revision: 27762
Modified:
gnunet/src/ats/gnunet-service-ats-solver_mlp.c
gnunet/src/ats/gnunet-service-ats-solver_mlp.h
gnunet/src/ats/gnunet-service-ats-solver_proportional.c
gnunet/src/ats/gnunet-service-ats-solver_proportional.h
gnunet/src/ats/gnunet-service-ats_addresses.c
gnunet/src/ats/gnunet-service-ats_addresses.h
gnunet/src/ats/perf_ats_mlp.c
Log:
doxygen documentation
Modified: gnunet/src/ats/gnunet-service-ats-solver_mlp.c
===================================================================
--- gnunet/src/ats/gnunet-service-ats-solver_mlp.c 2013-07-05 14:00:11 UTC
(rev 27761)
+++ gnunet/src/ats/gnunet-service-ats-solver_mlp.c 2013-07-05 14:00:50 UTC
(rev 27762)
@@ -421,7 +421,7 @@
* @param col the column to create the value in
* @param val the value to set
* @param line calling line for debbuging
- * @param GNUNET_YES value changed, GNUNET_NO value did not change,
GNUNET_SYSERR
+ * @return GNUNET_YES value changed, GNUNET_NO value did not change,
GNUNET_SYSERR
* on error
*/
static int
@@ -803,7 +803,6 @@
* Create the MLP problem
*
* @param mlp the MLP handle
- * @param addresses the hashmap containing all adresses
* @return GNUNET_OK or GNUNET_SYSERR
*/
static int
@@ -1150,7 +1149,6 @@
* Add a single address to the solve
*
* @param solver the solver Handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to add
* @param network network type of this address
*/
@@ -1288,13 +1286,11 @@
*
* @param solver solver handle
* @param address the address
- * @param cur_session the current session
- * @param new_session the new session
+ * @param in_use usage state
*/
void
GAS_mlp_address_inuse_changed (void *solver,
struct ATS_Address *address,
-
uint32_t session,
int in_use)
{
/* Nothing to do here */
@@ -1406,8 +1402,6 @@
* The MLP problem has to be recreated and the problem has to be resolved
*
* @param solver the MLP Handle
- * @param addresses the address hashmap
- * the address has to be already removed from the hashmap
* @param address the address to delete
* @param session_only delete only session not whole address
*/
@@ -1502,7 +1496,6 @@
* Get the preferred address for a specific peer
*
* @param solver the MLP Handle
- * @param addresses address hashmap
* @param peer the peer
* @return suggested address
*/
@@ -1589,7 +1582,6 @@
* Stop notifying about address and bandwidth changes for this peer
*
* @param solver the MLP handle
- * @param addresses address hashmap
* @param peer the peer
*/
void
@@ -1614,7 +1606,6 @@
* Changes the preferences for a peer in the MLP problem
*
* @param solver the MLP Handle
- * @param addresses the address hashmap
* @param peer the peer
* @param kind the kind to change the preference
* @param pref_rel the relative score
@@ -1699,6 +1690,7 @@
*
* @param cfg the GNUNET_CONFIGURATION_Handle handle
* @param stats the GNUNET_STATISTICS handle
+ * @param addresses the address hashmap
* @param network array of GNUNET_ATS_NetworkType with length dest_length
* @param out_dest array of outbound quotas
* @param in_dest array of outbound quota
@@ -1707,6 +1699,8 @@
* @param bw_changed_cb_cls cls for callback
* @param get_preference callback to get relative preferences for a peer
* @param get_preference_cls cls for callback to get relative preferences
+ * @param get_properties callback to get relative properties
+ * @param get_properties_cls cls for callback to get relative properties
* @return struct GAS_MLP_Handle on success, NULL on fail
*/
void *
Modified: gnunet/src/ats/gnunet-service-ats-solver_mlp.h
===================================================================
--- gnunet/src/ats/gnunet-service-ats-solver_mlp.h 2013-07-05 14:00:11 UTC
(rev 27761)
+++ gnunet/src/ats/gnunet-service-ats-solver_mlp.h 2013-07-05 14:00:50 UTC
(rev 27762)
@@ -371,7 +371,9 @@
* @param bw_changed_cb callback for changed bandwidth amounts
* @param bw_changed_cb_cls cls for callback
* @param get_preference callback to get relative preferences for a peer
- * @param get_preference_cls cls for callback to get relative preferences
+ * @param get_preference callback to get relative preferences for a peer
+ * @param get_properties_cls for callback to get relative properties
+ * @param get_properties_cls cls for callback to get relative properties
* @return struct GAS_MLP_Handle on success, NULL on fail
*/
void *
@@ -394,7 +396,6 @@
* Add a single address within a network to the solver
*
* @param solver the solver Handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to add
* @param network network type of this address
*/
@@ -439,19 +440,17 @@
/**
- * Transport session for this address has changed
+ * Usage for this address has changed
*
* NOTE: values in addresses are already updated
*
* @param solver solver handle
* @param address the address
- * @param cur_session the current session
- * @param new_session the new session
+ * @param in_use usage state
*/
void
GAS_mlp_address_inuse_changed (void *solver,
struct ATS_Address *address,
-
uint32_t session,
int in_use);
@@ -477,8 +476,6 @@
* The MLP problem has to be recreated and the problem has to be resolved
*
* @param solver the MLP Handle
- * @param addresses the address hashmap
- * the address has to be already removed from the hashmap
* @param address the address to delete
* @param session_only delete only session not whole address
*/
@@ -492,7 +489,6 @@
* Changes the preferences for a peer in the MLP problem
*
* @param solver the MLP Handle
- * @param addresses the address hashmap
* @param peer the peer
* @param kind the kind to change the preference
* @param pref_rel the relative score
@@ -524,7 +520,6 @@
* Get the preferred address for a specific peer
*
* @param solver the MLP Handle
- * @param addresses address hashmap
* @param peer the peer
* @return suggested address
*/
@@ -537,10 +532,8 @@
* Stop notifying about address and bandwidth changes for this peer
*
* @param solver the MLP handle
- * @param addresses address hashmap
* @param peer the peer
*/
-
void
GAS_mlp_stop_get_preferred_address (void *solver,
const struct GNUNET_PeerIdentity *peer);
Modified: gnunet/src/ats/gnunet-service-ats-solver_proportional.c
===================================================================
--- gnunet/src/ats/gnunet-service-ats-solver_proportional.c 2013-07-05
14:00:11 UTC (rev 27761)
+++ gnunet/src/ats/gnunet-service-ats-solver_proportional.c 2013-07-05
14:00:50 UTC (rev 27762)
@@ -888,7 +888,6 @@
* Get the preferred address for a specific peer
*
* @param solver the solver handle
- * @param addresses the address hashmap containing all addresses
* @param peer the identity of the peer
*/
const struct ATS_Address *
@@ -970,7 +969,6 @@
* Stop notifying about address and bandwidth changes for this peer
*
* @param solver the solver handle
- * @param addresses address hashmap
* @param peer the peer
*/
void
@@ -985,7 +983,6 @@
* Remove an address from the solver
*
* @param solver the solver handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to remove
* @param session_only delete only session not whole address
*/
@@ -1251,7 +1248,6 @@
* Add a new single address to a network
*
* @param solver the solver Handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to add
* @param network network type of this address
*/
@@ -1310,6 +1306,8 @@
* @param bw_changed_cb_cls cls for callback
* @param get_preference callback to get relative preferences for a peer
* @param get_preference_cls cls for callback to get relative preferences
+ * @param get_properties for callback to get relative properties
+ * @param get_properties_cls cls for callback to get relative properties
* @return handle for the solver on success, NULL on fail
*/
void *
Modified: gnunet/src/ats/gnunet-service-ats-solver_proportional.h
===================================================================
--- gnunet/src/ats/gnunet-service-ats-solver_proportional.h 2013-07-05
14:00:11 UTC (rev 27761)
+++ gnunet/src/ats/gnunet-service-ats-solver_proportional.h 2013-07-05
14:00:50 UTC (rev 27762)
@@ -38,7 +38,6 @@
* Changes the preferences for a peer in the problem
*
* @param solver the solver handle
- * @param addresses the address hashmap
* @param peer the peer to change the preference for
* @param kind the kind to change the preference
* @param pref_rel the normalized preference value for this kind over all
clients
@@ -75,6 +74,8 @@
* @param bw_changed_cb_cls cls for callback
* @param get_preference callback to get relative preferences for a peer
* @param get_preference_cls cls for callback to get relative preferences
+ * @param get_properties_cls for callback to get relative properties
+ * @param get_properties_cls cls for callback to get relative properties
* @return handle for the solver on success, NULL on fail
*/
void *
@@ -105,7 +106,6 @@
* Add a single address within a network to the solver
*
* @param solver the solver Handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to add
* @param network network type of this address
*/
@@ -114,6 +114,16 @@
struct ATS_Address
*address,
uint32_t network);
+
+/**
+ * Transport properties for this address have changed
+ *
+ * @param solver solver handle
+ * @param address the address
+ * @param type the ATSI type in HBO
+ * @param abs_value the absolute value of the property
+ * @param rel_value the normalized value
+ */
void
GAS_proportional_address_property_changed (void *solver,
struct ATS_Address *address,
@@ -122,18 +132,47 @@
double rel_value);
+/**
+ * Transport session for this address has changed
+ *
+ * NOTE: values in addresses are already updated
+ *
+ * @param solver solver handle
+ * @param address the address
+ * @param cur_session the current session
+ * @param new_session the new session
+ */
void
GAS_proportional_address_session_changed (void *solver,
struct ATS_Address *address,
uint32_t cur_session,
uint32_t new_session);
+
+/**
+ * Usage for this address has changed
+ *
+ * NOTE: values in addresses are already updated
+ *
+ * @param solver solver handle
+ * @param address the address
+ * @param in_use usage state
+ */
void
GAS_proportional_address_inuse_changed (void *solver,
struct ATS_Address *address,
-
uint32_t session,
int in_use);
+/**
+ * Network scope for this address has changed
+ *
+ * NOTE: values in addresses are already updated
+ *
+ * @param solver solver handle
+ * @param address the address
+ * @param current_network the current network
+ * @param new_network the new network
+ */
void
GAS_proportional_address_change_network (void *solver,
struct ATS_Address
*address,
@@ -144,7 +183,6 @@
* Remove an address from the solver
*
* @param solver the solver handle
- * @param addresses the address hashmap containing all addresses
* @param address the address to remove
* @param session_only delete only session not whole address
*/
@@ -172,7 +210,6 @@
* Stop notifying about address and bandwidth changes for this peer
*
* @param solver the proportional handle
- * @param addresses address hashmap
* @param peer the peer
*/
void
@@ -184,7 +221,6 @@
* Get the prefered address for a specific peer
*
* @param solver the solver handle
- * @param addresses the address hashmap containing all addresses
* @param peer the identity of the peer
*/
const struct ATS_Address *
Modified: gnunet/src/ats/gnunet-service-ats_addresses.c
===================================================================
--- gnunet/src/ats/gnunet-service-ats_addresses.c 2013-07-05 14:00:11 UTC
(rev 27761)
+++ gnunet/src/ats/gnunet-service-ats_addresses.c 2013-07-05 14:00:50 UTC
(rev 27762)
@@ -678,8 +678,6 @@
* @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
* @return an ATS_address or NULL
*/
@@ -1179,7 +1177,7 @@
/* Tell solver about update */
ea->used = in_use;
- handle->s_address_update_inuse (handle->solver, ea, ea->session_id,
ea->used);
+ handle->s_address_update_inuse (handle->solver, ea, ea->used);
return GNUNET_OK;
}
@@ -1356,7 +1354,7 @@
* The relative value for a property changed
*
* @param cls the address handle
- * @param peer the peer
+ * @param address the peer
* @param type the ATS type
* @param prop_rel the new relative preference value
*/
@@ -1402,7 +1400,7 @@
* values for an address from solver
*
* @param cls unused
- * @param id the peer to return the normalized properties for
+ * @param address the address
* @return array of double values with |GNUNET_ATS_QualityPropertiesCount|
elements
*/
const double *
Modified: gnunet/src/ats/gnunet-service-ats_addresses.h
===================================================================
--- gnunet/src/ats/gnunet-service-ats_addresses.h 2013-07-05 14:00:11 UTC
(rev 27761)
+++ gnunet/src/ats/gnunet-service-ats_addresses.h 2013-07-05 14:00:50 UTC
(rev 27762)
@@ -536,13 +536,11 @@
*
* @param solver solver handle
* @param address the address
- * @param cur_session the current session
- * @param new_session the new session
+ * @param in_use usage state
*/
typedef void
(*GAS_solver_address_inuse_changed) (void *solver,
struct ATS_Address
*address,
-
uint32_t session,
int in_use);
/**
Modified: gnunet/src/ats/perf_ats_mlp.c
===================================================================
--- gnunet/src/ats/perf_ats_mlp.c 2013-07-05 14:00:11 UTC (rev 27761)
+++ gnunet/src/ats/perf_ats_mlp.c 2013-07-05 14:00:50 UTC (rev 27762)
@@ -222,7 +222,7 @@
default:
break;
}
- GAS_mlp_address_inuse_changed(mlp, cur, 0, GNUNET_YES);
+ GAS_mlp_address_inuse_changed(mlp, cur, GNUNET_YES);
}
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r27762 - gnunet/src/ats,
gnunet <=