Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
234920087c746956b1e532bd3b38a07631269029
[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_ = 1;
184   }
185
186   if(cluster->limiter_link > 0){
187     current_as->linkCountPerNode_++;
188     current_as->hasLimiter_ = 1;
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_, {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,
266           rankId*current_as->linkCountPerNode_ + current_as->hasLoopback_ + current_as->hasLimiter_ );
267     }
268     rankId++;
269   }
270   delete cluster->properties;
271
272   // Add a router.
273   XBT_DEBUG(" ");
274   XBT_DEBUG("<router id=\"%s\"/>", cluster->router_id.c_str());
275   if (cluster->router_id.empty()) {
276     std::string newid   = std::string(cluster->prefix) + cluster->id + "_router" + cluster->suffix;
277     current_as->router_ = sg_platf_new_router(newid, NULL);
278   } else {
279     current_as->router_ = sg_platf_new_router(cluster->router_id, NULL);
280   }
281
282   //Make the backbone
283   if ((cluster->bb_bw > 0) || (cluster->bb_lat > 0)) {
284
285     LinkCreationArgs link;
286     link.id        = std::string(cluster->id)+ "_backbone";
287     link.bandwidth = cluster->bb_bw;
288     link.latency   = cluster->bb_lat;
289     link.policy    = cluster->bb_sharing_policy;
290
291     XBT_DEBUG("<link\tid=\"%s\" bw=\"%f\" lat=\"%f\"/>", link.id.c_str(), cluster->bb_bw, cluster->bb_lat);
292     sg_platf_new_link(&link);
293
294     routing_cluster_add_backbone(simgrid::surf::LinkImpl::byName(link.id));
295   }
296
297   XBT_DEBUG("</AS>");
298   sg_platf_new_Zone_seal();
299
300   simgrid::surf::on_cluster(cluster);
301   delete cluster->radicals;
302 }
303
304 void routing_cluster_add_backbone(simgrid::surf::LinkImpl* bb)
305 {
306   simgrid::kernel::routing::ClusterZone* cluster =
307       dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
308
309   xbt_assert(cluster, "Only hosts from Cluster can get a backbone.");
310   xbt_assert(nullptr == cluster->backbone_, "Cluster %s already has a backbone link!", cluster->getCname());
311
312   cluster->backbone_ = bb;
313   XBT_DEBUG("Add a backbone to AS '%s'", current_routing->getCname());
314 }
315
316 void sg_platf_new_cabinet(CabinetCreationArgs* cabinet)
317 {
318   for (int const& radical : *cabinet->radicals) {
319     std::string hostname = cabinet->prefix + std::to_string(radical) + cabinet->suffix;
320     s_sg_platf_host_cbarg_t host;
321     memset(&host, 0, sizeof(host));
322     host.pstate           = 0;
323     host.core_amount      = 1;
324     host.id               = hostname.c_str();
325     host.speed_per_pstate.push_back(cabinet->speed);
326     sg_platf_new_host(&host);
327
328     LinkCreationArgs link;
329     link.policy    = SURF_LINK_FULLDUPLEX;
330     link.latency   = cabinet->lat;
331     link.bandwidth = cabinet->bw;
332     link.id        = "link_" + hostname;
333     sg_platf_new_link(&link);
334
335     HostLinkCreationArgs host_link;
336     host_link.id        = hostname;
337     host_link.link_up   = std::string("link_") + hostname + "_UP";
338     host_link.link_down = std::string("link_") + hostname + "_DOWN";
339     sg_platf_new_hostlink(&host_link);
340   }
341   delete cabinet->radicals;
342 }
343
344 void sg_platf_new_storage(StorageCreationArgs* storage)
345 {
346   xbt_assert(std::find(known_storages.begin(), known_storages.end(), storage->id) == known_storages.end(),
347              "Refusing to add a second storage named \"%s\"", storage->id.c_str());
348
349   simgrid::surf::StorageType* stype;
350   auto st = storage_types.find(storage->type_id);
351   if (st != storage_types.end()) {
352     stype = st->second;
353   } else {
354     xbt_die("No storage type '%s'", storage->type_id.c_str());
355   }
356
357   XBT_DEBUG("ROUTING Create a storage name '%s' with type_id '%s' and content '%s'", storage->id.c_str(),
358             storage->type_id.c_str(), storage->content.c_str());
359
360   known_storages.push_back(storage->id);
361
362   // if storage content is not specified use the content of storage_type if any
363   if (storage->content.empty() && not stype->content.empty()) {
364     storage->content = stype->content;
365     XBT_DEBUG("For disk '%s' content is empty, inherit the content (of type %s)", storage->id.c_str(),
366               stype->id.c_str());
367   }
368
369   XBT_DEBUG("SURF storage create resource\n\t\tid '%s'\n\t\ttype '%s' "
370             "\n\t\tmodel '%s' \n\t\tcontent '%s' "
371             "\n\t\tproperties '%p''\n",
372             storage->id.c_str(), stype->model.c_str(), stype->id.c_str(), storage->content.c_str(),
373             storage->properties);
374
375   auto s = surf_storage_model->createStorage(storage->id, stype->id, storage->content, storage->attach);
376
377   if (storage->properties) {
378     for (auto const& elm : *storage->properties)
379       s->setProperty(elm.first, elm.second);
380     delete storage->properties;
381   }
382 }
383
384 void sg_platf_new_storage_type(StorageTypeCreationArgs* storage_type)
385 {
386   xbt_assert(storage_types.find(storage_type->id) == storage_types.end(),
387              "Reading a storage type, processing unit \"%s\" already exists", storage_type->id.c_str());
388
389   simgrid::surf::StorageType* stype =
390       new simgrid::surf::StorageType(storage_type->id, storage_type->model, storage_type->content,
391                                      storage_type->properties, storage_type->model_properties, storage_type->size);
392
393   XBT_DEBUG("Create a storage type id '%s' with model '%s', content '%s'", storage_type->id.c_str(),
394             storage_type->model.c_str(), storage_type->content.c_str());
395
396   storage_types[storage_type->id] = stype;
397 }
398
399 void sg_platf_new_mount(MountCreationArgs* mount)
400 {
401   xbt_assert(std::find(known_storages.begin(), known_storages.end(), mount->storageId) != known_storages.end(),
402              "Cannot mount non-existent disk \"%s\"", mount->storageId.c_str());
403
404   XBT_DEBUG("Mount '%s' on '%s'", mount->storageId.c_str(), mount->name.c_str());
405
406   if (mount_list.empty())
407     XBT_DEBUG("Create a Mount list for %s", A_surfxml_host_id);
408   mount_list.insert({mount->name, simgrid::surf::StorageImpl::byName(mount->storageId.c_str())});
409 }
410
411 void sg_platf_new_route(sg_platf_route_cbarg_t route)
412 {
413   routing_get_current()->addRoute(route);
414 }
415
416 void sg_platf_new_bypassRoute(sg_platf_route_cbarg_t bypassRoute)
417 {
418   routing_get_current()->addBypassRoute(bypassRoute);
419 }
420
421 void sg_platf_new_process(sg_platf_process_cbarg_t process)
422 {
423   sg_host_t host = sg_host_by_name(process->host);
424   if (not host) {
425     // The requested host does not exist. Do a nice message to the user
426     std::string msg = std::string("Cannot create process '") + process->function + "': host '" + process->host +
427                       "' does not exist\nExisting hosts: '";
428     for (auto const& kv : simgrid::s4u::host_list) {
429       simgrid::s4u::Host* host = kv.second;
430       msg += host->getName();
431       msg += "', '";
432       if (msg.length() > 1024) {
433         msg.pop_back(); // remove trailing quote
434         msg += "...(list truncated)......";
435         break;
436       }
437     }
438     xbt_die("%s", msg.c_str());
439   }
440   simgrid::simix::ActorCodeFactory& factory = SIMIX_get_actor_code_factory(process->function);
441   xbt_assert(factory, "Function '%s' unknown", process->function);
442
443   double start_time = process->start_time;
444   double kill_time  = process->kill_time;
445   int auto_restart = process->on_failure == SURF_ACTOR_ON_FAILURE_DIE ? 0 : 1;
446
447   std::vector<std::string> args(process->argv, process->argv + process->argc);
448   std::function<void()> code = factory(std::move(args));
449   std::shared_ptr<std::map<std::string, std::string>> properties(process->properties);
450
451   smx_process_arg_t arg = nullptr;
452
453   arg = new simgrid::simix::ProcessArg();
454   arg->name = std::string(process->argv[0]);
455   arg->code = code;
456   arg->data = nullptr;
457   arg->host = host;
458   arg->kill_time = kill_time;
459   arg->properties = properties;
460
461   host->extension<simgrid::simix::Host>()->boot_processes.push_back(arg);
462
463   if (start_time > SIMIX_get_clock()) {
464
465     arg = new simgrid::simix::ProcessArg();
466     arg->name = std::string(process->argv[0]);
467     arg->code = std::move(code);
468     arg->data = nullptr;
469     arg->host = host;
470     arg->kill_time = kill_time;
471     arg->properties = properties;
472
473     XBT_DEBUG("Process %s@%s will be started at time %f", arg->name.c_str(), arg->host->getCname(), start_time);
474     SIMIX_timer_set(start_time, [arg, auto_restart]() {
475       smx_actor_t actor = simix_global->create_process_function(arg->name.c_str(), std::move(arg->code), arg->data,
476                                                                 arg->host, arg->properties.get(), nullptr);
477       if (arg->kill_time >= 0)
478         simcall_process_set_kill_time(actor, arg->kill_time);
479       if (auto_restart)
480         SIMIX_process_auto_restart_set(actor, auto_restart);
481       delete arg;
482     });
483   } else {                      // start_time <= SIMIX_get_clock()
484     XBT_DEBUG("Starting Process %s(%s) right now", arg->name.c_str(), host->getCname());
485
486     smx_actor_t actor = simix_global->create_process_function(arg->name.c_str(), std::move(code), nullptr, host,
487                                                               arg->properties.get(), nullptr);
488
489     /* The actor creation will fail if the host is currently dead, but that's fine */
490     if (actor != nullptr) {
491       if (arg->kill_time >= 0)
492         simcall_process_set_kill_time(actor, arg->kill_time);
493       if (auto_restart)
494         SIMIX_process_auto_restart_set(actor, auto_restart);
495     }
496   }
497 }
498
499 void sg_platf_new_peer(PeerCreationArgs* peer)
500 {
501   simgrid::kernel::routing::VivaldiZone* as = dynamic_cast<simgrid::kernel::routing::VivaldiZone*>(current_routing);
502   xbt_assert(as, "<peer> tag can only be used in Vivaldi netzones.");
503
504   std::vector<double> speedPerPstate;
505   speedPerPstate.push_back(peer->speed);
506   simgrid::s4u::Host* host = as->createHost(peer->id.c_str(), &speedPerPstate, 1, nullptr);
507
508   as->setPeerLink(host->pimpl_netpoint, peer->bw_in, peer->bw_out, peer->coord);
509
510   /* Change from the defaults */
511   if (peer->state_trace)
512     host->pimpl_cpu->setStateTrace(peer->state_trace);
513   if (peer->speed_trace)
514     host->pimpl_cpu->setSpeedTrace(peer->speed_trace);
515 }
516
517 void sg_platf_begin() { /* Do nothing: just for symmetry of user code */ }
518
519 void sg_platf_end() {
520   simgrid::s4u::onPlatformCreated();
521 }
522
523 /* Pick the right models for CPU, net and host, and call their model_init_preparse */
524 static void surf_config_models_setup()
525 {
526   const char* host_model_name    = xbt_cfg_get_string("host/model");
527   const char* network_model_name = xbt_cfg_get_string("network/model");
528   const char* cpu_model_name     = xbt_cfg_get_string("cpu/model");
529   const char* storage_model_name = xbt_cfg_get_string("storage/model");
530
531   /* The compound host model is needed when using non-default net/cpu models */
532   if ((not xbt_cfg_is_default_value("network/model") || not xbt_cfg_is_default_value("cpu/model")) &&
533       xbt_cfg_is_default_value("host/model")) {
534     host_model_name = "compound";
535     xbt_cfg_set_string("host/model", host_model_name);
536   }
537
538   XBT_DEBUG("host model: %s", host_model_name);
539   if (not strcmp(host_model_name, "compound")) {
540     xbt_assert(cpu_model_name, "Set a cpu model to use with the 'compound' host model");
541     xbt_assert(network_model_name, "Set a network model to use with the 'compound' host model");
542
543     int cpu_id = find_model_description(surf_cpu_model_description, cpu_model_name);
544     surf_cpu_model_description[cpu_id].model_init_preparse();
545
546     int network_id = find_model_description(surf_network_model_description, network_model_name);
547     surf_network_model_description[network_id].model_init_preparse();
548   }
549
550   XBT_DEBUG("Call host_model_init");
551   int host_id = find_model_description(surf_host_model_description, host_model_name);
552   surf_host_model_description[host_id].model_init_preparse();
553
554   XBT_DEBUG("Call vm_model_init");
555   surf_vm_model_init_HL13();
556
557   XBT_DEBUG("Call storage_model_init");
558   int storage_id = find_model_description(surf_storage_model_description, storage_model_name);
559   surf_storage_model_description[storage_id].model_init_preparse();
560 }
561
562 /**
563  * \brief Add a Zone to the platform
564  *
565  * Add a new autonomous system to the platform. Any elements (such as host, router or sub-Zone) added after this call
566  * and before the corresponding call to sg_platf_new_Zone_seal() will be added to this Zone.
567  *
568  * Once this function was called, the configuration concerning the used models cannot be changed anymore.
569  *
570  * @param zone the parameters defining the Zone to build.
571  */
572 simgrid::s4u::NetZone* sg_platf_new_Zone_begin(ZoneCreationArgs* zone)
573 {
574   if (not surf_parse_models_setup_already_called) {
575     /* Initialize the surf models. That must be done after we got all config, and before we need the models.
576      * That is, after the last <config> tag, if any, and before the first of cluster|peer|AS|trace|trace_connect
577      *
578      * I'm not sure for <trace> and <trace_connect>, there may be a bug here
579      * (FIXME: check it out by creating a file beginning with one of these tags)
580      * but cluster and peer create ASes internally, so putting the code in there is ok.
581      */
582     surf_parse_models_setup_already_called = 1;
583     surf_config_models_setup();
584   }
585
586   _sg_cfg_init_status = 2; /* HACK: direct access to the global controlling the level of configuration to prevent
587                             * any further config now that we created some real content */
588
589   /* search the routing model */
590   simgrid::kernel::routing::NetZoneImpl* new_zone = nullptr;
591   switch (zone->routing) {
592     case A_surfxml_AS_routing_Cluster:
593       new_zone = new simgrid::kernel::routing::ClusterZone(current_routing, zone->id);
594       break;
595     case A_surfxml_AS_routing_ClusterDragonfly:
596       new_zone = new simgrid::kernel::routing::DragonflyZone(current_routing, zone->id);
597       break;
598     case A_surfxml_AS_routing_ClusterTorus:
599       new_zone = new simgrid::kernel::routing::TorusZone(current_routing, zone->id);
600       break;
601     case A_surfxml_AS_routing_ClusterFatTree:
602       new_zone = new simgrid::kernel::routing::FatTreeZone(current_routing, zone->id);
603       break;
604     case A_surfxml_AS_routing_Dijkstra:
605       new_zone = new simgrid::kernel::routing::DijkstraZone(current_routing, zone->id, 0);
606       break;
607     case A_surfxml_AS_routing_DijkstraCache:
608       new_zone = new simgrid::kernel::routing::DijkstraZone(current_routing, zone->id, 1);
609       break;
610     case A_surfxml_AS_routing_Floyd:
611       new_zone = new simgrid::kernel::routing::FloydZone(current_routing, zone->id);
612       break;
613     case A_surfxml_AS_routing_Full:
614       new_zone = new simgrid::kernel::routing::FullZone(current_routing, zone->id);
615       break;
616     case A_surfxml_AS_routing_None:
617       new_zone = new simgrid::kernel::routing::EmptyZone(current_routing, zone->id);
618       break;
619     case A_surfxml_AS_routing_Vivaldi:
620       new_zone = new simgrid::kernel::routing::VivaldiZone(current_routing, zone->id);
621       break;
622     default:
623       xbt_die("Not a valid model!");
624       break;
625   }
626
627   if (current_routing == nullptr) { /* it is the first one */
628     xbt_assert(simgrid::s4u::Engine::getInstance()->pimpl->netRoot_ == nullptr,
629                "All defined components must belong to a networking zone.");
630     simgrid::s4u::Engine::getInstance()->pimpl->netRoot_ = new_zone;
631
632   } else {
633     /* set the father behavior */
634     if (current_routing->hierarchy_ == simgrid::kernel::routing::NetZoneImpl::RoutingMode::unset)
635       current_routing->hierarchy_ = simgrid::kernel::routing::NetZoneImpl::RoutingMode::recursive;
636     /* add to the sons dictionary */
637     current_routing->getChildren()->push_back(static_cast<simgrid::s4u::NetZone*>(new_zone));
638   }
639
640   /* set the new current component of the tree */
641   current_routing = new_zone;
642
643   simgrid::s4u::NetZone::onCreation(*new_zone); // notify the signal
644
645   return new_zone;
646 }
647
648 /**
649  * \brief Specify that the description of the current AS is finished
650  *
651  * Once you've declared all the content of your AS, you have to seal
652  * it with this call. Your AS is not usable until you call this function.
653  */
654 void sg_platf_new_Zone_seal()
655 {
656   xbt_assert(current_routing, "Cannot seal the current AS: none under construction");
657   current_routing->seal();
658   simgrid::s4u::NetZone::onSeal(*current_routing);
659   current_routing = static_cast<simgrid::kernel::routing::NetZoneImpl*>(current_routing->getFather());
660 }
661
662 /** @brief Add a link connecting an host to the rest of its AS (which must be cluster or vivaldi) */
663 void sg_platf_new_hostlink(HostLinkCreationArgs* hostlink)
664 {
665   simgrid::kernel::routing::NetPoint* netpoint = sg_host_by_name(hostlink->id.c_str())->pimpl_netpoint;
666   xbt_assert(netpoint, "Host '%s' not found!", hostlink->id.c_str());
667   xbt_assert(dynamic_cast<simgrid::kernel::routing::ClusterZone*>(current_routing),
668              "Only hosts from Cluster and Vivaldi ASes can get an host_link.");
669
670   simgrid::surf::LinkImpl* linkUp   = simgrid::surf::LinkImpl::byName(hostlink->link_up);
671   simgrid::surf::LinkImpl* linkDown = simgrid::surf::LinkImpl::byName(hostlink->link_down);
672
673   xbt_assert(linkUp, "Link '%s' not found!", hostlink->link_up.c_str());
674   xbt_assert(linkDown, "Link '%s' not found!", hostlink->link_down.c_str());
675
676   auto as_cluster = static_cast<simgrid::kernel::routing::ClusterZone*>(current_routing);
677
678   if (as_cluster->privateLinks_.find(netpoint->id()) != as_cluster->privateLinks_.end())
679     surf_parse_error(std::string("Host_link for '") + hostlink->id.c_str() + "' is already defined!");
680
681   XBT_DEBUG("Push Host_link for host '%s' to position %u", netpoint->cname(), netpoint->id());
682   as_cluster->privateLinks_.insert({netpoint->id(), {linkUp, linkDown}});
683 }
684
685 void sg_platf_new_trace(TraceCreationArgs* trace)
686 {
687   tmgr_trace_t tmgr_trace;
688   if (not trace->file.empty()) {
689     tmgr_trace = tmgr_trace_new_from_file(trace->file);
690   } else {
691     xbt_assert(not trace->pc_data.empty(), "Trace '%s' must have either a content, or point to a file on disk.",
692                trace->id.c_str());
693     tmgr_trace = tmgr_trace_new_from_string(trace->id, trace->pc_data, trace->periodicity);
694   }
695   traces_set_list.insert({trace->id, tmgr_trace});
696 }