-skeletons for transport-ng
[oweals/gnunet.git] / src / ats / gnunet-service-ats_normalization.h
index 78fddbc567076bcb617c415f6b5fd82e95cce3e6..97389f561d55747aea78af4831e632012af50547 100644 (file)
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     (C) 2011 Christian Grothoff (and other contributing authors)
+     Copyright (C) 2011 GNUnet e.V.
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
@@ -14,8 +14,8 @@
 
      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.
+     Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+     Boston, MA 02110-1301, USA.
 */
 
 /**
  * @author Matthias Wachs
  * @author Christian Grothoff
  */
-#include "platform.h"
+#ifndef GNUNET_SERVICE_ATS_NORMALIZATION_H
+#define GNUNET_SERVICE_ATS_NORMALIZATION_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 DEFAULT_REL_PREFERENCE 1.0
-#define DEFAULT_ABS_PREFERENCE 0.0
-
+/**
+ * Value we return for a normalized quality score if we have no data.
+ */
+#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);
 
 /**
- * Get the normalized preference values for a specific peer
+ * Update and normalize a @a prop performance information
  *
- * @param id the peer
- * @return pointer to the values, can be indexed with GNUNET_ATS_PreferenceKind, NULL if peer does not exist
+ * @param address the address to update
  */
-const double *
-GAS_normalization_get_preferences (const struct GNUNET_PeerIdentity *id);
+void
+GAS_normalization_update_property (struct ATS_Address *address);
 
 
 /**
- * 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
+ * Start the normalization component
  */
-float
-GAS_normalization_change_preference (void *src,
-                                        const struct GNUNET_PeerIdentity *peer,
-                                        enum GNUNET_ATS_PreferenceKind kind,
-                                        float score_abs);
-
 void
-GAS_normalization_start (GAS_Normalization_preference_changed_cb pref_ch_cb, void *pref_ch_cb_cls);
+GAS_normalization_start (void);
 
-void
-GAS_normalization_stop ();
 
+/**
+ * Stop the normalization component and free all items
+ */
+void
+GAS_normalization_stop (void);
 
+#endif
 /* end of gnunet-service-ats_normalization.h */