src/surf/sg_platf.cpp

   1 /* Copyright (c) 2006-2022. 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/Exception.hpp>
   7 #include <simgrid/kernel/routing/DijkstraZone.hpp>
   8 #include <simgrid/kernel/routing/DragonflyZone.hpp>
   9 #include <simgrid/kernel/routing/EmptyZone.hpp>
  10 #include <simgrid/kernel/routing/FatTreeZone.hpp>
  11 #include <simgrid/kernel/routing/FloydZone.hpp>
  12 #include <simgrid/kernel/routing/FullZone.hpp>
  13 #include <simgrid/kernel/routing/NetPoint.hpp>
  14 #include <simgrid/kernel/routing/NetZoneImpl.hpp>
  15 #include <simgrid/kernel/routing/TorusZone.hpp>
  16 #include <simgrid/kernel/routing/VivaldiZone.hpp>
  17 #include <simgrid/kernel/routing/WifiZone.hpp>
  18 #include <simgrid/s4u/Engine.hpp>
  19 #include <simgrid/s4u/NetZone.hpp>
  20
  21 #include "simgrid/sg_config.hpp"
  22 #include "src/kernel/EngineImpl.hpp"
  23 #include "src/kernel/resource/DiskImpl.hpp"
  24 #include "src/kernel/resource/profile/Profile.hpp"
  25 #include "src/surf/HostImpl.hpp"
  26 #include "src/surf/xml/platf.hpp"
  27 #include "src/surf/xml/platf_private.hpp"
  28
  29 #include <algorithm>
  30 #include <string>
  31
  32 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(surf_parse);
  33
  34 namespace simgrid {
  35 namespace kernel {
  36 namespace routing {
  37 xbt::signal<void(ClusterCreationArgs const&)> on_cluster_creation;
  38 } // namespace routing
  39 } // namespace kernel
  40 } // namespace simgrid
  41
  42 static simgrid::kernel::routing::ClusterZoneCreationArgs
  43     zone_cluster; /* temporary store data for irregular clusters, created with <zone routing="Cluster"> */
  44
  45 /** The current NetZone in the parsing */
  46 static simgrid::kernel::routing::NetZoneImpl* current_routing = nullptr;
  47 static simgrid::s4u::Host* current_host = nullptr;
  48
  49 /** Module management function: creates all internal data structures */
  50 void sg_platf_init()
  51 {
  52   // Do nothing: just for symmetry of user code
  53 }
  54
  55 /** Module management function: frees all internal data structures */
  56 void sg_platf_exit()
  57 {
  58   simgrid::kernel::routing::on_cluster_creation.disconnect_slots();
  59   // simgrid::s4u::Engine::on_platform_created.disconnect_slots();
  60
  61   surf_parse_lex_destroy();
  62 }
  63
  64 /** @brief Add a host to the current NetZone */
  65 void sg_platf_new_host_begin(const simgrid::kernel::routing::HostCreationArgs* args)
  66 {
  67   current_host = current_routing->create_host(args->id, args->speed_per_pstate)
  68                      ->set_coordinates(args->coord)
  69                      ->set_core_count(args->core_amount)
  70                      ->set_state_profile(args->state_trace)
  71                      ->set_speed_profile(args->speed_trace);
  72 }
  73
  74 void sg_platf_new_host_set_properties(const std::unordered_map<std::string, std::string>& props)
  75 {
  76   xbt_assert(current_host, "Cannot set properties of the current host: none under construction");
  77   current_host->set_properties(props);
  78 }
  79
  80 void sg_platf_new_host_seal(int pstate)
  81 {
  82   xbt_assert(current_host, "Cannot seal the current Host: none under construction");
  83   current_host->seal();
  84
  85   /* When energy plugin is activated, changing the pstate requires to already have the HostEnergy extension whose
  86    * allocation is triggered by the on_creation signal. Then set_pstate must be called after the signal emission */
  87
  88   if (pstate != 0)
  89     current_host->set_pstate(pstate);
  90
  91   current_host = nullptr;
  92 }
  93
  94 void sg_platf_new_peer(const simgrid::kernel::routing::PeerCreationArgs* args)
  95 {
  96   auto* zone = dynamic_cast<simgrid::kernel::routing::VivaldiZone*>(current_routing);
  97   xbt_assert(zone, "<peer> tag can only be used in Vivaldi netzones.");
  98
  99   const auto* peer = zone->create_host(args->id, {args->speed})
 100                          ->set_state_profile(args->state_trace)
 101                          ->set_speed_profile(args->speed_trace)
 102                          ->set_coordinates(args->coord)
 103                          ->seal();
 104
 105   zone->set_peer_link(peer->get_netpoint(), args->bw_in, args->bw_out);
 106 }
 107
 108 /** @brief Add a "router" to the network element list */
 109 simgrid::kernel::routing::NetPoint* sg_platf_new_router(const std::string& name, const std::string& coords)
 110 {
 111   auto* netpoint = current_routing->create_router(name)->set_coordinates(coords);
 112   XBT_DEBUG("Router '%s' has the id %lu", netpoint->get_cname(), netpoint->id());
 113
 114   return netpoint;
 115 }
 116
 117 static void sg_platf_set_link_properties(simgrid::s4u::Link* link,
 118                                          const simgrid::kernel::routing::LinkCreationArgs* args)
 119 {
 120   link->set_properties(args->properties)
 121       ->set_state_profile(args->state_trace)
 122       ->set_latency_profile(args->latency_trace)
 123       ->set_bandwidth_profile(args->bandwidth_trace)
 124       ->set_latency(args->latency);
 125 }
 126
 127 void sg_platf_new_link(const simgrid::kernel::routing::LinkCreationArgs* args)
 128 {
 129   simgrid::s4u::Link* link;
 130   if (args->policy == simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX) {
 131     link = current_routing->create_split_duplex_link(args->id, args->bandwidths);
 132   } else {
 133     link = current_routing->create_link(args->id, args->bandwidths);
 134     link->get_impl()->set_sharing_policy(args->policy, {});
 135   }
 136   sg_platf_set_link_properties(link, args);
 137   link->seal();
 138 }
 139
 140 void sg_platf_new_disk(const simgrid::kernel::routing::DiskCreationArgs* disk)
 141 {
 142   const simgrid::s4u::Disk* new_disk = current_routing->create_disk(disk->id, disk->read_bw, disk->write_bw)
 143                                            ->set_host(current_host)
 144                                            ->set_properties(disk->properties)
 145                                            ->seal();
 146
 147   current_host->add_disk(new_disk);
 148 }
 149
 150 /*************************************************************************************************/
 151 /** @brief Auxiliary function to create hosts */
 152 static std::pair<simgrid::kernel::routing::NetPoint*, simgrid::kernel::routing::NetPoint*>
 153 sg_platf_cluster_create_host(const simgrid::kernel::routing::ClusterCreationArgs* cluster, simgrid::s4u::NetZone* zone,
 154                              const std::vector<unsigned long>& /*coord*/, unsigned long id)
 155 {
 156   xbt_assert(static_cast<unsigned long>(id) < cluster->radicals.size(),
 157              "Zone(%s): error when creating host number %lu in the zone. Insufficient number of radicals available "
 158              "(total = %zu). Check the 'radical' parameter in XML",
 159              cluster->id.c_str(), id, cluster->radicals.size());
 160
 161   std::string host_id = std::string(cluster->prefix) + std::to_string(cluster->radicals[id]) + cluster->suffix;
 162   XBT_DEBUG("Cluster: creating host=%s speed=%f", host_id.c_str(), cluster->speeds.front());
 163   const simgrid::s4u::Host* host = zone->create_host(host_id, cluster->speeds)
 164                                        ->set_core_count(cluster->core_amount)
 165                                        ->set_properties(cluster->properties)
 166                                        ->seal();
 167   return std::make_pair(host->get_netpoint(), nullptr);
 168 }
 169
 170 /** @brief Auxiliary function to create loopback links */
 171 static simgrid::s4u::Link*
 172 sg_platf_cluster_create_loopback(const simgrid::kernel::routing::ClusterCreationArgs* cluster,
 173                                  simgrid::s4u::NetZone* zone, const std::vector<unsigned long>& /*coord*/,
 174                                  unsigned long id)
 175 {
 176   xbt_assert(static_cast<unsigned long>(id) < cluster->radicals.size(),
 177              "Zone(%s): error when creating loopback for host number %lu in the zone. Insufficient number of "
 178              "radicals available "
 179              "(total = %zu). Check the 'radical' parameter in XML",
 180              cluster->id.c_str(), id, cluster->radicals.size());
 181
 182   std::string link_id = std::string(cluster->id) + "_link_" + std::to_string(cluster->radicals[id]) + "_loopback";
 183   XBT_DEBUG("Cluster: creating loopback link=%s bw=%f", link_id.c_str(), cluster->loopback_bw);
 184
 185   simgrid::s4u::Link* loopback = zone->create_link(link_id, cluster->loopback_bw)
 186                                      ->set_sharing_policy(simgrid::s4u::Link::SharingPolicy::FATPIPE)
 187                                      ->set_latency(cluster->loopback_lat)
 188                                      ->seal();
 189   return loopback;
 190 }
 191
 192 /** @brief Auxiliary function to create limiter links */
 193 static simgrid::s4u::Link* sg_platf_cluster_create_limiter(const simgrid::kernel::routing::ClusterCreationArgs* cluster,
 194                                                            simgrid::s4u::NetZone* zone,
 195                                                            const std::vector<unsigned long>& /*coord*/,
 196                                                            unsigned long id)
 197 {
 198   std::string link_id = std::string(cluster->id) + "_link_" + std::to_string(id) + "_limiter";
 199   XBT_DEBUG("Cluster: creating limiter link=%s bw=%f", link_id.c_str(), cluster->limiter_link);
 200
 201   simgrid::s4u::Link* limiter = zone->create_link(link_id, cluster->limiter_link)->seal();
 202   return limiter;
 203 }
 204
 205 /** @brief Create Torus, Fat-Tree and Dragonfly clusters */
 206 static void sg_platf_new_cluster_hierarchical(const simgrid::kernel::routing::ClusterCreationArgs* cluster)
 207 {
 208   using namespace std::placeholders;
 209   using simgrid::kernel::routing::DragonflyZone;
 210   using simgrid::kernel::routing::FatTreeZone;
 211   using simgrid::kernel::routing::TorusZone;
 212
 213   auto set_host = std::bind(sg_platf_cluster_create_host, cluster, _1, _2, _3);
 214   std::function<simgrid::s4u::ClusterCallbacks::ClusterLinkCb> set_loopback{};
 215   std::function<simgrid::s4u::ClusterCallbacks::ClusterLinkCb> set_limiter{};
 216
 217   if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
 218     set_loopback = std::bind(sg_platf_cluster_create_loopback, cluster, _1, _2, _3);
 219   }
 220
 221   if (cluster->limiter_link > 0) {
 222     set_limiter = std::bind(sg_platf_cluster_create_limiter, cluster, _1, _2, _3);
 223   }
 224
 225   simgrid::s4u::NetZone const* parent = current_routing ? current_routing->get_iface() : nullptr;
 226   switch (cluster->topology) {
 227     case simgrid::kernel::routing::ClusterTopology::TORUS:
 228       simgrid::s4u::create_torus_zone(cluster->id, parent, TorusZone::parse_topo_parameters(cluster->topo_parameters),
 229                                       {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat,
 230                                       cluster->sharing_policy);
 231       break;
 232     case simgrid::kernel::routing::ClusterTopology::DRAGONFLY:
 233       simgrid::s4u::create_dragonfly_zone(
 234           cluster->id, parent, DragonflyZone::parse_topo_parameters(cluster->topo_parameters),
 235           {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat, cluster->sharing_policy);
 236       break;
 237     case simgrid::kernel::routing::ClusterTopology::FAT_TREE:
 238       simgrid::s4u::create_fatTree_zone(
 239           cluster->id, parent, FatTreeZone::parse_topo_parameters(cluster->topo_parameters),
 240           {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat, cluster->sharing_policy);
 241       break;
 242     default:
 243       THROW_IMPOSSIBLE;
 244   }
 245 }
 246
 247 /*************************************************************************************************/
 248 /** @brief Create regular Cluster */
 249 static void sg_platf_new_cluster_flat(simgrid::kernel::routing::ClusterCreationArgs* cluster)
 250 {
 251   auto* zone                          = simgrid::s4u::create_star_zone(cluster->id);
 252   simgrid::s4u::NetZone const* parent = current_routing ? current_routing->get_iface() : nullptr;
 253   if (parent)
 254     zone->set_parent(parent);
 255
 256   /* set properties */
 257   for (auto const& elm : cluster->properties)
 258     zone->set_property(elm.first, elm.second);
 259
 260   /* Make the backbone */
 261   const simgrid::s4u::Link* backbone = nullptr;
 262   if ((cluster->bb_bw > 0) || (cluster->bb_lat > 0)) {
 263     std::string bb_name = std::string(cluster->id) + "_backbone";
 264     XBT_DEBUG("<link\tid=\"%s\" bw=\"%f\" lat=\"%f\"/> <!--backbone -->", bb_name.c_str(), cluster->bb_bw,
 265               cluster->bb_lat);
 266
 267     backbone = zone->create_link(bb_name, cluster->bb_bw)
 268                    ->set_sharing_policy(cluster->bb_sharing_policy)
 269                    ->set_latency(cluster->bb_lat)
 270                    ->seal();
 271   }
 272
 273   for (int const& i : cluster->radicals) {
 274     std::string host_id = std::string(cluster->prefix) + std::to_string(i) + cluster->suffix;
 275
 276     XBT_DEBUG("<host\tid=\"%s\"\tspeed=\"%f\">", host_id.c_str(), cluster->speeds.front());
 277     const auto* host = zone->create_host(host_id, cluster->speeds)
 278                            ->set_core_count(cluster->core_amount)
 279                            ->set_properties(cluster->properties)
 280                            ->seal();
 281
 282     XBT_DEBUG("</host>");
 283
 284     std::string link_id = std::string(cluster->id) + "_link_" + std::to_string(i);
 285     XBT_DEBUG("<link\tid=\"%s\"\tbw=\"%f\"\tlat=\"%f\"/>", link_id.c_str(), cluster->bw, cluster->lat);
 286
 287     // add a loopback link
 288     if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
 289       std::string loopback_name = link_id + "_loopback";
 290       XBT_DEBUG("<loopback\tid=\"%s\"\tbw=\"%f\"/>", loopback_name.c_str(), cluster->loopback_bw);
 291
 292       const auto* loopback = zone->create_link(loopback_name, cluster->loopback_bw)
 293                                  ->set_sharing_policy(simgrid::s4u::Link::SharingPolicy::FATPIPE)
 294                                  ->set_latency(cluster->loopback_lat)
 295                                  ->seal();
 296
 297       zone->add_route(host->get_netpoint(), host->get_netpoint(), nullptr, nullptr,
 298                       {simgrid::s4u::LinkInRoute(loopback)});
 299     }
 300
 301     // add a limiter link (shared link to account for maximal bandwidth of the node)
 302     const simgrid::s4u::Link* limiter = nullptr;
 303     if (cluster->limiter_link > 0) {
 304       std::string limiter_name = std::string(link_id) + "_limiter";
 305       XBT_DEBUG("<limiter\tid=\"%s\"\tbw=\"%f\"/>", limiter_name.c_str(), cluster->limiter_link);
 306
 307       limiter = zone->create_link(limiter_name, cluster->limiter_link)->seal();
 308     }
 309
 310     // create link
 311     const simgrid::s4u::Link* link;
 312     if (cluster->sharing_policy == simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX) {
 313       link = zone->create_split_duplex_link(link_id, cluster->bw)->set_latency(cluster->lat)->seal();
 314     } else {
 315       link = zone->create_link(link_id, cluster->bw)->set_latency(cluster->lat)->seal();
 316     }
 317
 318     /* adding routes */
 319     std::vector<simgrid::s4u::LinkInRoute> links;
 320     if (limiter)
 321       links.emplace_back(limiter);
 322     links.emplace_back(link, simgrid::s4u::LinkInRoute::Direction::UP);
 323     if (backbone)
 324       links.emplace_back(backbone);
 325
 326     zone->add_route(host->get_netpoint(), nullptr, nullptr, nullptr, links, true);
 327   }
 328
 329   // Add a router.
 330   XBT_DEBUG(" ");
 331   XBT_DEBUG("<router id=\"%s\"/>", cluster->router_id.c_str());
 332   if (cluster->router_id.empty())
 333     cluster->router_id = std::string(cluster->prefix) + cluster->id + "_router" + cluster->suffix;
 334   auto* router = zone->create_router(cluster->router_id);
 335   zone->add_route(router, nullptr, nullptr, nullptr, {});
 336
 337   simgrid::kernel::routing::on_cluster_creation(*cluster);
 338 }
 339
 340 void sg_platf_new_tag_cluster(simgrid::kernel::routing::ClusterCreationArgs* cluster)
 341 {
 342   switch (cluster->topology) {
 343     case simgrid::kernel::routing::ClusterTopology::TORUS:
 344     case simgrid::kernel::routing::ClusterTopology::DRAGONFLY:
 345     case simgrid::kernel::routing::ClusterTopology::FAT_TREE:
 346       sg_platf_new_cluster_hierarchical(cluster);
 347       break;
 348     default:
 349       sg_platf_new_cluster_flat(cluster);
 350       break;
 351   }
 352 }
 353 /*************************************************************************************************/
 354 /** @brief Set the links for internal node inside a Cluster(Star) */
 355 static void sg_platf_cluster_set_hostlink(simgrid::kernel::routing::StarZone* zone,
 356                                           simgrid::kernel::routing::NetPoint* netpoint,
 357                                           const simgrid::s4u::Link* link_up, const simgrid::s4u::Link* link_down,
 358                                           const simgrid::s4u::Link* backbone)
 359 {
 360   XBT_DEBUG("Push Host_link for host '%s' to position %lu", netpoint->get_cname(), netpoint->id());
 361   simgrid::s4u::LinkInRoute linkUp{link_up};
 362   simgrid::s4u::LinkInRoute linkDown{link_down};
 363   if (backbone) {
 364     simgrid::s4u::LinkInRoute linkBB{backbone};
 365     zone->add_route(netpoint, nullptr, nullptr, nullptr, {linkUp, linkBB}, false);
 366     zone->add_route(nullptr, netpoint, nullptr, nullptr, {linkBB, linkDown}, false);
 367   } else {
 368     zone->add_route(netpoint, nullptr, nullptr, nullptr, {linkUp}, false);
 369     zone->add_route(nullptr, netpoint, nullptr, nullptr, {linkDown}, false);
 370   }
 371 }
 372
 373 /** @brief Add a link connecting a host to the rest of its StarZone */
 374 static void sg_platf_build_hostlink(simgrid::kernel::routing::StarZone* zone,
 375                                     const simgrid::kernel::routing::HostLinkCreationArgs* hostlink,
 376                                     const simgrid::s4u::Link* backbone)
 377 {
 378   const auto engine = simgrid::s4u::Engine::get_instance();
 379   auto netpoint     = engine->host_by_name(hostlink->id)->get_netpoint();
 380   xbt_assert(netpoint, "Host '%s' not found!", hostlink->id.c_str());
 381
 382   const auto linkUp   = engine->link_by_name_or_null(hostlink->link_up);
 383   const auto linkDown = engine->link_by_name_or_null(hostlink->link_down);
 384
 385   xbt_assert(linkUp, "Link '%s' not found!", hostlink->link_up.c_str());
 386   xbt_assert(linkDown, "Link '%s' not found!", hostlink->link_down.c_str());
 387   sg_platf_cluster_set_hostlink(zone, netpoint, linkUp, linkDown, backbone);
 388 }
 389
 390 /** @brief Create a cabinet (set of hosts) inside a Cluster(StarZone) */
 391 static void sg_platf_build_cabinet(simgrid::kernel::routing::StarZone* zone,
 392                                    const simgrid::kernel::routing::CabinetCreationArgs* args,
 393                                    const simgrid::s4u::Link* backbone)
 394 {
 395   for (int const& radical : args->radicals) {
 396     std::string id   = args->prefix + std::to_string(radical) + args->suffix;
 397     auto const* host = zone->create_host(id, {args->speed})->seal();
 398
 399     const auto* link_up   = zone->create_link("link_" + id + "_UP", {args->bw})->set_latency(args->lat)->seal();
 400     const auto* link_down = zone->create_link("link_" + id + "_DOWN", {args->bw})->set_latency(args->lat)->seal();
 401
 402     sg_platf_cluster_set_hostlink(zone, host->get_netpoint(), link_up, link_down, backbone);
 403   }
 404 }
 405
 406 static void sg_platf_zone_cluster_populate(const simgrid::kernel::routing::ClusterZoneCreationArgs* cluster)
 407 {
 408   auto* zone = dynamic_cast<simgrid::kernel::routing::StarZone*>(current_routing);
 409   xbt_assert(zone, "Host_links are only valid for Cluster(Star)");
 410
 411   const simgrid::s4u::Link* backbone = nullptr;
 412   /* create backbone */
 413   if (cluster->backbone) {
 414     sg_platf_new_link(cluster->backbone.get());
 415     backbone = simgrid::s4u::Link::by_name(cluster->backbone->id);
 416   }
 417
 418   /* create host_links for hosts */
 419   for (auto const& hostlink : cluster->host_links) {
 420     sg_platf_build_hostlink(zone, &hostlink, backbone);
 421   }
 422
 423   /* create cabinets */
 424   for (auto const& cabinet : cluster->cabinets) {
 425     sg_platf_build_cabinet(zone, &cabinet, backbone);
 426   }
 427 }
 428
 429 void routing_cluster_add_backbone(std::unique_ptr<simgrid::kernel::routing::LinkCreationArgs> link)
 430 {
 431   zone_cluster.backbone = std::move(link);
 432 }
 433
 434 void sg_platf_new_cabinet(const simgrid::kernel::routing::CabinetCreationArgs* args)
 435 {
 436   xbt_assert(args, "Invalid nullptr argument");
 437   zone_cluster.cabinets.emplace_back(*args);
 438 }
 439
 440 /*************************************************************************************************/
 441 void sg_platf_new_route(simgrid::kernel::routing::RouteCreationArgs* route)
 442 {
 443   current_routing->add_route(route->src, route->dst, route->gw_src, route->gw_dst, route->link_list,
 444                              route->symmetrical);
 445 }
 446
 447 void sg_platf_new_bypass_route(simgrid::kernel::routing::RouteCreationArgs* route)
 448 {
 449   current_routing->add_bypass_route(route->src, route->dst, route->gw_src, route->gw_dst, route->link_list);
 450 }
 451
 452 void sg_platf_new_actor(simgrid::kernel::routing::ActorCreationArgs* actor)
 453 {
 454   const auto* engine = simgrid::s4u::Engine::get_instance();
 455   sg_host_t host = sg_host_by_name(actor->host);
 456   if (not host) {
 457     // The requested host does not exist. Do a nice message to the user
 458     std::string msg = std::string("Cannot create actor '") + actor->function + "': host '" + actor->host +
 459                       "' does not exist\nExisting hosts: '";
 460
 461     std::vector<simgrid::s4u::Host*> list = engine->get_all_hosts();
 462
 463     for (auto const& some_host : list) {
 464       msg += some_host->get_name();
 465       msg += "', '";
 466       if (msg.length() > 1024) {
 467         msg.pop_back(); // remove trailing quote
 468         msg += "...(list truncated)......";
 469         break;
 470       }
 471     }
 472     xbt_die("%s", msg.c_str());
 473   }
 474   const simgrid::kernel::actor::ActorCodeFactory& factory = engine->get_impl()->get_function(actor->function);
 475   xbt_assert(factory, "Error while creating an actor from the XML file: Function '%s' not registered", actor->function);
 476
 477   double start_time = actor->start_time;
 478   double kill_time  = actor->kill_time;
 479   bool auto_restart = actor->restart_on_failure;
 480
 481   std::string actor_name                 = actor->args[0];
 482   simgrid::kernel::actor::ActorCode code = factory(std::move(actor->args));
 483
 484   auto* arg = new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, actor->properties,
 485                                                      auto_restart);
 486
 487   host->get_impl()->add_actor_at_boot(arg);
 488
 489   if (start_time > simgrid::s4u::Engine::get_clock()) {
 490     arg = new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, actor->properties,
 491                                                  auto_restart);
 492
 493     XBT_DEBUG("Process %s@%s will be started at time %f", arg->name.c_str(), arg->host->get_cname(), start_time);
 494     simgrid::kernel::timer::Timer::set(start_time, [arg, auto_restart]() {
 495       simgrid::kernel::actor::ActorImplPtr new_actor =
 496           simgrid::kernel::actor::ActorImpl::create(arg->name.c_str(), arg->code, arg->data, arg->host, nullptr);
 497       new_actor->set_properties(arg->properties);
 498       if (arg->kill_time >= 0)
 499         new_actor->set_kill_time(arg->kill_time);
 500       if (auto_restart)
 501         new_actor->set_auto_restart(auto_restart);
 502       delete arg;
 503     });
 504   } else { // start_time <= simgrid::s4u::Engine::get_clock()
 505     XBT_DEBUG("Starting Process %s(%s) right now", arg->name.c_str(), host->get_cname());
 506
 507     try {
 508       simgrid::kernel::actor::ActorImplPtr new_actor = nullptr;
 509       new_actor = simgrid::kernel::actor::ActorImpl::create(arg->name.c_str(), code, nullptr, host, nullptr);
 510       new_actor->set_properties(arg->properties);
 511       /* The actor creation will fail if the host is currently dead, but that's fine */
 512       if (arg->kill_time >= 0)
 513         new_actor->set_kill_time(arg->kill_time);
 514       if (auto_restart)
 515         new_actor->set_auto_restart(auto_restart);
 516     } catch (simgrid::HostFailureException const&) {
 517       XBT_WARN("Deployment includes some initially turned off Hosts ... nevermind.");
 518     }
 519   }
 520 }
 521
 522 /**
 523  * @brief Auxiliary function to build the object NetZoneImpl
 524  *
 525  * Builds the objects, setting its parent properties and root netzone if needed
 526  * @param zone the parameters defining the Zone to build.
 527  * @return Pointer to recently created netzone
 528  */
 529 static simgrid::kernel::routing::NetZoneImpl*
 530 sg_platf_create_zone(const simgrid::kernel::routing::ZoneCreationArgs* zone)
 531 {
 532   /* search the routing model */
 533   const simgrid::s4u::NetZone* new_zone = nullptr;
 534
 535   if (strcasecmp(zone->routing.c_str(), "Cluster") == 0) {
 536     new_zone = simgrid::s4u::create_star_zone(zone->id);
 537   } else if (strcasecmp(zone->routing.c_str(), "Dijkstra") == 0) {
 538     new_zone = simgrid::s4u::create_dijkstra_zone(zone->id, false);
 539   } else if (strcasecmp(zone->routing.c_str(), "DijkstraCache") == 0) {
 540     new_zone = simgrid::s4u::create_dijkstra_zone(zone->id, true);
 541   } else if (strcasecmp(zone->routing.c_str(), "Floyd") == 0) {
 542     new_zone = simgrid::s4u::create_floyd_zone(zone->id);
 543   } else if (strcasecmp(zone->routing.c_str(), "Full") == 0) {
 544     new_zone = simgrid::s4u::create_full_zone(zone->id);
 545   } else if (strcasecmp(zone->routing.c_str(), "None") == 0) {
 546     new_zone = simgrid::s4u::create_empty_zone(zone->id);
 547   } else if (strcasecmp(zone->routing.c_str(), "Vivaldi") == 0) {
 548     new_zone = simgrid::s4u::create_vivaldi_zone(zone->id);
 549   } else if (strcasecmp(zone->routing.c_str(), "Wifi") == 0) {
 550     new_zone = simgrid::s4u::create_wifi_zone(zone->id);
 551   } else {
 552     xbt_die("Not a valid model!");
 553   }
 554
 555   simgrid::kernel::routing::NetZoneImpl* new_zone_impl = new_zone->get_impl();
 556   new_zone_impl->set_parent(current_routing);
 557
 558   return new_zone_impl;
 559 }
 560
 561 /**
 562  * @brief Add a Zone to the platform
 563  *
 564  * Add a new autonomous system to the platform. Any elements (such as host, router or sub-Zone) added after this call
 565  * and before the corresponding call to sg_platf_new_zone_seal() will be added to this Zone.
 566  *
 567  * Once this function was called, the configuration concerning the used models cannot be changed anymore.
 568  *
 569  * @param zone the parameters defining the Zone to build.
 570  */
 571 simgrid::kernel::routing::NetZoneImpl* sg_platf_new_zone_begin(const simgrid::kernel::routing::ZoneCreationArgs* zone)
 572 {
 573   zone_cluster.routing = zone->routing;
 574   current_routing      = sg_platf_create_zone(zone);
 575
 576   return current_routing;
 577 }
 578
 579 void sg_platf_new_zone_set_properties(const std::unordered_map<std::string, std::string>& props)
 580 {
 581   xbt_assert(current_routing, "Cannot set properties of the current Zone: none under construction");
 582
 583   current_routing->set_properties(props);
 584 }
 585
 586 /**
 587  * @brief Specify that the description of the current Zone is finished
 588  *
 589  * Once you've declared all the content of your Zone, you have to seal
 590  * it with this call. Your Zone is not usable until you call this function.
 591  */
 592 void sg_platf_new_zone_seal()
 593 {
 594   xbt_assert(current_routing, "Cannot seal the current Zone: none under construction");
 595   if (strcasecmp(zone_cluster.routing.c_str(), "Cluster") == 0) {
 596     sg_platf_zone_cluster_populate(&zone_cluster);
 597     zone_cluster.routing = "";
 598     zone_cluster.host_links.clear();
 599     zone_cluster.cabinets.clear();
 600     zone_cluster.backbone.reset();
 601   }
 602   current_routing = current_routing->get_parent();
 603 }
 604
 605 /** @brief Add a link connecting a host to the rest of its Zone (which must be cluster or vivaldi) */
 606 void sg_platf_new_hostlink(const simgrid::kernel::routing::HostLinkCreationArgs* hostlink)
 607 {
 608   xbt_assert(hostlink, "Invalid nullptr parameter");
 609   zone_cluster.host_links.emplace_back(*hostlink);
 610 }
 611
 612 void sg_platf_new_trace(simgrid::kernel::routing::ProfileCreationArgs* args)
 613 {
 614   simgrid::kernel::profile::Profile* profile;
 615   if (not args->file.empty()) {
 616     profile = simgrid::kernel::profile::Profile::from_file(args->file);
 617   } else {
 618     xbt_assert(not args->pc_data.empty(), "Trace '%s' must have either a content, or point to a file on disk.",
 619                args->id.c_str());
 620     profile = simgrid::kernel::profile::Profile::from_string(args->id, args->pc_data, args->periodicity);
 621   }
 622   traces_set_list.insert({args->id, profile});
 623 }