SIMGRID_UPDATE_XML(1)

🌸 NAME 🌸

simgrid_update_xml β€” bestie, it updates your SimGrid XML files to the latest version ✨ no cap, it just drags your crusty old platform files into the modern era πŸ’…

(this is a page from the Perl manual, section 1 β€” yes, our girlypop lives in SIMGRID_UPDATE_XML(1))


πŸ¦‹ SYNOPSIS πŸ¦‹

simgrid_update_xml xml_file

πŸ’– DESCRIPTION πŸ’–

Okay so simgrid_update_xml updates the SimGrid XML file you hand it as an argument. That's it. That's the whole job 🫢

🚨 GIRL. READ THIS FIRST. The file is modified in place, with no backup of any kind. None. Zero. You may want to save a copy before running the script. Please save a copy. I'm begging πŸ™ˆ

So inside SimGrid XML files, the standard version is chilling in the version attribute of the platform tag. Current version is 4. And here's the whole glow-up timeline of major changes in each version πŸ‘‘

⭐ Version 0

Used before SimGrid 3.3

⭐ Version 1

Introduced in SimGrid 3.3

  • The version attribute of platform were added to allow file versioning.
  • The link bandwidth changed from Mb/s to b/s; and the CPU power were changed from MFlop/s to Flop/s

⭐ Version 2

Introduced in SimGrid 3.4

  • Several tags were renamed:
  CPU -> HOST
  NETWORK_LINK -> LINK
  ROUTE_ELEMENT ->  LINK_CTN
  PLATFORM_DESCRIPTION -> PLATFORM

⭐ Version 3

Introduced in SimGrid 3.5

  • The AS tag were introduced. Every platform should now contain an englobing AS tag.
  • Routes are now symmetric by default.
  • Several tags were renamed (for sake of XML sanity):
  LINK:CTN -> LINK_CTN
  TRACE:CONNECT -> TRACE_CONNECT

⭐ Version 4

Introduced in SimGrid 3.13

  • Rename the attributes describing the amount of flop that a host / peer / cluster / cabinet can deliver per second.
  <host power=...> -> <host speed=...>
  • In <trace_connect>, attribute kind="POWER" is now kind="SPEED".
  • The DOCTYPE points to the right URL.
  • Units are now mandatory in attributes. USE THE SCRIPT sg_xml_unit_converter.py TO CONVERT THIS
      - speed. Old default: 'f' or 'flops'. Also defined:
        'Yf',         'Zf',         'Ef',       'Pf',        'Tf',        'Gf',        'Mf',        'kf'
        'yottaflops', 'zettaflops', 'exaflops', 'petaflops', 'teraflops', 'gigaflops', 'megaflops', 'kiloflops'

      - bandwidth. Old default: 'Bps' bytes per second (or 'bps' but 1 Bps = 8 bps)
        Also defined in bytes: 'TiBps', 'GiBps', 'MiBps', 'KiBps', 'TBps', 'GBps', 'MBps', 'kBps', 'Bps'
        And the same in bits:  'Tibps', 'Gibps', 'Mibps', 'Kibps', 'Tbps', 'Gbps', 'Mbps', 'kbps', 'bps'

      - latency. Old default: 's' second. Also defined:
        'w' week, 'd' day, 'h' hour, 'm' minute, 'ms' millisecond, 'us' microsecond, 'ns' nanosecond, 'ps' picosecond

⭐ Version 4.1

Introduced in SimGrid 3.16 (this is the current version).

  • Rename a few tags, but in a backward-compatible manner: the old names are still accepted. Iconic behaviour, honestly πŸ’…
  AS            -> zone
  ASroute       -> zoneRoute
  bypassAsRoute -> bypassZoneRoute
  process       -> actor

Other backward-compatible changes (old syntax is still accepted) for which we did not bump the DTD version:

  • Rename the FULLDUPLEX sharing into SPLITDUPLEX.
  • In <host> and <peer>, rename the 'availability_file' attribute into 'speed_file'.

πŸŽ€ AUTHORS πŸŽ€

The SimGrid team πŸ’œ (absolute legends, fr fr)


Copyright (c) 2006-2025. The SimGrid Team. All rights reserved.

This program is free software; you may redistribute it and/or modify it under the terms of GNU LGPL (v2.1) license.


And that's the whole vibe check, bestie πŸ¦‹ this came to you courtesy of perl v5.42.3, dated 2026-09-23 β€” slay, go update those XML files, but make a backup first, I'm not playing with you πŸ˜­πŸ’–

πŸ“¦ where this page comes from