/[MITgcm]/manual/s_getstarted/text/getting_started.tex
ViewVC logotype

Diff of /manual/s_getstarted/text/getting_started.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.39 by molod, Fri Jun 30 15:56:52 2006 UTC revision 1.42 by jmc, Fri May 28 02:09:59 2010 UTC
# Line 102  The MITgcm web site contains further dir Line 102  The MITgcm web site contains further dir
102  code and CVS.  It also contains a web interface to our CVS archive so  code and CVS.  It also contains a web interface to our CVS archive so
103  that one may easily view the state of files, revisions, and other  that one may easily view the state of files, revisions, and other
104  development milestones:  development milestones:
105  \begin{rawhtml} <A href="http://mitgcm.org/download" target="idontexist"> \end{rawhtml}  %\begin{rawhtml} <A href="http://mitgcm.org/download" target="idontexist"> \end{rawhtml}
106    \begin{rawhtml} <A href="http://mitgcm.org/viewvc/MITgcm/MITgcm/" target="idontexist"> \end{rawhtml}
107  \begin{verbatim}  \begin{verbatim}
108  http://mitgcm.org/source_code.html  http://mitgcm.org/source_code.html
109  \end{verbatim}  \end{verbatim}
# Line 139  track of your file versions with respect Line 140  track of your file versions with respect
140  the files in \texttt{CVS}!  You can also use CVS to download code  the files in \texttt{CVS}!  You can also use CVS to download code
141  updates.  More extensive information on using CVS for maintaining  updates.  More extensive information on using CVS for maintaining
142  MITgcm code can be found  MITgcm code can be found
143  \begin{rawhtml} <A href="http://mitgcm.org/usingcvstoget.html" target="idontexist"> \end{rawhtml}  \begin{rawhtml} <A href="http://mitgcm.org/public/using_cvs.html" target="idontexist"> \end{rawhtml}
144  here  here
145  \begin{rawhtml} </A> \end{rawhtml}  \begin{rawhtml} </A> \end{rawhtml}
146  .  .
# Line 223  with. So please be sure you understand w Line 224  with. So please be sure you understand w
224    
225  If you do not have CVS on your system, you can download the model as a  If you do not have CVS on your system, you can download the model as a
226  tar file from the web site at:  tar file from the web site at:
227  \begin{rawhtml} <A href=http://mitgcm.org/download target="idontexist"> \end{rawhtml}  \begin{rawhtml} <A href=http://mitgcm.org/download/ target="idontexist"> \end{rawhtml}
228  \begin{verbatim}  \begin{verbatim}
229  http://mitgcm.org/download/  http://mitgcm.org/download/
230  \end{verbatim}  \end{verbatim}
# Line 519  To compile the code, first use the progr Line 520  To compile the code, first use the progr
520  in the \texttt{tools} directory) to generate a Makefile.  in the \texttt{tools} directory) to generate a Makefile.
521  \texttt{genmake2} is a shell script written to work with all  \texttt{genmake2} is a shell script written to work with all
522  ``sh''--compatible shells including bash v1, bash v2, and Bourne.  ``sh''--compatible shells including bash v1, bash v2, and Bourne.
523  Internally, \texttt{genmake2} determines the locations of needed  %Internally, \texttt{genmake2} determines the locations of needed
524  files, the compiler, compiler options, libraries, and Unix tools.  It  %files, the compiler, compiler options, libraries, and Unix tools.  It
525  relies upon a number of ``optfiles'' located in the  %relies upon a number of ``optfiles'' located in the
526  \texttt{tools/build\_options} directory.  %\texttt{tools/build\_options} directory.
527    \texttt{genmake2} parses information from the following sources:
528    \begin{description}
529    \item[-] a {\em gemake\_local} file if one is found in the current
530      directory
531    \item[-] command-line options
532    \item[-] an "options file" as specified by the command-line option
533      \texttt{--optfile=/PATH/FILENAME}
534    \item[-] a {\em packages.conf} file (if one is found) with the
535      specific list of packages to compile. The search path for
536      file {\em packages.conf} is, first, the current directory and
537      then each of the "MODS" directories in the given order (see below).
538    \end{description}
539    
540    \subsubsection{Optfiles in \texttt{tools/build\_options} directory:}
541    
542  The purpose of the optfiles is to provide all the compilation options  The purpose of the optfiles is to provide all the compilation options
543  for particular ``platforms'' (where ``platform'' roughly means the  for particular ``platforms'' (where ``platform'' roughly means the
# Line 595  for inclusion.  Please send the file to Line 610  for inclusion.  Please send the file to
610  \begin{rawhtml} </A> \end{rawhtml}  \begin{rawhtml} </A> \end{rawhtml}
611  mailing list.  mailing list.
612    
613    \subsubsection{Command-line options:}
614    
615  In addition to the optfiles, \texttt{genmake2} supports a number of  In addition to the optfiles, \texttt{genmake2} supports a number of
616  helpful command-line options.  A complete list of these options can be  helpful command-line options.  A complete list of these options can be
617  obtained from:  obtained from:
# Line 617  The most important command-line options Line 634  The most important command-line options
634    the user's path.  When these three items have been identified,    the user's path.  When these three items have been identified,
635    genmake2 will try to find an optfile that has a matching name.    genmake2 will try to find an optfile that has a matching name.
636        
637  \item[\texttt{--pdefault='PKG1 PKG2 PKG3 ...'}] specifies the default  \item[\texttt{--mods='DIR1 DIR2 DIR3 ...'}] specifies a list of
638    set of packages to be used.  The normal order of precedence for    directories containing ``modifications''.  These directories contain
639    packages is as follows:    files with names that may (or may not) exist in the main MITgcm
640    \begin{enumerate}    source tree but will be overridden by any identically-named sources
641    \item If available, the command line (\texttt{--pdefault}) settings    within the ``MODS'' directories.
     over-rule any others.  
   
   \item Next, \texttt{genmake2} will look for a file named  
     ``\texttt{packages.conf}'' in the local directory or in any of the  
     directories specified with the \texttt{--mods} option.  
       
   \item Finally, if neither of the above are available,  
     \texttt{genmake2} will use the \texttt{/pkg/pkg\_default} file.  
   \end{enumerate}  
642        
643      The order of precedence for this "name-hiding" is as follows:
644      \begin{itemize}
645      \item ``MODS'' directories (in the order given)
646      \item Packages either explicitly specified or provided by default
647        (in the order given)
648      \item Packages included due to package dependencies (in the order
649        that that package dependencies are parsed)
650      \item The "standard dirs" (which may have been specified by the
651        ``-standarddirs'' option)
652      \end{itemize}
653      
654    \item[\texttt{--pgroups=/PATH/FILENAME}] specifies the file
655      where package groups are defined. If not set, the package-groups
656      definition will be read from {\em pkg/pkg\_groups}.
657      It also contains the default list of packages (defined
658      as the group ``{\it default\_pkg\_list}'' which is used
659      when no specific package list ({\em packages.conf})
660      is found in current directory or in any "MODS" directory.
661    
662  \item[\texttt{--pdepend=/PATH/FILENAME}] specifies the dependency file  \item[\texttt{--pdepend=/PATH/FILENAME}] specifies the dependency file
663    used for packages.    used for packages.
664        
# Line 656  The most important command-line options Line 683  The most important command-line options
683    "STAF" compiler.  As with any compilers, it is helpful to have their    "STAF" compiler.  As with any compilers, it is helpful to have their
684    directories listed in your {\tt \$PATH} environment variable.    directories listed in your {\tt \$PATH} environment variable.
685        
 \item[\texttt{--mods='DIR1 DIR2 DIR3 ...'}] specifies a list of  
   directories containing ``modifications''.  These directories contain  
   files with names that may (or may not) exist in the main MITgcm  
   source tree but will be overridden by any identically-named sources  
   within the ``MODS'' directories.  
     
   The order of precedence for this "name-hiding" is as follows:  
   \begin{itemize}  
   \item ``MODS'' directories (in the order given)  
   \item Packages either explicitly specified or provided by default  
     (in the order given)  
   \item Packages included due to package dependencies (in the order  
     that that package dependencies are parsed)  
   \item The "standard dirs" (which may have been specified by the  
     ``-standarddirs'' option)  
   \end{itemize}  
     
686  \item[\texttt{--mpi}] This option enables certain MPI features (using  \item[\texttt{--mpi}] This option enables certain MPI features (using
687    CPP \texttt{\#define}s) within the code and is necessary for MPI    CPP \texttt{\#define}s) within the code and is necessary for MPI
688    builds (see Section \ref{sect:mpi-build}).    builds (see Section \ref{sect:mpi-build}).
# Line 715  The steps for building MITgcm with MPI s Line 725  The steps for building MITgcm with MPI s
725    libraries and put them into an options file as described in Section    libraries and put them into an options file as described in Section
726    \ref{sect:genmake}.  One can start with one of the examples in:    \ref{sect:genmake}.  One can start with one of the examples in:
727    \begin{rawhtml} <A    \begin{rawhtml} <A
728      href="http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm/tools/build_options/">      href="http://mitgcm.org/viewvc/MITgcm/MITgcm/tools/build_options/">
729    \end{rawhtml}    \end{rawhtml}
730    \begin{center}    \begin{center}
731      \texttt{MITgcm/tools/build\_options/}      \texttt{MITgcm/tools/build\_options/}
# Line 766  The steps for building MITgcm with MPI s Line 776  The steps for building MITgcm with MPI s
776    library and a job scheduling and queueing system such as PBS,    library and a job scheduling and queueing system such as PBS,
777    LoadLeveller, Condor, or any of a number of similar tools.  A few    LoadLeveller, Condor, or any of a number of similar tools.  A few
778    example scripts (those used for our \begin{rawhtml} <A    example scripts (those used for our \begin{rawhtml} <A
779      href="http://mitgcm.org/testing.html"> \end{rawhtml}regular      href="http://mitgcm.org/public/testing.html"> \end{rawhtml}regular
780    verification runs\begin{rawhtml} </A> \end{rawhtml}) are available    verification runs\begin{rawhtml} </A> \end{rawhtml}) are available
781    at:    at:
782    \begin{rawhtml} <A    \begin{rawhtml} <A
783      href="http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/test_scripts/">      href="http://mitgcm.org/viewvc/MITgcm/MITgcm/tools/example_scripts/">
784      \end{rawhtml}
785      {\footnotesize \tt
786        http://mitgcm.org/viewvc/MITgcm/MITgcm/tools/example\_scripts/ }
787      \begin{rawhtml} </A> \end{rawhtml}
788      or at:
789      \begin{rawhtml} <A
790        href="http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/test_scripts/">
791    \end{rawhtml}    \end{rawhtml}
792    {\footnotesize \tt    {\footnotesize \tt
793      http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm\_contrib/test\_scripts/ }      http://mitgcm.org/viewvc/MITgcm/MITgcm\_contrib/test\_scripts/ }
794    \begin{rawhtml} </A> \end{rawhtml}    \begin{rawhtml} </A> \end{rawhtml}
795    
796  \end{enumerate}  \end{enumerate}
Legend:
Removed from v.1.39  
changed lines
  Added in v.1.42
  ViewVC Help
Powered by ViewVC 1.1.22