examples/msg/kademlia/node.h

   1 /* Copyright (c) 2012, 2014-2015. 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
  14 #include "answer.h"
  15 #include "routing_table.h"
  16 /**
  17   * Information about a foreign node
  18   */
  19 typedef struct s_node_contact {
  20   unsigned int id;              //The node identifier
  21   unsigned int distance;        //The distance from the node
  22 } s_node_contact_t, *node_contact_t;
  23
  24 /*
  25  * Node data
  26  */
  27 typedef struct s_node {
  28   unsigned int id;              //node id - 160 bits
  29   routing_table_t table;        //node routing table
  30   msg_comm_t receive_comm;      //current receiving communication.
  31   msg_task_t task_received;     //current task being received
  32
  33   char mailbox[MAILBOX_NAME_SIZE+1];      //node mailbox
  34   unsigned int find_node_success;       //Number of find_node which have succeeded.
  35   unsigned int find_node_failed;        //Number of find_node which have failed.
  36
  37 } 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
  43 void node_routing_table_update(node_t node, unsigned int id);
  44 answer_t node_find_closest(node_t node, unsigned int destination_id);
  45
  46
  47 // identifier functions
  48 unsigned int get_id_in_prefix(unsigned int id, unsigned int prefix);
  49 unsigned int get_node_prefix(unsigned int id, unsigned int nb_bits);
  50 void get_node_mailbox(unsigned int id, char *mailbox);
  51
  52 // node contact functions
  53 node_contact_t node_contact_new(unsigned int id, unsigned int distance);
  54 node_contact_t node_contact_copy(node_contact_t node_contact);
  55 void node_contact_free(node_contact_t contact);
  56 #endif                          /* _MSG_EXAMPLES_ROUTING_H */