Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
recommit my initial version of cloud stuff for 3.8. Hopefully with all files
[simgrid.git] / doc / platform.doc
index 9e09a04..5aff0e6 100644 (file)
@@ -8,7 +8,7 @@ application, and finally it needs something to know where to deploy what.
 
 For the latest 2 entries, you have basically 2 ways to give it as an input :
 \li You can program it, either using the Lua console (\ref MSG_Lua_funct) or if you're using MSG some 
-of its platform and deployments functions(\ref msg_easier_life). If you want to use it, please refer 
+of its platform and deployments functions(\ref msg_simulation). If you want to use it, please refer 
 to its doc. (you can also  check the section  \ref pf_flexml_bypassing but this is strongly deprecated, as there is a new way to do it properly, but not yet documented).
 \li You can use two XML files: a platform description file and a deployment 
 description one.
@@ -161,6 +161,10 @@ It is also possible to seamlessly declare a host whose
 availability changes over time using the availability_file
 attribute and a separate text file whose syntax is exemplified below.
 
+
+<b>IMPORTANT NOTE:</b> the numeric separator in both trace and availability depends on your system locale. Examples below holds for LC_NUMERIC=C. 
+
+
 <b>Adding a trace file</b>
 \verbatim
     <platform version="1">
@@ -406,7 +410,10 @@ As an host, a <b>link</b> tag can also contain the <b>prop</b> tag.
 
 \subsection pf_storage Storage
 <b>Note : This is a prototype version that should evolve quickly, this is just some doc valuable only at the time of writing this doc</b>
-This section describes the storage management under SimGrid ; nowadays it's only usable with MSG. It relies basically on linux-like concepts. You also may want to have a look to its corresponding section in \ref m_file_management ; functions access are organized as a POSIX-like interface.
+This section describes the storage management under SimGrid ; nowadays
+it's only usable with MSG. It relies basically on linux-like concepts.
+You also may want to have a look to its corresponding section in \ref
+msg_file_management ; functions access are organized as a POSIX-like interface.
 
 \subsubsection pf_sto_conc Storage Main concepts
 Basically there is 3 different entities to know : 
@@ -887,9 +894,19 @@ All constraints you have is that <b>trace_connect</b> is after <b>trace</b> and
 
 <b>trace</b> attributes : 
 \li <b>id (mandatory)</b>: the identifier of the trace to be used when referring to it.
-\li <b>file</b>: filename of the file to include. Possible values : absolute or relative path, syntax similar to the one in use on your system.
+\li <b>file</b>: filename of the file to include. Possible values : absolute or relative path, syntax similar to the one in use on your system. If ommited, the system expects that you provide the trace values inside the trace tags (see below).
 \li <b>trace periodicity (mandatory)</b>: trace periodicity, same definition as in hosts (see upper for details).
 
+Here is an example  of trace when no file name is provided: 
+
+\verbatim
+ <trace id="myTrace" periodicity="1.0">
+    0.0 1.0
+    11.0 0.5
+    20.0 0.8
+  </trace>
+\endverbatim
+
 <b>trace_connect</b> attributes : 
 \li <b>kind</b>: the type of trace, possible values <b>HOST_AVAIL|POWER|LINK_AVAIL|BANDWIDTH|LATENCY,</b>  default: <b>HOST_AVAIL</b>
 \li <b>trace (mandatory)</b>: the identifier of the trace referenced.