Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
add Exa- and Peta- units to XML
[simgrid.git] / src / surf / xml / simgrid.dtd
1 <!-- 
2              DTD of SimGrid platform and deployment files.
3
4 More info: http://simgrid.gforge.inria.fr/simgrid/latest/doc/platform.html
5 To upgrade your files, use the tool simgrid_update_xml
6
7 * New in DTD version 4 (in SimGrid 3.13):
8    - Rename (power->speed) the attributes describing the amount of flop
9      that a <host>, <peer>, <cluster> or <cabinet> can deliver per second.
10
11    - In <trace_connect>, attribute kind="POWER" is now kind="SPEED".
12    
13    - In <host> and <link>, attributes availability and state are gone.
14      It was redundent with state and availability traces, and with peak values.
15      
16    - In <cluster>, cannot set the availability nor state traces. 
17      This was too complex and unused.
18
19    - The DOCTYPE points to the right URL (this file):
20      http://simgrid.gforge.inria.fr/simgrid/simgrid.dtd
21      
22    - Kill <gpu>. Was not doing anything.
23
24    - A warning is emitted for unit-less values (they are still accepted).
25
26      - speed. Default: 'f' or 'flops'. Also defined:
27         'Yf',         'Zf',         'Ef',       'Pf',        'Tf',        'Gf',        'Mf',        'kf'
28         'yottaflops', 'zettaflops', 'exaflops', 'petaflops', 'teraflops', 'gigaflops', 'megaflops', 'kiloflops'
29
30      - bandwidth. Default: 'Bps' bytes per second
31        In bytes and powers of 2  (1 KiBps = 1024 Bps): 'EiBps', 'PiBps', 'TiBps', 'GiBps', 'MiBps', 'KiBps'
32        In bits  and powers of 2  (1 Bps = 8 bps)     : 'Eibps', 'Pibps', 'Tibps', 'Gibps', 'Mibps', 'Kibps'
33        In bytes and powers of 10 (1 KBps = 1000 Bps) : 'EBps', 'PBps', 'TBps', 'GBps', 'MBps', 'kBps', 'Bps'
34        In bits  and powers of 10                     : 'Ebps', 'Pbps', 'Tbps', 'Gbps', 'Mbps', 'kbps', 'bps'
35        (Exa and Peta notations were introduced in SimGrid v3.14)
36
37      - latency. Default: 's' second. Also defined:
38        'w' week, 'd' day, 'h' hour, 'm' minute, 'ms' millisecond, 'us' microsecond, 'ns' nanosecond, 'ps' picosecond
39
40 * New in DTD version 3 (in SimGrid 3.5):
41    - The AS tag were introduced. Every platform should now
42      contain an englobing AS tag.
43    - Routes are now symmetric by default.
44    - Renamed tags (for sake of XML sanity):
45      - LINK:CTN -> LINK_CTN
46      - TRACE:CONNECT -> TRACE_CONNECT
47
48 * New in DTD version 2 (in SimGrid 3.4):
49    - Renamed tags:
50      - CPU -> HOST
51      - NETWORK_LINK -> LINK
52      - ROUTE_ELEMENT ->  LINK:CTN (changed again in v3)
53      - PLATFORM_DESCRIPTION -> PLATFORM
54
55 * New in DTD version 1 (in SimGrid 3.3):
56    - DTD is now versionned with the version attribute of platform
57    - Unit change: 
58      - Link bandwidth: from Mb/s to b/s
59      - CPU speed: from MFlop/s to Flop/s
60
61 -->
62
63 <!ELEMENT platform ((config|random)*,(include|cluster|cabinet|peer|AS|trace|trace_connect)*,(process)*)>
64 <!ATTLIST platform version CDATA "0.0">
65
66 <!ELEMENT include (include|cluster|cabinet|peer|AS|trace|trace_connect)*>
67 <!ATTLIST include file CDATA #REQUIRED>
68
69 <!ELEMENT trace (#PCDATA)>
70 <!ATTLIST trace id CDATA #REQUIRED>
71 <!ATTLIST trace file CDATA "">
72 <!ATTLIST trace periodicity CDATA #REQUIRED>
73
74 <!ELEMENT random EMPTY>
75 <!ATTLIST random id CDATA #REQUIRED>
76 <!ATTLIST random min CDATA #REQUIRED>
77 <!ATTLIST random max CDATA #REQUIRED>
78 <!ATTLIST random mean CDATA #REQUIRED>
79 <!ATTLIST random std_deviation CDATA #REQUIRED>
80 <!ATTLIST random seed CDATA "2147483647">
81 <!ATTLIST random radical CDATA "">
82 <!ATTLIST random generator (DRAND48|RAND|RNGSTREAM|NONE) "DRAND48">
83
84 <!ELEMENT trace_connect EMPTY>
85 <!ATTLIST trace_connect kind (HOST_AVAIL|SPEED|LINK_AVAIL|BANDWIDTH|LATENCY) "HOST_AVAIL">
86 <!ATTLIST trace_connect trace CDATA #REQUIRED>
87 <!ATTLIST trace_connect element CDATA #REQUIRED>
88
89 <!ELEMENT AS ((prop*), ((AS|ASroute|include|storage_type|storage|link|backbone|cabinet|router|host|cluster|peer|host_link)*,(route|ASroute|trace|trace_connect|bypassRoute|bypassASroute)*))>
90 <!ATTLIST AS id CDATA #REQUIRED>
91 <!ATTLIST AS routing (Full|Floyd|Dijkstra|DijkstraCache|None|Vivaldi|Cluster|ClusterTorus|ClusterFatTree|ClusterDragonfly) #REQUIRED>
92
93 <!ELEMENT storage_type ((model_prop|prop)*)>
94 <!ATTLIST storage_type id       CDATA #REQUIRED>
95 <!ATTLIST storage_type model    CDATA #REQUIRED>
96 <!ATTLIST storage_type size     CDATA #REQUIRED>
97 <!ATTLIST storage_type content  CDATA "">
98 <!ATTLIST storage_type content_type  CDATA "txt_unix">
99
100 <!ELEMENT mount EMPTY>
101 <!ATTLIST mount storageId CDATA #REQUIRED>
102 <!ATTLIST mount name CDATA #REQUIRED>
103
104 <!ELEMENT host (prop|mount)*>
105 <!ATTLIST host id CDATA #REQUIRED>
106 <!ATTLIST host speed CDATA #REQUIRED>
107 <!ATTLIST host core  CDATA "1">
108 <!ATTLIST host availability_file CDATA "">
109 <!ATTLIST host state_file CDATA "">
110 <!ATTLIST host coordinates  CDATA "">
111 <!ATTLIST host pstate CDATA "0.0">
112
113 <!ELEMENT storage (prop*)>
114 <!ATTLIST storage id CDATA #REQUIRED>
115 <!ATTLIST storage typeId CDATA #REQUIRED>
116 <!ATTLIST storage content  CDATA "">
117 <!ATTLIST storage content_type  CDATA "txt_unix">
118 <!ATTLIST storage attach CDATA #REQUIRED>
119
120 <!ELEMENT host_link EMPTY>
121 <!ATTLIST host_link id CDATA #REQUIRED>
122 <!ATTLIST host_link up CDATA #REQUIRED>
123 <!ATTLIST host_link down CDATA #REQUIRED>
124
125 <!ELEMENT cluster (prop*)>
126 <!ATTLIST cluster id CDATA #REQUIRED>
127 <!ATTLIST cluster prefix CDATA #REQUIRED>
128 <!ATTLIST cluster suffix CDATA #REQUIRED>
129 <!ATTLIST cluster radical CDATA #REQUIRED>
130 <!ATTLIST cluster speed CDATA #REQUIRED>
131 <!ATTLIST cluster core CDATA "1">
132 <!ATTLIST cluster bw CDATA #REQUIRED>
133 <!ATTLIST cluster lat CDATA #REQUIRED>
134 <!ATTLIST cluster sharing_policy (SHARED|FULLDUPLEX|FATPIPE) "FULLDUPLEX">
135 <!ATTLIST cluster topology (FLAT|TORUS|FAT_TREE|DRAGONFLY) "FLAT">
136 <!ATTLIST cluster topo_parameters CDATA "">
137 <!ATTLIST cluster bb_bw CDATA "">
138 <!ATTLIST cluster bb_lat CDATA "0s">
139 <!ATTLIST cluster bb_sharing_policy (SHARED|FATPIPE) "SHARED">
140 <!ATTLIST cluster router_id CDATA "">
141 <!ATTLIST cluster limiter_link CDATA "">
142 <!ATTLIST cluster loopback_bw CDATA "">
143 <!ATTLIST cluster loopback_lat CDATA "">
144
145 <!ELEMENT cabinet EMPTY>
146 <!ATTLIST cabinet id CDATA #REQUIRED>
147 <!ATTLIST cabinet prefix CDATA #REQUIRED>
148 <!ATTLIST cabinet suffix CDATA #REQUIRED>
149 <!ATTLIST cabinet radical CDATA #REQUIRED>
150 <!ATTLIST cabinet speed CDATA #REQUIRED>
151 <!ATTLIST cabinet bw CDATA #REQUIRED>
152 <!ATTLIST cabinet lat CDATA #REQUIRED>
153
154 <!ELEMENT peer EMPTY>
155 <!ATTLIST peer id CDATA #REQUIRED>
156 <!ATTLIST peer speed CDATA #REQUIRED>
157 <!ATTLIST peer bw_in CDATA #REQUIRED>
158 <!ATTLIST peer bw_out CDATA #REQUIRED>
159 <!ATTLIST peer lat CDATA #REQUIRED>
160 <!ATTLIST peer coordinates CDATA "">
161 <!ATTLIST peer availability_file CDATA "">
162 <!ATTLIST peer state_file CDATA "">
163
164 <!ELEMENT router EMPTY>
165 <!ATTLIST router id CDATA #REQUIRED>
166 <!ATTLIST router coordinates  CDATA "">
167
168 <!ELEMENT backbone EMPTY>
169 <!ATTLIST backbone id CDATA #REQUIRED>
170 <!ATTLIST backbone bandwidth CDATA  #REQUIRED>
171 <!ATTLIST backbone latency CDATA #REQUIRED>
172
173 <!ELEMENT link (prop*)>
174 <!ATTLIST link id CDATA #REQUIRED>
175 <!ATTLIST link bandwidth CDATA  #REQUIRED>
176 <!ATTLIST link bandwidth_file CDATA "">
177 <!ATTLIST link latency CDATA "0">
178 <!ATTLIST link latency_file CDATA "">
179 <!ATTLIST link state_file CDATA "">
180 <!ATTLIST link sharing_policy (SHARED|FATPIPE|FULLDUPLEX) "SHARED">
181
182 <!ELEMENT route (link_ctn*)>
183 <!ATTLIST route src CDATA #REQUIRED>
184 <!ATTLIST route dst CDATA #REQUIRED>
185 <!ATTLIST route symmetrical (YES|NO) "YES">
186
187 <!ELEMENT ASroute (link_ctn*)>
188 <!ATTLIST ASroute src CDATA #REQUIRED>
189 <!ATTLIST ASroute dst CDATA #REQUIRED>
190 <!ATTLIST ASroute gw_src CDATA #REQUIRED>
191 <!ATTLIST ASroute gw_dst CDATA #REQUIRED>
192 <!ATTLIST ASroute symmetrical (YES|NO) "YES">
193
194 <!ELEMENT link_ctn EMPTY>
195 <!ATTLIST link_ctn id CDATA #REQUIRED>
196 <!ATTLIST link_ctn direction (UP|DOWN|NONE) "NONE">
197
198 <!ELEMENT bypassRoute (link_ctn*)>
199 <!ATTLIST bypassRoute src CDATA #REQUIRED>
200 <!ATTLIST bypassRoute dst CDATA #REQUIRED>
201
202 <!ELEMENT bypassASroute (link_ctn*)>
203 <!ATTLIST bypassASroute src CDATA #REQUIRED>
204 <!ATTLIST bypassASroute dst CDATA #REQUIRED>
205 <!ATTLIST bypassASroute gw_src CDATA #REQUIRED>
206 <!ATTLIST bypassASroute gw_dst CDATA #REQUIRED>
207
208 <!ELEMENT process ((argument|prop)*)>
209 <!ATTLIST process host CDATA #REQUIRED>
210 <!ATTLIST process function CDATA #REQUIRED>
211 <!ATTLIST process start_time CDATA "-1.0">
212 <!ATTLIST process kill_time CDATA "-1.0">
213 <!ATTLIST process on_failure (DIE|RESTART) "DIE">
214
215 <!ELEMENT argument EMPTY>
216 <!ATTLIST argument value CDATA #REQUIRED>
217
218 <!ELEMENT config (prop*)>
219 <!ATTLIST config id CDATA "">
220
221 <!ELEMENT prop EMPTY>
222 <!ATTLIST prop id CDATA #REQUIRED> <!-- <!ATTLIST prop key CDATA #REQUIRED> -->
223 <!ATTLIST prop value CDATA #REQUIRED>
224
225 <!ELEMENT model_prop EMPTY>
226 <!ATTLIST model_prop id CDATA #REQUIRED> <!-- <!ATTLIST model_prop key CDATA #REQUIRED> -->
227 <!ATTLIST model_prop value CDATA #REQUIRED>