examples/msg/dht-kademlia/node.h

   1 /* Copyright (c) 2012, 2014-2016. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   4 /* This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the license (GNU LGPL) which comes with this package. */
   6
   7 #ifndef _MSG_EXAMPLES_ROUTING_H
   8 #define _MSG_EXAMPLES_ROUTING_H
   9 #include "xbt/dynar.h"
  10 #include "simgrid/msg.h"
  11
  12 #include "common.h"
  13 #include "answer.h"
  14 #include "routing_table.h"
  15
  16 /* Information about a foreign node */
  17 typedef struct s_node_contact {
  18   unsigned int id;              //The node identifier
  19   unsigned int distance;        //The distance from the node
  20 } s_node_contact_t;
  21
  22 typedef s_node_contact_t *node_contact_t;
  23
  24 /* Node data */
  25 typedef struct s_node {
  26   unsigned int id;              //node id - 160 bits
  27   routing_table_t table;        //node routing table
  28   msg_comm_t receive_comm;      //current receiving communication.
  29   msg_task_t task_received;     //current task being received
  30
  31   char mailbox[MAILBOX_NAME_SIZE];      //node mailbox
  32   unsigned int find_node_success;       //Number of find_node which have succeeded.
  33   unsigned int find_node_failed;        //Number of find_node which have failed.
  34
  35 } s_node_t;
  36
  37 typedef s_node_t *node_t;
  38
  39 // node functions
  40 node_t node_init(unsigned int id);
  41 void node_free(node_t node);
  42 void node_routing_table_update(node_t node, unsigned int id);
  43 answer_t node_find_closest(node_t node, unsigned int destination_id);
  44
  45 // identifier functions
  46 unsigned int get_id_in_prefix(unsigned int id, unsigned int prefix);
  47 unsigned int get_node_prefix(unsigned int id, unsigned int nb_bits);
  48 void get_node_mailbox(unsigned int id, char *mailbox);
  49
  50 // node contact functions
  51 node_contact_t node_contact_new(unsigned int id, unsigned int distance);
  52 node_contact_t node_contact_copy(node_contact_t node_contact);
  53 void node_contact_free(node_contact_t contact);
  54 #endif                          /* _MSG_EXAMPLES_ROUTING_H */