Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Corrected GTNetS faq, bug found by Navarro.
[simgrid.git] / doc / FAQ.doc
index 5474071..e9a7dbe 100644 (file)
@@ -174,6 +174,38 @@ Thus, there is two ways to link your program with SimGrid:
 \verbatim export LD_LIBRARY_PATH=$HOME/lib/:$LD_LIBRARY_PATH
 \endverbatim
 
+\subsection faq_compiling_java Java bindings don't get compiled
+
+The configure script detects automatically whether you have the
+softwares needed to use the Java bindings or not. At the end of the
+configure, you can see the configuration picked by the script, which
+should look similar to 
+\verbatim Configuration of package simgrid' (version 3.3.4-svn) on
+little64 (=4):
+
+        Compiler:       gcc (version: )
+        
+        CFlags:          -O3 -finline-functions -funroll-loops -fno-strict-aliasing -Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wpointer-arith -Wchar-subscripts -Wcomment -Wformat -Wwrite-strings -Wno-unused-function -Wno-unused-parameter -Wno-strict-aliasing -Wno-format-nonliteral -Werror -g3
+        CPPFlags:   
+         LDFlags:       
+                                  
+         Context backend: ucontext
+         Compile Java: no
+                                                        
+         Maintainer mode: no
+         Supernovae mode: yes
+\endverbatim      
+
+In this example, Java backends won't be compiled. 
+
+On Debian-like systems (which includes ubuntu), you need the following
+packages: sun-java6-jdk libgcj10-dev. If you cannot find the
+libgcj10-dev, try another version, like libgcj9-dev (on Ubuntu before
+9.10) or libgcj11-dev (not released yet, but certainly one day).
+Please note that you need to activate the contrib and non-free
+repositories in Debian, and the universe ones in Ubuntu. Java comes at
+this price...
+
 \subsection faq_compiling_snapshoot SimGrid development snapshots
 
 We have very high standards on software quality, and we are reluctant releasing
@@ -932,27 +964,28 @@ and build/install it from scratch
 
  \verbatim
  unzip gtnets-current.zip
+ tar zxvf gtnets-current-patch.tgz 
  cd gtnets-current
- cp ../KAYO-PATCH-Added-RunUntilNextCompletion-and-some.patch .
- cat .patch | patch -p1
+ cat ../00*.patch | patch -p1
  \endverbatim
 
+  - <b>OPTIONALLY</b> you can use a patch for itanium 64bit processor family.
+
+  \verbatim
+  cat ../AMD64-FATAL-Removed-DUL_SIZE_DIFF-Added-fPIC-compillin.patch | patch -p1
+  \endverbatim
+
  - <b>Compile GTNetS</b>
 
-   Due to portability issues it is possible that GTNetS does not compile in your architecture. Some
-   other patches are provided in GTNetS directory. Use those patches at your own risk.
+   Due to portability issues it is possible that GTNetS does not compile in your architecture. The patches furnished in SimGrid SVN repository are intended for use in Linux architecture only. Unfortunately, we do not have the time, the money, neither the manpower to guarantee GTNetS portability. We advice you to use one of GTNetS communication channel to get more help in compiling GTNetS. 
+
 
  \verbatim
- cd gtnets-current
  ln -sf Makefile.linux Makefile
  make depend
  make debug
  \endverbatim
 
- - If you have a problem compiling the GTNetS simulator a series of patches can be found <a href="http://mescal.imag.fr/membres/pedro.velho/simgrid/gtnets-current-patch.tgz">here</a>. Although, it is not
-guaranteed that these patches will make GTNetS compile in your architecture, they will just probably fix main issues when using the
-linux operating system.
-</p>
 
  - <b>NOTE</b> A lot of warnings are expected but the application should compile
  just fine. If the makefile insists in compiling some QT libraries
@@ -968,10 +1001,10 @@ linux operating system.
 
  - <b>Installing GTNetS</b>
 
- Replace <userhome> by some path you have write access to.
It is important to put the full path of your libgtsim-xxxx.so file when creating the symbolic link. Replace <userhome> by some path you have write access to.
 
  \verbatim
- ln -sf libgtsim-debug.so /<userhome>/usr/lib/libgtnets.so
+ ln -sf /<absolute_path>/gtnets_current/libgtsim-debug.so /<userhome>/usr/lib/libgtnets.so
  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/<userhome>/usr/lib/libgtnets.so
  mkdir /<userhome>/usr/include/gtnets
  cp -fr SRC/*.h /<userhome>/usr/include/gtnets