Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Update doc for install section.
[simgrid.git] / doc / install.doc
index 935fc52..d912e8b 100644 (file)
@@ -24,6 +24,9 @@ For Unix and MacOS:
   \li c and c++ compiler
   \li ccmake for graphical used of CMake
   \li cmake <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
+                                                                                                                                                                                               
+On MacOSX some users reported that it is still possible to build with clang, provided that you use the 
+following package versions clang3.1 and clang++3.1. If it fails on you, try to use gcc47 (port install gcc47).
 
 For Windows :
   \li cmake 2.8 <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
@@ -31,6 +34,14 @@ For Windows :
   \li perl <a href="http://www.activestate.com/activeperl/downloads">(download page)</a>
   \li git <a href="http://msysgit.googlecode.com/files/Git-1.7.4-preview20110204.exe">(download page)</a>
   
+Note that if you want change the compiler, you can simply specify the environment variables CC and CXX.
+\verbatim
+       export CC=gcc-4.4
+       export CXX=g++-4.4
+       export CC=clang
+       export CXX=clang++
+\endverbatim 
+
 \subsubsection install_cmakeoption1 Liste of options
 
 \verbatim
@@ -57,8 +68,6 @@ For Windows :
        gtnets_path                     <path_to_gtnets_directory>
        ns3_path                        <path_to_ns3_directory>
        CMAKE_INSTALL_PREFIX            <path_to_install_directory>
-       CMAKE_C_COMPILER                <path_to_compiler>
-       CMAKE_CXX_COMPILER              <path_to_compiler>
        pipol_user                      <pipol_username>
 \endverbatim
                                                                                                                                                           
@@ -106,10 +115,6 @@ For Windows :
 
   \li CMAKE_INSTALL_PREFIX : Path where are installed lib/ doc/ and include/ directories (ex /usr/local)
   
-  \li CMAKE_C_COMPILER : Change the c compiler.
-  
-  \li CMAKE_CXX_COMPILER : Change the c++ compiler. 
-  
   \li pipol_user : specify your pipol username if you want to use the pipol-remote command.
 
 \subsubsection install_cmakeoption3 Initialisation
@@ -393,6 +398,22 @@ can use the SimGrid Ruby bindings in a virtual machine using
 VirtualBox. Thanks to him for that. You can find his project here:
 https://github.com/aespinosa/simgrid-vagrant
 
+\section install_mac Installing the SimGrid framework on Mac OS X
+
+The Mac OS X system is part of the UNIX familly, but it exibits some
+specificities that complicate a bit the build of SimGrid. Current
+versions of SimGrid (3.7.x) can only be build with the GCC Compiler,
+but recent OS X version provide only an ancient version of that tool
+in the hope to see the users switch to the LLVM compiler family. The
+problem is that SimGrid uses internal libraries of GCC, for stack
+manipulation for example. We are working on removing this dependency
+onto gcc to ease the build process, but this is still ongoing.
+
+For the time being, you need to get a recent version of GCC on your
+system to build SimGrid. Version 3.7.1  was successfully built on Mac
+Lion 10.7.4 using a GCC compiler retrieved from macport. The package
+used were gcc47, and the binary in the package were gcc-mp-4.7.
+
 \section install_setting_MSG Setting up your own MSG code
 
 Do not build your simulator by modifying the SimGrid examples.  Go