---
name: "simgrid_update_xml"
section: "1"
platform: "linux"
package: "libsimgrid-dev"
version: "4.0-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/simgrid_update_xml"
---

# simgrid\_update\_xml(1)

updates SimGrid XML files to latest version

## 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.