-only trigger check config if we actually need it
[oweals/gnunet.git] / src / ats / gnunet-service-ats_normalization.h
index ab37da796900fa75ba01f8a150c9b402b1043126..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) (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 (struct GNUNET_PeerIdentity *id);
+void
+GAS_normalization_update_property (struct ATS_Address *address);
+
 
 /**
- * Changes the preferences for a peer in the problem
- *
- * @param solver the solver handle
- * @param client the client with this preference
- * @param peer the peer to change the preference for
- * @param kind the kind to change the preference
- * @param score 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);
+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 */