📄 node30.html
字号:
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2 Final//FR"><!-- Converted with LaTeX2HTML 95.1 (Fri Jan 20 1995) --><!-- by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds --><!-- Modified Simulog 03/97 --><HTML><HEAD><TITLE>2.1 The installation procedure:</TITLE><LINK REL=STYLESHEET TYPE="text/css" HREF="./Modulef.css" TITLE="Modulef CSS"><meta name="description" value="2.1 The installation procedure:"><meta name="keywords" value="Guide1"><meta name="resource-type" value="document"><meta name="distribution" value="global"></HEAD><BODY BGCOLOR="#FFFFFF"><P> <IMG SRC="../icons/smallmod.gif" WIDTH=211 HEIGHT=50 ALIGN=BOTTOM ALT="Modulef"><A NAME=tex2html551 HREF="node29.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/previous_motif.gif" ALT="previous"></A><A NAME=tex2html557 HREF="node29.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/up_motif.gif" ALT="up"></A><A NAME=tex2html559 HREF="node31.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/next_motif.gif" ALT="next"></A><A NAME=tex2html561 HREF="node2.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/contents_motif.gif" ALT="contents"></A><A HREF="../Guide1-18/node30.html"><IMG BORDER=0 SRC="../icons/zoom18.gif" ALIGN=BOTTOM ALT="[BIG]"></A><A HREF="../Guide1-14/node30.html"><IMG BORDER=0 SRC="../icons/zoom14.gif" ALIGN=BOTTOM ALT="[Normal]"></A><A HREF="../Guide1-10/node30.html"><IMG BORDER=0 SRC="../icons/zoom10.gif" ALIGN=BOTTOM ALT="[small]"></A><BR><B> Next: </B> <A NAME=tex2html560 HREF="node31.html">2.2 Other information</A><B>Up: </B> <A NAME=tex2html558 HREF="node29.html">2 Installation procedure: UNIX</A><B> Prev: </B> <A NAME=tex2html552 HREF="node29.html">2 Installation procedure: UNIX</A><B><A HREF="node2.html" >Contents</A></B><HR SIZE=3 WIDTH="75%"><H1><A NAME=SECTION05310000000000000000>2.1 The installation procedure:</A></H1> <A NAME=secinstall_proc> </A><P><P><P> The installation is performed with the help of a Makefile and can be subdivided into two steps: <OL><LI> generating the installation Makefile, and <LI> installation: executing the Makefile </OL><H2><A NAME=SECTION05311000000000000000> Step 1</A></H2><P> This step is performed by initiating the following command after reading the magnetic tape:<P> <DL COMPACT><DT>% make<DD> <P> </DL><P> After entering this command an error message of the following form will probably appear:<P> <PRE>La variable MR n'est pas initialisee dans le fichier MakefileElle doit avoir pour valeur /udd/modulefmake: *** [verification] Error 1</PRE><P> In this example, let us assume that the MODULEF cartridge was read into directory <b> /udd/modulef</b>. Variable MR, in file <b> Makefile</b> located in the current directory, must then be initialized to the directory name where MODULEF was read (in this example <b> /udd/modulef</b>).<P> Having done this, you can re-enter the same command:<P> <DL COMPACT><DT>% make<DD> <P> </DL><P> As long as variable MR is not initialized correctly, the same type of error message as shown above will appear and the installation will not be effected.<P> Once the variable is initialized correctly, the Makefile requests the name of the type of machine on which the installation is to be done. A list of names of several type of machines will appear on the screen to aid you with the response. Your response is very important as it initializes variable MM which, amongst others, is used to select the library containing the utilities corresponding to the machine specified. If your machine does not appear in the list, you will need to rewrite the utility corresponding to your machine by consulting libraries <b> u_mod</b> and <b> u_rs6000</b> (see section <A HREF="node36.html#secnonport">4.2</A>).<P> Once MM is initialized, the Makefile performs the following actions:<P> <UL><LI> create directory <b> Install$MM</b> in the current directory, (<b> $MR/make</b>), <LI> generate files <b> Makefile</b> and <b> M_config</b> in directory <b> Install$MM</b>.<P> The file <b> Makefile</b> contains the installation Makefile. All the variables necessary for installation are initialized by default in the file <b> M_config</b> (which is read by the Makefile). </UL><P> Having performed these tasks, the Makefile then gives the following instructions:<P> <OL><LI> change directory (<b> cd Install$MM</b>), <LI> consult file <b> M_config</b> contained in this directory, and <LI> restart the Makefile (<b> make</b>). </OL><P>Each of the points are described below:<P><OL><LI> change directory (<b> cd Install$MM</b>)<P>We place ourselves in the directory in which we want to perform the installation;<P><LI> consult file <b> M_config</b> contained in this directory;<P>It is preferable to edit file <b> M_config</b> before starting the initialization process so that the following variables are initialized correctly:<P><DL COMPACT><DT>MR :<DD> root directory where MODULEF is installed;<DT>MM :<DD> machine name;<DT>MV :<DD> version name (<b> sta</b>);<DT>SHELL :<DD> kind of shell used (<tt> /bin/sh</tt>)<DT>F77 :<DD> Fortran compilation command;<DT>F77FLAGS :<DD> Fortran compilation options;<DT>CC :<DD> C compilation command;<DT>CCFLAGS :<DD> C compilation options;<DT>CIFLAGS :<DD> search path for the include files during compilation of the C source files;<DT>LINK :<DD> link command for creating the executables;<DT>CPPFLAGS :<DD> search path for the object libraries;<DT>STDLIB :<DD> libraries to include during linking. The libraries to include depend stronglyon the graphic peripherals selected from the list at a later stage (the listof graphic peripherals available is given in Appendix <A HREF="node62.html#anngraph_disp">F</A>) ;<DT>AR :<DD> archive command for the object files;<DT>ARFLAGS :<DD> archive option for the object files;<DT>RANLIB :<DD> modify the object archives so that the linking process is faster. In general, thevalue of this variable is <b> ranlib</b>, except on machines for which this command does not exist (Silicon), in which casethis variable is initialized to an empty string of characters (<b> RANLIB=</b>) ;<DT>LANGUAGE :<DD> if the contents of this variable is empty, theMakefile makes nothing, else<UL><LI> <tt> LANGUAGE=GB</tt> : translates the print format in English<LI> <tt> LANGUAGE=F</tt> : translates the print format in wrench</UL><DT>BLAS :<DD> indicate whether libraryBLAS (Basic Linear Algebra Software) already exists in the system, in which case it is of no use to compile library <b> blas_mod</b> (for example on Cray);<P><DT>ZZZZ :<DD> indicates if library <b> zzzz_mod</b>, containing the user sub-programs, to be compiled.<P>If your machine accepts unsatisfied references, it is not necessary to compile <b> zzzz_mod</b>and, in this case, <b> ZZZZ</b> is initialized to an empty string of characters(<b> ZZZZ =</b>);<P><DT>FF3D :<DD> name of the library containing the interface sub-programs between the graphics software, FORTRAN 3D [<A HREF="node65.html#mod_96"><A NAME=tex2html41 HREF="../Guide6/welcome.html">MODULEF User Guide - 6</A></A>], andMODULEF (<b> p_l<i> $MM</i></b>),<P><DT>UTIL :<DD> name of the library containing utilities corresponding to the installationmachine (in general, <b> u_<i> machine name</i></b>);<P><DT>PPAL :<DD> variable <b> PPAL</b> indicates which executables you wish to create.<b> PPAL</b> is initialized by default to the list of executables most often used, however, you can enter any values you wish:<P><DL COMPACT><DT>PPAL=tout :<DD> to link all the executables contained in library <b> ppal</b>.<P>If you decide to link all the executables contained in library <b> ppal</b>, make sure that you have enough disk space (approximately 100 MB).<P><DT>PPAL=PP_nofoxx PP_toutxx :<DD> only executables <b> nofoxx</b> and <b> toutxx</b> are created.<P> </DL><DT>MAXSUB:<DD> this variable, used for the compilation of the libraries, gives the maximal number of files that can depend on a library.If a Modulef library contains more than MAXSUB files then the update of the library will be made by several Makefile. Modify the value of MAXSUB only if you have this kind of message during the libraries compilation <PRE>Make: Expanded macro line is too long. Stop.*** Exit 1Stop.*** Exit 1Stop.</PRE>For further details, consult the appendix <A HREF="node60.html#compillibrary">D.2.2</A><DT>TYPEMAKE :<DD> this variable depends on the make command you useduring the installation of Modulef.<BR> By default, we suppose that this command assumes the syntax <code>%.f%.o:</code>is correct and TYPEMAKE is set to <code>makeMakefile</code>. If not, (an error message will appear during the library compilation)set this variable to <code>makeMakefile.bb</code>.<DT>MAJMIN :<DD> this variable contains the command that allows totranslate uppercase letters into lowercase letters. It is used inorder to generate the Makefile of the libraries <b> test</b> and <b> ppal</b>.<BR> Generally this variable is automatically set, therefore it is possible,that this initialization cannot be made under some operating system.<P>In this case, the makefile tells you that you have to find the commandthat allows to make this translation and to set MAJMIN in thefile <BR>[4]<code>$MR/make/Install$MM/M_config</code>.<BR><P>In order to find this command you can use these 2 files:<UL><LI> <code> $racine/make/test_maj</code> contains uppercase letters<LI> <code> $racine/make/test_min</code> contains the same lowercase letters</UL> </DL><P><b> Note :</b> If you modify the values of certain variables, these values should notbe put between quotes, as that could result in errors at a later stage.<P> The value of MAJMIN has to be put between quotes.<P><P><P>Once file <b> M_config</b> has been consulted, the installation can be performed:<P><LI> restart the makefile (<b> make</b>)<P>We are now in the second part of the Makefile, called the installation.<P></OL><P><P><P><H2><A NAME=SECTION05312000000000000000> Step 2</A></H2><P>It is during this step that the installation is really performed (compiling, creating the executables, ...).<P>We remain in the installation directory throughout this step:<P><blockquote> <b> $MR/make/Install<i> name of machine</i></b></blockquote><P> During this phase the Makefile will be interrupted at least once.This interruption allows you to select the graphic peripherals. This choice is made in file <b> periphin.in</b>; the graphic peripherals <b> x11</b> and <b> postscript</b> (see Appendix <A HREF="node62.html#anngraph_disp">F</A>)are selected by default. Thus:<P><UL><LI> if the default setting suits you, you can immediately perform the installation process by entering the <b> make</b> command,<LI> if not, you need to edit file <b> periphin.in</b> and, at the position indicated following the line:<P><blockquote> <code># INSEREZ LA LISTE DES PERIPHERIQUES : (ne pas mettre le caractere diese en debut de ligne)</code><BR> </blockquote><P>replace <b> x11</b> and <b> postscript</b> by the graphic peripherals you wish touse (check that the value of variable <b> STDLIB</b> is compatible with your peripheral choice).<P>Having made the necessary modifications, You can now start the installation process by entering the <b> make</b> command.</UL><P>The Makefile now continues by performing the following tasks:<P><OL><LI> Create the object libraries, (target <b> libraries</b>).<P>To this end, a new Makefile is created in each source library, whichcompiles the library and stores the object files in an archive.If this target is executed several times, the Makefile will verify all thedependencies and will not do anything if everything is up-to-date, or recompile onlythose which are not up-to-date.<P>Each Makefile generated in the source libraries can easily be re-used if you install on different machineswithout duplicating the source code.<P>Any error messages generated during compilation are written on file:<P><UL><LI> <b> output_compil</b> contains all the compilation messages,<LI> <b> erreur_compil</b> contains the list of procedures that need to be recompiled(if this file does not exist, it means that all the compilations were performed correctly).</UL><P>During compilation, a directory with the name of the library compiled is createdin the current directory, <b> $MR/make/Install$MM</b>. This directory contains the object files temporarily before they are stored in a library.<P>If an interruption occurs during compilation, those files that are already compiled will not be lost. In fact, when the Makefile is re-started it checks, for each library, if a directory with the same name does not exist in the current directory(<b> $MR/make/Install$MM</b>). If this is indeed the case, it will archive the objects contained in the directory before compiling.<P><LI> Link (target <b> executables</b>).<P>As before (target libraries), we generate the Makefiles, giving the inter-dependence between the object libraries and the main programs contained in libraries<b> test</b> and <b> ppal</b>. In this manner, the link is done only with those libraries that are necessary (thus being faster).<P>While executing this target, several actions are performed:<P><UL><LI> Firstly, in order to generate the Makefiles of libraries <b> ppal</b> and <b> test</b>, programs <b> procat</b> and <b> proimp</b> are linked (it is imperative that the creation and execution of these two programs are successful, otherwisethe Makefile cannot continue).<LI> The main programs contained in variable PPAL are created.<LI> The test program (contained in library <b> test</b>) are created.<LI> Lastly, the direct access files <b> poba.direct</b> and <b> pobv.direct</b>, required when using certain finite elements, are generated.</UL></OL><P><P><P><HR SIZE=3 WIDTH="75%"><IMG SRC="../icons/smallmod.gif" WIDTH=211 HEIGHT=50 ALIGN=BOTTOM ALT="Modulef"><A NAME=tex2html551 HREF="node29.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/previous_motif.gif" ALT="previous"></A><A NAME=tex2html557 HREF="node29.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/up_motif.gif" ALT="up"></A><A NAME=tex2html559 HREF="node31.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/next_motif.gif" ALT="next"></A><A NAME=tex2html561 HREF="node2.html"><IMG BORDER=0 ALIGN=BOTTOM SRC="../icons/contents_motif.gif" ALT="contents"></A><A HREF="../Guide1-18/node30.html"><IMG BORDER=0 SRC="../icons/zoom18.gif" ALIGN=BOTTOM ALT="[BIG]"></A><A HREF="../Guide1-14/node30.html"><IMG BORDER=0 SRC="../icons/zoom14.gif" ALIGN=BOTTOM ALT="[Normal]"></A><A HREF="../Guide1-10/node30.html"><IMG BORDER=0 SRC="../icons/zoom10.gif" ALIGN=BOTTOM ALT="[small]"></A><BR><B> Next: </B> <A NAME=tex2html560 HREF="node31.html">2.2 Other information</A><B>Up: </B> <A NAME=tex2html558 HREF="node29.html">2 Installation procedure: UNIX</A><B> Prev: </B> <A NAME=tex2html552 HREF="node29.html">2 Installation procedure: UNIX</A><B><A HREF="node2.html" >Contents</A></B><BR> <HR><P><ADDRESS></ADDRESS></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -