Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Remove doc items about gras.
authorArnaud Giersch <arnaud.giersch@iut-bm.univ-fcomte.fr>
Fri, 23 Nov 2012 15:45:59 +0000 (16:45 +0100)
committerArnaud Giersch <arnaud.giersch@iut-bm.univ-fcomte.fr>
Fri, 23 Nov 2012 15:48:24 +0000 (16:48 +0100)
doc/FAQ.doc
doc/ref_guide/doxygen/main.doc
doc/ref_guide/doxygen/module-xbt.doc
doc/ref_guide/doxygen/modules.doc
doc/shared/fig/simgrid_modules2.fig
doc/user_guide/doxygen/pls.doc

index fe82f4e..c2b2d89 100644 (file)
@@ -15,7 +15,7 @@ MSG_examples.
 If you are stuck at any point and if this FAQ cannot help you, please drop us a
 mail to the user mailing list: <simgrid-user@lists.gforge.inria.fr>.
 
 If you are stuck at any point and if this FAQ cannot help you, please drop us a
 mail to the user mailing list: <simgrid-user@lists.gforge.inria.fr>.
 
-\subsection faq_interfaces What is the difference between MSG, SimDag, and GRAS? Do they serve the same purpose?
+\subsection faq_interfaces What is the difference between MSG and SimDag? Do they serve the same purpose?
 
 It depend on how you define "purpose", I guess ;)
 
 
 It depend on how you define "purpose", I guess ;)
 
@@ -29,16 +29,9 @@ parallel tasks. So, in this model, applications can be seen as a DAG of
 tasks. This is the interface of choice for people wanting to port old
 code designed for SimGrid v1 or v2 to the framework current version.
 
 tasks. This is the interface of choice for people wanting to port old
 code designed for SimGrid v1 or v2 to the framework current version.
 
-With both GRAS and MSG, your application is seen as a set of communicating
-processes, exchanging data by the way of messages and performing computation
-on their own.
-
-The difference between both is that MSG is somehow easier to use, but GRAS
-is not limited to the simulator. Once you're done writing your GRAS code,
-you can run your code both in the simulator and on a real platform. For this,
-there are two implementations of the GRAS interface, one for simulation, and one
-for real execution. So, you just have to relink your code to choose one of
-both worlds.
+With MSG, your application is seen as a set of communicating
+processes, exchanging data by the way of messages and performing
+computation on their own.
 
 \subsection faq_visualization Visualizing and analyzing the results
 
 
 \subsection faq_visualization Visualizing and analyzing the results
 
@@ -73,7 +66,7 @@ we do not feel a real demand for any other language. But if you think there is o
 
 \subsection faq_MIA "Could you please add (your favorite feature here) to SimGrid?"
 
 
 \subsection faq_MIA "Could you please add (your favorite feature here) to SimGrid?"
 
-Here is the deal. The whole SimGrid project (MSG, SURF, GRAS, ...) is
+Here is the deal. The whole SimGrid project (MSG, SURF, ...) is
 meant to be kept as simple and generic as possible. We cannot add
 functions for everybody's needs when these functions can easily be
 built from the ones already in the API. Most of the time, it is
 meant to be kept as simple and generic as possible. We cannot add
 functions for everybody's needs when these functions can easily be
 built from the ones already in the API. Most of the time, it is
@@ -609,46 +602,6 @@ such a crude usage of FleXML. So, we now have to repair the bypassing
 functionality to use the latest FleXML version and fix the memory usage in
 SimGrid.
 
 functionality to use the latest FleXML version and fix the memory usage in
 SimGrid.
 
-\subsubsection faq_trouble_gras_transport GRAS spits networking error messages
-
-Gras, on real platforms, naturally use regular sockets to communicate. They
-are deeply hidden in the gras abstraction, but when things go wrong, you may
-get some weird error messages. Here are some example, with the probable
-reason:
-
- - <b>Transport endpoint is not connected</b>: several processes try to open
-   a server socket on the same port number of the same machine. This is
-   naturally bad and each process should pick its own port number for this.\n
-   Maybe, you just have some processes remaining from a previous experiment
-   on your machine.\n
-   Killing them may help, but again if you kill -KILL them, you'll have to
-   wait for a while: they didn't close there sockets properly and the system
-   needs a while to notice that this port is free again.
-
- - <b>Socket closed by remote side</b>: if the remote process is not
-   supposed to close the socket at this point, it may be dead.
-
- - <b>Connection reset by peer</b>: I found this on Internet about this
-   error. I think it's what's happening here, too:\n
-   <i>This basically means that a network error occurred while the client was
-   receiving data from the server. But what is really happening is that the
-   server actually accepts the connection, processes the request, and sends
-   a reply to the client. However, when the server closes the socket, the
-   client believes that the connection has been terminated abnormally
-   because the socket implementation sends a TCP reset segment telling the
-   client to throw away the data and report an error.\n
-   Sometimes, this problem is caused by not properly closing the
-   input/output streams and the socket connection. Make sure you close the
-   input/output streams and socket connection properly. If everything is
-   closed properly, however, and the problem persists, you can work around
-   it by adding a one-second sleep before closing the streams and the
-   socket. This technique, however, is not reliable and may not work on all
-   systems.</i>\n
-   Since GRAS sockets are closed properly (repeat after me: there is no bug
-   in GRAS), it is either that you are closing your sockets on server side
-   before the client get a chance to read them (use gras_os_sleep() to delay
-   the server), or the server died awfully before the client got the data.
-
 \subsubsection faq_trouble_errors_big_fat_warning I'm told that my XML files are too old.
 
 The format of the XML platform description files is sometimes
 \subsubsection faq_trouble_errors_big_fat_warning I'm told that my XML files are too old.
 
 The format of the XML platform description files is sometimes
index a923f02..d6e0e6a 100644 (file)
@@ -78,22 +78,6 @@ your work.
    MPI) programming environment. Unfortunately, this work is still underway.
    Check the \ref SMPI_API section for more information.
 
    MPI) programming environment. Unfortunately, this work is still underway.
    Check the \ref SMPI_API section for more information.
 
- - If you want to develop a real distributed application, then you may find
-   <b>\ref GRAS_API</b> (Grid Reality And Simulation) useful. This is an API
-   for the realization of distributed applications.
-   \n\n
-   Moreover, there is two implementations of this API: one on top of the
-   SURF (allowing to develop and test your application within the comfort of
-   the simulator) and another suited for deployment on real platforms
-   (allowing the resulting application to be highly portable and extremely
-   efficient).
-   \n\n
-   Even if you do not plan to run your code for real, you may want to switch
-   to GRAS if you intend to use MSG in a very intensive way (e.g. for
-   simulating a peer-to-peer environment).
-   \n\n
-   See the \ref GRAS_API section for more details.
-
 If your favorite programming environment/model is not there (BSP,
 components, OpenMP, etc.) is not represented in the SimGrid toolkit yet, you may
 consider adding it. You should contact us first on the
 If your favorite programming environment/model is not there (BSP,
 components, OpenMP, etc.) is not represented in the SimGrid toolkit yet, you may
 consider adding it. You should contact us first on the
index 8fdd0e5..2d9b8ea 100644 (file)
@@ -99,7 +99,7 @@
   *
   *  You shouldn't use it directly since it is merely intended to ease the
   *  implementation of the several programmation environment of the
   *
   *  You shouldn't use it directly since it is merely intended to ease the
   *  implementation of the several programmation environment of the
-  *  SimGrid toolkit (namely, \ref MSG_API, \ref GRAS_API and \ref SMPI_API).
+  *  SimGrid toolkit (namely, \ref MSG_API and \ref SMPI_API).
   *
   *  You should use those environments instead.
   */
   *
   *  You should use those environments instead.
   */
index 54ff191..415bc82 100644 (file)
@@ -17,8 +17,7 @@
       given problem you don't really want to implement.
       If you want to use DAGs, have a look at the \ref SD_API programming
       environment.
       given problem you don't really want to implement.
       If you want to use DAGs, have a look at the \ref SD_API programming
       environment.
-      If you want to get a real (but experimental) implementation of your solution, have a look
-      at the \ref GRAS_API one. If you want to study an existing MPI program,
+      If you want to study an existing MPI program,
       have a look at the \ref SMPI_API one. If none of those programming
       environments fits your needs, you may consider implementing your own
       directly on top of \ref SURF_API (but you probably want to contact us
       have a look at the \ref SMPI_API one. If none of those programming
       environments fits your needs, you may consider implementing your own
       directly on top of \ref SURF_API (but you probably want to contact us
 */
 
 
 */
 
 
-/** \defgroup GRAS_API      GRAS
-    \brief Realistic programming environment (Grid Reality And Simulation)
-
-    GRAS provides a complete API to implement distributed application on top
-    of heterogeneous plateforms. In addition to the SimGrid implementation
-    of this interface (allowing you to work on your application within the
-    comfort of the simulator), an implementation suited to real platforms is
-    also provided (allowing you to really use your application once you're
-    done with developing it). It may still contain rought corners as
-    GRAS is not the most used part of SimGrid, however.
-
-    GRAS thus constitute a complete grid application developement framework,
-    encompassing both developer helping tools (the simulator and associated
-    tools) and an efficient while portable execution runtime.
-
-    \section GRAS_who Who should use this (and who shouldn't)
-
-    You should use this programming environment if you want to develop real
-    applications, ie if the final result of your work is a program which
-    may eventually be distributed. Rember however that GRAS is
-    considered as experimental at this point. Help would be welcomed
-    to improve this sorry situation...
-
-    If you just want to study some heuristics for a given problem you don't
-    want to implement really (ie, if your result would be a theorem), have a
-    look at the \ref MSG_API one, or the \ref SD_API one if you need to use DAGs.
-    If you want to study an existing MPI program, have a look at the
-    \ref SMPI_API one.
-    If none of those programming environments fits your needs, you may
-    consider implementing your own directly on top of \ref SURF_API (but you
-    probably want to contact us before).
-*/
-
-/** \defgroup AMOK_API AMOK
-    \brief Distributed toolkit built over \ref GRAS_API (Advanced Metacomputing Overlay Kit)
-
-    AMOK provides several tools useful to most applications built on top of GRAS,
-    but yet not belonging to GRAS itself. It is planned that those modules will be
-    changed to real plugins one day, allowing users to load only the needed parts at
-    run time. For now, they live in another library against which you should link your
-    programs explicitly.
-*/
-
 /** \defgroup SMPI_API      SMPI
     \brief Programming environment for the simulation of MPI applications
 
 /** \defgroup SMPI_API      SMPI
     \brief Programming environment for the simulation of MPI applications
 
@@ -89,15 +45,13 @@ detailed below.
 \section SMPI_who Who should use SMPI (and who shouldn't)
 
 You should use this programming environment of the SimGrid suite if
 \section SMPI_who Who should use SMPI (and who shouldn't)
 
 You should use this programming environment of the SimGrid suite if
-you want to study existing MPI applications. If you want to create a
-distributed application, you may be interested in the \ref GRAS_API
-environment instead (but note that GRAS is not very actively
-maintained nowadays). If you want to study some heuristics for a given
-problem (and if your goal is to produce theorems and publications, not
-code), have a look at the \ref MSG_API environment, or the \ref SD_API
-one if you need to use DAGs. If none of those programming environments
-fits your needs, you may consider implementing your own directly on
-top of \ref SURF_API (but you probably want to contact us before).
+you want to study existing MPI applications.  If you want to study
+some heuristics for a given problem (and if your goal is to produce
+theorems and publications, not code), have a look at the \ref MSG_API
+environment, or the \ref SD_API one if you need to use DAGs. If none
+of those programming environments fits your needs, you may consider
+implementing your own directly on top of \ref SURF_API (but you
+probably want to contact us before).
 
 \section SMPI_what What can run within SMPI?
 
 
 \section SMPI_what What can run within SMPI?
 
@@ -195,8 +149,6 @@ smpirun -help
     to study algorithms and heuristics with DAGs of parallel tasks.
     If you don't need to use DAGs for your simulation, have a look at the
     \ref MSG_API programming environment.
     to study algorithms and heuristics with DAGs of parallel tasks.
     If you don't need to use DAGs for your simulation, have a look at the
     \ref MSG_API programming environment.
-    If you want to implement a real distributed application, have a look at the
-    \ref GRAS_API programming environment.
     If you want to study an existing MPI program, have a look at the
     \ref SMPI_API one.
     If none of those programming environments fits your needs, you may
     If you want to study an existing MPI program, have a look at the
     \ref SMPI_API one.
     If none of those programming environments fits your needs, you may
index 50f6f12..16e0dd4 100644 (file)
@@ -1,4 +1,4 @@
-#FIG 3.2  Produced by xfig version 3.2.5-alpha5
+#FIG 3.2  Produced by xfig version 3.2.5b
 Landscape
 Center
 Metric
 Landscape
 Center
 Metric
@@ -14,7 +14,7 @@ Single
 0 36 #a5a6a5
 0 37 #ff9700
 6 -158 4680 7987 5175
 0 36 #a5a6a5
 0 37 #ff9700
 6 -158 4680 7987 5175
-4 1 0 50 -1 4 12 0.0000 2 210 8595 3914 5115 Grounding features (logging, etc.), usual data structures (lists, sets, etc.) and portability layer\001
+4 1 0 50 -1 4 12 0.0000 2 195 8085 3914 5115 Grounding features (logging, etc.), usual data structures (lists, sets, etc.) and portability layer\001
 4 1 0 50 -1 4 14 0.0000 2 180 480 3914 4860 XBT\001
 -6
 6 -1215 -900 9045 -180
 4 1 0 50 -1 4 14 0.0000 2 180 480 3914 4860 XBT\001
 -6
 6 -1215 -900 9045 -180
@@ -23,58 +23,24 @@ Single
 # href="/contrib.html" ALT="Contrib"
 2 2 0 1 0 37 55 -1 20 0.000 0 0 -1 0 0 5
         5670 -315 8370 -315 8370 -810 5670 -810 5670 -315
 # href="/contrib.html" ALT="Contrib"
 2 2 0 1 0 37 55 -1 20 0.000 0 0 -1 0 0 5
         5670 -315 8370 -315 8370 -810 5670 -810 5670 -315
-4 1 0 50 -1 4 14 0.0000 2 180 1170 3914 -465 User Code\001
+4 1 0 50 -1 4 14 0.0000 2 180 1155 3914 -465 User Code\001
 4 1 0 50 -1 4 14 0.0000 2 180 780 7020 -480 Contrib\001
 -6
 4 1 0 50 -1 4 14 0.0000 2 180 780 7020 -480 Contrib\001
 -6
-6 5490 0 6525 630
-# href="group__AMOK__API.html" ALT="AMOK"
-2 2 0 1 0 27 60 -1 20 0.000 0 0 -1 0 0 5
-        5512 0 6502 0 6502 630 5512 630 5512 0
-4 1 0 50 -1 4 12 0.0000 2 165 675 6007 540 toolbox\001
-4 1 0 50 -1 4 14 0.0000 2 180 720 6007 270 AMOK\001
--6
-6 4185 90 6435 1035
-4 1 0 50 -1 4 14 0.0000 2 180 705 4860 270 GRAS\001
-4 1 0 50 -1 4 12 0.0000 2 165 1050 4860 540 Framework\001
-4 1 0 50 -1 4 12 0.0000 2 210 1050 4860 765 to  develop\001
-4 1 0 50 -1 4 12 0.0000 2 210 2205 5310 990  distributed applications\001
--6
-6 1800 0 4050 2070
-6 2002 652 3847 1417
-4 1 0 50 -1 4 14 0.0000 2 180 555 2924 832 MSG\001
-4 1 0 50 -1 4 12 0.0000 2 210 1770 2924 1147 Simple application-\001
-4 1 0 50 -1 4 12 0.0000 2 165 1335 2924 1417 level simulator\001
--6
-# href="group__MSG__API.html" ALT="MSG"
-2 2 0 1 0 23 60 -1 23 0.000 0 0 -1 0 0 5
-        1800 0 4050 0 4050 2070 1800 2070 1800 0
--6
 6 -675 0 1665 3375
 6 -518 1282 1507 2092
 6 -675 0 1665 3375
 6 -518 1282 1507 2092
-4 1 0 50 -1 4 14 0.0000 2 240 870 494 1462 SimDag\001
-4 1 0 50 -1 4 12 0.0000 2 165 1365 494 1777 Framework for\001
-4 1 0 50 -1 4 12 0.0000 2 210 2100 494 2047 DAGs of parallel tasks\001
+4 1 0 50 -1 4 14 0.0000 2 225 870 494 1462 SimDag\001
+4 1 0 50 -1 4 12 0.0000 2 150 1245 494 1777 Framework for\001
+4 1 0 50 -1 4 12 0.0000 2 195 1965 494 2047 DAGs of parallel tasks\001
 -6
 # href="group__SD__API.html" ALT="SimDag"
 2 2 0 1 0 23 60 -1 30 0.000 0 0 -1 0 0 5
         -675 0 1665 0 1665 3375 -675 3375 -675 0
 -6
 -6
 # href="group__SD__API.html" ALT="SimDag"
 2 2 0 1 0 23 60 -1 30 0.000 0 0 -1 0 0 5
         -675 0 1665 0 1665 3375 -675 3375 -675 0
 -6
-6 6660 0 9045 1170
-6 6817 135 8887 1035
-4 1 0 50 -1 4 12 0.0000 2 210 2025 7852 750 applications on top of\001
-4 1 0 50 -1 4 12 0.0000 2 165 1965 7852 1005 a virtual environment\001
-4 1 0 50 -1 4 12 0.0000 2 210 1680 7852 540 Library to run MPI\001
-4 1 0 50 -1 4 14 0.0000 2 180 585 7852 315 SMPI\001
--6
-# href="group__SMPI__API.html" ALT="SMPI"
-2 2 0 1 0 36 60 -1 20 0.000 0 0 -1 0 0 5
-        6660 0 9045 0 9045 1170 6660 1170 6660 0
--6
 6 4815 1305 9045 2070
 6 5332 1440 8527 1935
 6 6952 1440 8527 1935
 6 4815 1305 9045 2070
 6 5332 1440 8527 1935
 6 6952 1440 8527 1935
-4 1 0 50 -1 4 12 0.0000 2 210 1545 7739 1620 SIMIX-like Proxy\001
-4 1 0 50 -1 4 12 0.0000 2 210 1305 7739 1890 (sockets/MPI)\001
+4 1 0 50 -1 4 12 0.0000 2 195 1485 7739 1620 SIMIX-like Proxy\001
+4 1 0 50 -1 4 12 0.0000 2 180 1230 7739 1890 (sockets/MPI)\001
 -6
 4 1 0 50 -1 4 14 0.0000 2 180 870 5782 1777 SMURF\001
 -6
 -6
 4 1 0 50 -1 4 14 0.0000 2 180 870 5782 1777 SMURF\001
 -6
@@ -84,7 +50,7 @@ Single
 -6
 6 -675 3510 7200 4365
 6 2159 3667 4364 4207
 -6
 6 -675 3510 7200 4365
 6 2159 3667 4364 4207
-4 1 0 50 -1 4 12 0.0000 2 210 2280 3261 4124 virtual platform simulator\001
+4 1 0 50 -1 4 12 0.0000 2 195 2145 3261 4124 virtual platform simulator\001
 4 1 0 50 -1 4 14 0.0000 2 180 675 3261 3869 SURF\001
 -6
 # href="group__SURF__API.html" ALT="SMPI"
 4 1 0 50 -1 4 14 0.0000 2 180 675 3261 3869 SURF\001
 -6
 # href="group__SURF__API.html" ALT="SMPI"
@@ -93,9 +59,9 @@ Single
 -6
 6 1800 2205 7200 3375
 6 3554 2385 5444 3195
 -6
 6 1800 2205 7200 3375
 6 3554 2385 5444 3195
-4 1 0 50 -1 4 12 0.0000 2 210 1860 4498 3150 on a virtual platform\001
+4 1 0 50 -1 4 12 0.0000 2 195 1725 4498 3150 on a virtual platform\001
 4 1 0 50 -1 4 14 0.0000 2 180 645 4498 2565 SimIX\001
 4 1 0 50 -1 4 14 0.0000 2 180 645 4498 2565 SimIX\001
-4 1 0 50 -1 4 12 0.0000 2 165 1410 4498 2880 "UNIX-like" API\001
+4 1 0 50 -1 4 12 0.0000 2 150 1365 4498 2880 "UNIX-like" API\001
 -6
 # href="group__SD__API.html" ALT="SimDag"
 2 2 0 1 0 10 60 -1 28 0.000 0 0 -1 0 0 5
 -6
 # href="group__SD__API.html" ALT="SimDag"
 2 2 0 1 0 10 60 -1 28 0.000 0 0 -1 0 0 5
@@ -104,17 +70,30 @@ Single
 6 7335 2205 9045 4365
 6 7470 3015 8955 3555
 4 1 0 50 -1 4 14 0.0000 2 180 375 8211 3217 MC\001
 6 7335 2205 9045 4365
 6 7470 3015 8955 3555
 4 1 0 50 -1 4 14 0.0000 2 180 375 8211 3217 MC\001
-4 1 0 50 -1 4 12 0.0000 2 165 1440 8211 3532 Model Checker\001
+4 1 0 50 -1 4 12 0.0000 2 150 1305 8211 3532 Model Checker\001
 -6
 # href="group__MSG__API.html" ALT="MSG"
 2 2 0 1 0 20 60 -1 23 0.000 0 0 -1 0 0 5
         7335 2205 9045 2205 9045 4365 7335 4365 7335 2205
 -6
 -6
 # href="group__MSG__API.html" ALT="MSG"
 2 2 0 1 0 20 60 -1 23 0.000 0 0 -1 0 0 5
         7335 2205 9045 2205 9045 4365 7335 4365 7335 2205
 -6
+6 2317 652 4162 1417
+4 1 0 50 -1 4 14 0.0000 2 180 555 3239 832 MSG\001
+4 1 0 50 -1 4 12 0.0000 2 195 1650 3239 1147 Simple application-\001
+4 1 0 50 -1 4 12 0.0000 2 150 1260 3239 1417 level simulator\001
+-6
+6 5895 135 7965 1035
+4 1 0 50 -1 4 12 0.0000 2 195 1860 6930 750 applications on top of\001
+4 1 0 50 -1 4 12 0.0000 2 150 1815 6930 1005 a virtual environment\001
+4 1 0 50 -1 4 12 0.0000 2 195 1560 6930 540 Library to run MPI\001
+4 1 0 50 -1 4 14 0.0000 2 180 585 6930 315 SMPI\001
+-6
 # href="group__XBT__API.html" ALT="XBT"
 2 3 0 1 0 33 60 -1 20 0.000 0 0 -1 0 0 7
         -765 0 -1215 0 -1215 5400 9045 5400 9045 4500 -765 4500
         -765 0
 # href="group__XBT__API.html" ALT="XBT"
 2 3 0 1 0 33 60 -1 20 0.000 0 0 -1 0 0 7
         -765 0 -1215 0 -1215 5400 9045 5400 9045 4500 -765 4500
         -765 0
-# href="group__GRAS__API.html" ALT="GRAS"
-2 3 0 1 0 35 60 -1 20 0.000 0 0 -1 0 0 9
-        6525 720 5445 720 5445 0 4185 0 4185 2070 4680 2070
-        4680 1170 6525 1170 6525 720
+# href="group__MSG__API.html" ALT="MSG"
+2 2 0 1 0 23 60 -1 23 0.000 0 0 -1 0 0 5
+        1800 0 4680 0 4680 2070 1800 2070 1800 0
+# href="group__SMPI__API.html" ALT="SMPI"
+2 2 0 1 0 36 60 -1 20 0.000 0 0 -1 0 0 5
+        4815 0 9045 0 9045 1170 4815 1170 4815 0
index a893f9c..adf9661 100644 (file)
@@ -206,7 +206,6 @@ Configuration of package `simgrid' on arch (=4):
         Graphviz mode  :
 
        Simgrid dependencies:   -lm -lpcre -lpthread -lns3 -lrt
         Graphviz mode  :
 
        Simgrid dependencies:   -lm -lpcre -lpthread -lns3 -lrt
-       Gras dependencies   :   -lm -lpthread -lrt
        Smpi dependencies   :
 
        INSTALL_PREFIX:         /usr/local
        Smpi dependencies   :
 
        INSTALL_PREFIX:         /usr/local