Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
91224b243c1b0aec3a63e3ec05ac84b7d288237b
[simgrid.git] / src / surf / xml / surfxml_sax_cb.cpp
1 /* Copyright (c) 2006-2019. 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/NetPoint.hpp"
7 #include "simgrid/s4u/Engine.hpp"
8 #include "simgrid/sg_config.hpp"
9 #include "src/kernel/resource/profile/FutureEvtSet.hpp"
10 #include "src/kernel/resource/profile/Profile.hpp"
11 #include "src/surf/network_interface.hpp"
12 #include "src/surf/surf_interface.hpp"
13 #include "src/surf/xml/platf_private.hpp"
14 #include "surf/surf.hpp"
15 #include "xbt/file.hpp"
16
17 #include <boost/algorithm/string.hpp>
18 #include <boost/algorithm/string/classification.hpp>
19 #include <boost/algorithm/string/split.hpp>
20 #include <string>
21 #include <tuple>
22 #include <unordered_map>
23 #include <vector>
24
25 #include "simgrid_dtd.c"
26
27 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_parse, surf, "Logging specific to the SURF parsing module");
28
29 static std::string surf_parsed_filename; // Currently parsed file (for the error messages)
30 std::vector<simgrid::kernel::resource::LinkImpl*>
31     parsed_link_list; /* temporary store of current list link of a route */
32
33 /*
34  * Helping functions
35  */
36 void surf_parse_assert(bool cond, const std::string& msg)
37 {
38   if (not cond) {
39     int lineno = surf_parse_lineno;
40     cleanup();
41     XBT_ERROR("Parse error at %s:%d: %s", surf_parsed_filename.c_str(), lineno, msg.c_str());
42     surf_exit();
43     xbt_die("Exiting now");
44   }
45 }
46
47 void surf_parse_error(const std::string& msg)
48 {
49   int lineno = surf_parse_lineno;
50   cleanup();
51   XBT_ERROR("Parse error at %s:%d: %s", surf_parsed_filename.c_str(), lineno, msg.c_str());
52   surf_exit();
53   xbt_die("Exiting now");
54 }
55
56 void surf_parse_assert_netpoint(const std::string& hostname, const std::string& pre, const std::string& post)
57 {
58   if (simgrid::s4u::Engine::get_instance()->netpoint_by_name_or_null(hostname) != nullptr) // found
59     return;
60
61   std::string msg = pre + hostname + post + " Existing netpoints: \n";
62
63   std::vector<simgrid::kernel::routing::NetPoint*> netpoints =
64       simgrid::s4u::Engine::get_instance()->get_all_netpoints();
65   std::sort(netpoints.begin(), netpoints.end(),
66             [](simgrid::kernel::routing::NetPoint* a, simgrid::kernel::routing::NetPoint* b) {
67               return a->get_name() < b->get_name();
68             });
69   bool first = true;
70   for (auto const& np : netpoints) {
71     if (np->is_netzone())
72       continue;
73
74     if (not first)
75       msg += ",";
76     first = false;
77     msg += "'" + np->get_name() + "'";
78     if (msg.length() > 4096) {
79       msg.pop_back(); // remove trailing quote
80       msg += "...(list truncated)......";
81       break;
82     }
83   }
84   surf_parse_error(msg);
85 }
86
87 double surf_parse_get_double(const std::string& s)
88 {
89   try {
90     return std::stod(s);
91   } catch (const std::invalid_argument&) {
92     surf_parse_error(s + " is not a double");
93   }
94 }
95
96 int surf_parse_get_int(const std::string& s)
97 {
98   try {
99     return std::stoi(s);
100   } catch (const std::invalid_argument&) {
101     surf_parse_error(s + " is not a double");
102   }
103 }
104
105 namespace {
106
107 /* Turn something like "1-4,6,9-11" into the vector {1,2,3,4,6,9,10,11} */
108 std::vector<int>* explodesRadical(const std::string& radicals)
109 {
110   std::vector<int>* exploded = new std::vector<int>();
111
112   // Make all hosts
113   std::vector<std::string> radical_elements;
114   boost::split(radical_elements, radicals, boost::is_any_of(","));
115   for (auto const& group : radical_elements) {
116     std::vector<std::string> radical_ends;
117     boost::split(radical_ends, group, boost::is_any_of("-"));
118     int start = surf_parse_get_int(radical_ends.front());
119     int end   = 0;
120
121     switch (radical_ends.size()) {
122       case 1:
123         end = start;
124         break;
125       case 2:
126         end = surf_parse_get_int(radical_ends.back());
127         break;
128       default:
129         surf_parse_error(std::string("Malformed radical: ") + group);
130     }
131     for (int i = start; i <= end; i++)
132       exploded->push_back(i);
133   }
134
135   return exploded;
136 }
137
138 class unit_scale : public std::unordered_map<std::string, double> {
139 public:
140   using std::unordered_map<std::string, double>::unordered_map;
141   // tuples are : <unit, value for unit, base (2 or 10), true if abbreviated>
142   explicit unit_scale(std::initializer_list<std::tuple<const std::string, double, int, bool>> generators);
143 };
144
145 unit_scale::unit_scale(std::initializer_list<std::tuple<const std::string, double, int, bool>> generators)
146 {
147   for (const auto& gen : generators) {
148     const std::string& unit = std::get<0>(gen);
149     double value            = std::get<1>(gen);
150     const int base          = std::get<2>(gen);
151     const bool abbrev       = std::get<3>(gen);
152     double mult;
153     std::vector<std::string> prefixes;
154     switch (base) {
155       case 2:
156         mult     = 1024.0;
157         prefixes = abbrev ? std::vector<std::string>{"Ki", "Mi", "Gi", "Ti", "Pi", "Ei", "Zi", "Yi"}
158                           : std::vector<std::string>{"kibi", "mebi", "gibi", "tebi", "pebi", "exbi", "zebi", "yobi"};
159         break;
160       case 10:
161         mult     = 1000.0;
162         prefixes = abbrev ? std::vector<std::string>{"k", "M", "G", "T", "P", "E", "Z", "Y"}
163                           : std::vector<std::string>{"kilo", "mega", "giga", "tera", "peta", "exa", "zeta", "yotta"};
164         break;
165       default:
166         THROW_IMPOSSIBLE;
167     }
168     emplace(unit, value);
169     for (const auto& prefix : prefixes) {
170       value *= mult;
171       emplace(prefix + unit, value);
172     }
173   }
174 }
175
176 /* Note: no warning is issued for unit-less values when `name' is empty. */
177 double surf_parse_get_value_with_unit(const char* string, const unit_scale& units, const char* entity_kind,
178                                       const std::string& name, const char* error_msg, const char* default_unit)
179 {
180   char* endptr;
181   errno = 0;
182   double res      = strtod(string, &endptr);
183   const char* ptr = endptr; // for const-correctness
184   if (errno == ERANGE)
185     surf_parse_error(std::string("value out of range: ") + string);
186   if (ptr == string)
187     surf_parse_error(std::string("cannot parse number:") + string);
188   if (ptr[0] == '\0') {
189     // Ok, 0 can be unit-less
190     if (res != 0 && not name.empty())
191       XBT_WARN("Deprecated unit-less value '%s' for %s %s. %s", string, entity_kind, name.c_str(), error_msg);
192     ptr = default_unit;
193   }
194   auto u = units.find(ptr);
195   if (u == units.end())
196     surf_parse_error(std::string("unknown unit: ") + ptr);
197   return res * u->second;
198 }
199 }
200
201 double surf_parse_get_time(const char* string, const char* entity_kind, const std::string& name)
202 {
203   static const unit_scale units{std::make_pair("w", 7 * 24 * 60 * 60),
204                                 std::make_pair("d", 24 * 60 * 60),
205                                 std::make_pair("h", 60 * 60),
206                                 std::make_pair("m", 60),
207                                 std::make_pair("s", 1.0),
208                                 std::make_pair("ms", 1e-3),
209                                 std::make_pair("us", 1e-6),
210                                 std::make_pair("ns", 1e-9),
211                                 std::make_pair("ps", 1e-12)};
212   return surf_parse_get_value_with_unit(string, units, entity_kind, name,
213       "Append 's' to your time to get seconds", "s");
214 }
215
216 double surf_parse_get_size(const char* string, const char* entity_kind, const std::string& name)
217 {
218   static const unit_scale units{std::make_tuple("b", 0.125, 2, true), std::make_tuple("b", 0.125, 10, true),
219                                 std::make_tuple("B", 1.0, 2, true), std::make_tuple("B", 1.0, 10, true)};
220   return surf_parse_get_value_with_unit(string, units, entity_kind, name,
221       "Append 'B' to get bytes (or 'b' for bits but 1B = 8b).", "B");
222 }
223
224 double surf_parse_get_bandwidth(const char* string, const char* entity_kind, const std::string& name)
225 {
226   static const unit_scale units{std::make_tuple("bps", 0.125, 2, true), std::make_tuple("bps", 0.125, 10, true),
227                                 std::make_tuple("Bps", 1.0, 2, true), std::make_tuple("Bps", 1.0, 10, true)};
228   return surf_parse_get_value_with_unit(string, units, entity_kind, name,
229       "Append 'Bps' to get bytes per second (or 'bps' for bits but 1Bps = 8bps)", "Bps");
230 }
231
232 std::vector<double> surf_parse_get_bandwidths(const char* string, const char* entity_kind, const std::string& name)
233 {
234   static const unit_scale units{std::make_tuple("bps", 0.125, 2, true), std::make_tuple("bps", 0.125, 10, true),
235                                 std::make_tuple("Bps", 1.0, 2, true), std::make_tuple("Bps", 1.0, 10, true)};
236
237   std::vector<double> bandwidths;
238   std::vector<std::string> tokens;
239   boost::split(tokens, string, boost::is_any_of(";"));
240   for (auto token : tokens) {
241     bandwidths.push_back(surf_parse_get_value_with_unit(
242         token.c_str(), units, entity_kind, name,
243         "Append 'Bps' to get bytes per second (or 'bps' for bits but 1Bps = 8bps)", "Bps"));
244   }
245
246   return bandwidths;
247 }
248
249 double surf_parse_get_speed(const char* string, const char* entity_kind, const std::string& name)
250 {
251   static const unit_scale units{std::make_tuple("f", 1.0, 10, true), std::make_tuple("flops", 1.0, 10, false)};
252   return surf_parse_get_value_with_unit(string, units, entity_kind, name,
253       "Append 'f' or 'flops' to your speed to get flop per second", "f");
254 }
255
256 static std::vector<double> surf_parse_get_all_speeds(char* speeds, const char* entity_kind, const std::string& id)
257 {
258
259   std::vector<double> speed_per_pstate;
260
261   if (strchr(speeds, ',') == nullptr){
262     double speed = surf_parse_get_speed(speeds, entity_kind, id);
263     speed_per_pstate.push_back(speed);
264   } else {
265     std::vector<std::string> pstate_list;
266     boost::split(pstate_list, speeds, boost::is_any_of(","));
267     for (auto speed_str : pstate_list) {
268       boost::trim(speed_str);
269       double speed = surf_parse_get_speed(speed_str.c_str(), entity_kind, id);
270       speed_per_pstate.push_back(speed);
271       XBT_DEBUG("Speed value: %f", speed);
272     }
273   }
274   return speed_per_pstate;
275 }
276
277 /*
278  * All the callback lists that can be overridden anywhere.
279  * (this list should probably be reduced to the bare minimum to allow the models to work)
280  */
281
282 /* make sure these symbols are defined as strong ones in this file so that the linker can resolve them */
283
284 /* The default current property receiver. Setup in the corresponding opening callbacks. */
285 std::unordered_map<std::string, std::string>* current_property_set       = nullptr;
286 std::unordered_map<std::string, std::string>* current_model_property_set = nullptr;
287 int ZONE_TAG                            = 0; // Whether we just opened a zone tag (to see what to do with the properties)
288
289 FILE *surf_file_to_parse = nullptr;
290
291 /* Stuff relative to storage */
292 void STag_surfxml_storage()
293 {
294   ZONE_TAG = 0;
295   XBT_DEBUG("STag_surfxml_storage");
296   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
297 }
298
299 void ETag_surfxml_storage()
300 {
301   simgrid::kernel::routing::StorageCreationArgs storage;
302
303   storage.properties   = current_property_set;
304   current_property_set = nullptr;
305
306   storage.id           = A_surfxml_storage_id;
307   storage.type_id      = A_surfxml_storage_typeId;
308   storage.content      = A_surfxml_storage_content;
309   storage.attach       = A_surfxml_storage_attach;
310
311   sg_platf_new_storage(&storage);
312 }
313 void STag_surfxml_storage___type()
314 {
315   ZONE_TAG = 0;
316   XBT_DEBUG("STag_surfxml_storage___type");
317   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
318   xbt_assert(current_model_property_set == nullptr, "Someone forgot to reset the model property set to nullptr in its closing tag (or XML malformed)");
319 }
320 void ETag_surfxml_storage___type()
321 {
322   simgrid::kernel::routing::StorageTypeCreationArgs storage_type;
323
324   storage_type.properties = current_property_set;
325   current_property_set    = nullptr;
326
327   storage_type.model_properties = current_model_property_set;
328   current_model_property_set    = nullptr;
329
330   storage_type.content = A_surfxml_storage___type_content;
331   storage_type.id      = A_surfxml_storage___type_id;
332   storage_type.model   = A_surfxml_storage___type_model;
333   storage_type.size =
334       surf_parse_get_size(A_surfxml_storage___type_size, "size of storage type", storage_type.id.c_str());
335   sg_platf_new_storage_type(&storage_type);
336 }
337
338 void STag_surfxml_mount()
339 {
340   XBT_DEBUG("STag_surfxml_mount");
341 }
342
343 void ETag_surfxml_mount()
344 {
345   simgrid::kernel::routing::MountCreationArgs mount;
346
347   mount.name      = A_surfxml_mount_name;
348   mount.storageId = A_surfxml_mount_storageId;
349   sg_platf_new_mount(&mount);
350 }
351
352 void STag_surfxml_include()
353 {
354   xbt_die("<include> tag was removed in SimGrid v3.18. Please stop using it now.");
355 }
356
357 void ETag_surfxml_include()
358 {
359   /* Won't happen since <include> is now removed since v3.18. */
360 }
361
362 /* Stag and Etag parse functions */
363 void STag_surfxml_platform() {
364   XBT_ATTRIB_UNUSED double version = surf_parse_get_double(A_surfxml_platform_version);
365
366   xbt_assert((version >= 1.0), "******* BIG FAT WARNING *********\n "
367       "You're using an ancient XML file.\n"
368       "Since SimGrid 3.1, units are Bytes, Flops, and seconds "
369       "instead of MBytes, MFlops and seconds.\n"
370
371       "Use simgrid_update_xml to update your file automatically. "
372       "This program is installed automatically with SimGrid, or "
373       "available in the tools/ directory of the source archive.\n"
374
375       "Please check also out the SURF section of the ChangeLog for "
376       "the 3.1 version for more information. \n"
377
378       "Last, do not forget to also update your values for "
379       "the calls to MSG_task_create (if any).");
380   xbt_assert((version >= 3.0), "******* BIG FAT WARNING *********\n "
381       "You're using an old XML file.\n"
382       "Use simgrid_update_xml to update your file automatically. "
383       "This program is installed automatically with SimGrid, or "
384       "available in the tools/ directory of the source archive.");
385   xbt_assert((version >= 4.0),
386              "******* FILE %s IS TOO OLD (v:%.1f) *********\n "
387              "Changes introduced in SimGrid 3.13:\n"
388              "  - 'power' attribute of hosts (and others) got renamed to 'speed'.\n"
389              "  - In <trace_connect>, attribute kind=\"POWER\" is now kind=\"SPEED\".\n"
390              "  - DOCTYPE now point to the rignt URL.\n"
391              "  - speed, bandwidth and latency attributes now MUST have an explicit unit (f, Bps, s by default)"
392              "\n\n"
393              "Use simgrid_update_xml to update your file automatically. "
394              "This program is installed automatically with SimGrid, or "
395              "available in the tools/ directory of the source archive.",
396              surf_parsed_filename.c_str(), version);
397   if (version < 4.1) {
398     XBT_INFO("You're using a v%.1f XML file (%s) while the current standard is v4.1 "
399              "That's fine, the new version is backward compatible. \n\n"
400              "Use simgrid_update_xml to update your file automatically to get rid of this warning. "
401              "This program is installed automatically with SimGrid, or "
402              "available in the tools/ directory of the source archive.",
403              version, surf_parsed_filename.c_str());
404   }
405   xbt_assert(version <= 4.1,
406              "******* FILE %s COMES FROM THE FUTURE (v:%.1f) *********\n "
407              "The most recent formalism that this version of SimGrid understands is v4.1.\n"
408              "Please update your code, or use another, more adapted, file.",
409              surf_parsed_filename.c_str(), version);
410 }
411 void ETag_surfxml_platform(){
412   simgrid::s4u::on_platform_created();
413 }
414
415 void STag_surfxml_host(){
416   ZONE_TAG = 0;
417   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
418 }
419
420 void STag_surfxml_prop()
421 {
422   if (ZONE_TAG) { // We need to retrieve the most recently opened zone
423     XBT_DEBUG("Set zone property %s -> %s", A_surfxml_prop_id, A_surfxml_prop_value);
424     simgrid::s4u::NetZone* netzone = simgrid::s4u::Engine::get_instance()->netzone_by_name_or_null(A_surfxml_zone_id);
425
426     netzone->set_property(std::string(A_surfxml_prop_id), A_surfxml_prop_value);
427   } else {
428     if (not current_property_set)
429       current_property_set = new std::unordered_map<std::string, std::string>; // Maybe, it should raise an error
430     current_property_set->insert({A_surfxml_prop_id, A_surfxml_prop_value});
431     XBT_DEBUG("add prop %s=%s into current property set %p", A_surfxml_prop_id, A_surfxml_prop_value,
432               current_property_set);
433   }
434 }
435
436 void ETag_surfxml_host()    {
437   simgrid::kernel::routing::HostCreationArgs host;
438
439   host.properties = current_property_set;
440   current_property_set = nullptr;
441
442   host.id = A_surfxml_host_id;
443
444   host.speed_per_pstate = surf_parse_get_all_speeds(A_surfxml_host_speed, "speed of host", host.id);
445
446   XBT_DEBUG("pstate: %s", A_surfxml_host_pstate);
447   host.core_amount = surf_parse_get_int(A_surfxml_host_core);
448
449   host.speed_trace = nullptr;
450   if (A_surfxml_host_availability___file[0] != '\0') {
451     XBT_WARN("The availability_file attribute in <host> is now deprecated. Please, use 'speed_file' instead.");
452     host.speed_trace = simgrid::kernel::profile::Profile::from_file(A_surfxml_host_availability___file);
453   }
454   if (A_surfxml_host_speed___file[0] != '\0')
455     host.speed_trace = simgrid::kernel::profile::Profile::from_file(A_surfxml_host_speed___file);
456   host.state_trace = A_surfxml_host_state___file[0]
457                          ? simgrid::kernel::profile::Profile::from_file(A_surfxml_host_state___file)
458                          : nullptr;
459   host.pstate      = surf_parse_get_int(A_surfxml_host_pstate);
460   host.coord       = A_surfxml_host_coordinates;
461
462   sg_platf_new_host(&host);
463 }
464
465 void STag_surfxml_disk() {
466   XBT_DEBUG("STag_surfxml_disk");
467   xbt_assert(current_property_set == nullptr,
468              "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
469 }
470
471 void ETag_surfxml_disk() {
472   simgrid::kernel::routing::DiskCreationArgs disk;
473   disk.properties      = current_property_set;
474   current_property_set = nullptr;
475
476   disk.id       = A_surfxml_disk_id;
477   disk.read_bw  = surf_parse_get_bandwidth(A_surfxml_disk_read___bw, "read_bw of disk ", disk.id);
478   disk.write_bw = surf_parse_get_bandwidth(A_surfxml_disk_write___bw, "write_bw of disk ", disk.id);
479   sg_platf_new_disk(&disk);
480 }
481
482 void STag_surfxml_host___link(){
483   XBT_DEBUG("Create a Host_link for %s",A_surfxml_host___link_id);
484   simgrid::kernel::routing::HostLinkCreationArgs host_link;
485
486   host_link.id        = A_surfxml_host___link_id;
487   host_link.link_up   = A_surfxml_host___link_up;
488   host_link.link_down = A_surfxml_host___link_down;
489   sg_platf_new_hostlink(&host_link);
490 }
491
492 void STag_surfxml_router(){
493   sg_platf_new_router(A_surfxml_router_id, A_surfxml_router_coordinates);
494 }
495
496 void ETag_surfxml_cluster(){
497   simgrid::kernel::routing::ClusterCreationArgs cluster;
498   cluster.properties   = current_property_set;
499   current_property_set = nullptr;
500
501   cluster.id          = A_surfxml_cluster_id;
502   cluster.prefix      = A_surfxml_cluster_prefix;
503   cluster.suffix      = A_surfxml_cluster_suffix;
504   cluster.radicals    = explodesRadical(A_surfxml_cluster_radical);
505   cluster.speeds      = surf_parse_get_all_speeds(A_surfxml_cluster_speed, "speed of cluster", cluster.id);
506   cluster.core_amount = surf_parse_get_int(A_surfxml_cluster_core);
507   cluster.bw          = surf_parse_get_bandwidth(A_surfxml_cluster_bw, "bw of cluster", cluster.id);
508   cluster.lat         = surf_parse_get_time(A_surfxml_cluster_lat, "lat of cluster", cluster.id);
509   if(strcmp(A_surfxml_cluster_bb___bw,""))
510     cluster.bb_bw = surf_parse_get_bandwidth(A_surfxml_cluster_bb___bw, "bb_bw of cluster", cluster.id);
511   if(strcmp(A_surfxml_cluster_bb___lat,""))
512     cluster.bb_lat = surf_parse_get_time(A_surfxml_cluster_bb___lat, "bb_lat of cluster", cluster.id);
513   if(strcmp(A_surfxml_cluster_limiter___link,""))
514     cluster.limiter_link = surf_parse_get_bandwidth(A_surfxml_cluster_limiter___link, "limiter_link of cluster", cluster.id);
515   if(strcmp(A_surfxml_cluster_loopback___bw,""))
516     cluster.loopback_bw = surf_parse_get_bandwidth(A_surfxml_cluster_loopback___bw, "loopback_bw of cluster", cluster.id);
517   if(strcmp(A_surfxml_cluster_loopback___lat,""))
518     cluster.loopback_lat = surf_parse_get_time(A_surfxml_cluster_loopback___lat, "loopback_lat of cluster", cluster.id);
519
520   switch(AX_surfxml_cluster_topology){
521   case A_surfxml_cluster_topology_FLAT:
522     cluster.topology = simgrid::kernel::routing::ClusterTopology::FLAT;
523     break;
524   case A_surfxml_cluster_topology_TORUS:
525     cluster.topology = simgrid::kernel::routing::ClusterTopology::TORUS;
526     break;
527   case A_surfxml_cluster_topology_FAT___TREE:
528     cluster.topology = simgrid::kernel::routing::ClusterTopology::FAT_TREE;
529     break;
530   case A_surfxml_cluster_topology_DRAGONFLY:
531     cluster.topology = simgrid::kernel::routing::ClusterTopology::DRAGONFLY;
532     break;
533   default:
534     surf_parse_error(std::string("Invalid cluster topology for cluster ") + cluster.id);
535   }
536   cluster.topo_parameters = A_surfxml_cluster_topo___parameters;
537   cluster.router_id = A_surfxml_cluster_router___id;
538
539   switch (AX_surfxml_cluster_sharing___policy) {
540   case A_surfxml_cluster_sharing___policy_SHARED:
541     cluster.sharing_policy = simgrid::s4u::Link::SharingPolicy::SHARED;
542     break;
543   case A_surfxml_cluster_sharing___policy_FULLDUPLEX:
544     XBT_WARN("FULLDUPLEX is now deprecated. Please update your platform file to use SPLITDUPLEX instead.");
545     cluster.sharing_policy = simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX;
546     break;
547   case A_surfxml_cluster_sharing___policy_SPLITDUPLEX:
548     cluster.sharing_policy = simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX;
549     break;
550   case A_surfxml_cluster_sharing___policy_FATPIPE:
551     cluster.sharing_policy = simgrid::s4u::Link::SharingPolicy::FATPIPE;
552     break;
553   default:
554     surf_parse_error(std::string("Invalid cluster sharing policy for cluster ") + cluster.id);
555   }
556   switch (AX_surfxml_cluster_bb___sharing___policy) {
557   case A_surfxml_cluster_bb___sharing___policy_FATPIPE:
558     cluster.bb_sharing_policy = simgrid::s4u::Link::SharingPolicy::FATPIPE;
559     break;
560   case A_surfxml_cluster_bb___sharing___policy_SHARED:
561     cluster.bb_sharing_policy = simgrid::s4u::Link::SharingPolicy::SHARED;
562     break;
563   default:
564     surf_parse_error(std::string("Invalid bb sharing policy in cluster ") + cluster.id);
565   }
566
567   sg_platf_new_cluster(&cluster);
568 }
569
570 void STag_surfxml_cluster(){
571   ZONE_TAG = 0;
572   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
573 }
574
575 void STag_surfxml_cabinet(){
576   simgrid::kernel::routing::CabinetCreationArgs cabinet;
577   cabinet.id      = A_surfxml_cabinet_id;
578   cabinet.prefix  = A_surfxml_cabinet_prefix;
579   cabinet.suffix  = A_surfxml_cabinet_suffix;
580   cabinet.speed    = surf_parse_get_speed(A_surfxml_cabinet_speed, "speed of cabinet", cabinet.id.c_str());
581   cabinet.bw       = surf_parse_get_bandwidth(A_surfxml_cabinet_bw, "bw of cabinet", cabinet.id.c_str());
582   cabinet.lat      = surf_parse_get_time(A_surfxml_cabinet_lat, "lat of cabinet", cabinet.id.c_str());
583   cabinet.radicals = explodesRadical(A_surfxml_cabinet_radical);
584
585   sg_platf_new_cabinet(&cabinet);
586 }
587
588 void STag_surfxml_peer(){
589   simgrid::kernel::routing::PeerCreationArgs peer;
590
591   peer.id          = std::string(A_surfxml_peer_id);
592   peer.speed       = surf_parse_get_speed(A_surfxml_peer_speed, "speed of peer", peer.id.c_str());
593   peer.bw_in       = surf_parse_get_bandwidth(A_surfxml_peer_bw___in, "bw_in of peer", peer.id.c_str());
594   peer.bw_out      = surf_parse_get_bandwidth(A_surfxml_peer_bw___out, "bw_out of peer", peer.id.c_str());
595   peer.coord       = A_surfxml_peer_coordinates;
596   peer.speed_trace = nullptr;
597   if (A_surfxml_peer_availability___file[0] != '\0') {
598     XBT_WARN("The availability_file attribute in <peer> is now deprecated. Please, use 'speed_file' instead.");
599     peer.speed_trace = simgrid::kernel::profile::Profile::from_file(A_surfxml_peer_availability___file);
600   }
601   if (A_surfxml_peer_speed___file[0] != '\0')
602     peer.speed_trace = simgrid::kernel::profile::Profile::from_file(A_surfxml_peer_speed___file);
603   peer.state_trace = A_surfxml_peer_state___file[0]
604                          ? simgrid::kernel::profile::Profile::from_file(A_surfxml_peer_state___file)
605                          : nullptr;
606
607   if (A_surfxml_peer_lat[0] != '\0')
608     XBT_WARN("The latency attribute in <peer> is now deprecated. Use the z coordinate instead of '%s'.",
609              A_surfxml_peer_lat);
610
611   sg_platf_new_peer(&peer);
612 }
613
614 void STag_surfxml_link(){
615   ZONE_TAG = 0;
616   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
617 }
618
619 void ETag_surfxml_link(){
620   simgrid::kernel::routing::LinkCreationArgs link;
621
622   link.properties          = current_property_set;
623   current_property_set     = nullptr;
624
625   link.id                  = std::string(A_surfxml_link_id);
626   link.bandwidths          = surf_parse_get_bandwidths(A_surfxml_link_bandwidth, "bandwidth of link", link.id.c_str());
627   link.bandwidth_trace     = A_surfxml_link_bandwidth___file[0]
628                              ? simgrid::kernel::profile::Profile::from_file(A_surfxml_link_bandwidth___file)
629                              : nullptr;
630   link.latency             = surf_parse_get_time(A_surfxml_link_latency, "latency of link", link.id.c_str());
631   link.latency_trace       = A_surfxml_link_latency___file[0]
632                            ? simgrid::kernel::profile::Profile::from_file(A_surfxml_link_latency___file)
633                            : nullptr;
634   link.state_trace = A_surfxml_link_state___file[0]
635                          ? simgrid::kernel::profile::Profile::from_file(A_surfxml_link_state___file)
636                          : nullptr;
637
638   switch (A_surfxml_link_sharing___policy) {
639   case A_surfxml_link_sharing___policy_SHARED:
640     link.policy = simgrid::s4u::Link::SharingPolicy::SHARED;
641     break;
642   case A_surfxml_link_sharing___policy_FATPIPE:
643     link.policy = simgrid::s4u::Link::SharingPolicy::FATPIPE;
644     break;
645   case A_surfxml_link_sharing___policy_FULLDUPLEX:
646     XBT_WARN("FULLDUPLEX is now deprecated. Please update your platform file to use SPLITDUPLEX instead.");
647     link.policy = simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX;
648     break;
649   case A_surfxml_link_sharing___policy_SPLITDUPLEX:
650     link.policy = simgrid::s4u::Link::SharingPolicy::SPLITDUPLEX;
651     break;
652   case A_surfxml_link_sharing___policy_WIFI:
653     link.policy = simgrid::s4u::Link::SharingPolicy::WIFI;
654     break;
655   default:
656     surf_parse_error(std::string("Invalid sharing policy in link ") + link.id);
657   }
658
659   sg_platf_new_link(&link);
660 }
661
662 void STag_surfxml_link___ctn()
663 {
664   simgrid::kernel::resource::LinkImpl* link = nullptr;
665   switch (A_surfxml_link___ctn_direction) {
666   case AU_surfxml_link___ctn_direction:
667   case A_surfxml_link___ctn_direction_NONE:
668     link = simgrid::s4u::Link::by_name(std::string(A_surfxml_link___ctn_id))->get_impl();
669     break;
670   case A_surfxml_link___ctn_direction_UP:
671     link = simgrid::s4u::Link::by_name(std::string(A_surfxml_link___ctn_id) + "_UP")->get_impl();
672     break;
673   case A_surfxml_link___ctn_direction_DOWN:
674     link = simgrid::s4u::Link::by_name(std::string(A_surfxml_link___ctn_id) + "_DOWN")->get_impl();
675     break;
676   default:
677     surf_parse_error(std::string("Invalid direction for link ") + A_surfxml_link___ctn_id);
678   }
679
680   const char* dirname = "";
681   switch (A_surfxml_link___ctn_direction) {
682     case A_surfxml_link___ctn_direction_UP:
683       dirname = " (upward)";
684       break;
685     case A_surfxml_link___ctn_direction_DOWN:
686       dirname = " (downward)";
687       break;
688     default:
689       dirname = "";
690   }
691   surf_parse_assert(link != nullptr, std::string("No such link: '") + A_surfxml_link___ctn_id + "'" + dirname);
692   parsed_link_list.push_back(link);
693 }
694
695 void ETag_surfxml_backbone(){
696   simgrid::kernel::routing::LinkCreationArgs link;
697
698   link.properties = nullptr;
699   link.id = std::string(A_surfxml_backbone_id);
700   link.bandwidths.push_back(
701       surf_parse_get_bandwidth(A_surfxml_backbone_bandwidth, "bandwidth of backbone", link.id.c_str()));
702   link.latency = surf_parse_get_time(A_surfxml_backbone_latency, "latency of backbone", link.id.c_str());
703   link.policy     = simgrid::s4u::Link::SharingPolicy::SHARED;
704
705   sg_platf_new_link(&link);
706   routing_cluster_add_backbone(simgrid::s4u::Link::by_name(std::string(A_surfxml_backbone_id))->get_impl());
707 }
708
709 void STag_surfxml_route(){
710   surf_parse_assert_netpoint(A_surfxml_route_src, "Route src='", "' does name a node.");
711   surf_parse_assert_netpoint(A_surfxml_route_dst, "Route dst='", "' does name a node.");
712 }
713
714 void STag_surfxml_ASroute(){
715   surf_parse_assert_netpoint(A_surfxml_ASroute_src, "ASroute src='", "' does name a node.");
716   surf_parse_assert_netpoint(A_surfxml_ASroute_dst, "ASroute dst='", "' does name a node.");
717
718   surf_parse_assert_netpoint(A_surfxml_ASroute_gw___src, "ASroute gw_src='", "' does name a node.");
719   surf_parse_assert_netpoint(A_surfxml_ASroute_gw___dst, "ASroute gw_dst='", "' does name a node.");
720 }
721 void STag_surfxml_zoneRoute(){
722   surf_parse_assert_netpoint(A_surfxml_zoneRoute_src, "zoneRoute src='", "' does name a node.");
723   surf_parse_assert_netpoint(A_surfxml_zoneRoute_dst, "zoneRoute dst='", "' does name a node.");
724   surf_parse_assert_netpoint(A_surfxml_zoneRoute_gw___src, "zoneRoute gw_src='", "' does name a node.");
725   surf_parse_assert_netpoint(A_surfxml_zoneRoute_gw___dst, "zoneRoute gw_dst='", "' does name a node.");
726 }
727
728 void STag_surfxml_bypassRoute(){
729   surf_parse_assert_netpoint(A_surfxml_bypassRoute_src, "bypassRoute src='", "' does name a node.");
730   surf_parse_assert_netpoint(A_surfxml_bypassRoute_dst, "bypassRoute dst='", "' does name a node.");
731 }
732
733 void STag_surfxml_bypassASroute(){
734   surf_parse_assert_netpoint(A_surfxml_bypassASroute_src, "bypassASroute src='", "' does name a node.");
735   surf_parse_assert_netpoint(A_surfxml_bypassASroute_dst, "bypassASroute dst='", "' does name a node.");
736   surf_parse_assert_netpoint(A_surfxml_bypassASroute_gw___src, "bypassASroute gw_src='", "' does name a node.");
737   surf_parse_assert_netpoint(A_surfxml_bypassASroute_gw___dst, "bypassASroute gw_dst='", "' does name a node.");
738 }
739 void STag_surfxml_bypassZoneRoute(){
740   surf_parse_assert_netpoint(A_surfxml_bypassZoneRoute_src, "bypassZoneRoute src='", "' does name a node.");
741   surf_parse_assert_netpoint(A_surfxml_bypassZoneRoute_dst, "bypassZoneRoute dst='", "' does name a node.");
742   surf_parse_assert_netpoint(A_surfxml_bypassZoneRoute_gw___src, "bypassZoneRoute gw_src='", "' does name a node.");
743   surf_parse_assert_netpoint(A_surfxml_bypassZoneRoute_gw___dst, "bypassZoneRoute gw_dst='", "' does name a node.");
744 }
745
746 void ETag_surfxml_route(){
747   simgrid::kernel::routing::RouteCreationArgs route;
748
749   route.src         = sg_netpoint_by_name_or_null(A_surfxml_route_src); // tested to not be nullptr in start tag
750   route.dst         = sg_netpoint_by_name_or_null(A_surfxml_route_dst); // tested to not be nullptr in start tag
751   route.gw_src    = nullptr;
752   route.gw_dst    = nullptr;
753   route.symmetrical = (A_surfxml_route_symmetrical == A_surfxml_route_symmetrical_YES);
754
755   route.link_list.swap(parsed_link_list);
756
757   sg_platf_new_route(&route);
758 }
759
760 void ETag_surfxml_ASroute()
761 {
762   AX_surfxml_zoneRoute_src = AX_surfxml_ASroute_src;
763   AX_surfxml_zoneRoute_dst = AX_surfxml_ASroute_dst;
764   AX_surfxml_zoneRoute_gw___src = AX_surfxml_ASroute_gw___src;
765   AX_surfxml_zoneRoute_gw___dst = AX_surfxml_ASroute_gw___dst;
766   AX_surfxml_zoneRoute_symmetrical = (AT_surfxml_zoneRoute_symmetrical)AX_surfxml_ASroute_symmetrical;
767   ETag_surfxml_zoneRoute();
768 }
769 void ETag_surfxml_zoneRoute()
770 {
771   simgrid::kernel::routing::RouteCreationArgs ASroute;
772
773   ASroute.src = sg_netpoint_by_name_or_null(A_surfxml_zoneRoute_src); // tested to not be nullptr in start tag
774   ASroute.dst = sg_netpoint_by_name_or_null(A_surfxml_zoneRoute_dst); // tested to not be nullptr in start tag
775
776   ASroute.gw_src = sg_netpoint_by_name_or_null(A_surfxml_zoneRoute_gw___src); // tested to not be nullptr in start tag
777   ASroute.gw_dst = sg_netpoint_by_name_or_null(A_surfxml_zoneRoute_gw___dst); // tested to not be nullptr in start tag
778
779   ASroute.link_list.swap(parsed_link_list);
780
781   switch (A_surfxml_zoneRoute_symmetrical) {
782   case AU_surfxml_zoneRoute_symmetrical:
783   case A_surfxml_zoneRoute_symmetrical_YES:
784     ASroute.symmetrical = true;
785     break;
786   case A_surfxml_zoneRoute_symmetrical_NO:
787     ASroute.symmetrical = false;
788     break;
789   default:
790     THROW_IMPOSSIBLE;
791   }
792
793   sg_platf_new_route(&ASroute);
794 }
795
796 void ETag_surfxml_bypassRoute(){
797   simgrid::kernel::routing::RouteCreationArgs route;
798
799   route.src         = sg_netpoint_by_name_or_null(A_surfxml_bypassRoute_src); // tested to not be nullptr in start tag
800   route.dst         = sg_netpoint_by_name_or_null(A_surfxml_bypassRoute_dst); // tested to not be nullptr in start tag
801   route.gw_src = nullptr;
802   route.gw_dst = nullptr;
803   route.symmetrical = false;
804
805   route.link_list.swap(parsed_link_list);
806
807   sg_platf_new_bypassRoute(&route);
808 }
809
810 void ETag_surfxml_bypassASroute()
811 {
812   AX_surfxml_bypassZoneRoute_src = AX_surfxml_bypassASroute_src;
813   AX_surfxml_bypassZoneRoute_dst = AX_surfxml_bypassASroute_dst;
814   AX_surfxml_bypassZoneRoute_gw___src = AX_surfxml_bypassASroute_gw___src;
815   AX_surfxml_bypassZoneRoute_gw___dst = AX_surfxml_bypassASroute_gw___dst;
816   ETag_surfxml_bypassZoneRoute();
817 }
818 void ETag_surfxml_bypassZoneRoute()
819 {
820   simgrid::kernel::routing::RouteCreationArgs ASroute;
821
822   ASroute.src         = sg_netpoint_by_name_or_null(A_surfxml_bypassZoneRoute_src);
823   ASroute.dst         = sg_netpoint_by_name_or_null(A_surfxml_bypassZoneRoute_dst);
824   ASroute.link_list.swap(parsed_link_list);
825
826   ASroute.symmetrical = false;
827
828   ASroute.gw_src = sg_netpoint_by_name_or_null(A_surfxml_bypassZoneRoute_gw___src);
829   ASroute.gw_dst = sg_netpoint_by_name_or_null(A_surfxml_bypassZoneRoute_gw___dst);
830
831   sg_platf_new_bypassRoute(&ASroute);
832 }
833
834 void ETag_surfxml_trace(){
835   simgrid::kernel::routing::ProfileCreationArgs trace;
836
837   trace.id = A_surfxml_trace_id;
838   trace.file = A_surfxml_trace_file;
839   trace.periodicity = surf_parse_get_double(A_surfxml_trace_periodicity);
840   trace.pc_data = surfxml_pcdata;
841
842   sg_platf_new_trace(&trace);
843 }
844
845 void STag_surfxml_trace___connect()
846 {
847   simgrid::kernel::routing::TraceConnectCreationArgs trace_connect;
848
849   trace_connect.element = A_surfxml_trace___connect_element;
850   trace_connect.trace = A_surfxml_trace___connect_trace;
851
852   switch (A_surfxml_trace___connect_kind) {
853   case AU_surfxml_trace___connect_kind:
854   case A_surfxml_trace___connect_kind_SPEED:
855     trace_connect.kind = simgrid::kernel::routing::TraceConnectKind::SPEED;
856     break;
857   case A_surfxml_trace___connect_kind_BANDWIDTH:
858     trace_connect.kind = simgrid::kernel::routing::TraceConnectKind::BANDWIDTH;
859     break;
860   case A_surfxml_trace___connect_kind_HOST___AVAIL:
861     trace_connect.kind = simgrid::kernel::routing::TraceConnectKind::HOST_AVAIL;
862     break;
863   case A_surfxml_trace___connect_kind_LATENCY:
864     trace_connect.kind = simgrid::kernel::routing::TraceConnectKind::LATENCY;
865     break;
866   case A_surfxml_trace___connect_kind_LINK___AVAIL:
867     trace_connect.kind = simgrid::kernel::routing::TraceConnectKind::LINK_AVAIL;
868     break;
869   default:
870     surf_parse_error("Invalid trace kind");
871   }
872   sg_platf_trace_connect(&trace_connect);
873 }
874
875 void STag_surfxml_AS()
876 {
877   AX_surfxml_zone_id = AX_surfxml_AS_id;
878   AX_surfxml_zone_routing = (AT_surfxml_zone_routing)AX_surfxml_AS_routing;
879   STag_surfxml_zone();
880 }
881
882 void ETag_surfxml_AS()
883 {
884   ETag_surfxml_zone();
885 }
886
887 void STag_surfxml_zone()
888 {
889   ZONE_TAG                 = 1;
890   simgrid::kernel::routing::ZoneCreationArgs zone;
891   zone.id      = A_surfxml_zone_id;
892   zone.routing = static_cast<int>(A_surfxml_zone_routing);
893
894   sg_platf_new_Zone_begin(&zone);
895 }
896
897 void ETag_surfxml_zone()
898 {
899   sg_platf_new_Zone_seal();
900 }
901
902 void STag_surfxml_config()
903 {
904   ZONE_TAG = 0;
905   xbt_assert(current_property_set == nullptr,
906              "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
907   XBT_DEBUG("START configuration name = %s",A_surfxml_config_id);
908   if (_sg_cfg_init_status == 2) {
909     surf_parse_error("All <config> tags must be given before any platform elements (such as <zone>, <host>, <cluster>, "
910                      "<link>, etc).");
911   }
912 }
913
914 void ETag_surfxml_config()
915 {
916   // Sort config elements before applying.
917   // That's a little waste of time, but not doing so would break the tests
918   std::vector<std::string> keys;
919   for (auto const& kv : *current_property_set) {
920     keys.push_back(kv.first);
921   }
922   std::sort(keys.begin(), keys.end());
923   for (std::string key : keys) {
924     if (simgrid::config::is_default(key.c_str())) {
925       std::string cfg = key + ":" + current_property_set->at(key);
926       simgrid::config::set_parse(std::move(cfg));
927     } else
928       XBT_INFO("The custom configuration '%s' is already defined by user!", key.c_str());
929   }
930   XBT_DEBUG("End configuration name = %s",A_surfxml_config_id);
931
932   delete current_property_set;
933   current_property_set = nullptr;
934 }
935
936 static std::vector<std::string> arguments;
937
938 void STag_surfxml_process()
939 {
940   AX_surfxml_actor_function = AX_surfxml_process_function;
941   STag_surfxml_actor();
942 }
943
944 void STag_surfxml_actor()
945 {
946   ZONE_TAG  = 0;
947   arguments.assign(1, A_surfxml_actor_function);
948   xbt_assert(current_property_set == nullptr, "Someone forgot to reset the property set to nullptr in its closing tag (or XML malformed)");
949 }
950
951 void ETag_surfxml_process()
952 {
953   AX_surfxml_actor_host = AX_surfxml_process_host;
954   AX_surfxml_actor_function = AX_surfxml_process_function;
955   AX_surfxml_actor_start___time = AX_surfxml_process_start___time;
956   AX_surfxml_actor_kill___time = AX_surfxml_process_kill___time;
957   AX_surfxml_actor_on___failure = (AT_surfxml_actor_on___failure)AX_surfxml_process_on___failure;
958   ETag_surfxml_actor();
959 }
960
961 void ETag_surfxml_actor()
962 {
963   simgrid::kernel::routing::ActorCreationArgs actor;
964
965   actor.properties     = current_property_set;
966   current_property_set = nullptr;
967
968   actor.args.swap(arguments);
969   actor.host       = A_surfxml_actor_host;
970   actor.function   = A_surfxml_actor_function;
971   actor.start_time = surf_parse_get_double(A_surfxml_actor_start___time);
972   actor.kill_time  = surf_parse_get_double(A_surfxml_actor_kill___time);
973
974   switch (A_surfxml_actor_on___failure) {
975   case AU_surfxml_actor_on___failure:
976   case A_surfxml_actor_on___failure_DIE:
977     actor.on_failure = simgrid::kernel::routing::ActorOnFailure::DIE;
978     break;
979   case A_surfxml_actor_on___failure_RESTART:
980     actor.on_failure = simgrid::kernel::routing::ActorOnFailure::RESTART;
981     break;
982   default:
983     surf_parse_error("Invalid on failure behavior");
984   }
985
986   sg_platf_new_actor(&actor);
987 }
988
989 void STag_surfxml_argument(){
990   arguments.push_back(A_surfxml_argument_value);
991 }
992
993 void STag_surfxml_model___prop(){
994   if (not current_model_property_set)
995     current_model_property_set = new std::unordered_map<std::string, std::string>();
996
997   current_model_property_set->insert({A_surfxml_model___prop_id, A_surfxml_model___prop_value});
998 }
999
1000 void ETag_surfxml_prop(){/* Nothing to do */}
1001 void STag_surfxml_random(){/* Nothing to do */}
1002 void ETag_surfxml_random(){/* Nothing to do */}
1003 void ETag_surfxml_trace___connect(){/* Nothing to do */}
1004 void STag_surfxml_trace()
1005 { /* Nothing to do */
1006 }
1007 void ETag_surfxml_router(){/*Nothing to do*/}
1008 void ETag_surfxml_host___link(){/* Nothing to do */}
1009 void ETag_surfxml_cabinet(){/* Nothing to do */}
1010 void ETag_surfxml_peer(){/* Nothing to do */}
1011 void STag_surfxml_backbone(){/* Nothing to do */}
1012 void ETag_surfxml_link___ctn(){/* Nothing to do */}
1013 void ETag_surfxml_argument(){/* Nothing to do */}
1014 void ETag_surfxml_model___prop(){/* Nothing to do */}
1015
1016 /* Open and Close parse file */
1017 YY_BUFFER_STATE surf_input_buffer;
1018
1019 void surf_parse_open(const std::string& file)
1020 {
1021   surf_parsed_filename = file;
1022   std::string dir      = simgrid::xbt::Path(file).get_dir_name();
1023   surf_path.push_back(dir);
1024
1025   surf_file_to_parse = surf_fopen(file, "r");
1026   if (surf_file_to_parse == nullptr) {
1027     std::string cwd = simgrid::xbt::Path().get_name();
1028     xbt_die("Unable to open '%s' from '%s'\n", file.c_str(), cwd.c_str());
1029   }
1030   surf_input_buffer = surf_parse__create_buffer(surf_file_to_parse, YY_BUF_SIZE);
1031   surf_parse__switch_to_buffer(surf_input_buffer);
1032   surf_parse_lineno = 1;
1033 }
1034
1035 void surf_parse_close()
1036 {
1037   surf_path.pop_back(); // remove the dirname of the opened file, that was added in surf_parse_open()
1038
1039   if (surf_file_to_parse) {
1040     surf_parse__delete_buffer(surf_input_buffer);
1041     fclose(surf_file_to_parse);
1042     surf_file_to_parse = nullptr; //Must be reset for Bypass
1043   }
1044 }
1045
1046 /* Call the lexer to parse the currently opened file */
1047 int surf_parse()
1048 {
1049   return surf_parse_lex();
1050 }