Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Added some stuff about deployment to please Fred. Corrected some stuff.
authorlbobelin <lbobelin@mintcar.imag.fr>
Fri, 29 Jun 2012 20:00:53 +0000 (22:00 +0200)
committerlbobelin <lbobelin@mintcar.imag.fr>
Fri, 29 Jun 2012 20:00:53 +0000 (22:00 +0200)
doc/user_guide/doxygen/deployment.doc [new file with mode: 0644]
doc/user_guide/doxygen/examples.doc [new file with mode: 0644]

index 0bfdd0f..f457554 100644 (file)
@@ -592,6 +592,7 @@ set(USER_GUIDE_SOURCES
+  doc/user_guide/doxygen/deployment.doc
index 5b454de..1bf013f 100644 (file)
@@ -664,6 +664,7 @@ INPUT                  = index.doc \
                          examples.doc \            
                          options.doc \
                          platform.doc \
+                         deployment.doc \
                          tracing.doc \
                          pls.doc \
diff --git a/doc/user_guide/doxygen/deployment.doc b/doc/user_guide/doxygen/deployment.doc
new file mode 100644 (file)
index 0000000..355cf35
--- /dev/null
@@ -0,0 +1,38 @@
+/*! \page deployment Deployment description
+Deployment just consists of saying which
+process runs where and which arguments it should take as input, the easier way to
+understand how to write it is just to take a look at the examples. Here is an example of it:
+<?xml version='1.0'?>
+<!DOCTYPE platform SYSTEM "http://simgrid.gforge.inria.fr/simgrid.dtd">
+<platform version="3">
+  <!-- The master process (with some arguments) -->
+  <process host="Tremblay" function="master">
+     <argument value="20"/>       <!-- Number of tasks -->
+     <argument value="50000000"/>  <!-- Computation size of tasks -->
+     <argument value="1000000"/>   <!-- Communication size of tasks -->
+     <argument value="Jupiter"/>  <!-- First slave -->
+     <argument value="Fafard"/>   <!-- Second slave -->
+     <argument value="Ginette"/>  <!-- Third slave -->
+     <argument value="Bourassa"/> <!-- Last slave -->
+     <argument value="Tremblay"/> <!-- Me! I can work too! -->
+  </process>
+  <!-- The slave processes (with no argument) -->
+  <process host="Tremblay" function="slave"/>
+  <process host="Jupiter" function="slave"/>
+  <process host="Fafard" function="slave"/>
+  <process host="Ginette" function="slave"/>
+  <process host="Bourassa" function="slave"/>
+There are additional attributes to the process tag, here is a list of attributes of process: 
+\li <b>host CDATA (mandatory)</b>: the host on which the function will be executed.  
+\li <b>process CDATA (mandatory)</b>: the process function that will be executed on that host.
+\li <b>start_time</b>: the time when the function will start. Default is zero.
+\li <b>kill_time</b>: the time when the function will stop. Default is when it's actually finishing.
diff --git a/doc/user_guide/doxygen/examples.doc b/doc/user_guide/doxygen/examples.doc
new file mode 100644 (file)
index 0000000..e9053e9
--- /dev/null
@@ -0,0 +1,10 @@
+\defgroup MSG_examples MSG examples
+\brief MSG examples from examples directory examples/msg
+MSG comes with an extensive set of examples. It is sometimes difficult to find the one you need. This list aims at helping you finding the example from which you can learn what you want to.
+\section msg_bsc_ex Basic examples
index f4f4eab..72d45f1 100644 (file)
@@ -11,35 +11,9 @@ to its doc. (you can also  check the section  \ref pf_flexml_bypassing but this
 \li You can use two XML files: a platform description file and a deployment
 description one.
-As the second one (deployment description) just consists of saying which
-process runs where and which arguments it should take as input, the easier way to
-understand how to write it is just to take a look at the examples. Here is an example of it:
+For the deployment stuff, please takea look at \ref deployment
-<?xml version='1.0'?>
-<!DOCTYPE platform SYSTEM "http://simgrid.gforge.inria.fr/simgrid.dtd">
-<platform version="3">
-  <!-- The master process (with some arguments) -->
-  <process host="Tremblay" function="master">
-     <argument value="20"/>       <!-- Number of tasks -->
-     <argument value="50000000"/>  <!-- Computation size of tasks -->
-     <argument value="1000000"/>   <!-- Communication size of tasks -->
-     <argument value="Jupiter"/>  <!-- First slave -->
-     <argument value="Fafard"/>   <!-- Second slave -->
-     <argument value="Ginette"/>  <!-- Third slave -->
-     <argument value="Bourassa"/> <!-- Last slave -->
-     <argument value="Tremblay"/> <!-- Me! I can work too! -->
-  </process>
-  <!-- The slave processes (with no argument) -->
-  <process host="Tremblay" function="slave"/>
-  <process host="Jupiter" function="slave"/>
-  <process host="Fafard" function="slave"/>
-  <process host="Ginette" function="slave"/>
-  <process host="Bourassa" function="slave"/>
-The platform description is slightly more complicated. This documentation is all about how to write this file: what are the basic concept it relies on, what possibilities are offered, and some hints and tips on how to write a good platform description.
+The platform description may be complicated. This documentation is all about how to write this file: what are the basic concept it relies on, what possibilities are offered, and some hints and tips on how to write a good platform description.
 \section pf_overview Some words about XML and DTD
@@ -159,10 +133,6 @@ 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>
     <platform version="1">