Logo AND Algorithmique Numérique Distribuée

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