complete reservations API

diff --git a/src/ats/gnunet-service-ats.c b/src/ats/gnunet-service-ats.c
index 10972190fc0812a81cd700bb8c3fa4fdb1774ea5..14bb963b91543592ce082b731d455b7b5edfc328 100644 (file)
--- a/src/ats/gnunet-service-ats.c
+++ b/src/ats/gnunet-service-ats.c
@@ -27,9 +27,10 @@
 #include "platform.h"
 #include "gnunet_util_lib.h"
 #include "gnunet_ats_service.h"
+#include "gnunet-service-ats_addresses.h"
 #include "gnunet-service-ats_performance.h"
 #include "gnunet-service-ats_scheduling.h"
-#include "gnunet-service-ats_addresses.h"
+#include "gnunet-service-ats_reservations.h"
 #include "ats.h"
 
 
@@ -97,6 +98,8 @@ cleanup_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 {
   GAS_addresses_done ();
   GAS_scheduling_done ();
+  GAS_performance_done ();
+  GAS_reservations_done ();
 }
 
 
@@ -126,6 +129,8 @@ run (void *cls, struct GNUNET_SERVER_Handle *server,
       GNUNET_MESSAGE_TYPE_ATS_PREFERENCE_CHANGE, 0},
     {NULL, NULL, 0, 0}
   };
+  GAS_reservations_init ();
+  GAS_performance_init (server);
   GAS_scheduling_init (server);
   GAS_addresses_init ();
   GNUNET_SERVER_disconnect_notify (server, 

diff --git a/src/ats/gnunet-service-ats_reservations.c b/src/ats/gnunet-service-ats_reservations.c
index 3356aefbd409b2e1c9e2ba02454c8a030d3aae84..8171b71f07a7e0ac0938427da7ade7fb5278cb31 100644 (file)
--- a/src/ats/gnunet-service-ats_reservations.c
+++ b/src/ats/gnunet-service-ats_reservations.c
@@ -27,6 +27,17 @@
 #include "gnunet-service-ats_reservations.h"
 
 
+/**
+ * Reserve the given amount of incoming bandwidth (in bytes) from the
+ * given peer.  If a reservation is not possible right now, return how
+ * long the client should wait before trying again.
+ *
+ * @param peer peer to reserve bandwidth from
+ * @param amount number of bytes to reserve
+ * @return 0 if the reservation was successful, FOREVER if the
+ *         peer is not connected, otherwise the time to wait
+ *         until the reservation might succeed
+ */
 struct GNUNET_TIME_Relative
 GAS_reservations_reserve (const struct GNUNET_PeerIdentity *peer,
                          int32_t amount)
@@ -36,4 +47,40 @@ GAS_reservations_reserve (const struct GNUNET_PeerIdentity *peer,
   return GNUNET_TIME_UNIT_ZERO;
 }
 
+
+/**
+ * Set the amount of bandwidth the other peer could currently transmit
+ * to us (as far as we know) to the given value.
+ * 
+ * @param peer identity of the peer
+ * @param bandwidth_in currently available bandwidth from that peer to
+ *        this peer (estimate)
+ */
+void
+GAS_reservations_set_bandwidth (const struct GNUNET_PeerIdentity *peer,
+                               struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in)
+{
+}
+
+
+
+/**
+ * Initialize reservations subsystem.
+ */
+void
+GAS_reservations_init ()
+{
+}
+
+
+/**
+ * Shutdown reservations subsystem.
+ */
+void
+GAS_reservations_done ()
+{
+}
+
+
+
 /* end of gnunet-service-ats_reservations.c */

diff --git a/src/ats/gnunet-service-ats_reservations.h b/src/ats/gnunet-service-ats_reservations.h
index 63b9a593699c29fc92214ddfe9baf0e6f6150738..5112f8213edc18466e2c7f69ec2398d8c955a46c 100644 (file)
--- a/src/ats/gnunet-service-ats_reservations.h
+++ b/src/ats/gnunet-service-ats_reservations.h
@@ -29,9 +29,46 @@
 #include "gnunet_util_lib.h"
 
 
+/**
+ * Set the amount of bandwidth the other peer could currently transmit
+ * to us (as far as we know) to the given value.
+ * 
+ * @param peer identity of the peer
+ * @param bandwidth_in currently available bandwidth from that peer to
+ *        this peer (estimate)
+ */
+void
+GAS_reservations_set_bandwidth (const struct GNUNET_PeerIdentity *peer,
+                               struct GNUNET_BANDWIDTH_Value32NBO bandwidth_in);
+
+
+/**
+ * Reserve the given amount of incoming bandwidth (in bytes) from the
+ * given peer.  If a reservation is not possible right now, return how
+ * long the client should wait before trying again.
+ *
+ * @param peer peer to reserve bandwidth from
+ * @param amount number of bytes to reserve
+ * @return 0 if the reservation was successful, FOREVER if the
+ *         peer is not connected, otherwise the time to wait
+ *         until the reservation might succeed
+ */
 struct GNUNET_TIME_Relative
 GAS_reservations_reserve (const struct GNUNET_PeerIdentity *peer,
                          int32_t amount);
 
 
+/**
+ * Initialize reservations subsystem.
+ */
+void
+GAS_reservations_init (void);
+
+
+/**
+ * Shutdown reservations subsystem.
+ */
+void
+GAS_reservations_done (void);
+
 #endif