remove protocol violation
[oweals/gnunet.git] / src / dht / gnunet-service-xdht_routing.c
index 3af1e6ea881ea786828faa076e7de19ab2bf76e3..9df6a04ec15943d39b8f79ee305964a22d121b44 100644 (file)
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     (C) 2011 Christian Grothoff (and other contributing authors)
+     (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
 /**
  * @file dht/gnunet-service-xdht_routing.c
  * @brief GNUnet DHT tracking of requests for routing replies
- * @author Christian Grothoff
+ * @author Supriti Singh
  */
 #include "platform.h"
-#include "gnunet-service-dht_neighbours.h"
-#include "gnunet-service-dht_routing.h"
-#include "gnunet-service-dht.h"
-
+#include "gnunet-service-xdht_neighbours.h"
+#include "gnunet-service-xdht_routing.h"
+#include "gnunet-service-xdht.h"
 
 /**
- * Number of requests we track at most (for routing replies).
+ * Maximum number of entries in routing table.
  */
-#define DHT_MAX_RECENT (1024 * 16)
+#define ROUTING_TABLE_THRESHOLD 64
 
 
 /**
- * Information we keep about all recent GET requests
- * so that we can route replies.
+ * FIXME: do we need to store destination and source.
+ * because in trail teardown we will reach destination but it will not find any
+ * entry in routing table. so we should store destination and source.
+ * Routing table entry .
  */
-struct RecentRequest
+struct RoutingTrail
 {
-
-  /**
-   * The peer this request was received from.
-   */
-  struct GNUNET_PeerIdentity peer;
-
-  /**
-   * Key of this request.
-   */
-  struct GNUNET_HashCode key;
-
-  /**
-   * Position of this node in the min heap.
-   */
-  struct GNUNET_CONTAINER_HeapNode *heap_node;
-
-  /**
-   * Bloomfilter for replies to drop.
-   */
-  struct GNUNET_CONTAINER_BloomFilter *reply_bf;
-
-  /**
-   * Type of the requested block.
-   */
-  enum GNUNET_BLOCK_Type type;
-
-  /**
-   * extended query (see gnunet_block_lib.h).  Allocated at the
-   * end of this struct.
-   */
-  const void *xquery;
-
   /**
-   * Number of bytes in xquery.
+   * Global Unique identifier of the trail.
    */
-  size_t xquery_size;
+  struct GNUNET_HashCode trail_id;
 
   /**
-   * Mutator value for the reply_bf, see gnunet_block_lib.h
+   * The peer to which this request should be passed to.
    */
-  uint32_t reply_bf_mutator;
+  struct GNUNET_PeerIdentity next_hop; // change to struct FriendInfo *
 
   /**
-   * Request options.
+   * Peer just before next hop in the trail.
    */
-  enum GNUNET_DHT_RouteOption options;
-
+  struct GNUNET_PeerIdentity prev_hop;  // change to struct FriendInfo *
 };
 
-
-/**
- * Recent requests by time inserted.
- */
-static struct GNUNET_CONTAINER_Heap *recent_heap;
-
 /**
- * Recently seen requests by key.
+ * Routing table of the peer
  */
-static struct GNUNET_CONTAINER_MultiHashMap *recent_map;
-
+static struct GNUNET_CONTAINER_MultiHashMap *routing_table;
 
 /**
- * Closure for the 'process' function.
+ * Update the prev. hop of the trail. Call made by trail teardown where
+ * if you are the first friend now in the trail then you need to update
+ * your prev. hop.
+ * @param trail_id
+ * @return #GNUNET_OK success
+ *         #GNUNET_SYSERR in case no matching entry found in routing table.
  */
-struct ProcessContext
+int
+GDS_ROUTING_update_trail_prev_hop (const struct GNUNET_HashCode trail_id,
+                                   struct GNUNET_PeerIdentity prev_hop)
 {
-  /**
-   * Path of the original PUT
-   */
-  const struct GNUNET_PeerIdentity *put_path;
+  struct RoutingTrail *trail;
 
-  /**
-   * Path of the reply.
-   */
-  const struct GNUNET_PeerIdentity *get_path;
+  trail = GNUNET_CONTAINER_multihashmap_get (routing_table, &trail_id);
 
-  /**
-   * Payload of the reply.
-   */
-  const void *data;
+  if (NULL == trail)
+    return GNUNET_SYSERR;
 
-  /**
-   * Expiration time of the result.
-   */
-  struct GNUNET_TIME_Absolute expiration_time;
+  trail->prev_hop = prev_hop;
+  return GNUNET_OK;
+}
 
-  /**
-   * Number of entries in 'put_path'.
-   */
-  unsigned int put_path_length;
 
-  /**
-   * Number of entries in 'get_path'.
-   */
-  unsigned int get_path_length;
+/**
+ * Get the next hop for trail corresponding to trail_id
+ * @param trail_id Trail id to be searched.
+ * @return Next_hop if found
+ *         NULL If next hop not found.
+ */
+struct GNUNET_PeerIdentity *
+GDS_ROUTING_get_next_hop (const struct GNUNET_HashCode trail_id,
+                          enum GDS_ROUTING_trail_direction trail_direction)
+{
+  struct RoutingTrail *trail;
 
-  /**
-   * Number of bytes in 'data'.
-   */
-  size_t data_size;
+  trail = GNUNET_CONTAINER_multihashmap_get (routing_table, &trail_id);
 
-  /**
-   * Type of the reply.
-   */
-  enum GNUNET_BLOCK_Type type;
+  if (NULL == trail)
+    return NULL;
 
-};
+  switch (trail_direction)
+  {
+    case GDS_ROUTING_SRC_TO_DEST:
+      return &(trail->next_hop);
+    case GDS_ROUTING_DEST_TO_SRC:
+      return &(trail->prev_hop);
+  }
+  return NULL;
+}
 
 
 /**
- * Forward the result to the given peer if it matches the request.
- *
- * @param cls the `struct ProcessContext` with the result
- * @param key the query
- * @param value the `struct RecentRequest` with the request
- * @return #GNUNET_OK (continue to iterate),
- *         #GNUNET_SYSERR if the result is malformed or type unsupported
+ * Remove trail with trail_id
+ * @param trail_id Trail id to be removed
+ * @return #GNUNET_YES success
+ *         #GNUNET_NO if entry not found.
  */
-static int
-process (void *cls, const struct GNUNET_HashCode * key, void *value)
+int
+GDS_ROUTING_remove_trail (const struct GNUNET_HashCode remove_trail_id)
 {
-  struct ProcessContext *pc = cls;
-  struct RecentRequest *rr = value;
-  enum GNUNET_BLOCK_EvaluationResult eval;
-  unsigned int gpl;
-  unsigned int ppl;
-  struct GNUNET_HashCode hc;
-  const struct GNUNET_HashCode *eval_key;
-
-  if ((rr->type != GNUNET_BLOCK_TYPE_ANY) && (rr->type != pc->type))
-    return GNUNET_OK;           /* type missmatch */
-
-  if (0 != (rr->options & GNUNET_DHT_RO_RECORD_ROUTE))
-  {
-    gpl = pc->get_path_length;
-    ppl = pc->put_path_length;
-  }
-  else
-  {
-    gpl = 0;
-    ppl = 0;
-  }
-  if ((0 != (rr->options & GNUNET_DHT_RO_FIND_PEER)) &&
-      (pc->type == GNUNET_BLOCK_TYPE_DHT_HELLO))
-  {
-    /* key may not match HELLO, which is OK since
-     * the search is approximate.  Still, the evaluation
-     * would fail since the match is not exact.  So
-     * we fake it by changing the key to the actual PID ... */
-    GNUNET_BLOCK_get_key (GDS_block_context, GNUNET_BLOCK_TYPE_DHT_HELLO,
-                          pc->data, pc->data_size, &hc);
-    eval_key = &hc;
-  }
-  else
-  {
-    eval_key = key;
-  }
-  eval =
-      GNUNET_BLOCK_evaluate (GDS_block_context, pc->type, eval_key,
-                             &rr->reply_bf, rr->reply_bf_mutator, rr->xquery,
-                             rr->xquery_size, pc->data, pc->data_size);
-  switch (eval)
+  struct RoutingTrail *remove_entry;
+
+  remove_entry = GNUNET_CONTAINER_multihashmap_get (routing_table, &remove_trail_id);
+
+  if (NULL == remove_entry)
+    return GNUNET_NO;
+
+  if (GNUNET_YES == GNUNET_CONTAINER_multihashmap_remove (routing_table,
+                                                          &remove_trail_id,
+                                                          remove_entry))
   {
-  case GNUNET_BLOCK_EVALUATION_OK_MORE:
-  case GNUNET_BLOCK_EVALUATION_OK_LAST:
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# Good REPLIES matched against routing table"),
-                              1, GNUNET_NO);
-    GDS_NEIGHBOURS_handle_reply (&rr->peer, pc->type, pc->expiration_time, key,
-                                 ppl, pc->put_path, gpl, pc->get_path, pc->data,
-                                 pc->data_size);
-    break;
-  case GNUNET_BLOCK_EVALUATION_OK_DUPLICATE:
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# Duplicate REPLIES matched against routing table"),
-                              1, GNUNET_NO);
-    return GNUNET_OK;
-  case GNUNET_BLOCK_EVALUATION_RESULT_INVALID:
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# Invalid REPLIES matched against routing table"),
-                              1, GNUNET_NO);
-    return GNUNET_SYSERR;
-  case GNUNET_BLOCK_EVALUATION_RESULT_IRRELEVANT:
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# Irrelevant REPLIES matched against routing table"),
-                              1, GNUNET_NO);
-    return GNUNET_OK;
-  case GNUNET_BLOCK_EVALUATION_REQUEST_VALID:
-    GNUNET_break (0);
-    return GNUNET_OK;
-  case GNUNET_BLOCK_EVALUATION_REQUEST_INVALID:
-    GNUNET_break (0);
-    return GNUNET_OK;
-  case GNUNET_BLOCK_EVALUATION_TYPE_NOT_SUPPORTED:
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# Unsupported REPLIES matched against routing table"),
-                              1, GNUNET_NO);
-    return GNUNET_SYSERR;
-  default:
-    GNUNET_break (0);
-    return GNUNET_SYSERR;
+    GNUNET_free (remove_entry);
+    return GNUNET_YES;
   }
-  return GNUNET_OK;
+  return GNUNET_NO;
 }
 
 
 /**
- * Handle a reply (route to origin).  Only forwards the reply back to
- * other peers waiting for it.  Does not do local caching or
- * forwarding to local clients.  Essentially calls
- * GDS_NEIGHBOURS_handle_reply for all peers that sent us a matching
- * request recently.
- *
- * @param type type of the block
- * @param expiration_time when does the content expire
- * @param key key for the content
- * @param put_path_length number of entries in put_path
- * @param put_path peers the original PUT traversed (if tracked)
- * @param get_path_length number of entries in get_path
- * @param get_path peers this reply has traversed so far (if tracked)
- * @param data payload of the reply
- * @param data_size number of bytes in data
+ * Iterate over routing table and remove entries with value as part of any trail.
+ * @param cls closure
+ * @param key current public key
+ * @param value value in the hash map
+ * @return #GNUNET_YES if we should continue to iterate,
+ *         #GNUNET_NO if not.
  */
-void
-GDS_ROUTING_process (enum GNUNET_BLOCK_Type type,
-                     struct GNUNET_TIME_Absolute expiration_time,
-                     const struct GNUNET_HashCode * key, unsigned int put_path_length,
-                     const struct GNUNET_PeerIdentity *put_path,
-                     unsigned int get_path_length,
-                     const struct GNUNET_PeerIdentity *get_path,
-                     const void *data, size_t data_size)
+static int remove_matching_trails (void *cls,
+                                   const struct GNUNET_HashCode *key,
+                                   void *value)
 {
-  struct ProcessContext pc;
-
-  pc.type = type;
-  pc.expiration_time = expiration_time;
-  pc.put_path_length = put_path_length;
-  pc.put_path = put_path;
-  pc.get_path_length = get_path_length;
-  pc.get_path = get_path;
-  pc.data = data;
-  pc.data_size = data_size;
-  if (NULL == data)
+  struct RoutingTrail *remove_trail = cls;
+  struct GNUNET_PeerIdentity *peer = value;
+
+  if ((0 == GNUNET_CRYPTO_cmp_peer_identity (&remove_trail->next_hop, peer)) ||
+      (0 == GNUNET_CRYPTO_cmp_peer_identity (&remove_trail->prev_hop, peer)))
   {
-    /* Some apps might have an 'empty' reply as a valid reply; however,
-       'process' will call GNUNET_BLOCK_evaluate' which treats a 'NULL'
-       reply as request-validation (but we need response-validation).
-       So we set 'data' to a 0-byte non-NULL value just to be sure */
-    GNUNET_break (0 == data_size);
-    pc.data_size = 0;
-    pc.data = ""; /* something not null */
+    GNUNET_assert (GNUNET_YES ==
+                   GNUNET_CONTAINER_multihashmap_remove (routing_table,
+                                                         &remove_trail->trail_id,
+                                                         remove_trail));
+    GNUNET_free (remove_trail);
   }
-  GNUNET_CONTAINER_multihashmap_get_multiple (recent_map, key, &process, &pc);
+  return GNUNET_YES;
 }
 
 
 /**
- * Remove the oldest entry from the DHT routing table.  Must only
- * be called if it is known that there is at least one entry
- * in the heap and hashmap.
+ *  * FIXME: when a friend gets disconnected, then we remove the entry from routing
+ * table where this friend is either a next_hop or prev_hop. But we don't communicate
+ * that the trail is broken to any one who is part of trail. Should we communicate or
+ * not. And if not then the cases where trail setup fails because next_hop = NULL
+ * or something like that. VERY URGENT.
+ * Remove every trail where peer is either next_hop or prev_hop
+ * @param peer Peer to be searched.
  */
-static void
-expire_oldest_entry ()
+void
+GDS_ROUTING_remove_trail_by_peer (const struct GNUNET_PeerIdentity *peer)
 {
-  struct RecentRequest *recent_req;
-
-  GNUNET_STATISTICS_update (GDS_stats,
-                           gettext_noop
-                           ("# Entries removed from routing table"), 1,
-                           GNUNET_NO);
-  recent_req = GNUNET_CONTAINER_heap_peek (recent_heap);
-  GNUNET_assert (recent_req != NULL);
-  GNUNET_CONTAINER_heap_remove_node (recent_req->heap_node);
-  GNUNET_CONTAINER_bloomfilter_free (recent_req->reply_bf);
-  GNUNET_assert (GNUNET_YES ==
-                GNUNET_CONTAINER_multihashmap_remove (recent_map,
-                                                      &recent_req->key,
-                                                      recent_req));
-  GNUNET_free (recent_req);
+  GNUNET_CONTAINER_multihashmap_iterate (routing_table, &remove_matching_trails,
+                                           (void *)peer);
 }
 
 
 /**
- * Try to combine multiple recent requests for the same value
- * (if they come from the same peer).
- *
- * @param cls the new 'struct RecentRequest' (to discard upon successful combination)
- * @param key the query
- * @param value the existing 'struct RecentRequest' (to update upon successful combination)
- * @return GNUNET_OK (continue to iterate),
- *         GNUNET_SYSERR if the request was successfully combined
+ * Add a new entry in routing table
+ * @param new_trail_id
+ * @param prev_hop
+ * @param next_hop
+ * @return #GNUNET_OK success
+ *         #GNUNET_SYSERR in case new_trail_id already exists in the network
+ *                         but with different prev_hop/next_hop
  */
-static int
-try_combine_recent (void *cls, const struct GNUNET_HashCode * key, void *value)
+int
+GDS_ROUTING_add (struct GNUNET_HashCode new_trail_id,
+                 const struct GNUNET_PeerIdentity prev_hop,
+                 const struct GNUNET_PeerIdentity next_hop)
 {
-  struct RecentRequest *in = cls;
-  struct RecentRequest *rr = value;
-
-  if ( (0 != memcmp (&in->peer,
-                    &rr->peer,
-                    sizeof (struct GNUNET_PeerIdentity))) ||
-       (in->type != rr->type) ||
-       (in->xquery_size != rr->xquery_size) ||
-       (0 != memcmp (in->xquery,
-                    rr->xquery,
-                    in->xquery_size)) )
-    return GNUNET_OK;
-  if (in->reply_bf_mutator != rr->reply_bf_mutator)
-  {
-    rr->reply_bf_mutator = in->reply_bf_mutator;
-    GNUNET_CONTAINER_bloomfilter_free (rr->reply_bf);
-    rr->reply_bf = in->reply_bf;
-  }
-  else
-  {
-    GNUNET_CONTAINER_bloomfilter_or2 (rr->reply_bf,
-                                     in->reply_bf);
-    GNUNET_CONTAINER_bloomfilter_free (in->reply_bf);
-  }
-  GNUNET_free (in);
-  return GNUNET_SYSERR;
+  struct RoutingTrail *new_entry;
+
+  new_entry = GNUNET_malloc (sizeof (struct RoutingTrail));
+  new_entry->trail_id = new_trail_id;
+  new_entry->next_hop = next_hop;
+  new_entry->prev_hop = prev_hop;
+  return GNUNET_CONTAINER_multihashmap_put (routing_table,
+                                            &new_trail_id, new_entry,
+                                            GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY);
 }
 
 
 /**
- * Add a new entry to our routing table.
- *
- * @param sender peer that originated the request
- * @param type type of the block
- * @param options options for processing
- * @param key key for the content
- * @param xquery extended query
- * @param xquery_size number of bytes in @a xquery
- * @param reply_bf bloomfilter to filter duplicates
- * @param reply_bf_mutator mutator for @a reply_bf
+ * Check if the size of routing table has crossed threshold.
+ * @return #GNUNET_YES, if threshold crossed else #GNUNET_NO.
  */
-void
-GDS_ROUTING_add (const struct GNUNET_PeerIdentity *sender,
-                 enum GNUNET_BLOCK_Type type,
-                 enum GNUNET_DHT_RouteOption options,
-                 const struct GNUNET_HashCode * key, const void *xquery,
-                 size_t xquery_size,
-                 const struct GNUNET_CONTAINER_BloomFilter *reply_bf,
-                 uint32_t reply_bf_mutator)
+int
+GDS_ROUTING_threshold_reached (void)
 {
-  struct RecentRequest *recent_req;
-
-  while (GNUNET_CONTAINER_heap_get_size (recent_heap) >= DHT_MAX_RECENT)
-    expire_oldest_entry ();
-  GNUNET_STATISTICS_update (GDS_stats,
-                            gettext_noop ("# Entries added to routing table"),
-                            1, GNUNET_NO);
-  recent_req = GNUNET_malloc (sizeof (struct RecentRequest) + xquery_size);
-  recent_req->peer = *sender;
-  recent_req->key = *key;
-  recent_req->reply_bf = GNUNET_CONTAINER_bloomfilter_copy (reply_bf);
-  recent_req->type = type;
-  recent_req->options = options;
-  recent_req->xquery = &recent_req[1];
-  memcpy (&recent_req[1], xquery, xquery_size);
-  recent_req->xquery_size = xquery_size;
-  recent_req->reply_bf_mutator = reply_bf_mutator;
-  if (GNUNET_SYSERR ==
-      GNUNET_CONTAINER_multihashmap_get_multiple (recent_map, key,
-                                                 &try_combine_recent, recent_req))
-  {
-    GNUNET_STATISTICS_update (GDS_stats,
-                              gettext_noop
-                              ("# DHT requests combined"),
-                              1, GNUNET_NO);
-    return;
-  }
-  recent_req->heap_node =
-      GNUNET_CONTAINER_heap_insert (recent_heap, recent_req,
-                                    GNUNET_TIME_absolute_get ().abs_value_us);
-  GNUNET_CONTAINER_multihashmap_put (recent_map, key, recent_req,
-                                     GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE);
-
-
+  return (GNUNET_CONTAINER_multihashmap_size(routing_table) >
+          ROUTING_TABLE_THRESHOLD) ? GNUNET_YES:GNUNET_NO;
 }
 
 
@@ -432,10 +229,10 @@ GDS_ROUTING_add (const struct GNUNET_PeerIdentity *sender,
  * Initialize routing subsystem.
  */
 void
-GDS_ROUTING_init ()
+GDS_ROUTING_init (void)
 {
-  recent_heap = GNUNET_CONTAINER_heap_create (GNUNET_CONTAINER_HEAP_ORDER_MIN);
-  recent_map = GNUNET_CONTAINER_multihashmap_create (DHT_MAX_RECENT * 4 / 3, GNUNET_NO);
+  routing_table = GNUNET_CONTAINER_multihashmap_create (ROUTING_TABLE_THRESHOLD * 4 / 3,
+                                                        GNUNET_NO);
 }
 
 
@@ -443,16 +240,10 @@ GDS_ROUTING_init ()
  * Shutdown routing subsystem.
  */
 void
-GDS_ROUTING_done ()
+GDS_ROUTING_done (void)
 {
-  while (GNUNET_CONTAINER_heap_get_size (recent_heap) > 0)
-    expire_oldest_entry ();
-  GNUNET_assert (0 == GNUNET_CONTAINER_heap_get_size (recent_heap));
-  GNUNET_CONTAINER_heap_destroy (recent_heap);
-  recent_heap = NULL;
-  GNUNET_assert (0 == GNUNET_CONTAINER_multihashmap_size (recent_map));
-  GNUNET_CONTAINER_multihashmap_destroy (recent_map);
-  recent_map = NULL;
+  GNUNET_assert (0 == GNUNET_CONTAINER_multihashmap_size (routing_table));
+  GNUNET_CONTAINER_multihashmap_destroy (routing_table);
 }
 
-/* end of gnunet-service-dht_routing.c */
+/* end of gnunet-service-xdht_routing.c */