SIMGRID_UPDATE_XML(1)

NAME
simgrid_update_xml - updates SimGrid XML files to latest version

SYNOPSIS
simgrid_update_xml xml_file

DESCRIPTION
simgrid_update_xml updates the SimGrid XML file passed as argument. The file is modified in place, without any kind of backup. You may want to save a copy before running the script.

In SimGrid XML files, the standard version is indicated in the version attribute of the platform tag. Current version is 4. Here is a list 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.

          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

COPYRIGHT AND LICENSE
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.