Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Remove gtnets and ns3 pages for one: Packet level simulation.
authorNavarrop <Pierre.Navarro@imag.fr>
Wed, 21 Sep 2011 14:45:46 +0000 (16:45 +0200)
committerNavarrop <Pierre.Navarro@imag.fr>
Wed, 21 Sep 2011 15:12:55 +0000 (17:12 +0200)
buildtools/Cmake/DefinePackages.cmake
buildtools/Cmake/GenerateDoc.cmake
doc/Doxyfile.in
doc/gtnets.doc [deleted file]
doc/ns3.doc [deleted file]
doc/pls.doc [new file with mode: 0644]
tools/doxygen/doxygen_postprocesser.pl

index 62b7b4e..ea1f093 100644 (file)
@@ -585,8 +585,7 @@ set(DOC_SOURCES
        doc/options.doc
        doc/use.doc
        doc/tracing.doc
-       doc/gtnets.doc
-       doc/ns3.doc
+       doc/pls.doc
        doc/gtut-howto-design.doc
        doc/gtut-howto.doc
        doc/gtut-introduction.doc
index e26ccec..2a5eed6 100644 (file)
@@ -92,7 +92,7 @@ if(DOXYGEN_PATH AND FIG2DEV_PATH AND BIBTOOL_PATH AND BIBTEX2HTML_PATH AND ICONV
            COMMAND ${CMAKE_COMMAND} -E echo "XX First Doxygen pass"
                COMMAND ${DOXYGEN_PATH}/doxygen Doxyfile
                COMMAND ${CMAKE_HOME_DIRECTORY}/tools/doxygen/index_create.pl simgrid.tag index-API.doc
-               COMMAND ${CMAKE_HOME_DIRECTORY}/tools/doxygen/toc_create.pl index.doc gtut-introduction.doc installSimgrid.doc bindings.doc options.doc tracing.doc
+               COMMAND ${CMAKE_HOME_DIRECTORY}/tools/doxygen/toc_create.pl pls.doc index.doc gtut-introduction.doc installSimgrid.doc bindings.doc options.doc tracing.doc
                
                COMMAND ${CMAKE_COMMAND} -E echo "XX Second Doxygen pass"
                COMMAND ${DOXYGEN_PATH}/doxygen Doxyfile
index 4932bb5..c1dd9e6 100644 (file)
@@ -619,8 +619,7 @@ INPUT                  = index.doc \
                          options.doc \
                          tracing.doc \
                          use.doc \
-                         gtnets.doc \
-                         ns3.doc \
+                         pls.doc \
                          ./index-API.doc \
                          modules.doc \
                          module-xbt.doc \
diff --git a/doc/gtnets.doc b/doc/gtnets.doc
deleted file mode 100644 (file)
index fbe6b0e..0000000
+++ /dev/null
@@ -1,125 +0,0 @@
-/*! \page gtnets SimGrid and GTNets
-
-\section gtnets_simgrid_configuration_gtnets Using GTNetS
-
-It is possible to use a packet-level network simulator
-instead of the default flow-based simulation. You may want to use such
-an approach if you have doubts about the validity of the default model
-or if you want to perform some validation experiments. At the moment,
-we support the GTNetS simulator (it is still rather experimental
-though, so leave us a message if you play with it). 
-
-<i>
-To enable GTNetS model inside SimGrid it is needed to patch the GTNetS simulator source code 
-and build/install it from scratch
-</i>
-
- - <b>Download and enter the recent downloaded GTNetS directory</b>
-
- \verbatim
- svn checkout svn://scm.gforge.inria.fr/svn/simgrid/contrib/trunk/GTNetS/
- cd GTNetS
- \endverbatim
-
-
- - <b>Use the following commands to unzip and patch GTNetS package to work within SimGrid.</b>
-
- \verbatim
- unzip gtnets-current.zip
- tar zxvf gtnets-current-patch.tgz 
- cd gtnets-current
- 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. 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
- ln -sf Makefile.linux Makefile
- make depend
- make debug
- \endverbatim
-
-
- - <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
- please try a make clean before asking for help.
-
-
- - <b>To compile optimized version</b>
-
- \verbatim
- make opt
- \endverbatim
-
-
- - <b>Installing GTNetS</b>
-
- 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 /<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
- \endverbatim
-
-
- - <b>Enable GTNetS support in SimGrid</b>
-In order to enable gtnets with simgrid you have to give where is gtnets. (path to \<gtnets_path\>/lib and \<gtnets_path\>/include)
-
-   \verbatim
-   Since v3.4 (with cmake)
-   cmake . -Dgtnets_path=/<userhome>/usr
-   
-   Until v3.4 (with autotools)
-   ./configure --with-gtnets=/<userhome>/usr
-   \endverbatim
-
- - <b>Once you have followed all the instructions for compiling and
-   installing successfully you can activate this feature at 
-   runntime with the following options:</b>
-
-   \verbatim
-   Since v3.4 (with cmake)
-   cd simgrid
-   make
-   ctest -R gtnets
-   
-   Until v3.4 (with autotools)
-   cd simgrid/example/msg/
-   make
-   make check
-   \endverbatim
-
-
- - <b>Or try the GTNetS model dogbone example with</b>
-
- \verbatim
- gtnets/gtnets gtnets/onelink-p.xml gtnets/onelink-d.xml --cfg=network_model:GTNets
- \endverbatim
-
- A long version of this <a href="http://gforge.inria.fr/docman/view.php/12/6283/GTNetS HowTo.html">HowTo</a>  it is available 
-
-
- More about GTNetS simulator at <a href="http://www.ece.gatech.edu/research/labs/MANIACS/GTNetS/index.html">GTNetS Website</a>
-
-
- - <b>DISCLAIMER</b>
- The patches provided by us worked successfully with GTNetS found 
- <a href="http://www.ece.gatech.edu/research/labs/MANIACS/GTNetS/software/gtnets-current.zip">here</a>, 
- dated from 12th June 2008. Due to the discontinuing development of
- GTNetS it is impossible to precise a version number. We STRONGLY recommend you
- to download and install the GTNetS version found in SimGrid repository as explained above.
-*/
\ No newline at end of file
diff --git a/doc/ns3.doc b/doc/ns3.doc
deleted file mode 100644 (file)
index d37e74c..0000000
+++ /dev/null
@@ -1,109 +0,0 @@
-/*! \page ns3 SimGrid and NS3
-
-\section ns3_simgrid_configuration_ns3 Using NS3
-
-It is possible to use discrete-event network simulator <a href="http://www.nsnam.org/">(ns-3)</a> for Internet systems
-instead of the default one. 
-
-<i>
-To use ns3 model inside SimGrid you have to install at least the version 3.10 of ns3 simulator.
-</i>
-
-- <b>Download and enter the lateast release (here the 3.12.1)</b>
-
-\verbatim
-http://www.nsnam.org/release/ns-allinone-3.12.1.tar.bz2
-tar -xf ns-allinone-3.12.1.tar.bz2
-cd ns-allinone-3.12.1/ns-3.12.1/
-\endverbatim
-
-- <b>Configure, make and install ns3</b>
-
-\verbatim
-./waf configure --prefix="ns-3_install_directory"
-./waf
-./waf install
-\endverbatim
-
-After install ns-3 you should have directories into your "ns-3_install_directory":
-       \li include/ns3/ 
-       \li lib/ 
-       \li bin/ (with 3.12)
-       
-You also need to add to the LD_LIBRARY_PATH : "ns-3_install_directory/lib".
-
-- <b>Enable ns-3 support on SimGrid</b>
-
-In order to enable ns-3 with simgrid you have to give where is ns-3 to the simgrid configuration command. (path to \<ns3_path\>/lib and \<ns3_path\>/include)
-
-\verbatim
-navarrop@caraja:~/workspace/simgrid/build$cmake . -Dns3_path=<ns3_path>
-\endverbatim
-
-With the output of the configuration you can see if ns-3 is detected by included the directory to flags.
-
-\verbatim
-Configuration of package `simgrid' on arch (=4):
-            BUILDNAME :        UNIX
-            SITE      :        Linux_2.6.38-11-generic_x86_64
-            Release   :        simgrid-3.6.1
-
-        Compiler: c++ :        /usr/bin/c++
-               version:        4.6.1
-        Compiler: c   :        /usr/bin/gcc
-               version:        4.6.1
-
-              CFlags  :        -O3 -finline-functions -funroll-loops -fno-strict-aliasing -L/usr/lib/x86_64-linux-gnu -I/usr/include 
-                                       -L/home/navarrop/Install/ns3-3.10/lib -I/home/navarrop/Install/ns3-3.10/include -g3  -D_NS3_3_10
-              CPPFlags:        -I/home/navarrop/Install/ns3-3.10/include -L/home/navarrop/Install/ns3-3.10/lib 
-
-       Compile Gtnets :        0
-       Compile NS-3   :        1 ---------------------> Be sure this option is "1" otherwise ns-3 is not activated
-       Gtnets path    :        
-       NS-3 path      :        /home/navarrop/Install/ns3-3.10
-       Compile Lua    :        
-       Compile Smpi   :        OFF
-       Compile Static :        OFF
-       Compile pcre   :        AUTO
-
-       Maintainer mode:        OFF
-       Supernovae mode:        OFF
-       Model checking :        OFF
-       Tracing mode   :        OFF
-       Jedule  mode   :        OFF
-       Latency bound  :        OFF
-        Graphviz mode  :        
-
-       Simgrid dependencies:   -lm -lpcre -lpthread -lns3 -lrt
-       Gras dependencies   :   -lm -lpthread -lrt
-       Smpi dependencies   :   
-
-       INSTALL_PREFIX:         /usr/local
--- Configuring done
--- Generating done
--- Build files have been written to: /home/navarrop/workspace/simgrid/build
-\endverbatim
-
-Now you can compile SimGrid
-\verbatim
-navarrop@caraja:~/workspace/simgrid/build$make
-\endverbatim
-
-Then you can see if ns-3 is well activated by testing
-\verbatim
-navarrop@caraja:~/workspace/simgrid/build$ctest -R ns3
-\endverbatim
-
-You should see
-\verbatim
-    Start 182: msg-ns3-thread
-1/3 Test #182: msg-ns3-thread ...................   Passed    0.35 sec
-    Start 183: msg-ns3-ucontext
-2/3 Test #183: msg-ns3-ucontext .................   Passed    0.22 sec
-    Start 184: msg-ns3-raw
-3/3 Test #184: msg-ns3-raw ......................   Passed    0.23 sec
-\endverbatim
-
-More about ns-3 simulator <a href="http://www.nsnam.org/">(Official website)</a>
-
-*/
\ No newline at end of file
diff --git a/doc/pls.doc b/doc/pls.doc
new file mode 100644 (file)
index 0000000..a6deac5
--- /dev/null
@@ -0,0 +1,223 @@
+/*! \page pls Packet level simulation
+
+\htmlinclude .pls.doc.toc
+
+\section pls_simgrid_configuration_gtnets Using GTNetS
+
+It is possible to use a packet-level network simulator
+instead of the default flow-based simulation. You may want to use such
+an approach if you have doubts about the validity of the default model
+or if you want to perform some validation experiments. At the moment,
+we support the GTNetS simulator (it is still rather experimental
+though, so leave us a message if you play with it). 
+
+<i>
+To enable GTNetS model inside SimGrid it is needed to patch the GTNetS simulator source code 
+and build/install it from scratch
+</i>
+
+ - <b>Download and enter the recent downloaded GTNetS directory</b>
+
+\verbatim
+svn checkout svn://scm.gforge.inria.fr/svn/simgrid/contrib/trunk/GTNetS/
+cd GTNetS
+\endverbatim
+
+
+ - <b>Use the following commands to unzip and patch GTNetS package to work within SimGrid.</b>
+
+\verbatim
+unzip gtnets-current.zip
+tar zxvf gtnets-current-patch.tgz 
+cd gtnets-current
+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. 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
+ln -sf Makefile.linux Makefile
+make depend
+make debug
+\endverbatim
+
+
+ - <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
+ please try a make clean before asking for help.
+
+
+ - <b>To compile optimized version</b>
+
+\verbatim
+make opt
+\endverbatim
+
+
+ - <b>Installing GTNetS</b>
+
+ 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 /<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
+\endverbatim
+
+
+ - <b>Enable GTNetS support in SimGrid</b>
+In order to enable gtnets with simgrid you have to give where is gtnets. (path to \<gtnets_path\>/lib and \<gtnets_path\>/include)
+
+\verbatim
+cmake . -Denable_gtnets=ON -Dgtnets_path=/<userhome>/usr
+\endverbatim
+
+ - <b>Once you have followed all the instructions for compiling and
+   installing successfully you can activate this feature at 
+   runntime with the following options:</b>
+
+\verbatim
+cd simgrid
+make
+ctest -R gtnets
+\endverbatim
+
+
+ - <b>Or try the GTNetS model dogbone example with</b>
+
+\verbatim
+gtnets/gtnets gtnets/onelink-p.xml gtnets/onelink-d.xml --cfg=network_model:GTNets
+\endverbatim
+
+ A long version of this <a href="http://gforge.inria.fr/docman/view.php/12/6283/GTNetS HowTo.html">HowTo</a>  it is available 
+
+
+ More about GTNetS simulator at <a href="http://www.ece.gatech.edu/research/labs/MANIACS/GTNetS/index.html">GTNetS Website</a>
+
+
+ - <b>DISCLAIMER</b>
+ The patches provided by us worked successfully with GTNetS found 
+ <a href="http://www.ece.gatech.edu/research/labs/MANIACS/GTNetS/software/gtnets-current.zip">here</a>, 
+ dated from 12th June 2008. Due to the discontinuing development of
+ GTNetS it is impossible to precise a version number. We STRONGLY recommend you
+ to download and install the GTNetS version found in SimGrid repository as explained above.
+
+\section pls_simgrid_configuration_ns3 Using NS3
+
+It is possible to use discrete-event network simulator <a href="http://www.nsnam.org/">(ns-3)</a> for Internet systems
+instead of the default one. 
+
+<i>
+To use ns3 model inside SimGrid you have to install at least the version 3.10 of ns3 simulator.
+</i>
+
+- <b>Download and enter the lateast release (here the 3.12.1)</b>
+
+\verbatim
+http://www.nsnam.org/release/ns-allinone-3.12.1.tar.bz2
+tar -xf ns-allinone-3.12.1.tar.bz2
+cd ns-allinone-3.12.1/ns-3.12.1/
+\endverbatim
+
+- <b>Configure, make and install ns3</b>
+
+\verbatim
+./waf configure --prefix="ns-3_install_directory"
+./waf
+./waf install
+\endverbatim
+
+After install ns-3 you should have directories into your "ns-3_install_directory":
+       \li include/ns3/ 
+       \li lib/ 
+       \li bin/ (with 3.12)
+       
+You also need to add to the LD_LIBRARY_PATH : "ns-3_install_directory/lib".
+
+- <b>Enable ns-3 support on SimGrid</b>
+
+In order to enable ns-3 with simgrid you have to give where is ns-3 to the simgrid configuration command. (path to \<ns3_path\>/lib and \<ns3_path\>/include)
+
+\verbatim
+cmake . -Denable_ns3=ON -Dns3_path=<ns3_path>
+\endverbatim
+
+With the output of the configuration you can see if ns-3 is detected by included the directory to flags.
+
+\verbatim
+Configuration of package `simgrid' on arch (=4):
+            BUILDNAME :        UNIX
+            SITE      :        Linux_2.6.38-11-generic_x86_64
+            Release   :        simgrid-3.6.1
+
+        Compiler: c++ :        /usr/bin/c++
+               version:        4.6.1
+        Compiler: c   :        /usr/bin/gcc
+               version:        4.6.1
+
+              CFlags  :        -O3 -finline-functions -funroll-loops -fno-strict-aliasing -L/usr/lib/x86_64-linux-gnu -I/usr/include 
+                                       -L/home/navarrop/Install/ns3-3.10/lib -I/home/navarrop/Install/ns3-3.10/include -g3  -D_NS3_3_10
+              CPPFlags:        -I/home/navarrop/Install/ns3-3.10/include -L/home/navarrop/Install/ns3-3.10/lib 
+
+       Compile Gtnets :        0
+       Compile NS-3   :        1 ---------------------> Be sure this option is "1" otherwise ns-3 is not activated
+       Gtnets path    :        
+       NS-3 path      :        /home/navarrop/Install/ns3-3.10
+       Compile Lua    :        
+       Compile Smpi   :        OFF
+       Compile Static :        OFF
+       Compile pcre   :        AUTO
+
+       Maintainer mode:        OFF
+       Supernovae mode:        OFF
+       Model checking :        OFF
+       Tracing mode   :        OFF
+       Jedule  mode   :        OFF
+       Latency bound  :        OFF
+        Graphviz mode  :        
+
+       Simgrid dependencies:   -lm -lpcre -lpthread -lns3 -lrt
+       Gras dependencies   :   -lm -lpthread -lrt
+       Smpi dependencies   :   
+
+       INSTALL_PREFIX:         /usr/local
+-- Configuring done
+-- Generating done
+-- Build files have been written to: /home/navarrop/workspace/simgrid/build
+\endverbatim
+
+Now you can compile SimGrid
+\verbatim
+make
+\endverbatim
+
+Then you can see if ns-3 is well activated by testing
+\verbatim
+ctest -R ns3
+\endverbatim
+
+You should see
+\verbatim
+    Start 182: msg-ns3-thread
+1/3 Test #182: msg-ns3-thread ...................   Passed    0.35 sec
+    Start 183: msg-ns3-ucontext
+2/3 Test #183: msg-ns3-ucontext .................   Passed    0.22 sec
+    Start 184: msg-ns3-raw
+3/3 Test #184: msg-ns3-raw ......................   Passed    0.23 sec
+\endverbatim
+
+More about ns-3 simulator <a href="http://www.nsnam.org/">(Official website)</a>
+
+*/
\ No newline at end of file
index 94720fb..bd15975 100755 (executable)
@@ -5,8 +5,8 @@ use strict;
 # Add here the pages of the documentation generated by a @page doxygen macro
 my @extra_files = qw(html/index.html html/pages.html html/modules.html html/annotated.html html/functions.html 
                                         html/functions_vars.html index.php 
-                     html/GRAS_tut.html html/tracing.html html/installSimgrid.html html/bindings.html html/options.html html/use.html html/gtnets.html
-                     html/ns3.html);
+                     html/GRAS_tut.html html/tracing.html html/installSimgrid.html html/bindings.html
+                     html/options.html html/use.html html/pls.html);
 
 # GRAS tutorial
 map {push @extra_files, "html/GRAS_tut_$_.html"} qw (intro 
@@ -395,8 +395,7 @@ foreach my $file (@allfiles) {
              || $file =~ /^html\/options.*/
              || $file =~ /^html\/tracing.*/ 
              || $file =~ /^html\/bindings.*/
-             || $file =~ /^html\/gtnets.*/
-             || $file =~ /^html\/ns3.*/
+             || $file =~ /^html\/pls.*/
              || $file =~ /^html\/modules.*/
              || $file =~ /^html\/annotated.*/
              || $file =~ /^html\/group__.*/
@@ -410,8 +409,7 @@ foreach my $file (@allfiles) {
                                $tmp_buff .= '          <li><a href="options.html"><span>Options & configurations</span></a></li>'."\n";
                                $tmp_buff .= '          <li><a href="tracing.html"><span>Tracing Simulations</span></a></li>'."\n";
                                $tmp_buff .= '          <li><a href="bindings.html"><span>Bindings</span></a></li>'."\n";
-                               $tmp_buff .= '          <li><a href="gtnets.html"><span>GTNets</span></a></li>'."\n";
-                               $tmp_buff .= '          <li><a href="ns3.html"><span>NS3</span></a></li>'."\n";
+                               $tmp_buff .= '          <li><a href="pls.html"><span>Packet level simulation</span></a></li>'."\n";
                                $tmp_buff .= '          </ul></div>'."\n";
                                $tmp_buff .= '      </div>'."\n";