Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
reindent
[simgrid.git] / doc / install.doc
index 7d9dbdf..b97eab3 100644 (file)
@@ -13,7 +13,8 @@ Then Download and install package Simgrid-java:
 \verbatim
 git clone git://scm.gforge.inria.fr/simgrid/simgrid-java.git
 cd simgrid-java
-cmake .
+cmake -DCMAKE_INSTALL_PREFIX=$HOME/Install/simgrid-java/ .
+make install
 \endverbatim
  
 Cmake output
@@ -51,11 +52,38 @@ LD_LIBRARY_PATH.
 
 \verbatim
 $ export SIMGRID_ROOT="$HOME/Install/simgrid/"
-$ export SIMGRID_JAVA_ROOT="$HOME/workspace/simgrid-java"
-$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SIMGRID_ROOT/lib:$SIMGRID_JAVA_ROOT/lib
+$ export SIMGRID_JAVA_ROOT="$HOME/Install/simgrid-java"
+$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SIMGRID_ROOT/lib:$SIMGRID_JAVA_ROOT/java
 $ cd examples
 $ java -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.xml
 \endverbatim
 
- */
\ No newline at end of file
+\section bindings_binding_java_coroutines How to use the coroutines context factory
+
+You may want to use the coroutines context factory, if speed maters to
+you (since it's about 5 times faster than the default thread-based
+context factory).
+
+First, remember that the coroutines context factory is still
+experimental work.
+
+To use the coroutines context factory, you need a Java virtual machine
+which supports it.
+
+Our implementation rely on a JVM patch made by Lukas Stadler, which
+you can find <a href="http://ssw.jku.at/General/Staff/LS/coro/">here</a>. You 
+can either recompile the JVM yourself or use the offered pre-built
+binaries.
+
+SimGrid Java will automatically switch to the coroutine context
+factory if your JVM support it, so you will just need to execute your
+simulation with the correct JVM:
+\verbatim
+$ $PATH_TO_COROUTINE_JVM/java -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.xml
+\endverbatim
+
+Note that you may have to adjust the "coro.stacksPerThread" configuration option to run large simulations:
+\verbatim
+$ $PATH_TO_COROUTINE_JVM/java -Dcoro.stacksPerThread=$STACKS_NUMBER -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.xml
+\endverbatim 
+ */