Logo AND Algorithmique Numérique Distribuée

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