[cig-commits] r18206 - seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL

[dkomati1 at geodynamics.org]

Author: dkomati1
Date: 2011-04-09 08:02:09 -0700 (Sat, 09 Apr 2011)
New Revision: 18206

Modified:
   seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.pdf
   seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.tex
Log:
added a note about removing the Unix stack size limit


Modified: seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.pdf
===================================================================
(Binary files differ)

Modified: seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.tex
===================================================================
--- seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.tex	2011-04-09 03:11:59 UTC (rev 18205)
+++ seismo/3D/SPECFEM3D/trunk/doc/USER_MANUAL/manual_SPECFEM3D.tex	2011-04-09 15:02:09 UTC (rev 18206)
@@ -271,7 +271,11 @@
 {\small tar~-zxvf~SPECFEM3D\_V2.0.1.tar.gz}{\small \par}
 \end{lyxcode}
 The directory \texttt{\small SPECFEM3D/} will then contain
-the source code. To configure the software for your system, run the
+the source code.\\
+
+We recommend that you add {\texttt{ulimit -S -s unlimited}} to your {\texttt{.bash\_profile}} file and/or {\texttt{limit stacksize unlimited }} to your {\texttt{.cshrc}} file to suppress any potential limit to the size of the Unix stack.\\
+
+Then, to configure the software for your system, run the
 \texttt{configure} shell script. This script will attempt to guess
 the appropriate configuration values for your system. However, at
 a minimum, it is recommended that you explicitly specify the appropriate
@@ -378,13 +382,14 @@
 to insert `\texttt{`TRAP\_FPE=OFF}'' into the generated \texttt{Makefile}
 in order to turn underflow trapping off.\\
 
-Note that if you run very large meshes on a relatively small number
+If you run very large meshes on a relatively small number
 of processors, the memory size needed on each processor might become
-greater than 2 gigabytes, which is the upper limit for 32-bit addressing;
-in this case, on some compilers you may need to add \char`\"{}\texttt{-mcmodel=medium}\char`\"{}
-to the compiler options otherwise the compiler will display an error message; on an IBM machine with the \texttt{xlf} and \texttt{xlc} compilers, using \texttt{-q64} is usually sufficient.
+greater than 2 gigabytes, which is the upper limit for 32-bit addressing.
+In this case, on some compilers you may need to add \texttt{``-mcmodel=medium}''
+to the compiler options otherwise the compiler will display an error
+message (for instance \texttt{``relocation truncated to fit: R\_X86\_64\_PC32 against .bss''} or something similar);
+on an IBM machine with the \texttt{xlf} and \texttt{xlc} compilers, using \texttt{-q64} is usually sufficient.
 
-
 \chapter{\label{cha:Mesh-Generation}Mesh Generation}
 
 The first step in running a spectral-element simulation consists of constructing a high-quality mesh for the region under consideration. We provide two possibilities to do so: (1) relying on the external, hexahedral mesher CUBIT, or (2) using the provided, internal mesher \texttt{xmeshfem3D}. In the following, we explain these two approaches.