Adding a function pick_random_friend ()
[oweals/gnunet.git] / src / dht / gnunet-service-xdht_routing.h
index 9f54d2596687cb16fcf64e25fd8e5e59d29826dc..5292ec2ce9ac2773a4d944eb0ae041ef4280dbc6 100644 (file)
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     (C) 2011 - 2014 Christian Grothoff (and other contributing authors)
+     Copyright (C) 2011 - 2014 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
@@ -52,6 +52,19 @@ int
 GDS_ROUTING_update_trail_prev_hop (struct GNUNET_HashCode trail_id,
                                    struct GNUNET_PeerIdentity prev_hop);
 
+
+/**
+ * Update the next hop of the trail. Call made by trail compression where
+ * if you are source of the trail and now you have a new first friend, then
+ * you should update the trail. 
+ * @param trail_id
+ * @return #GNUNET_OK success
+ *         #GNUNET_SYSERR in case no matching entry found in routing table.
+ */
+int
+GDS_ROUTING_update_trail_next_hop (const struct GNUNET_HashCode trail_id,
+                                   struct GNUNET_PeerIdentity next_hop);
+
 /**
  * Get the next hop for trail corresponding to trail_id
  * @param trail_id Trail id to be searched. 
@@ -67,7 +80,7 @@ GDS_ROUTING_get_next_hop (struct GNUNET_HashCode trail_id,
   * Remove every trail where peer is either next_hop or prev_hop 
  * @param peer Peer to be searched.
  */
-void
+int
 GDS_ROUTING_remove_trail_by_peer (const struct GNUNET_PeerIdentity *peer);
 /**
  * Remove trail with trail_id
@@ -109,6 +122,7 @@ GDS_ROUTING_threshold_reached (void);
 void 
 GDS_ROUTING_test_print (void);
 #endif
+
 /**
  * Initialize routing subsystem.
  */
@@ -120,4 +134,5 @@ GDS_ROUTING_init (void);
  */
 void
 GDS_ROUTING_done (void);
+
 #endif
\ No newline at end of file