examples/c/dht-pastry/dht-pastry.c

   1 /* Copyright (c) 2013-2020. The SimGrid Team. All rights reserved.          */
   2
   3 /* This program is free software; you can redistribute it and/or modify it
   4  * under the terms of the license (GNU LGPL) which comes with this package. */
   5
   6 #include "simgrid/actor.h"
   7 #include "simgrid/comm.h"
   8 #include "simgrid/engine.h"
   9 #include "simgrid/mailbox.h"
  10
  11 #include "xbt/dynar.h"
  12 #include "xbt/log.h"
  13 #include "xbt/str.h"
  14 #include "xbt/sysdep.h"
  15
  16 #include <math.h>
  17 #include <stdio.h>
  18
  19 XBT_LOG_NEW_DEFAULT_CATEGORY(pastry, "Messages specific for this example");
  20
  21 #define COMM_SIZE 10
  22 #define COMP_SIZE 0
  23 #define MAILBOX_NAME_SIZE 10
  24
  25 #define DOMAIN_SIZE 4
  26 #define LEVELS_COUNT 8 // sizeof(int)*8/DOMAIN_SIZE
  27 #define LEVEL_SIZE 16  // 2^DOMAIN_SIZE
  28 #define NEIGHBORHOOD_SIZE 6
  29 #define NAMESPACE_SIZE 6
  30 #define MAILBOX_NAME_SIZE 10
  31
  32 static int nb_bits             = 16;
  33 static int timeout             = 50;
  34 static int max_simulation_time = 1000;
  35
  36 typedef struct s_node {
  37   int id; // 128bits generated random(2^128 -1)
  38   int known_id;
  39   sg_mailbox_t mailbox;
  40   int namespace_set[NAMESPACE_SIZE];
  41   int neighborhood_set[NEIGHBORHOOD_SIZE];
  42   int routing_table[LEVELS_COUNT][LEVEL_SIZE];
  43   int ready;
  44   sg_comm_t comm_receive; // current communication to receive
  45   xbt_dynar_t pending_messages;
  46 } s_node_t;
  47 typedef s_node_t* node_t;
  48 typedef const s_node_t* const_node_t;
  49
  50 typedef struct s_state {
  51   int id;
  52   int namespace_set[NAMESPACE_SIZE];
  53   int neighborhood_set[NEIGHBORHOOD_SIZE];
  54   int routing_table[LEVELS_COUNT][LEVEL_SIZE];
  55 } s_state_t;
  56 typedef s_state_t* state_t;
  57
  58 /** Types of tasks exchanged between nodes. */
  59 typedef enum { JOIN, JOIN_REPLY, JOIN_LAST_REPLY, UPDATE } e_message_type_t;
  60
  61 typedef struct s_pastry_message {
  62   e_message_type_t type; // type of task
  63   int sender_id;         // id parameter (used by some types of tasks)
  64   // int request_finger;           // finger parameter (used by some types of tasks)
  65   int answer_id;          // answer (used by some types of tasks)
  66   sg_mailbox_t answer_to; // mailbox to send an answer to (if any)
  67   int steps;
  68   state_t state;
  69 } s_pastry_message_t;
  70 typedef s_pastry_message_t* pastry_message_t;
  71 typedef const s_pastry_message_t* const_pastry_message_t;
  72
  73 /** Get the mailbox of a host given its pastry id. */
  74 static sg_mailbox_t get_mailbox(int node_id)
  75 {
  76   char mailbox_name[MAILBOX_NAME_SIZE];
  77   snprintf(mailbox_name, MAILBOX_NAME_SIZE - 1, "%d", node_id);
  78   return sg_mailbox_by_name(mailbox_name);
  79 }
  80
  81 /** Get the specific level of a node id */
  82 unsigned int domain_mask = 0;
  83 static int domain(unsigned int a, unsigned int level)
  84 {
  85   if (domain_mask == 0)
  86     domain_mask = pow(2, DOMAIN_SIZE) - 1;
  87   unsigned int shift = (LEVELS_COUNT - level - 1) * DOMAIN_SIZE;
  88   return (a >> shift) & domain_mask;
  89 }
  90
  91 /* Get the shared domains between the two givens ids */
  92 static int shl(int a, int b)
  93 {
  94   int l = 0;
  95   while (l < LEVELS_COUNT && domain(a, l) == domain(b, l))
  96     l++;
  97   return l;
  98 }
  99
 100 /* Frees the memory used by a task and destroy it */
 101 static void message_free(pastry_message_t message)
 102 {
 103   if (message != NULL) {
 104     xbt_free(message->state);
 105     xbt_free(message);
 106   }
 107 }
 108
 109 /* Get the closest id to the dest in the node namespace_set */
 110 static int closest_in_namespace_set(const_node_t node, int dest)
 111 {
 112   int res = -1;
 113   if ((node->namespace_set[NAMESPACE_SIZE - 1] <= dest) && (dest <= node->namespace_set[0])) {
 114     int best_dist = abs(node->id - dest);
 115     res           = node->id;
 116     for (int i = 0; i < NAMESPACE_SIZE; i++) {
 117       if (node->namespace_set[i] != -1) {
 118         int dist = abs(node->namespace_set[i] - dest);
 119         if (dist < best_dist) {
 120           best_dist = dist;
 121           res       = node->namespace_set[i];
 122         }
 123       }
 124     }
 125   }
 126   return res;
 127 }
 128
 129 /* Find the next node to forward a message to */
 130 static int routing_next(const_node_t node, int dest)
 131 {
 132   int closest = closest_in_namespace_set(node, dest);
 133   if (closest != -1)
 134     return closest;
 135
 136   int l   = shl(node->id, dest);
 137   int res = node->routing_table[l][domain(dest, l)];
 138   if (res != -1)
 139     return res;
 140
 141   // rare case
 142   int dist = abs(node->id - dest);
 143   for (int i = l; i < LEVELS_COUNT; i++) {
 144     for (int j = 0; j < LEVEL_SIZE; j++) {
 145       res = node->routing_table[i][j];
 146       if (res != -1 && abs(res - dest) < dist)
 147         return res;
 148     }
 149   }
 150
 151   for (int i = 0; i < NEIGHBORHOOD_SIZE; i++) {
 152     res = node->neighborhood_set[i];
 153     if (res != -1 && shl(res, dest) >= l && abs(res - dest) < dist)
 154       return res;
 155   }
 156
 157   for (int i = 0; i < NAMESPACE_SIZE; i++) {
 158     res = node->namespace_set[i];
 159     if (res != -1 && shl(res, dest) >= l && abs(res - dest) < dist)
 160       return res;
 161   }
 162
 163   return node->id;
 164 }
 165
 166 /* Get the corresponding state of a node */
 167 static state_t node_get_state(const_node_t node)
 168 {
 169   state_t state = xbt_new0(s_state_t, 1);
 170   state->id     = node->id;
 171   for (int i = 0; i < NEIGHBORHOOD_SIZE; i++)
 172     state->neighborhood_set[i] = node->neighborhood_set[i];
 173
 174   for (int i = 0; i < LEVELS_COUNT; i++)
 175     for (int j = 0; j < LEVEL_SIZE; j++)
 176       state->routing_table[i][j] = node->routing_table[i][j];
 177
 178   for (int i = 0; i < NAMESPACE_SIZE; i++)
 179     state->namespace_set[i] = node->namespace_set[i];
 180
 181   return state;
 182 }
 183
 184 static void print_node_id(const_node_t node)
 185 {
 186   XBT_INFO(" Id: %i '%08x' ", node->id, (unsigned)node->id);
 187 }
 188
 189 /* Print the node namespace set */
 190 static void print_node_namespace_set(const_node_t node)
 191 {
 192   XBT_INFO(" Namespace:");
 193   for (int i = 0; i < NAMESPACE_SIZE; i++)
 194     XBT_INFO("  %08x", (unsigned)node->namespace_set[i]);
 195 }
 196
 197 /** Handle a given task */
 198 static void handle_message(node_t node, pastry_message_t message)
 199 {
 200   XBT_DEBUG("Handling task %p", message);
 201   int i;
 202   int j;
 203   int min;
 204   int max;
 205   int next;
 206   sg_mailbox_t mailbox;
 207   sg_comm_t comm = NULL;
 208   sg_error_t err = SG_OK;
 209   pastry_message_t request;
 210   e_message_type_t type = message->type;
 211
 212   // If the node is not ready keep the task for later
 213   if (node->ready != 0 && !(type == JOIN_LAST_REPLY || type == JOIN_REPLY)) {
 214     XBT_DEBUG("Task pending %u", type);
 215     xbt_dynar_push(node->pending_messages, &message);
 216     return;
 217   }
 218
 219   switch (type) {
 220     /* Try to join the ring */
 221     case JOIN:
 222       next = routing_next(node, message->answer_id);
 223       XBT_DEBUG("Join request from %08x forwarding to %08x", (unsigned)message->answer_id, (unsigned)next);
 224       type = JOIN_LAST_REPLY;
 225
 226       request            = xbt_new0(s_pastry_message_t, 1);
 227       request->answer_id = message->sender_id;
 228       request->steps     = message->steps + 1;
 229
 230       // if next different from current node forward the join
 231       if (next != node->id) {
 232         mailbox            = get_mailbox(next);
 233         message->sender_id = node->id;
 234         message->steps++;
 235         comm = sg_mailbox_put_async(mailbox, message, COMM_SIZE);
 236         err  = sg_comm_wait_for(comm, timeout);
 237         if (err == SG_ERROR_TIMEOUT) {
 238           XBT_DEBUG("Timeout expired when forwarding join to next %d", next);
 239           break;
 240         }
 241         type = JOIN_REPLY;
 242       }
 243
 244       // send back the current node state to the joining node
 245       request->type      = type;
 246       request->sender_id = node->id;
 247       request->answer_to = get_mailbox(node->id);
 248       request->state     = node_get_state(node);
 249       comm               = sg_mailbox_put_async(message->answer_to, request, COMM_SIZE);
 250       err                = sg_comm_wait_for(comm, timeout);
 251       if (err == SG_ERROR_TIMEOUT) {
 252         XBT_DEBUG("Timeout expired when sending back the current node state to the joining node to %d", node->id);
 253       }
 254       break;
 255     /* Join reply from all the node touched by the join  */
 256     case JOIN_LAST_REPLY:
 257       // if last node touched reply, copy its namespace set
 258       // TODO: it works only if the two nodes are side to side (is it really the case ?)
 259       j = (message->sender_id < node->id) ? -1 : 0;
 260       for (i = 0; i < NAMESPACE_SIZE / 2; i++) {
 261         node->namespace_set[i]                      = message->state->namespace_set[i - j];
 262         node->namespace_set[NAMESPACE_SIZE - 1 - i] = message->state->namespace_set[NAMESPACE_SIZE - 1 - i - j - 1];
 263       }
 264       node->namespace_set[NAMESPACE_SIZE / 2 + j] = message->sender_id;
 265       node->ready += message->steps + 1;
 266       /* no break */
 267     case JOIN_REPLY:
 268       XBT_DEBUG("Joining Reply");
 269
 270       // if first node touched reply, copy its neighborhood set
 271       if (message->sender_id == node->known_id) {
 272         node->neighborhood_set[0] = message->sender_id;
 273         for (i = 1; i < NEIGHBORHOOD_SIZE; i++)
 274           node->neighborhood_set[i] = message->state->neighborhood_set[i - 1];
 275       }
 276
 277       // copy the corresponding routing table levels
 278       min = (node->id == message->answer_id) ? 0 : shl(node->id, message->answer_id);
 279       max = shl(node->id, message->sender_id) + 1;
 280       for (i = min; i < max; i++) {
 281         int d = domain(node->id, i);
 282         for (j = 0; j < LEVEL_SIZE; j++)
 283           if (d != j)
 284             node->routing_table[i][j] = message->state->routing_table[i][j];
 285       }
 286
 287       node->ready--;
 288       // if the node is ready, do all the pending tasks and send update to known nodes
 289       if (node->ready == 0) {
 290         XBT_DEBUG("Node %i is ready!!!", node->id);
 291         while (!xbt_dynar_is_empty(node->pending_messages)) {
 292           pastry_message_t m;
 293           xbt_dynar_shift(node->pending_messages, &m);
 294           handle_message(node, m);
 295         }
 296
 297         for (i = 0; i < NAMESPACE_SIZE; i++) {
 298           j = node->namespace_set[i];
 299           if (j != -1) {
 300             XBT_DEBUG("Send update to %i", j);
 301             mailbox = get_mailbox(j);
 302
 303             request            = xbt_new0(s_pastry_message_t, 1);
 304             request->answer_id = node->id;
 305             request->steps     = 0;
 306             request->type      = UPDATE;
 307             request->sender_id = node->id;
 308             request->answer_to = get_mailbox(node->id);
 309             request->state     = node_get_state(node);
 310             comm               = sg_mailbox_put_async(mailbox, request, COMM_SIZE);
 311             err                = sg_comm_wait_for(comm, timeout);
 312             if (err == SG_ERROR_TIMEOUT) {
 313               XBT_DEBUG("Timeout expired when sending update to %d", j);
 314               break;
 315             }
 316           }
 317         }
 318       }
 319       break;
 320     /* Received an update of state */
 321     case UPDATE:
 322       XBT_DEBUG("Task update %i !!!", node->id);
 323
 324       /* Update namespace ses */
 325       XBT_INFO("Task update from %i !!!", message->sender_id);
 326       XBT_INFO("Node:");
 327       print_node_id(node);
 328       print_node_namespace_set(node);
 329       int curr_namespace_set[NAMESPACE_SIZE];
 330       int task_namespace_set[NAMESPACE_SIZE + 1];
 331
 332       // Copy the current namespace and the task state namespace with state->id in the middle
 333       i = 0;
 334       for (; i < NAMESPACE_SIZE / 2; i++) {
 335         curr_namespace_set[i] = node->namespace_set[i];
 336         task_namespace_set[i] = message->state->namespace_set[i];
 337       }
 338       task_namespace_set[i] = message->state->id;
 339       for (; i < NAMESPACE_SIZE; i++) {
 340         curr_namespace_set[i]     = node->namespace_set[i];
 341         task_namespace_set[i + 1] = message->state->namespace_set[i];
 342       }
 343
 344       // get the index of values before and after node->id in task_namespace
 345       min = -1;
 346       max = -1;
 347       for (i = 0; i <= NAMESPACE_SIZE; i++) {
 348         j = task_namespace_set[i];
 349         if (j != -1 && j < node->id)
 350           min = i;
 351         if (j != -1 && max == -1 && j > node->id)
 352           max = i;
 353       }
 354
 355       // add lower elements
 356       j = NAMESPACE_SIZE / 2 - 1;
 357       for (i = NAMESPACE_SIZE / 2 - 1; i >= 0; i--) {
 358         if (min < 0 || curr_namespace_set[j] > task_namespace_set[min]) {
 359           node->namespace_set[i] = curr_namespace_set[j];
 360           j--;
 361         } else if (curr_namespace_set[j] == task_namespace_set[min]) {
 362           node->namespace_set[i] = curr_namespace_set[j];
 363           j--;
 364           min--;
 365         } else {
 366           node->namespace_set[i] = task_namespace_set[min];
 367           min--;
 368         }
 369       }
 370
 371       // add greater elements
 372       j = NAMESPACE_SIZE / 2;
 373       for (i = NAMESPACE_SIZE / 2; i < NAMESPACE_SIZE; i++) {
 374         if (min < 0 || max >= NAMESPACE_SIZE) {
 375           node->namespace_set[i] = curr_namespace_set[j];
 376           j++;
 377         } else if (max >= 0) {
 378           if (curr_namespace_set[j] == -1 || curr_namespace_set[j] > task_namespace_set[max]) {
 379             node->namespace_set[i] = task_namespace_set[max];
 380             max++;
 381           } else if (curr_namespace_set[j] == task_namespace_set[max]) {
 382             node->namespace_set[i] = curr_namespace_set[j];
 383             j++;
 384             max++;
 385           } else {
 386             node->namespace_set[i] = curr_namespace_set[j];
 387             j++;
 388           }
 389         }
 390       }
 391
 392       /* Update routing table */
 393       for (i = shl(node->id, message->state->id); i < LEVELS_COUNT; i++) {
 394         for (j = 0; j < LEVEL_SIZE; j++) {
 395           if (node->routing_table[i][j] == -1 && message->state->routing_table[i][j] == -1)
 396             node->routing_table[i][j] = message->state->routing_table[i][j];
 397         }
 398       }
 399       break;
 400     default:
 401       THROW_IMPOSSIBLE;
 402   }
 403   message_free(message);
 404 }
 405
 406 /* Join the ring */
 407 static int join(const_node_t node)
 408 {
 409   pastry_message_t request = xbt_new0(s_pastry_message_t, 1);
 410   request->type            = JOIN;
 411   request->sender_id       = node->id;
 412   request->answer_id       = node->id;
 413   request->steps           = 0;
 414   request->answer_to       = get_mailbox(node->id);
 415
 416   sg_mailbox_t mailbox = get_mailbox(node->known_id);
 417
 418   XBT_DEBUG("Trying to join Pastry ring... (with node %s)", sg_mailbox_get_name(mailbox));
 419   sg_comm_t comm = sg_mailbox_put_async(mailbox, request, COMM_SIZE);
 420   sg_error_t err = sg_comm_wait_for(comm, timeout);
 421   if (err == SG_ERROR_TIMEOUT) {
 422     XBT_DEBUG("Timeout expired when joining ring with node %d", node->known_id);
 423     message_free(request);
 424   }
 425
 426   return 1;
 427 }
 428
 429 /**
 430  * @brief Node Function
 431  * Arguments:
 432  * - my id
 433  * - the id of a guy I know in the system (except for the first node)
 434  * - the time to sleep before I join (except for the first node)
 435  * - the deadline time
 436  */
 437 static void node(int argc, char* argv[])
 438 {
 439   double init_time = simgrid_get_clock();
 440   void* received   = NULL;
 441   int join_success = 0;
 442   double deadline;
 443   xbt_assert(argc == 3 || argc == 5, "Wrong number of arguments for this node");
 444   s_node_t node         = {0};
 445   node.id               = xbt_str_parse_int(argv[1], "Invalid ID: %s");
 446   node.known_id         = -1;
 447   node.ready            = -1;
 448   node.pending_messages = xbt_dynar_new(sizeof(pastry_message_t), NULL);
 449   node.mailbox          = get_mailbox(node.id);
 450
 451   XBT_DEBUG("New node with id %s (%08x)", sg_mailbox_get_name(node.mailbox), (unsigned)node.id);
 452
 453   for (int i = 0; i < LEVELS_COUNT; i++) {
 454     int d = domain(node.id, i);
 455     for (int j = 0; j < LEVEL_SIZE; j++)
 456       node.routing_table[i][j] = (d == j) ? node.id : -1;
 457   }
 458
 459   for (int i = 0; i < NEIGHBORHOOD_SIZE; i++)
 460     node.neighborhood_set[i] = -1;
 461
 462   for (int i = 0; i < NAMESPACE_SIZE; i++)
 463     node.namespace_set[i] = -1;
 464
 465   if (argc == 3) { // first ring
 466     XBT_DEBUG("Hey! Let's create the system.");
 467     deadline   = xbt_str_parse_double(argv[2], "Invalid deadline: %s");
 468     node.ready = 0;
 469     XBT_DEBUG("Create a new Pastry ring...");
 470     join_success = 1;
 471   } else {
 472     node.known_id     = xbt_str_parse_int(argv[2], "Invalid known ID: %s");
 473     double sleep_time = xbt_str_parse_double(argv[3], "Invalid sleep time: %s");
 474     deadline          = xbt_str_parse_double(argv[4], "Invalid deadline: %s");
 475
 476     // sleep before starting
 477     XBT_DEBUG("Let's sleep during %f", sleep_time);
 478     sg_actor_sleep_for(sleep_time);
 479     XBT_DEBUG("Hey! Let's join the system.");
 480
 481     join_success = join(&node);
 482   }
 483
 484   if (join_success) {
 485     XBT_DEBUG("Waiting ….");
 486
 487     while (simgrid_get_clock() < init_time + deadline && simgrid_get_clock() < max_simulation_time) {
 488       if (node.comm_receive == NULL) {
 489         received          = NULL;
 490         node.comm_receive = sg_mailbox_get_async(node.mailbox, &received);
 491       }
 492       if (!sg_comm_test(node.comm_receive)) {
 493         sg_actor_sleep_for(5);
 494       } else {
 495         // the task was successfully received
 496         handle_message(&node, received);
 497         node.comm_receive = NULL;
 498       }
 499     }
 500     // Cleanup the receiving communication.
 501     if (node.comm_receive != NULL)
 502       sg_comm_unref(node.comm_receive);
 503   }
 504   xbt_dynar_free(&node.pending_messages);
 505 }
 506
 507 /** @brief Main function. */
 508 int main(int argc, char* argv[])
 509 {
 510   simgrid_init(&argc, argv);
 511   xbt_assert(argc > 2,
 512              "Usage: %s [-nb_bits=n] [-timeout=t] platform_file deployment_file\n"
 513              "\tExample: %s ../msg_platform.xml pastry10.xml\n",
 514              argv[0], argv[0]);
 515
 516   char** options = &argv[1];
 517   while (!strncmp(options[0], "-", 1)) {
 518     int length = strlen("-nb_bits=");
 519     if (!strncmp(options[0], "-nb_bits=", length) && strlen(options[0]) > length) {
 520       nb_bits = xbt_str_parse_int(options[0] + length, "Invalid nb_bits parameter: %s");
 521       XBT_DEBUG("Set nb_bits to %d", nb_bits);
 522     } else {
 523       length = strlen("-timeout=");
 524       if (!strncmp(options[0], "-timeout=", length) && strlen(options[0]) > length) {
 525         timeout = xbt_str_parse_int(options[0] + length, "Invalid timeout parameter: %s");
 526         XBT_DEBUG("Set timeout to %d", timeout);
 527       } else {
 528         xbt_die("Invalid pastry option '%s'", options[0]);
 529       }
 530     }
 531     options++;
 532   }
 533
 534   simgrid_load_platform(options[0]);
 535
 536   simgrid_register_function("node", node);
 537   simgrid_load_deployment(options[1]);
 538
 539   simgrid_run();
 540   XBT_INFO("Simulated time: %g", simgrid_get_clock());
 541
 542   return 0;
 543 }