src/surf/sg_platf.cpp

   1 /* Copyright (c) 2006-2021. 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/ClusterZone.hpp"
   8 #include "simgrid/kernel/routing/DijkstraZone.hpp"
   9 #include "simgrid/kernel/routing/DragonflyZone.hpp"
  10 #include "simgrid/kernel/routing/EmptyZone.hpp"
  11 #include "simgrid/kernel/routing/FatTreeZone.hpp"
  12 #include "simgrid/kernel/routing/FloydZone.hpp"
  13 #include "simgrid/kernel/routing/FullZone.hpp"
  14 #include "simgrid/kernel/routing/NetPoint.hpp"
  15 #include "simgrid/kernel/routing/NetZoneImpl.hpp"
  16 #include "simgrid/kernel/routing/TorusZone.hpp"
  17 #include "simgrid/kernel/routing/VivaldiZone.hpp"
  18 #include "simgrid/kernel/routing/WifiZone.hpp"
  19 #include "simgrid/s4u/Engine.hpp"
  20 #include "src/include/simgrid/sg_config.hpp"
  21 #include "src/include/surf/surf.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/simix/smx_private.hpp"
  26 #include "src/surf/HostImpl.hpp"
  27 #include "src/surf/xml/platf_private.hpp"
  28
  29 #include <string>
  30
  31 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(surf_parse);
  32
  33 namespace simgrid {
  34 namespace kernel {
  35 namespace routing {
  36 xbt::signal<void(ClusterCreationArgs const&)> on_cluster_creation;
  37 } // namespace routing
  38 } // namespace kernel
  39 } // namespace simgrid
  40
  41 /** The current NetZone in the parsing */
  42 static simgrid::kernel::routing::NetZoneImpl* current_routing = nullptr;
  43 static simgrid::kernel::routing::NetZoneImpl* routing_get_current()
  44 {
  45   return current_routing;
  46 }
  47
  48 /** Module management function: creates all internal data structures */
  49 void sg_platf_init()
  50 {
  51   // Do nothing: just for symmetry of user code
  52 }
  53
  54 /** Module management function: frees all internal data structures */
  55 void sg_platf_exit()
  56 {
  57   simgrid::kernel::routing::on_cluster_creation.disconnect_slots();
  58   simgrid::s4u::Engine::on_platform_created.disconnect_slots();
  59
  60   surf_parse_lex_destroy();
  61 }
  62
  63 /** @brief Add a host to the current NetZone */
  64 void sg_platf_new_host(const simgrid::kernel::routing::HostCreationArgs* args)
  65 {
  66   simgrid::s4u::Host* host =
  67       routing_get_current()->create_host(args->id, args->speed_per_pstate)->set_core_count(args->core_amount);
  68
  69   if (args->properties) {
  70     host->set_properties(*args->properties);
  71     delete args->properties;
  72   }
  73
  74   host->get_impl()->set_disks(args->disks, host);
  75
  76   /* Change from the defaults */
  77   host->set_state_profile(args->state_trace)->set_speed_profile(args->speed_trace);
  78
  79   if (not args->coord.empty())
  80     new simgrid::kernel::routing::vivaldi::Coords(host->get_netpoint(), args->coord);
  81
  82   host->seal();
  83   simgrid::s4u::Host::on_creation(*host); // notify the signal
  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 emition */
  87   if (args->pstate != 0)
  88     host->set_pstate(args->pstate);
  89 }
  90
  91 /** @brief Add a "router" to the network element list */
  92 simgrid::kernel::routing::NetPoint* sg_platf_new_router(const std::string& name, const char* coords)
  93 {
  94   if (current_routing->hierarchy_ == simgrid::kernel::routing::NetZoneImpl::RoutingMode::unset)
  95     current_routing->hierarchy_ = simgrid::kernel::routing::NetZoneImpl::RoutingMode::base;
  96   xbt_assert(nullptr == simgrid::s4u::Engine::get_instance()->netpoint_by_name_or_null(name),
  97              "Refusing to create a router named '%s': this name already describes a node.", name.c_str());
  98
  99   auto* netpoint = new simgrid::kernel::routing::NetPoint(name, simgrid::kernel::routing::NetPoint::Type::Router);
 100   netpoint->set_englobing_zone(current_routing);
 101   XBT_DEBUG("Router '%s' has the id %u", netpoint->get_cname(), netpoint->id());
 102
 103   if (coords && strcmp(coords, ""))
 104     new simgrid::kernel::routing::vivaldi::Coords(netpoint, coords);
 105
 106   return netpoint;
 107 }
 108
 109 static void sg_platf_new_link(const simgrid::kernel::routing::LinkCreationArgs* args, const std::string& link_name)
 110 {
 111   simgrid::s4u::Link* link = routing_get_current()->create_link(link_name, args->bandwidths, args->policy);
 112   if (args->properties)
 113     link->set_properties(*args->properties);
 114
 115   link->get_impl() // this call to get_impl saves some simcalls but can be removed
 116       ->set_state_profile(args->state_trace)
 117       ->set_latency_profile(args->latency_trace)
 118       ->set_bandwidth_profile(args->bandwidth_trace)
 119       ->set_latency(args->latency)
 120       ->seal();
 121 }
 122
 123 void sg_platf_new_link(const simgrid::kernel::routing::LinkCreationArgs* link)
 124 {
 125   if (link->policy == simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX) {
 126     sg_platf_new_link(link, link->id + "_UP");
 127     sg_platf_new_link(link, link->id + "_DOWN");
 128   } else {
 129     sg_platf_new_link(link, link->id);
 130   }
 131   delete link->properties;
 132 }
 133
 134 void sg_platf_new_cluster(simgrid::kernel::routing::ClusterCreationArgs* cluster)
 135 {
 136   using simgrid::kernel::routing::ClusterZone;
 137   using simgrid::kernel::routing::DragonflyZone;
 138   using simgrid::kernel::routing::FatTreeZone;
 139   using simgrid::kernel::routing::TorusZone;
 140
 141   int rankId = 0;
 142
 143   // What an inventive way of initializing the NetZone that I have as ancestor :-(
 144   simgrid::kernel::routing::ZoneCreationArgs zone;
 145   zone.id = cluster->id;
 146   switch (cluster->topology) {
 147     case simgrid::kernel::routing::ClusterTopology::TORUS:
 148       zone.routing = "ClusterTorus";
 149       break;
 150     case simgrid::kernel::routing::ClusterTopology::DRAGONFLY:
 151       zone.routing = "ClusterDragonfly";
 152       break;
 153     case simgrid::kernel::routing::ClusterTopology::FAT_TREE:
 154       zone.routing = "ClusterFatTree";
 155       break;
 156     default:
 157       zone.routing = "Cluster";
 158       break;
 159   }
 160   sg_platf_new_Zone_begin(&zone);
 161   auto* current_zone = static_cast<ClusterZone*>(routing_get_current());
 162   current_zone->parse_specific_arguments(cluster);
 163   if (cluster->properties != nullptr)
 164     for (auto const& elm : *cluster->properties)
 165       current_zone->get_iface()->set_property(elm.first, elm.second);
 166
 167   if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
 168     current_zone->set_loopback();
 169   }
 170
 171   if (cluster->limiter_link > 0) {
 172     current_zone->set_limiter();
 173   }
 174
 175   for (int const& i : *cluster->radicals) {
 176     std::string host_id = std::string(cluster->prefix) + std::to_string(i) + cluster->suffix;
 177     std::string link_id = std::string(cluster->id) + "_link_" + std::to_string(i);
 178
 179     XBT_DEBUG("<host\tid=\"%s\"\tpower=\"%f\">", host_id.c_str(), cluster->speeds.front());
 180
 181     simgrid::kernel::routing::HostCreationArgs host;
 182     host.id = host_id;
 183     if ((cluster->properties != nullptr) && (not cluster->properties->empty())) {
 184       host.properties = new std::unordered_map<std::string, std::string>();
 185
 186       for (auto const& elm : *cluster->properties)
 187         host.properties->insert({elm.first, elm.second});
 188     }
 189
 190     host.speed_per_pstate = cluster->speeds;
 191     host.pstate           = 0;
 192     host.core_amount      = cluster->core_amount;
 193     host.coord            = "";
 194     sg_platf_new_host(&host);
 195     XBT_DEBUG("</host>");
 196
 197     XBT_DEBUG("<link\tid=\"%s\"\tbw=\"%f\"\tlat=\"%f\"/>", link_id.c_str(), cluster->bw, cluster->lat);
 198
 199     // All links are saved in a matrix;
 200     // every row describes a single node; every node may have multiple links.
 201     // the first column may store a link from x to x if p_has_loopback is set
 202     // the second column may store a limiter link if p_has_limiter is set
 203     // other columns are to store one or more link for the node
 204
 205     // add a loopback link
 206     const simgrid::s4u::Link* linkUp   = nullptr;
 207     const simgrid::s4u::Link* linkDown = nullptr;
 208     if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
 209       std::string tmp_link = link_id + "_loopback";
 210       XBT_DEBUG("<loopback\tid=\"%s\"\tbw=\"%f\"/>", tmp_link.c_str(), cluster->loopback_bw);
 211
 212       simgrid::kernel::routing::LinkCreationArgs link;
 213       link.id = tmp_link;
 214       link.bandwidths.push_back(cluster->loopback_bw);
 215       link.latency = cluster->loopback_lat;
 216       link.policy  = simgrid::s4u::Link::SharingPolicy::FATPIPE;
 217       sg_platf_new_link(&link);
 218       linkUp   = simgrid::s4u::Link::by_name_or_null(tmp_link);
 219       linkDown = simgrid::s4u::Link::by_name_or_null(tmp_link);
 220
 221       current_zone->add_private_link_at(current_zone->node_pos(rankId), {linkUp->get_impl(), linkDown->get_impl()});
 222     }
 223
 224     // add a limiter link (shared link to account for maximal bandwidth of the node)
 225     linkUp   = nullptr;
 226     linkDown = nullptr;
 227     if (cluster->limiter_link > 0) {
 228       std::string tmp_link = std::string(link_id) + "_limiter";
 229       XBT_DEBUG("<limiter\tid=\"%s\"\tbw=\"%f\"/>", tmp_link.c_str(), cluster->limiter_link);
 230
 231       simgrid::kernel::routing::LinkCreationArgs link;
 232       link.id = tmp_link;
 233       link.bandwidths.push_back(cluster->limiter_link);
 234       link.latency = 0;
 235       link.policy  = simgrid::s4u::Link::SharingPolicy::SHARED;
 236       sg_platf_new_link(&link);
 237       linkDown = simgrid::s4u::Link::by_name_or_null(tmp_link);
 238       linkUp   = linkDown;
 239       current_zone->add_private_link_at(current_zone->node_pos_with_loopback(rankId),
 240                                         {linkUp->get_impl(), linkDown->get_impl()});
 241     }
 242
 243     // call the cluster function that adds the others links
 244     if (cluster->topology == simgrid::kernel::routing::ClusterTopology::FAT_TREE) {
 245       static_cast<FatTreeZone*>(current_zone)->add_processing_node(i);
 246     } else {
 247       current_zone->create_links_for_node(cluster, i, rankId, current_zone->node_pos_with_loopback_limiter(rankId));
 248     }
 249     rankId++;
 250   }
 251   delete cluster->properties;
 252
 253   // Add a router.
 254   XBT_DEBUG(" ");
 255   XBT_DEBUG("<router id=\"%s\"/>", cluster->router_id.c_str());
 256   if (cluster->router_id.empty())
 257     cluster->router_id = std::string(cluster->prefix) + cluster->id + "_router" + cluster->suffix;
 258   current_zone->set_router(sg_platf_new_router(cluster->router_id, nullptr));
 259
 260   // Make the backbone
 261   if ((cluster->bb_bw > 0) || (cluster->bb_lat > 0)) {
 262     simgrid::kernel::routing::LinkCreationArgs link;
 263     link.id = std::string(cluster->id) + "_backbone";
 264     link.bandwidths.push_back(cluster->bb_bw);
 265     link.latency = cluster->bb_lat;
 266     link.policy  = cluster->bb_sharing_policy;
 267
 268     XBT_DEBUG("<link\tid=\"%s\" bw=\"%f\" lat=\"%f\"/>", link.id.c_str(), cluster->bb_bw, cluster->bb_lat);
 269     sg_platf_new_link(&link);
 270
 271     routing_cluster_add_backbone(simgrid::s4u::Link::by_name(link.id)->get_impl());
 272   }
 273
 274   XBT_DEBUG("</zone>");
 275   sg_platf_new_Zone_seal();
 276
 277   simgrid::kernel::routing::on_cluster_creation(*cluster);
 278   delete cluster->radicals;
 279 }
 280
 281 void routing_cluster_add_backbone(simgrid::kernel::resource::LinkImpl* bb)
 282 {
 283   auto* cluster = dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
 284
 285   xbt_assert(cluster, "Only hosts from Cluster can get a backbone.");
 286   xbt_assert(not cluster->has_backbone(), "Cluster %s already has a backbone link!", cluster->get_cname());
 287
 288   cluster->set_backbone(bb);
 289   XBT_DEBUG("Add a backbone to zone '%s'", current_routing->get_cname());
 290 }
 291
 292 void sg_platf_new_cabinet(const simgrid::kernel::routing::CabinetCreationArgs* cabinet)
 293 {
 294   for (int const& radical : *cabinet->radicals) {
 295     std::string hostname = cabinet->prefix + std::to_string(radical) + cabinet->suffix;
 296     simgrid::kernel::routing::HostCreationArgs host;
 297     host.pstate      = 0;
 298     host.core_amount = 1;
 299     host.id          = hostname;
 300     host.speed_per_pstate.push_back(cabinet->speed);
 301     sg_platf_new_host(&host);
 302
 303     simgrid::kernel::routing::LinkCreationArgs link;
 304     link.policy  = simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX;
 305     link.latency = cabinet->lat;
 306     link.bandwidths.push_back(cabinet->bw);
 307     link.id = "link_" + hostname;
 308     sg_platf_new_link(&link);
 309
 310     simgrid::kernel::routing::HostLinkCreationArgs host_link;
 311     host_link.id        = hostname;
 312     host_link.link_up   = std::string("link_") + hostname + "_UP";
 313     host_link.link_down = std::string("link_") + hostname + "_DOWN";
 314     sg_platf_new_hostlink(&host_link);
 315   }
 316   delete cabinet->radicals;
 317 }
 318
 319 simgrid::kernel::resource::DiskImpl* sg_platf_new_disk(const simgrid::kernel::routing::DiskCreationArgs* disk)
 320 {
 321   simgrid::kernel::resource::DiskImpl* pimpl =
 322       routing_get_current()->create_disk(disk->id, disk->read_bw, disk->write_bw)->get_impl();
 323
 324   if (disk->properties) {
 325     pimpl->set_properties(*disk->properties);
 326     delete disk->properties;
 327   }
 328
 329   pimpl->seal();
 330   simgrid::s4u::Disk::on_creation(*pimpl->get_iface());
 331   return pimpl;
 332 }
 333
 334 void sg_platf_new_route(simgrid::kernel::routing::RouteCreationArgs* route)
 335 {
 336   routing_get_current()->add_route(route->src, route->dst, route->gw_src, route->gw_dst, route->link_list,
 337                                    route->symmetrical);
 338 }
 339
 340 void sg_platf_new_bypassRoute(simgrid::kernel::routing::RouteCreationArgs* bypassRoute)
 341 {
 342   routing_get_current()->add_bypass_route(bypassRoute->src, bypassRoute->dst, bypassRoute->gw_src, bypassRoute->gw_dst,
 343                                           bypassRoute->link_list, bypassRoute->symmetrical);
 344 }
 345
 346 void sg_platf_new_actor(simgrid::kernel::routing::ActorCreationArgs* actor)
 347 {
 348   sg_host_t host = sg_host_by_name(actor->host);
 349   if (not host) {
 350     // The requested host does not exist. Do a nice message to the user
 351     std::string msg = std::string("Cannot create actor '") + actor->function + "': host '" + actor->host +
 352                       "' does not exist\nExisting hosts: '";
 353
 354     std::vector<simgrid::s4u::Host*> list = simgrid::s4u::Engine::get_instance()->get_all_hosts();
 355
 356     for (auto const& some_host : list) {
 357       msg += some_host->get_name();
 358       msg += "', '";
 359       if (msg.length() > 1024) {
 360         msg.pop_back(); // remove trailing quote
 361         msg += "...(list truncated)......";
 362         break;
 363       }
 364     }
 365     xbt_die("%s", msg.c_str());
 366   }
 367   const simgrid::kernel::actor::ActorCodeFactory& factory =
 368       simgrid::kernel::EngineImpl::get_instance()->get_function(actor->function);
 369   xbt_assert(factory, "Error while creating an actor from the XML file: Function '%s' not registered", actor->function);
 370
 371   double start_time = actor->start_time;
 372   double kill_time  = actor->kill_time;
 373   bool auto_restart = actor->restart_on_failure;
 374
 375   std::string actor_name                 = actor->args[0];
 376   simgrid::kernel::actor::ActorCode code = factory(std::move(actor->args));
 377   std::shared_ptr<std::unordered_map<std::string, std::string>> properties(actor->properties);
 378
 379   auto* arg =
 380       new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, properties, auto_restart);
 381
 382   host->get_impl()->add_actor_at_boot(arg);
 383
 384   if (start_time > SIMIX_get_clock()) {
 385     arg = new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, properties, auto_restart);
 386
 387     XBT_DEBUG("Process %s@%s will be started at time %f", arg->name.c_str(), arg->host->get_cname(), start_time);
 388     simgrid::simix::Timer::set(start_time, [arg, auto_restart]() {
 389       simgrid::kernel::actor::ActorImplPtr new_actor = simgrid::kernel::actor::ActorImpl::create(
 390           arg->name.c_str(), arg->code, arg->data, arg->host, arg->properties.get(), nullptr);
 391       if (arg->kill_time >= 0)
 392         new_actor->set_kill_time(arg->kill_time);
 393       if (auto_restart)
 394         new_actor->set_auto_restart(auto_restart);
 395       delete arg;
 396     });
 397   } else { // start_time <= SIMIX_get_clock()
 398     XBT_DEBUG("Starting Process %s(%s) right now", arg->name.c_str(), host->get_cname());
 399
 400     try {
 401       simgrid::kernel::actor::ActorImplPtr new_actor = nullptr;
 402       new_actor = simgrid::kernel::actor::ActorImpl::create(arg->name.c_str(), code, nullptr, host,
 403                                                             arg->properties.get(), nullptr);
 404       /* The actor creation will fail if the host is currently dead, but that's fine */
 405       if (arg->kill_time >= 0)
 406         new_actor->set_kill_time(arg->kill_time);
 407       if (auto_restart)
 408         new_actor->set_auto_restart(auto_restart);
 409     } catch (simgrid::HostFailureException const&) {
 410       XBT_WARN("Deployment includes some initially turned off Hosts ... nevermind.");
 411     }
 412   }
 413 }
 414
 415 void sg_platf_new_peer(const simgrid::kernel::routing::PeerCreationArgs* peer)
 416 {
 417   auto* zone = dynamic_cast<simgrid::kernel::routing::VivaldiZone*>(current_routing);
 418   xbt_assert(zone, "<peer> tag can only be used in Vivaldi netzones.");
 419
 420   std::vector<double> speed_per_pstate;
 421   speed_per_pstate.push_back(peer->speed);
 422   simgrid::s4u::Host* host = zone->create_host(peer->id, speed_per_pstate);
 423
 424   zone->set_peer_link(host->get_netpoint(), peer->bw_in, peer->bw_out, peer->coord);
 425
 426   /* Change from the defaults */
 427   if (peer->state_trace)
 428     host->set_state_profile(peer->state_trace);
 429   if (peer->speed_trace)
 430     host->set_speed_profile(peer->speed_trace);
 431   host->seal();
 432   simgrid::s4u::Host::on_creation(*host); // notify the signal
 433 }
 434
 435 /**
 436  * @brief Auxiliary function to build the object NetZoneImpl
 437  *
 438  * Builds the objects, setting its father properties and root netzone if needed
 439  * @param zone the parameters defining the Zone to build.
 440  * @return Pointer to recently created netzone
 441  */
 442 static simgrid::kernel::routing::NetZoneImpl*
 443 sg_platf_create_zone(const simgrid::kernel::routing::ZoneCreationArgs* zone)
 444 {
 445   /* search the routing model */
 446   simgrid::kernel::routing::NetZoneImpl* new_zone = nullptr;
 447
 448   if (strcasecmp(zone->routing.c_str(), "Cluster") == 0) {
 449     new_zone = new simgrid::kernel::routing::ClusterZone(zone->id);
 450   } else if (strcasecmp(zone->routing.c_str(), "ClusterDragonfly") == 0) {
 451     new_zone = new simgrid::kernel::routing::DragonflyZone(zone->id);
 452   } else if (strcasecmp(zone->routing.c_str(), "ClusterTorus") == 0) {
 453     new_zone = new simgrid::kernel::routing::TorusZone(zone->id);
 454   } else if (strcasecmp(zone->routing.c_str(), "ClusterFatTree") == 0) {
 455     new_zone = new simgrid::kernel::routing::FatTreeZone(zone->id);
 456   } else if (strcasecmp(zone->routing.c_str(), "Dijkstra") == 0) {
 457     new_zone = new simgrid::kernel::routing::DijkstraZone(zone->id, false);
 458   } else if (strcasecmp(zone->routing.c_str(), "DijkstraCache") == 0) {
 459     new_zone = new simgrid::kernel::routing::DijkstraZone(zone->id, true);
 460   } else if (strcasecmp(zone->routing.c_str(), "Floyd") == 0) {
 461     new_zone = new simgrid::kernel::routing::FloydZone(zone->id);
 462   } else if (strcasecmp(zone->routing.c_str(), "Full") == 0) {
 463     new_zone = new simgrid::kernel::routing::FullZone(zone->id);
 464   } else if (strcasecmp(zone->routing.c_str(), "None") == 0) {
 465     new_zone = new simgrid::kernel::routing::EmptyZone(zone->id);
 466   } else if (strcasecmp(zone->routing.c_str(), "Vivaldi") == 0) {
 467     new_zone = new simgrid::kernel::routing::VivaldiZone(zone->id);
 468   } else if (strcasecmp(zone->routing.c_str(), "Wifi") == 0) {
 469     new_zone = new simgrid::kernel::routing::WifiZone(zone->id);
 470   } else {
 471     xbt_die("Not a valid model!");
 472   }
 473   new_zone->set_parent(current_routing);
 474
 475   if (current_routing) {
 476     /* set the father behavior */
 477     if (current_routing->hierarchy_ == simgrid::kernel::routing::NetZoneImpl::RoutingMode::unset)
 478       current_routing->hierarchy_ = simgrid::kernel::routing::NetZoneImpl::RoutingMode::recursive;
 479     /* add to the sons dictionary */
 480     current_routing->add_child(new_zone);
 481     /* set models from parent netzone */
 482     new_zone->set_network_model(current_routing->get_network_model());
 483     new_zone->set_cpu_pm_model(current_routing->get_cpu_pm_model());
 484     new_zone->set_cpu_vm_model(current_routing->get_cpu_vm_model());
 485     new_zone->set_disk_model(current_routing->get_disk_model());
 486     new_zone->set_host_model(current_routing->get_host_model());
 487   }
 488   return new_zone;
 489 }
 490
 491 /**
 492  * @brief Add a Zone to the platform
 493  *
 494  * Add a new autonomous system to the platform. Any elements (such as host, router or sub-Zone) added after this call
 495  * and before the corresponding call to sg_platf_new_Zone_seal() will be added to this Zone.
 496  *
 497  * Once this function was called, the configuration concerning the used models cannot be changed anymore.
 498  *
 499  * @param zone the parameters defining the Zone to build.
 500  */
 501 simgrid::kernel::routing::NetZoneImpl* sg_platf_new_Zone_begin(const simgrid::kernel::routing::ZoneCreationArgs* zone)
 502 {
 503   /* First create the zone.
 504    * This order is important to assure that root netzone is set when models are setting
 505    * the default mode for each resource (CPU, network, etc)
 506    */
 507   auto* new_zone = sg_platf_create_zone(zone);
 508
 509   _sg_cfg_init_status = 2; /* HACK: direct access to the global controlling the level of configuration to prevent
 510                             * any further config now that we created some real content */
 511
 512   /* set the new current component of the tree */
 513   current_routing = new_zone;
 514   simgrid::s4u::NetZone::on_creation(*new_zone->get_iface()); // notify the signal
 515
 516   return new_zone;
 517 }
 518
 519 void sg_platf_new_Zone_set_properties(const std::unordered_map<std::string, std::string>* props)
 520 {
 521   xbt_assert(current_routing, "Cannot set properties of the current Zone: none under construction");
 522
 523   if (props)
 524     current_routing->set_properties(*props);
 525 }
 526
 527 /**
 528  * @brief Specify that the description of the current Zone is finished
 529  *
 530  * Once you've declared all the content of your Zone, you have to seal
 531  * it with this call. Your Zone is not usable until you call this function.
 532  */
 533 void sg_platf_new_Zone_seal()
 534 {
 535   xbt_assert(current_routing, "Cannot seal the current Zone: zone under construction");
 536   current_routing->seal();
 537   simgrid::s4u::NetZone::on_seal(*current_routing->get_iface());
 538   current_routing = current_routing->get_parent();
 539 }
 540
 541 /** @brief Add a link connecting a host to the rest of its Zone (which must be cluster or vivaldi) */
 542 void sg_platf_new_hostlink(const simgrid::kernel::routing::HostLinkCreationArgs* hostlink)
 543 {
 544   const simgrid::kernel::routing::NetPoint* netpoint = simgrid::s4u::Host::by_name(hostlink->id)->get_netpoint();
 545   xbt_assert(netpoint, "Host '%s' not found!", hostlink->id.c_str());
 546   xbt_assert(dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing),
 547              "Only hosts from Cluster and Vivaldi Zones can get a host_link.");
 548
 549   const simgrid::s4u::Link* linkUp   = simgrid::s4u::Link::by_name_or_null(hostlink->link_up);
 550   const simgrid::s4u::Link* linkDown = simgrid::s4u::Link::by_name_or_null(hostlink->link_down);
 551
 552   xbt_assert(linkUp, "Link '%s' not found!", hostlink->link_up.c_str());
 553   xbt_assert(linkDown, "Link '%s' not found!", hostlink->link_down.c_str());
 554
 555   auto* cluster_zone = static_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
 556
 557   if (cluster_zone->private_link_exists_at(netpoint->id()))
 558     surf_parse_error(std::string("Host_link for '") + hostlink->id.c_str() + "' is already defined!");
 559
 560   XBT_DEBUG("Push Host_link for host '%s' to position %u", netpoint->get_cname(), netpoint->id());
 561   cluster_zone->add_private_link_at(netpoint->id(), {linkUp->get_impl(), linkDown->get_impl()});
 562 }
 563
 564 void sg_platf_new_trace(simgrid::kernel::routing::ProfileCreationArgs* profile)
 565 {
 566   simgrid::kernel::profile::Profile* mgr_profile;
 567   if (not profile->file.empty()) {
 568     mgr_profile = simgrid::kernel::profile::Profile::from_file(profile->file);
 569   } else {
 570     xbt_assert(not profile->pc_data.empty(), "Trace '%s' must have either a content, or point to a file on disk.",
 571                profile->id.c_str());
 572     mgr_profile = simgrid::kernel::profile::Profile::from_string(profile->id, profile->pc_data, profile->periodicity);
 573   }
 574   traces_set_list.insert({profile->id, mgr_profile});
 575 }