Logo AND Algorithmique Numérique Distribuée

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