Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
b4afbd571126ec381e1125cfd6cc932d35b45292
[simgrid.git] / src / surf / sg_platf.cpp
1 /* Copyright (c) 2006-2017. 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/s4u/Engine.hpp"
7 #include "simgrid/s4u/Storage.hpp"
8
9 #include "src/kernel/EngineImpl.hpp"
10 #include "src/simix/smx_private.h"
11
12 #include "src/include/simgrid/sg_config.h"
13
14 #include "src/surf/HostImpl.hpp"
15 #include "src/surf/cpu_interface.hpp"
16 #include "src/surf/network_interface.hpp"
17
18 #include "src/kernel/routing/ClusterZone.hpp"
19 #include "src/kernel/routing/DijkstraZone.hpp"
20 #include "src/kernel/routing/DragonflyZone.hpp"
21 #include "src/kernel/routing/EmptyZone.hpp"
22 #include "src/kernel/routing/FatTreeZone.hpp"
23 #include "src/kernel/routing/FloydZone.hpp"
24 #include "src/kernel/routing/FullZone.hpp"
25 #include "src/kernel/routing/NetPoint.hpp"
26 #include "src/kernel/routing/NetZoneImpl.hpp"
27 #include "src/kernel/routing/TorusZone.hpp"
28 #include "src/kernel/routing/VivaldiZone.hpp"
29 #include <string>
30 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(surf_parse);
31
32 XBT_PRIVATE std::map<std::string, simgrid::surf::StorageImpl*> mount_list;
33 XBT_PRIVATE std::vector<std::string> known_storages;
34
35 namespace simgrid {
36 namespace surf {
37
38 simgrid::xbt::signal<void(ClusterCreationArgs*)> on_cluster;
39 }
40 }
41
42 // FIXME: The following duplicates the content of s4u::Host
43 namespace simgrid {
44 namespace s4u {
45 extern std::map<std::string, simgrid::s4u::Host*> host_list;
46 }
47 }
48
49 static int surf_parse_models_setup_already_called = 0;
50 std::map<std::string, simgrid::surf::StorageType*> storage_types;
51
52 /** The current AS in the parsing */
53 static simgrid::kernel::routing::NetZoneImpl* current_routing = nullptr;
54 static simgrid::kernel::routing::NetZoneImpl* routing_get_current()
55 {
56   return current_routing;
57 }
58
59 /** Module management function: creates all internal data structures */
60 void sg_platf_init()
61 { /* Do nothing: just for symmetry of user code */
62 }
63
64 /** Module management function: frees all internal data structures */
65 void sg_platf_exit() {
66   simgrid::surf::on_cluster.disconnect_all_slots();
67   simgrid::s4u::onPlatformCreated.disconnect_all_slots();
68
69   /* make sure that we will reinit the models while loading the platf once reinited */
70   surf_parse_models_setup_already_called = 0;
71   surf_parse_lex_destroy();
72 }
73
74 /** @brief Add an host to the current AS */
75 void sg_platf_new_host(sg_platf_host_cbarg_t args)
76 {
77   std::map<std::string, std::string> props;
78   if (args->properties) {
79     for (auto const& elm : *args->properties)
80       props.insert({elm.first, elm.second});
81     delete args->properties;
82   }
83
84   simgrid::s4u::Host* host =
85       routing_get_current()->createHost(args->id, &args->speed_per_pstate, args->core_amount, &props);
86
87   host->pimpl_->storage_ = mount_list;
88   mount_list.clear();
89
90   /* Change from the defaults */
91   if (args->state_trace)
92     host->pimpl_cpu->setStateTrace(args->state_trace);
93   if (args->speed_trace)
94     host->pimpl_cpu->setSpeedTrace(args->speed_trace);
95   if (args->pstate != 0)
96     host->pimpl_cpu->setPState(args->pstate);
97   if (args->coord && strcmp(args->coord, ""))
98     new simgrid::kernel::routing::vivaldi::Coords(host->pimpl_netpoint, args->coord);
99 }
100
101 /** @brief Add a "router" to the network element list */
102 simgrid::kernel::routing::NetPoint* sg_platf_new_router(std::string name, const char* coords)
103 {
104   simgrid::kernel::routing::NetZoneImpl* current_routing = routing_get_current();
105
106   if (current_routing->hierarchy_ == simgrid::kernel::routing::NetZoneImpl::RoutingMode::unset)
107     current_routing->hierarchy_ = simgrid::kernel::routing::NetZoneImpl::RoutingMode::base;
108   xbt_assert(nullptr == simgrid::s4u::Engine::getInstance()->getNetpointByNameOrNull(name),
109              "Refusing to create a router named '%s': this name already describes a node.", name.c_str());
110
111   simgrid::kernel::routing::NetPoint* netpoint =
112       new simgrid::kernel::routing::NetPoint(name, simgrid::kernel::routing::NetPoint::Type::Router, current_routing);
113   XBT_DEBUG("Router '%s' has the id %u", name.c_str(), netpoint->id());
114
115   if (coords && strcmp(coords, ""))
116     new simgrid::kernel::routing::vivaldi::Coords(netpoint, coords);
117
118
119   return netpoint;
120 }
121
122 void sg_platf_new_link(LinkCreationArgs* link)
123 {
124   std::vector<std::string> names;
125
126   if (link->policy == SURF_LINK_FULLDUPLEX) {
127     names.push_back(link->id+ "_UP");
128     names.push_back(link->id+ "_DOWN");
129   } else {
130     names.push_back(link->id);
131   }
132   for (auto const& link_name : names) {
133     simgrid::surf::LinkImpl* l =
134         surf_network_model->createLink(link_name, link->bandwidth, link->latency, link->policy);
135
136     if (link->properties) {
137       for (auto const& elm : *link->properties)
138         l->setProperty(elm.first, elm.second);
139     }
140
141     if (link->latency_trace)
142       l->setLatencyTrace(link->latency_trace);
143     if (link->bandwidth_trace)
144       l->setBandwidthTrace(link->bandwidth_trace);
145     if (link->state_trace)
146       l->setStateTrace(link->state_trace);
147   }
148   delete link->properties;
149 }
150
151 void sg_platf_new_cluster(ClusterCreationArgs* cluster)
152 {
153   using simgrid::kernel::routing::ClusterZone;
154   using simgrid::kernel::routing::DragonflyZone;
155   using simgrid::kernel::routing::FatTreeZone;
156   using simgrid::kernel::routing::TorusZone;
157
158   int rankId=0;
159
160   // What an inventive way of initializing the AS that I have as ancestor :-(
161   ZoneCreationArgs zone;
162   zone.id = cluster->id;
163   switch (cluster->topology) {
164   case SURF_CLUSTER_TORUS:
165     zone.routing = A_surfxml_AS_routing_ClusterTorus;
166     break;
167   case SURF_CLUSTER_DRAGONFLY:
168     zone.routing = A_surfxml_AS_routing_ClusterDragonfly;
169     break;
170   case SURF_CLUSTER_FAT_TREE:
171     zone.routing = A_surfxml_AS_routing_ClusterFatTree;
172     break;
173   default:
174     zone.routing = A_surfxml_AS_routing_Cluster;
175     break;
176   }
177   sg_platf_new_Zone_begin(&zone);
178   simgrid::kernel::routing::ClusterZone* current_as = static_cast<ClusterZone*>(routing_get_current());
179   current_as->parse_specific_arguments(cluster);
180
181   if(cluster->loopback_bw > 0 || cluster->loopback_lat > 0){
182     current_as->linkCountPerNode_++;
183     current_as->hasLoopback_ = true;
184   }
185
186   if(cluster->limiter_link > 0){
187     current_as->linkCountPerNode_++;
188     current_as->hasLimiter_ = true;
189   }
190
191   for (int const& i : *cluster->radicals) {
192     std::string host_id = std::string(cluster->prefix) + std::to_string(i) + cluster->suffix;
193     std::string link_id = std::string(cluster->id) + "_link_" + std::to_string(i);
194
195     XBT_DEBUG("<host\tid=\"%s\"\tpower=\"%f\">", host_id.c_str(), cluster->speeds.front());
196
197     s_sg_platf_host_cbarg_t host;
198     memset(&host, 0, sizeof(host));
199     host.id = host_id.c_str();
200     if ((cluster->properties != nullptr) && (not cluster->properties->empty())) {
201       host.properties = new std::map<std::string, std::string>;
202
203       for (auto const& elm : *cluster->properties)
204         host.properties->insert({elm.first, elm.second});
205     }
206
207     host.speed_per_pstate = cluster->speeds;
208     host.pstate = 0;
209     host.core_amount = cluster->core_amount;
210     host.coord = "";
211     sg_platf_new_host(&host);
212     XBT_DEBUG("</host>");
213
214     XBT_DEBUG("<link\tid=\"%s\"\tbw=\"%f\"\tlat=\"%f\"/>", link_id.c_str(), cluster->bw, cluster->lat);
215
216     // All links are saved in a matrix;
217     // every row describes a single node; every node may have multiple links.
218     // the first column may store a link from x to x if p_has_loopback is set
219     // the second column may store a limiter link if p_has_limiter is set
220     // other columns are to store one or more link for the node
221
222     //add a loopback link
223     simgrid::surf::LinkImpl* linkUp   = nullptr;
224     simgrid::surf::LinkImpl* linkDown = nullptr;
225     if(cluster->loopback_bw > 0 || cluster->loopback_lat > 0){
226       std::string tmp_link = link_id + "_loopback";
227       XBT_DEBUG("<loopback\tid=\"%s\"\tbw=\"%f\"/>", tmp_link.c_str(), cluster->loopback_bw);
228
229       LinkCreationArgs link;
230       link.id        = tmp_link;
231       link.bandwidth = cluster->loopback_bw;
232       link.latency   = cluster->loopback_lat;
233       link.policy    = SURF_LINK_FATPIPE;
234       sg_platf_new_link(&link);
235       linkUp   = simgrid::surf::LinkImpl::byName(tmp_link);
236       linkDown = simgrid::surf::LinkImpl::byName(tmp_link);
237
238       auto as_cluster = static_cast<ClusterZone*>(current_as);
239       as_cluster->privateLinks_.insert({rankId * as_cluster->linkCountPerNode_, {linkUp, linkDown}});
240     }
241
242     //add a limiter link (shared link to account for maximal bandwidth of the node)
243     linkUp   = nullptr;
244     linkDown = nullptr;
245     if(cluster->limiter_link > 0){
246       std::string tmp_link = std::string(link_id) + "_limiter";
247       XBT_DEBUG("<limiter\tid=\"%s\"\tbw=\"%f\"/>", tmp_link.c_str(), cluster->limiter_link);
248
249       LinkCreationArgs link;
250       link.id        = tmp_link;
251       link.bandwidth = cluster->limiter_link;
252       link.latency = 0;
253       link.policy = SURF_LINK_SHARED;
254       sg_platf_new_link(&link);
255       linkDown = simgrid::surf::LinkImpl::byName(tmp_link);
256       linkUp   = linkDown;
257       current_as->privateLinks_.insert(
258           {rankId * current_as->linkCountPerNode_ + (current_as->hasLoopback_ ? 1 : 0), {linkUp, linkDown}});
259     }
260
261     //call the cluster function that adds the others links
262     if (cluster->topology == SURF_CLUSTER_FAT_TREE) {
263       static_cast<FatTreeZone*>(current_as)->addProcessingNode(i);
264     } else {
265       current_as->create_links_for_node(cluster, i, rankId, rankId * current_as->linkCountPerNode_ +
266                                                                 (current_as->hasLoopback_ ? 1 : 0) +
267                                                                 (current_as->hasLimiter_ ? 1 : 0));
268     }
269     rankId++;
270   }
271   delete cluster->properties;
272
273   // Add a router.
274   XBT_DEBUG(" ");
275   XBT_DEBUG("<router id=\"%s\"/>", cluster->router_id.c_str());
276   if (cluster->router_id.empty()) {
277     std::string newid   = std::string(cluster->prefix) + cluster->id + "_router" + cluster->suffix;
278     current_as->router_ = sg_platf_new_router(newid, NULL);
279   } else {
280     current_as->router_ = sg_platf_new_router(cluster->router_id, NULL);
281   }
282
283   //Make the backbone
284   if ((cluster->bb_bw > 0) || (cluster->bb_lat > 0)) {
285
286     LinkCreationArgs link;
287     link.id        = std::string(cluster->id)+ "_backbone";
288     link.bandwidth = cluster->bb_bw;
289     link.latency   = cluster->bb_lat;
290     link.policy    = cluster->bb_sharing_policy;
291
292     XBT_DEBUG("<link\tid=\"%s\" bw=\"%f\" lat=\"%f\"/>", link.id.c_str(), cluster->bb_bw, cluster->bb_lat);
293     sg_platf_new_link(&link);
294
295     routing_cluster_add_backbone(simgrid::surf::LinkImpl::byName(link.id));
296   }
297
298   XBT_DEBUG("</AS>");
299   sg_platf_new_Zone_seal();
300
301   simgrid::surf::on_cluster(cluster);
302   delete cluster->radicals;
303 }
304
305 void routing_cluster_add_backbone(simgrid::surf::LinkImpl* bb)
306 {
307   simgrid::kernel::routing::ClusterZone* cluster =
308       dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
309
310   xbt_assert(cluster, "Only hosts from Cluster can get a backbone.");
311   xbt_assert(nullptr == cluster->backbone_, "Cluster %s already has a backbone link!", cluster->getCname());
312
313   cluster->backbone_ = bb;
314   XBT_DEBUG("Add a backbone to AS '%s'", current_routing->getCname());
315 }
316
317 void sg_platf_new_cabinet(CabinetCreationArgs* cabinet)
318 {
319   for (int const& radical : *cabinet->radicals) {
320     std::string hostname = cabinet->prefix + std::to_string(radical) + cabinet->suffix;
321     s_sg_platf_host_cbarg_t host;
322     memset(&host, 0, sizeof(host));
323     host.pstate           = 0;
324     host.core_amount      = 1;
325     host.id               = hostname.c_str();
326     host.speed_per_pstate.push_back(cabinet->speed);
327     sg_platf_new_host(&host);
328
329     LinkCreationArgs link;
330     link.policy    = SURF_LINK_FULLDUPLEX;
331     link.latency   = cabinet->lat;
332     link.bandwidth = cabinet->bw;
333     link.id        = "link_" + hostname;
334     sg_platf_new_link(&link);
335
336     HostLinkCreationArgs host_link;
337     host_link.id        = hostname;
338     host_link.link_up   = std::string("link_") + hostname + "_UP";
339     host_link.link_down = std::string("link_") + hostname + "_DOWN";
340     sg_platf_new_hostlink(&host_link);
341   }
342   delete cabinet->radicals;
343 }
344
345 void sg_platf_new_storage(StorageCreationArgs* storage)
346 {
347   xbt_assert(std::find(known_storages.begin(), known_storages.end(), storage->id) == known_storages.end(),
348              "Refusing to add a second storage named \"%s\"", storage->id.c_str());
349
350   simgrid::surf::StorageType* stype;
351   auto st = storage_types.find(storage->type_id);
352   if (st != storage_types.end()) {
353     stype = st->second;
354   } else {
355     xbt_die("No storage type '%s'", storage->type_id.c_str());
356   }
357
358   XBT_DEBUG("ROUTING Create a storage name '%s' with type_id '%s' and content '%s'", storage->id.c_str(),
359             storage->type_id.c_str(), storage->content.c_str());
360
361   known_storages.push_back(storage->id);
362
363   // if storage content is not specified use the content of storage_type if any
364   if (storage->content.empty() && not stype->content.empty()) {
365     storage->content = stype->content;
366     XBT_DEBUG("For disk '%s' content is empty, inherit the content (of type %s)", storage->id.c_str(),
367               stype->id.c_str());
368   }
369
370   XBT_DEBUG("SURF storage create resource\n\t\tid '%s'\n\t\ttype '%s' "
371             "\n\t\tmodel '%s' \n\t\tcontent '%s' "
372             "\n\t\tproperties '%p''\n",
373             storage->id.c_str(), stype->model.c_str(), stype->id.c_str(), storage->content.c_str(),
374             storage->properties);
375
376   auto s = surf_storage_model->createStorage(storage->id, stype->id, storage->content, storage->attach);
377
378   if (storage->properties) {
379     for (auto const& elm : *storage->properties)
380       s->setProperty(elm.first, elm.second);
381     delete storage->properties;
382   }
383 }
384
385 void sg_platf_new_storage_type(StorageTypeCreationArgs* storage_type)
386 {
387   xbt_assert(storage_types.find(storage_type->id) == storage_types.end(),
388              "Reading a storage type, processing unit \"%s\" already exists", storage_type->id.c_str());
389
390   simgrid::surf::StorageType* stype =
391       new simgrid::surf::StorageType(storage_type->id, storage_type->model, storage_type->content,
392                                      storage_type->properties, storage_type->model_properties, storage_type->size);
393
394   XBT_DEBUG("Create a storage type id '%s' with model '%s', content '%s'", storage_type->id.c_str(),
395             storage_type->model.c_str(), storage_type->content.c_str());
396
397   storage_types[storage_type->id] = stype;
398 }
399
400 void sg_platf_new_mount(MountCreationArgs* mount)
401 {
402   xbt_assert(std::find(known_storages.begin(), known_storages.end(), mount->storageId) != known_storages.end(),
403              "Cannot mount non-existent disk \"%s\"", mount->storageId.c_str());
404
405   XBT_DEBUG("Mount '%s' on '%s'", mount->storageId.c_str(), mount->name.c_str());
406
407   if (mount_list.empty())
408     XBT_DEBUG("Create a Mount list for %s", A_surfxml_host_id);
409   mount_list.insert({mount->name, simgrid::surf::StorageImpl::byName(mount->storageId.c_str())});
410 }
411
412 void sg_platf_new_route(sg_platf_route_cbarg_t route)
413 {
414   routing_get_current()->addRoute(route);
415 }
416
417 void sg_platf_new_bypassRoute(sg_platf_route_cbarg_t bypassRoute)
418 {
419   routing_get_current()->addBypassRoute(bypassRoute);
420 }
421
422 void sg_platf_new_process(sg_platf_process_cbarg_t process)
423 {
424   sg_host_t host = sg_host_by_name(process->host);
425   if (not host) {
426     // The requested host does not exist. Do a nice message to the user
427     std::string msg = std::string("Cannot create process '") + process->function + "': host '" + process->host +
428                       "' does not exist\nExisting hosts: '";
429     for (auto const& kv : simgrid::s4u::host_list) {
430       simgrid::s4u::Host* host = kv.second;
431       msg += host->getName();
432       msg += "', '";
433       if (msg.length() > 1024) {
434         msg.pop_back(); // remove trailing quote
435         msg += "...(list truncated)......";
436         break;
437       }
438     }
439     xbt_die("%s", msg.c_str());
440   }
441   simgrid::simix::ActorCodeFactory& factory = SIMIX_get_actor_code_factory(process->function);
442   xbt_assert(factory, "Function '%s' unknown", process->function);
443
444   double start_time = process->start_time;
445   double kill_time  = process->kill_time;
446   int auto_restart = process->on_failure == SURF_ACTOR_ON_FAILURE_DIE ? 0 : 1;
447
448   std::vector<std::string> args(process->argv, process->argv + process->argc);
449   std::function<void()> code = factory(std::move(args));
450   std::shared_ptr<std::map<std::string, std::string>> properties(process->properties);
451
452   smx_process_arg_t arg = nullptr;
453
454   arg = new simgrid::simix::ProcessArg();
455   arg->name = std::string(process->argv[0]);
456   arg->code = code;
457   arg->data = nullptr;
458   arg->host = host;
459   arg->kill_time = kill_time;
460   arg->properties = properties;
461
462   host->extension<simgrid::simix::Host>()->boot_processes.push_back(arg);
463
464   if (start_time > SIMIX_get_clock()) {
465
466     arg = new simgrid::simix::ProcessArg();
467     arg->name = std::string(process->argv[0]);
468     arg->code = std::move(code);
469     arg->data = nullptr;
470     arg->host = host;
471     arg->kill_time = kill_time;
472     arg->properties = properties;
473
474     XBT_DEBUG("Process %s@%s will be started at time %f", arg->name.c_str(), arg->host->getCname(), start_time);
475     SIMIX_timer_set(start_time, [arg, auto_restart]() {
476       smx_actor_t actor = simix_global->create_process_function(arg->name.c_str(), std::move(arg->code), arg->data,
477                                                                 arg->host, arg->properties.get(), nullptr);
478       if (arg->kill_time >= 0)
479         simcall_process_set_kill_time(actor, arg->kill_time);
480       if (auto_restart)
481         SIMIX_process_auto_restart_set(actor, auto_restart);
482       delete arg;
483     });
484   } else {                      // start_time <= SIMIX_get_clock()
485     XBT_DEBUG("Starting Process %s(%s) right now", arg->name.c_str(), host->getCname());
486
487     smx_actor_t actor = simix_global->create_process_function(arg->name.c_str(), std::move(code), nullptr, host,
488                                                               arg->properties.get(), nullptr);
489
490     /* The actor creation will fail if the host is currently dead, but that's fine */
491     if (actor != nullptr) {
492       if (arg->kill_time >= 0)
493         simcall_process_set_kill_time(actor, arg->kill_time);
494       if (auto_restart)
495         SIMIX_process_auto_restart_set(actor, auto_restart);
496     }
497   }
498 }
499
500 void sg_platf_new_peer(PeerCreationArgs* peer)
501 {
502   simgrid::kernel::routing::VivaldiZone* as = dynamic_cast<simgrid::kernel::routing::VivaldiZone*>(current_routing);
503   xbt_assert(as, "<peer> tag can only be used in Vivaldi netzones.");
504
505   std::vector<double> speedPerPstate;
506   speedPerPstate.push_back(peer->speed);
507   simgrid::s4u::Host* host = as->createHost(peer->id.c_str(), &speedPerPstate, 1, nullptr);
508
509   as->setPeerLink(host->pimpl_netpoint, peer->bw_in, peer->bw_out, peer->coord);
510
511   /* Change from the defaults */
512   if (peer->state_trace)
513     host->pimpl_cpu->setStateTrace(peer->state_trace);
514   if (peer->speed_trace)
515     host->pimpl_cpu->setSpeedTrace(peer->speed_trace);
516 }
517
518 void sg_platf_begin() { /* Do nothing: just for symmetry of user code */ }
519
520 void sg_platf_end() {
521   simgrid::s4u::onPlatformCreated();
522 }
523
524 /* Pick the right models for CPU, net and host, and call their model_init_preparse */
525 static void surf_config_models_setup()
526 {
527   const char* host_model_name    = xbt_cfg_get_string("host/model");
528   const char* network_model_name = xbt_cfg_get_string("network/model");
529   const char* cpu_model_name     = xbt_cfg_get_string("cpu/model");
530   const char* storage_model_name = xbt_cfg_get_string("storage/model");
531
532   /* The compound host model is needed when using non-default net/cpu models */
533   if ((not xbt_cfg_is_default_value("network/model") || not xbt_cfg_is_default_value("cpu/model")) &&
534       xbt_cfg_is_default_value("host/model")) {
535     host_model_name = "compound";
536     xbt_cfg_set_string("host/model", host_model_name);
537   }
538
539   XBT_DEBUG("host model: %s", host_model_name);
540   if (not strcmp(host_model_name, "compound")) {
541     xbt_assert(cpu_model_name, "Set a cpu model to use with the 'compound' host model");
542     xbt_assert(network_model_name, "Set a network model to use with the 'compound' host model");
543
544     int cpu_id = find_model_description(surf_cpu_model_description, cpu_model_name);
545     surf_cpu_model_description[cpu_id].model_init_preparse();
546
547     int network_id = find_model_description(surf_network_model_description, network_model_name);
548     surf_network_model_description[network_id].model_init_preparse();
549   }
550
551   XBT_DEBUG("Call host_model_init");
552   int host_id = find_model_description(surf_host_model_description, host_model_name);
553   surf_host_model_description[host_id].model_init_preparse();
554
555   XBT_DEBUG("Call vm_model_init");
556   surf_vm_model_init_HL13();
557
558   XBT_DEBUG("Call storage_model_init");
559   int storage_id = find_model_description(surf_storage_model_description, storage_model_name);
560   surf_storage_model_description[storage_id].model_init_preparse();
561 }
562
563 /**
564  * \brief Add a Zone to the platform
565  *
566  * Add a new autonomous system to the platform. Any elements (such as host, router or sub-Zone) added after this call
567  * and before the corresponding call to sg_platf_new_Zone_seal() will be added to this Zone.
568  *
569  * Once this function was called, the configuration concerning the used models cannot be changed anymore.
570  *
571  * @param zone the parameters defining the Zone to build.
572  */
573 simgrid::s4u::NetZone* sg_platf_new_Zone_begin(ZoneCreationArgs* zone)
574 {
575   if (not surf_parse_models_setup_already_called) {
576     /* Initialize the surf models. That must be done after we got all config, and before we need the models.
577      * That is, after the last <config> tag, if any, and before the first of cluster|peer|AS|trace|trace_connect
578      *
579      * I'm not sure for <trace> and <trace_connect>, there may be a bug here
580      * (FIXME: check it out by creating a file beginning with one of these tags)
581      * but cluster and peer create ASes internally, so putting the code in there is ok.
582      */
583     surf_parse_models_setup_already_called = 1;
584     surf_config_models_setup();
585   }
586
587   _sg_cfg_init_status = 2; /* HACK: direct access to the global controlling the level of configuration to prevent
588                             * any further config now that we created some real content */
589
590   /* search the routing model */
591   simgrid::kernel::routing::NetZoneImpl* new_zone = nullptr;
592   switch (zone->routing) {
593     case A_surfxml_AS_routing_Cluster:
594       new_zone = new simgrid::kernel::routing::ClusterZone(current_routing, zone->id);
595       break;
596     case A_surfxml_AS_routing_ClusterDragonfly:
597       new_zone = new simgrid::kernel::routing::DragonflyZone(current_routing, zone->id);
598       break;
599     case A_surfxml_AS_routing_ClusterTorus:
600       new_zone = new simgrid::kernel::routing::TorusZone(current_routing, zone->id);
601       break;
602     case A_surfxml_AS_routing_ClusterFatTree:
603       new_zone = new simgrid::kernel::routing::FatTreeZone(current_routing, zone->id);
604       break;
605     case A_surfxml_AS_routing_Dijkstra:
606       new_zone = new simgrid::kernel::routing::DijkstraZone(current_routing, zone->id, 0);
607       break;
608     case A_surfxml_AS_routing_DijkstraCache:
609       new_zone = new simgrid::kernel::routing::DijkstraZone(current_routing, zone->id, 1);
610       break;
611     case A_surfxml_AS_routing_Floyd:
612       new_zone = new simgrid::kernel::routing::FloydZone(current_routing, zone->id);
613       break;
614     case A_surfxml_AS_routing_Full:
615       new_zone = new simgrid::kernel::routing::FullZone(current_routing, zone->id);
616       break;
617     case A_surfxml_AS_routing_None:
618       new_zone = new simgrid::kernel::routing::EmptyZone(current_routing, zone->id);
619       break;
620     case A_surfxml_AS_routing_Vivaldi:
621       new_zone = new simgrid::kernel::routing::VivaldiZone(current_routing, zone->id);
622       break;
623     default:
624       xbt_die("Not a valid model!");
625       break;
626   }
627
628   if (current_routing == nullptr) { /* it is the first one */
629     xbt_assert(simgrid::s4u::Engine::getInstance()->pimpl->netRoot_ == nullptr,
630                "All defined components must belong to a networking zone.");
631     simgrid::s4u::Engine::getInstance()->pimpl->netRoot_ = new_zone;
632
633   } else {
634     /* set the father behavior */
635     if (current_routing->hierarchy_ == simgrid::kernel::routing::NetZoneImpl::RoutingMode::unset)
636       current_routing->hierarchy_ = simgrid::kernel::routing::NetZoneImpl::RoutingMode::recursive;
637     /* add to the sons dictionary */
638     current_routing->getChildren()->push_back(static_cast<simgrid::s4u::NetZone*>(new_zone));
639   }
640
641   /* set the new current component of the tree */
642   current_routing = new_zone;
643
644   simgrid::s4u::NetZone::onCreation(*new_zone); // notify the signal
645
646   return new_zone;
647 }
648
649 /**
650  * \brief Specify that the description of the current AS is finished
651  *
652  * Once you've declared all the content of your AS, you have to seal
653  * it with this call. Your AS is not usable until you call this function.
654  */
655 void sg_platf_new_Zone_seal()
656 {
657   xbt_assert(current_routing, "Cannot seal the current AS: none under construction");
658   current_routing->seal();
659   simgrid::s4u::NetZone::onSeal(*current_routing);
660   current_routing = static_cast<simgrid::kernel::routing::NetZoneImpl*>(current_routing->getFather());
661 }
662
663 /** @brief Add a link connecting an host to the rest of its AS (which must be cluster or vivaldi) */
664 void sg_platf_new_hostlink(HostLinkCreationArgs* hostlink)
665 {
666   simgrid::kernel::routing::NetPoint* netpoint = sg_host_by_name(hostlink->id.c_str())->pimpl_netpoint;
667   xbt_assert(netpoint, "Host '%s' not found!", hostlink->id.c_str());
668   xbt_assert(dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing),
669              "Only hosts from Cluster and Vivaldi ASes can get an host_link.");
670
671   simgrid::surf::LinkImpl* linkUp   = simgrid::surf::LinkImpl::byName(hostlink->link_up);
672   simgrid::surf::LinkImpl* linkDown = simgrid::surf::LinkImpl::byName(hostlink->link_down);
673
674   xbt_assert(linkUp, "Link '%s' not found!", hostlink->link_up.c_str());
675   xbt_assert(linkDown, "Link '%s' not found!", hostlink->link_down.c_str());
676
677   auto as_cluster = static_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
678
679   if (as_cluster->privateLinks_.find(netpoint->id()) != as_cluster->privateLinks_.end())
680     surf_parse_error(std::string("Host_link for '") + hostlink->id.c_str() + "' is already defined!");
681
682   XBT_DEBUG("Push Host_link for host '%s' to position %u", netpoint->cname(), netpoint->id());
683   as_cluster->privateLinks_.insert({netpoint->id(), {linkUp, linkDown}});
684 }
685
686 void sg_platf_new_trace(TraceCreationArgs* trace)
687 {
688   tmgr_trace_t tmgr_trace;
689   if (not trace->file.empty()) {
690     tmgr_trace = tmgr_trace_new_from_file(trace->file);
691   } else {
692     xbt_assert(not trace->pc_data.empty(), "Trace '%s' must have either a content, or point to a file on disk.",
693                trace->id.c_str());
694     tmgr_trace = tmgr_trace_new_from_string(trace->id, trace->pc_data, trace->periodicity);
695   }
696   traces_set_list.insert({trace->id, tmgr_trace});
697 }