Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Cosmetics: whitespace cleanup.
[simgrid.git] / doc / install.doc
index 92f9806..eb3663f 100644 (file)
@@ -1,4 +1,4 @@
-/*! \page install Install Simgrid
+/*! \page install Installing Simgrid
 
 \htmlinclude .install.doc.toc
 
@@ -54,7 +54,6 @@ For Windows :
        enable_supernovae               ON/OFF or TRUE/FALSE or 1/0
        enable_msg_deprecated           ON/OFF or TRUE/FALSE or 1/0                                                                                                                                                                                                                                                                               
        enable_print_message            ON/OFF or TRUE/FALSE or 1/0 
-       custom_flags                    <flags>
        gtnets_path                     <path_to_gtnets_directory>
        ns3_path                        <path_to_ns3_directory>
        CMAKE_INSTALL_PREFIX            <path_to_install_directory>
@@ -101,8 +100,6 @@ For Windows :
   
   \li enable_print_message : When set to true configuration print more debug output.
   
-  \li custom_flags : If user wants to use a specific flag during compilation, give here.
-
   \li gtnets_path : Path to gtnets install directory (ex /usr)
   
   \li ns3_path : Path to ns3 install directory (ex /usr)
@@ -135,7 +132,6 @@ enable_jedule                       off
 enable_latency_bound_tracking  off 
 enable_lib_static              off
 CMAKE_INSTALL_PREFIX           /usr/local
-custom_flags                   null
 gtnets_path                    null
 pipol_user                     null
 \endverbatim
@@ -397,6 +393,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