1 /* Copyright (c) 2006-2023. The SimGrid Team. All rights reserved. */
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. */
6 /* This file implements the public API to platform parsing */
8 #include <simgrid/Exception.hpp>
9 #include <simgrid/kernel/routing/DijkstraZone.hpp>
10 #include <simgrid/kernel/routing/DragonflyZone.hpp>
11 #include <simgrid/kernel/routing/EmptyZone.hpp>
12 #include <simgrid/kernel/routing/FatTreeZone.hpp>
13 #include <simgrid/kernel/routing/FloydZone.hpp>
14 #include <simgrid/kernel/routing/FullZone.hpp>
15 #include <simgrid/kernel/routing/NetPoint.hpp>
16 #include <simgrid/kernel/routing/NetZoneImpl.hpp>
17 #include <simgrid/kernel/routing/TorusZone.hpp>
18 #include <simgrid/kernel/routing/VivaldiZone.hpp>
19 #include <simgrid/kernel/routing/WifiZone.hpp>
20 #include <simgrid/s4u/Engine.hpp>
21 #include <simgrid/s4u/NetZone.hpp>
23 #include "src/kernel/EngineImpl.hpp"
24 #include "src/kernel/resource/DiskImpl.hpp"
25 #include "src/kernel/resource/HostImpl.hpp"
26 #include "src/kernel/resource/profile/Profile.hpp"
27 #include "src/kernel/xml/platf.hpp"
28 #include "src/kernel/xml/platf_private.hpp"
29 #include "src/simgrid/sg_config.hpp"
34 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(platf_parse);
36 /* This function acts as a main in the parsing area. */
37 void parse_platform_file(const std::string& file)
39 /* init the flex parser */
40 simgrid_parse_open(file);
42 /* Do the actual parsing */
45 simgrid_parse_close();
48 namespace simgrid::kernel::routing {
49 xbt::signal<void(ClusterCreationArgs const&)> on_cluster_creation;
50 } // namespace simgrid::kernel::routing
52 static simgrid::kernel::routing::ClusterZoneCreationArgs
53 zone_cluster; /* temporary store data for irregular clusters, created with <zone routing="Cluster"> */
55 /** The current NetZone in the parsing */
56 static simgrid::kernel::routing::NetZoneImpl* current_routing = nullptr;
57 static simgrid::s4u::Host* current_host = nullptr;
59 /** Module management function: frees all internal data structures */
60 void sg_platf_parser_finalize()
62 simgrid::kernel::routing::on_cluster_creation.disconnect_slots();
64 simgrid_parse_lex_destroy();
67 /** @brief Add a host to the current NetZone */
68 void sg_platf_new_host_begin(const simgrid::kernel::routing::HostCreationArgs* args)
70 current_host = current_routing->create_host(args->id, args->speed_per_pstate)
71 ->set_coordinates(args->coord)
72 ->set_core_count(args->core_amount)
73 ->set_state_profile(args->state_trace)
74 ->set_speed_profile(args->speed_trace);
77 void sg_platf_new_host_set_properties(const std::unordered_map<std::string, std::string>& props)
79 xbt_assert(current_host, "Cannot set properties of the current host: none under construction");
80 current_host->set_properties(props);
83 void sg_platf_new_host_seal(int pstate)
85 xbt_assert(current_host, "Cannot seal the current Host: none under construction");
88 /* When energy plugin is activated, changing the pstate requires to already have the HostEnergy extension whose
89 * allocation is triggered by the on_creation signal. Then set_pstate must be called after the signal emission */
92 current_host->set_pstate(pstate);
94 current_host = nullptr;
97 void sg_platf_new_peer(const simgrid::kernel::routing::PeerCreationArgs* args)
99 auto* zone = dynamic_cast<simgrid::kernel::routing::VivaldiZone*>(current_routing);
100 xbt_assert(zone, "<peer> tag can only be used in Vivaldi netzones.");
102 const auto* peer = zone->create_host(args->id, {args->speed})
103 ->set_state_profile(args->state_trace)
104 ->set_speed_profile(args->speed_trace)
105 ->set_coordinates(args->coord)
108 zone->set_peer_link(peer->get_netpoint(), args->bw_in, args->bw_out);
111 /** @brief Add a "router" to the network element list */
112 simgrid::kernel::routing::NetPoint* sg_platf_new_router(const std::string& name, const std::string& coords)
114 auto* netpoint = current_routing->create_router(name)->set_coordinates(coords);
115 XBT_DEBUG("Router '%s' has the id %lu", netpoint->get_cname(), netpoint->id());
120 void sg_platf_new_link(const simgrid::kernel::routing::LinkCreationArgs* args)
122 simgrid::s4u::Link* link;
123 if (args->policy == simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX) {
124 link = current_routing->create_split_duplex_link(args->id, args->bandwidths);
126 link = current_routing->create_link(args->id, args->bandwidths);
127 link->get_impl()->set_sharing_policy(args->policy, {});
130 link->set_properties(args->properties)
131 ->set_state_profile(args->state_trace)
132 ->set_latency_profile(args->latency_trace)
133 ->set_bandwidth_profile(args->bandwidth_trace)
134 ->set_latency(args->latency);
139 void sg_platf_new_disk(const simgrid::kernel::routing::DiskCreationArgs* disk)
141 const simgrid::s4u::Disk* new_disk = current_routing->create_disk(disk->id, disk->read_bw, disk->write_bw)
142 ->set_host(current_host)
143 ->set_properties(disk->properties)
146 current_host->add_disk(new_disk);
149 /*************************************************************************************************/
150 /** @brief Auxiliary function to create hosts */
151 static std::pair<simgrid::kernel::routing::NetPoint*, simgrid::kernel::routing::NetPoint*>
152 sg_platf_cluster_create_host(const simgrid::kernel::routing::ClusterCreationArgs* cluster, simgrid::s4u::NetZone* zone,
153 const std::vector<unsigned long>& /*coord*/, unsigned long id)
155 xbt_assert(static_cast<unsigned long>(id) < cluster->radicals.size(),
156 "Zone(%s): error when creating host number %lu in the zone. Insufficient number of radicals available "
157 "(total = %zu). Check the 'radical' parameter in XML",
158 cluster->id.c_str(), id, cluster->radicals.size());
160 std::string host_id = cluster->prefix + std::to_string(cluster->radicals[id]) + cluster->suffix;
161 XBT_DEBUG("Cluster: creating host=%s speed=%f", host_id.c_str(), cluster->speeds.front());
162 const simgrid::s4u::Host* host = zone->create_host(host_id, cluster->speeds)
163 ->set_core_count(cluster->core_amount)
164 ->set_properties(cluster->properties)
166 return std::make_pair(host->get_netpoint(), nullptr);
169 /** @brief Auxiliary function to create loopback links */
170 static simgrid::s4u::Link*
171 sg_platf_cluster_create_loopback(const simgrid::kernel::routing::ClusterCreationArgs* cluster,
172 simgrid::s4u::NetZone* zone, const std::vector<unsigned long>& /*coord*/,
175 xbt_assert(static_cast<unsigned long>(id) < cluster->radicals.size(),
176 "Zone(%s): error when creating loopback for host number %lu in the zone. Insufficient number of "
177 "radicals available "
178 "(total = %zu). Check the 'radical' parameter in XML",
179 cluster->id.c_str(), id, cluster->radicals.size());
181 std::string link_id = cluster->id + "_link_" + std::to_string(cluster->radicals[id]) + "_loopback";
182 XBT_DEBUG("Cluster: creating loopback link=%s bw=%f", link_id.c_str(), cluster->loopback_bw);
184 simgrid::s4u::Link* loopback = zone->create_link(link_id, cluster->loopback_bw)
185 ->set_sharing_policy(simgrid::s4u::Link::SharingPolicy::FATPIPE)
186 ->set_latency(cluster->loopback_lat)
191 /** @brief Auxiliary function to create limiter links */
192 static simgrid::s4u::Link* sg_platf_cluster_create_limiter(const simgrid::kernel::routing::ClusterCreationArgs* cluster,
193 simgrid::s4u::NetZone* zone,
194 const std::vector<unsigned long>& /*coord*/,
197 std::string link_id = cluster->id + "_link_" + std::to_string(id) + "_limiter";
198 XBT_DEBUG("Cluster: creating limiter link=%s bw=%f", link_id.c_str(), cluster->limiter_link);
200 simgrid::s4u::Link* limiter = zone->create_link(link_id, cluster->limiter_link)->seal();
204 /** @brief Create Torus, Fat-Tree and Dragonfly clusters */
205 static void sg_platf_new_cluster_hierarchical(const simgrid::kernel::routing::ClusterCreationArgs* cluster)
207 using namespace std::placeholders;
208 using simgrid::kernel::routing::DragonflyZone;
209 using simgrid::kernel::routing::FatTreeZone;
210 using simgrid::kernel::routing::TorusZone;
212 auto set_host = std::bind(sg_platf_cluster_create_host, cluster, _1, _2, _3);
213 std::function<simgrid::s4u::ClusterCallbacks::ClusterLinkCb> set_loopback{};
214 std::function<simgrid::s4u::ClusterCallbacks::ClusterLinkCb> set_limiter{};
216 if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
217 set_loopback = std::bind(sg_platf_cluster_create_loopback, cluster, _1, _2, _3);
220 if (cluster->limiter_link > 0) {
221 set_limiter = std::bind(sg_platf_cluster_create_limiter, cluster, _1, _2, _3);
224 simgrid::s4u::NetZone const* parent = current_routing ? current_routing->get_iface() : nullptr;
225 switch (cluster->topology) {
226 case simgrid::kernel::routing::ClusterTopology::TORUS:
227 simgrid::s4u::create_torus_zone(cluster->id, parent, TorusZone::parse_topo_parameters(cluster->topo_parameters),
228 {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat,
229 cluster->sharing_policy);
231 case simgrid::kernel::routing::ClusterTopology::DRAGONFLY:
232 simgrid::s4u::create_dragonfly_zone(
233 cluster->id, parent, DragonflyZone::parse_topo_parameters(cluster->topo_parameters),
234 {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat, cluster->sharing_policy);
236 case simgrid::kernel::routing::ClusterTopology::FAT_TREE:
237 simgrid::s4u::create_fatTree_zone(
238 cluster->id, parent, FatTreeZone::parse_topo_parameters(cluster->topo_parameters),
239 {set_host, set_loopback, set_limiter}, cluster->bw, cluster->lat, cluster->sharing_policy);
246 /*************************************************************************************************/
247 /** @brief Create regular Cluster */
248 static void sg_platf_new_cluster_flat(simgrid::kernel::routing::ClusterCreationArgs* cluster)
250 auto* zone = simgrid::s4u::create_star_zone(cluster->id);
251 if (const auto* parent = current_routing ? current_routing->get_iface() : nullptr)
252 zone->set_parent(parent);
255 for (auto const& [key, value] : cluster->properties)
256 zone->set_property(key, value);
258 /* Make the backbone */
259 const simgrid::s4u::Link* backbone = nullptr;
260 if ((cluster->bb_bw > 0) || (cluster->bb_lat > 0)) {
261 std::string bb_name = cluster->id + "_backbone";
262 XBT_DEBUG("<link\tid=\"%s\" bw=\"%f\" lat=\"%f\"/> <!--backbone -->", bb_name.c_str(), cluster->bb_bw,
265 backbone = zone->create_link(bb_name, cluster->bb_bw)
266 ->set_sharing_policy(cluster->bb_sharing_policy)
267 ->set_latency(cluster->bb_lat)
271 for (int const& i : cluster->radicals) {
272 std::string host_id = cluster->prefix + std::to_string(i) + cluster->suffix;
274 XBT_DEBUG("<host\tid=\"%s\"\tspeed=\"%f\">", host_id.c_str(), cluster->speeds.front());
275 const auto* host = zone->create_host(host_id, cluster->speeds)
276 ->set_core_count(cluster->core_amount)
277 ->set_properties(cluster->properties)
280 XBT_DEBUG("</host>");
282 std::string link_id = cluster->id + "_link_" + std::to_string(i);
283 XBT_DEBUG("<link\tid=\"%s\"\tbw=\"%f\"\tlat=\"%f\"/>", link_id.c_str(), cluster->bw, cluster->lat);
285 // add a loopback link
286 if (cluster->loopback_bw > 0 || cluster->loopback_lat > 0) {
287 std::string loopback_name = link_id + "_loopback";
288 XBT_DEBUG("<loopback\tid=\"%s\"\tbw=\"%f\"/>", loopback_name.c_str(), cluster->loopback_bw);
290 const auto* loopback = zone->create_link(loopback_name, cluster->loopback_bw)
291 ->set_sharing_policy(simgrid::s4u::Link::SharingPolicy::FATPIPE)
292 ->set_latency(cluster->loopback_lat)
295 zone->add_route(host->get_netpoint(), host->get_netpoint(), nullptr, nullptr,
296 {simgrid::s4u::LinkInRoute(loopback)});
299 // add a limiter link (shared link to account for maximal bandwidth of the node)
300 const simgrid::s4u::Link* limiter = nullptr;
301 if (cluster->limiter_link > 0) {
302 std::string limiter_name = link_id + "_limiter";
303 XBT_DEBUG("<limiter\tid=\"%s\"\tbw=\"%f\"/>", limiter_name.c_str(), cluster->limiter_link);
305 limiter = zone->create_link(limiter_name, cluster->limiter_link)->seal();
309 const simgrid::s4u::Link* link;
310 if (cluster->sharing_policy == simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX) {
311 link = zone->create_split_duplex_link(link_id, cluster->bw)->set_latency(cluster->lat)->seal();
313 link = zone->create_link(link_id, cluster->bw)->set_latency(cluster->lat)->seal();
317 std::vector<simgrid::s4u::LinkInRoute> links;
319 links.emplace_back(limiter);
320 links.emplace_back(link, simgrid::s4u::LinkInRoute::Direction::UP);
322 links.emplace_back(backbone);
324 zone->add_route(host->get_netpoint(), nullptr, nullptr, nullptr, links, true);
329 XBT_DEBUG("<router id=\"%s\"/>", cluster->router_id.c_str());
330 if (cluster->router_id.empty())
331 cluster->router_id = cluster->prefix + cluster->id + "_router" + cluster->suffix;
332 auto* router = zone->create_router(cluster->router_id);
333 zone->add_route(router, nullptr, nullptr, nullptr, {});
335 simgrid::kernel::routing::on_cluster_creation(*cluster);
338 void sg_platf_new_tag_cluster(simgrid::kernel::routing::ClusterCreationArgs* cluster)
340 switch (cluster->topology) {
341 case simgrid::kernel::routing::ClusterTopology::TORUS:
342 case simgrid::kernel::routing::ClusterTopology::DRAGONFLY:
343 case simgrid::kernel::routing::ClusterTopology::FAT_TREE:
344 sg_platf_new_cluster_hierarchical(cluster);
347 sg_platf_new_cluster_flat(cluster);
351 /*************************************************************************************************/
352 /** @brief Set the links for internal node inside a Cluster(Star) */
353 static void sg_platf_cluster_set_hostlink(simgrid::kernel::routing::StarZone* zone,
354 simgrid::kernel::routing::NetPoint* netpoint,
355 const simgrid::s4u::Link* link_up, const simgrid::s4u::Link* link_down,
356 const simgrid::s4u::Link* backbone)
358 XBT_DEBUG("Push Host_link for host '%s' to position %lu", netpoint->get_cname(), netpoint->id());
359 simgrid::s4u::LinkInRoute linkUp{link_up};
360 simgrid::s4u::LinkInRoute linkDown{link_down};
362 simgrid::s4u::LinkInRoute linkBB{backbone};
363 zone->add_route(netpoint, nullptr, nullptr, nullptr, {linkUp, linkBB}, false);
364 zone->add_route(nullptr, netpoint, nullptr, nullptr, {linkBB, linkDown}, false);
366 zone->add_route(netpoint, nullptr, nullptr, nullptr, {linkUp}, false);
367 zone->add_route(nullptr, netpoint, nullptr, nullptr, {linkDown}, false);
371 /** @brief Add a link connecting a host to the rest of its StarZone */
372 static void sg_platf_build_hostlink(simgrid::kernel::routing::StarZone* zone,
373 const simgrid::kernel::routing::HostLinkCreationArgs* hostlink,
374 const simgrid::s4u::Link* backbone)
376 const auto engine = simgrid::s4u::Engine::get_instance();
377 auto netpoint = engine->host_by_name(hostlink->id)->get_netpoint();
378 xbt_assert(netpoint, "Host '%s' not found!", hostlink->id.c_str());
380 const auto linkUp = engine->link_by_name_or_null(hostlink->link_up);
381 const auto linkDown = engine->link_by_name_or_null(hostlink->link_down);
383 xbt_assert(linkUp, "Link '%s' not found!", hostlink->link_up.c_str());
384 xbt_assert(linkDown, "Link '%s' not found!", hostlink->link_down.c_str());
385 sg_platf_cluster_set_hostlink(zone, netpoint, linkUp, linkDown, backbone);
388 /** @brief Create a cabinet (set of hosts) inside a Cluster(StarZone) */
389 static void sg_platf_build_cabinet(simgrid::kernel::routing::StarZone* zone,
390 const simgrid::kernel::routing::CabinetCreationArgs* args,
391 const simgrid::s4u::Link* backbone)
393 for (int const& radical : args->radicals) {
394 std::string id = args->prefix + std::to_string(radical) + args->suffix;
395 auto const* host = zone->create_host(id, {args->speed})->seal();
397 const auto* link_up = zone->create_link("link_" + id + "_UP", {args->bw})->set_latency(args->lat)->seal();
398 const auto* link_down = zone->create_link("link_" + id + "_DOWN", {args->bw})->set_latency(args->lat)->seal();
400 sg_platf_cluster_set_hostlink(zone, host->get_netpoint(), link_up, link_down, backbone);
404 static void sg_platf_zone_cluster_populate(const simgrid::kernel::routing::ClusterZoneCreationArgs* cluster)
406 auto* zone = dynamic_cast<simgrid::kernel::routing::StarZone*>(current_routing);
407 xbt_assert(zone, "Host_links are only valid for Cluster(Star)");
409 const simgrid::s4u::Link* backbone = nullptr;
410 /* create backbone */
411 if (cluster->backbone) {
412 sg_platf_new_link(cluster->backbone.get());
413 backbone = simgrid::s4u::Link::by_name(cluster->backbone->id);
416 /* create host_links for hosts */
417 for (auto const& hostlink : cluster->host_links) {
418 sg_platf_build_hostlink(zone, &hostlink, backbone);
421 /* create cabinets */
422 for (auto const& cabinet : cluster->cabinets) {
423 sg_platf_build_cabinet(zone, &cabinet, backbone);
427 void routing_cluster_add_backbone(std::unique_ptr<simgrid::kernel::routing::LinkCreationArgs> link)
429 zone_cluster.backbone = std::move(link);
432 void sg_platf_new_cabinet(const simgrid::kernel::routing::CabinetCreationArgs* args)
434 xbt_assert(args, "Invalid nullptr argument");
435 zone_cluster.cabinets.emplace_back(*args);
438 /*************************************************************************************************/
439 void sg_platf_new_route(simgrid::kernel::routing::RouteCreationArgs* route)
441 current_routing->add_route(route->src, route->dst, route->gw_src, route->gw_dst, route->link_list,
445 void sg_platf_new_bypass_route(simgrid::kernel::routing::RouteCreationArgs* route)
447 current_routing->add_bypass_route(route->src, route->dst, route->gw_src, route->gw_dst, route->link_list);
450 void sg_platf_new_actor(simgrid::kernel::routing::ActorCreationArgs* actor)
452 const auto* engine = simgrid::s4u::Engine::get_instance();
453 sg_host_t host = sg_host_by_name(actor->host);
455 // The requested host does not exist. Do a nice message to the user
456 std::string msg = std::string("Cannot create actor '") + actor->function + "': host '" + actor->host +
457 "' does not exist\nExisting hosts: '";
459 std::vector<simgrid::s4u::Host*> list = engine->get_all_hosts();
461 for (auto const& some_host : list) {
462 msg += some_host->get_name();
464 if (msg.length() > 1024) {
465 msg.pop_back(); // remove trailing quote
466 msg += "...(list truncated)......";
470 xbt_die("%s", msg.c_str());
472 const simgrid::kernel::actor::ActorCodeFactory& factory = engine->get_impl()->get_function(actor->function);
473 xbt_assert(factory, "Error while creating an actor from the XML file: Function '%s' not registered", actor->function);
475 double start_time = actor->start_time;
476 double kill_time = actor->kill_time;
477 bool auto_restart = actor->restart_on_failure;
479 std::string actor_name = actor->args[0];
480 simgrid::kernel::actor::ActorCode code = factory(std::move(actor->args));
482 auto* arg = new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, actor->properties,
483 auto_restart, /*daemon=*/false, /*restart_count=*/0);
485 host->get_impl()->add_actor_at_boot(arg);
487 if (start_time > simgrid::s4u::Engine::get_clock()) {
488 arg = new simgrid::kernel::actor::ProcessArg(actor_name, code, nullptr, host, kill_time, actor->properties,
489 auto_restart, /*daemon=*/false, /*restart_count=*/0);
491 XBT_DEBUG("Actor %s@%s will be started at time %f", arg->name.c_str(), arg->host->get_cname(), start_time);
492 simgrid::kernel::timer::Timer::set(start_time, [arg]() {
493 simgrid::kernel::actor::ActorImplPtr new_actor = simgrid::kernel::actor::ActorImpl::create(arg);
496 } else { // start_time <= simgrid::s4u::Engine::get_clock()
497 XBT_DEBUG("Starting actor %s(%s) right now", arg->name.c_str(), host->get_cname());
500 simgrid::kernel::actor::ActorImplPtr new_actor = simgrid::kernel::actor::ActorImpl::create(arg);
501 } catch (simgrid::HostFailureException const&) {
502 XBT_WARN("Starting actor %s(%s) failed because its host is turned off.", arg->name.c_str(), host->get_cname());
508 * @brief Auxiliary function to build the object NetZoneImpl
510 * Builds the objects, setting its parent properties and root netzone if needed
511 * @param zone the parameters defining the Zone to build.
512 * @return Pointer to recently created netzone
514 static simgrid::kernel::routing::NetZoneImpl*
515 sg_platf_create_zone(const simgrid::kernel::routing::ZoneCreationArgs* zone)
517 /* search the routing model */
518 const simgrid::s4u::NetZone* new_zone = nullptr;
520 if (strcasecmp(zone->routing.c_str(), "Cluster") == 0) {
521 new_zone = simgrid::s4u::create_star_zone(zone->id);
522 } else if (strcasecmp(zone->routing.c_str(), "Dijkstra") == 0) {
523 new_zone = simgrid::s4u::create_dijkstra_zone(zone->id, false);
524 } else if (strcasecmp(zone->routing.c_str(), "DijkstraCache") == 0) {
525 new_zone = simgrid::s4u::create_dijkstra_zone(zone->id, true);
526 } else if (strcasecmp(zone->routing.c_str(), "Floyd") == 0) {
527 new_zone = simgrid::s4u::create_floyd_zone(zone->id);
528 } else if (strcasecmp(zone->routing.c_str(), "Full") == 0) {
529 new_zone = simgrid::s4u::create_full_zone(zone->id);
530 } else if (strcasecmp(zone->routing.c_str(), "None") == 0) {
531 new_zone = simgrid::s4u::create_empty_zone(zone->id);
532 } else if (strcasecmp(zone->routing.c_str(), "Vivaldi") == 0) {
533 new_zone = simgrid::s4u::create_vivaldi_zone(zone->id);
534 } else if (strcasecmp(zone->routing.c_str(), "Wifi") == 0) {
535 new_zone = simgrid::s4u::create_wifi_zone(zone->id);
537 xbt_die("Not a valid model!");
540 simgrid::kernel::routing::NetZoneImpl* new_zone_impl = new_zone->get_impl();
541 new_zone_impl->set_parent(current_routing);
543 return new_zone_impl;
547 * @brief Add a Zone to the platform
549 * Add a new autonomous system to the platform. Any elements (such as host, router or sub-Zone) added after this call
550 * and before the corresponding call to sg_platf_new_zone_seal() will be added to this Zone.
552 * Once this function was called, the configuration concerning the used models cannot be changed anymore.
554 * @param zone the parameters defining the Zone to build.
556 simgrid::kernel::routing::NetZoneImpl* sg_platf_new_zone_begin(const simgrid::kernel::routing::ZoneCreationArgs* zone)
558 zone_cluster.routing = zone->routing;
559 current_routing = sg_platf_create_zone(zone);
561 return current_routing;
564 void sg_platf_new_zone_set_properties(const std::unordered_map<std::string, std::string>& props)
566 xbt_assert(current_routing, "Cannot set properties of the current Zone: none under construction");
568 current_routing->set_properties(props);
572 * @brief Specify that the description of the current Zone is finished
574 * Once you've declared all the content of your Zone, you have to seal
575 * it with this call. Your Zone is not usable until you call this function.
577 void sg_platf_new_zone_seal()
579 xbt_assert(current_routing, "Cannot seal the current Zone: none under construction");
580 if (strcasecmp(zone_cluster.routing.c_str(), "Cluster") == 0) {
581 sg_platf_zone_cluster_populate(&zone_cluster);
582 zone_cluster.routing = "";
583 zone_cluster.host_links.clear();
584 zone_cluster.cabinets.clear();
585 zone_cluster.backbone.reset();
587 current_routing = current_routing->get_parent();
590 /** @brief Add a link connecting a host to the rest of its Zone (which must be cluster or vivaldi) */
591 void sg_platf_new_hostlink(const simgrid::kernel::routing::HostLinkCreationArgs* hostlink)
593 xbt_assert(hostlink, "Invalid nullptr parameter");
594 zone_cluster.host_links.emplace_back(*hostlink);
597 void sg_platf_new_trace(const simgrid::kernel::routing::ProfileCreationArgs* args)
599 simgrid::kernel::profile::Profile* profile;
600 if (not args->file.empty()) {
601 profile = simgrid::kernel::profile::ProfileBuilder::from_file(args->file);
603 xbt_assert(not args->pc_data.empty(), "Trace '%s' must have either a content, or point to a file on disk.",
605 profile = simgrid::kernel::profile::ProfileBuilder::from_string(args->id, args->pc_data, args->periodicity);
607 traces_set_list.try_emplace(args->id, profile);