examples/s4u/comm-ready/s4u-comm-ready.cpp

   1 /* Copyright (c) 2010-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 /* This example shows how to use simgrid::s4u::Mailbox::ready() to check for completed communications.
   7  *
   8  * We have a number of peers which send and receive messages in two phases:
   9  * -> sending phase:   each one of them sends a number of messages to the others followed
  10  *                     by a single "finalize" message.
  11  * -> receiving phase: each one of them receives all the available messages that reached
  12  *                     their corresponding mailbox until it has all the needed "finalize"
  13  *                     messages to know that no more work needs to be done.
  14  *
  15  * To avoid doing a wait() over the ongoing communications, each peer makes use of the
  16  * simgrid::s4u::Mailbox::ready() method. If it returns true then a following get() will fetch the
  17  * message immediately, if not the peer will sleep for a fixed amount of time before checking again.
  18  *
  19  */
  20
  21 #include "simgrid/s4u.hpp"
  22 #include <cstdlib>
  23 #include <iostream>
  24 #include <string>
  25
  26 XBT_LOG_NEW_DEFAULT_CATEGORY(s4u_async_ready, "Messages specific for this s4u example");
  27
  28 static void peer(int argc, char** argv)
  29 {
  30   xbt_assert(argc == 5, "Expecting 4 parameters from the XML deployment file but got %d", argc);
  31   int my_id           = std::stoi(argv[1]); /* - my id */
  32   long messages_count = std::stol(argv[2]); /* - number of message */
  33   long msg_size       = std::stol(argv[3]); /* - message size in bytes */
  34   long peers_count    = std::stol(argv[4]); /* - number of peers */
  35
  36   /* Set myself as the persistent receiver of my mailbox so that messages start flowing to me as soon as they are put
  37    * into it */
  38   simgrid::s4u::Mailbox* my_mbox = simgrid::s4u::Mailbox::by_name(std::string("peer-") + std::to_string(my_id));
  39   my_mbox->set_receiver(simgrid::s4u::Actor::self());
  40
  41   std::vector<simgrid::s4u::CommPtr> pending_comms;
  42
  43   /* Start dispatching all messages to peers others that myself */
  44   for (int i = 0; i < messages_count; i++) {
  45     for (int peer_id = 0; peer_id < peers_count; peer_id++) {
  46       if (peer_id != my_id) {
  47         std::string mboxName        = std::string("peer-") + std::to_string(peer_id);
  48         simgrid::s4u::Mailbox* mbox = simgrid::s4u::Mailbox::by_name(mboxName);
  49         std::string msgName =
  50             std::string("Message ") + std::to_string(i) + std::string(" from peer ") + std::to_string(my_id);
  51         auto* payload = new std::string(msgName); // copy the data we send:
  52         // 'msgName' is not a stable storage location
  53         XBT_INFO("Send '%s' to '%s'", msgName.c_str(), mboxName.c_str());
  54         /* Create a communication representing the ongoing communication */
  55         pending_comms.push_back(mbox->put_async(payload, msg_size));
  56       }
  57     }
  58   }
  59
  60   /* Start sending messages to let peers know that they should stop */
  61   for (int peer_id = 0; peer_id < peers_count; peer_id++) {
  62     if (peer_id != my_id) {
  63       std::string mboxName        = std::string("peer-") + std::to_string(peer_id);
  64       simgrid::s4u::Mailbox* mbox = simgrid::s4u::Mailbox::by_name(mboxName);
  65       auto* payload               = new std::string("finalize"); // Make a copy of the data we will send
  66       pending_comms.push_back(mbox->put_async(payload, msg_size));
  67       XBT_INFO("Send 'finalize' to 'peer-%d'", peer_id);
  68     }
  69   }
  70   XBT_INFO("Done dispatching all messages");
  71
  72   /* Retrieve all the messages other peers have been sending to me until I receive all the corresponding "Finalize"
  73    * messages */
  74   long pending_finalize_messages = peers_count - 1;
  75   while (pending_finalize_messages > 0) {
  76     if (my_mbox->ready()) {
  77       double start                = simgrid::s4u::Engine::get_clock();
  78       const auto* received        = my_mbox->get<std::string>();
  79       double waiting_time         = simgrid::s4u::Engine::get_clock() - start;
  80       xbt_assert(
  81           waiting_time == 0,
  82           "Expecting the waiting time to be 0 because the communication was supposedly ready, but got %f instead",
  83           waiting_time);
  84       XBT_INFO("I got a '%s'.", received->c_str());
  85       if (*received == "finalize") {
  86         pending_finalize_messages--;
  87       }
  88       delete received;
  89     } else {
  90       XBT_INFO("Nothing ready to consume yet, I better sleep for a while");
  91       simgrid::s4u::this_actor::sleep_for(.01);
  92     }
  93   }
  94
  95   XBT_INFO("I'm done, just waiting for my peers to receive the messages before exiting");
  96   simgrid::s4u::Comm::wait_all(&pending_comms);
  97
  98   XBT_INFO("Goodbye now!");
  99 }
 100
 101 int main(int argc, char* argv[])
 102 {
 103   xbt_assert(argc > 2, "Usage: %s platform_file deployment_file\n", argv[0]);
 104
 105   simgrid::s4u::Engine e(&argc, argv);
 106   e.register_function("peer", &peer);
 107
 108   e.load_platform(argv[1]);
 109   e.load_deployment(argv[2]);
 110
 111   e.run();
 112
 113   return 0;
 114 }