<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <title>GAP (IO) - Chapter 2: Installation of the IO-package</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <meta name="generator" content="GAPDoc2HTML" /> <link rel="stylesheet" type="text/css" href="manual.css" /> </head> <body> <div class="chlinktop"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a> <a href="chap1.html">1</a> <a href="chap2.html">2</a> <a href="chap3.html">3</a> <a href="chap4.html">4</a> <a href="chap5.html">5</a> <a href="chap6.html">6</a> <a href="chap7.html">7</a> <a href="chap8.html">8</a> <a href="chap9.html">9</a> <a href="chapInd.html">Ind</a> </div> <div class="chlinkprevnexttop"> <a href="chap0.html">Top of Book</a> <a href="chap1.html">Previous Chapter</a> <a href="chap3.html">Next Chapter</a> </div> <p><a id="X8203E34B178787118" name="X8203E34B178787118"></a></p> <div class="ChapSects"><a href="chap2.html#X8203E34B178787118">2. <span class="Heading">Installation of the <strong class="pkg">IO</strong>-package</span></a> <div class="ContSect"><span class="nocss"> </span><a href="chap2.html#X17F7AFC7E808A56C7">2.1 <span class="Heading">Static linking</span></a> </div> <div class="ContSect"><span class="nocss"> </span><a href="chap2.html#X17FB00ED21787027A3">2.2 <span class="Heading">Recompiling the documentation</span></a> </div> </div> <h3>2. <span class="Heading">Installation of the <strong class="pkg">IO</strong>-package</span></h3> <p>To get the newest version of this <strong class="pkg">GAP</strong> 4 package download one of the archive files</p> <ul> <li><p><code class="file">io-x.x.tar.gz</code></p> </li> <li><p><code class="file">io-x.x.zoo</code></p> </li> <li><p><code class="file">io-x.x.tar.bz2</code></p> </li> <li><p><code class="file">io-x.x.zip</code></p> </li> </ul> <p>and unpack it using</p> <pre class="normal"> gunzip io-x.x.tar.gz; tar xvf io-x.x.tar </pre> <p>respectively</p> <pre class="normal"> unzoo -x io-x.x.zoo </pre> <p>and so on.</p> <p>Do this in a directory called "<code class="file">pkg</code>", preferably (but not necessarily) in the "<code class="file">pkg</code>" subdirectory of your <strong class="pkg">GAP</strong> 4 installation. It creates a subdirectory called "<code class="file">io</code>".</p> <p>To install this package do</p> <pre class="normal"> cd io ./configure [path] </pre> <p>where "path" is a path to the main <strong class="pkg">GAP</strong> root directory (if not given the default "<code class="file">../..</code>" is assumed).</p> <p>Afterwards call "<code class="file">make</code>" to compile a binary file.</p> <p>If you installed <strong class="pkg">GAP</strong> on several architectures, you must execute this configure/make step on each of the architectures immediately after configuring <strong class="pkg">GAP</strong> itself on this architecture.</p> <p>The package will not work without this step.</p> <p>If you installed the package in another "<code class="file">pkg</code>" directory than the standard "<code class="file">pkg</code>" directory in your <strong class="pkg">GAP</strong> 4 installation, then you have to add the path to the directory containing your "<code class="file">pkg</code>" directory to <strong class="pkg">GAP</strong>'s list of directories. This can be done by starting <strong class="pkg">GAP</strong> with the "<code class="file">-l</code>" command line option followed by the name of the directory and a semicolon. Then your directory is prepended to the list of directories searched. Otherwise the package is not found by <strong class="pkg">GAP</strong>. Of course, you can add this option to your <strong class="pkg">GAP</strong> startup script.</p> <p><a id="X17F7AFC7E808A56C7" name="X17F7AFC7E808A56C7"></a></p> <h4>2.1 <span class="Heading">Static linking</span></h4> <p>This might be interesting for M$ Windows users, as dynamic loading of binary modules does not work there.</p> <p>You can also create a new statically linked "<code class="file">gap</code>" binary as follows: Go into the main <strong class="pkg">GAP</strong> directory and then into <code class="file">bin/BINDIR</code>. Here <code class="file">BINDIR</code> means the directory containing the "<code class="file">gap</code>" executable after compiling "<code class="file">gap</code>". This directory also contains the <strong class="pkg">GAP</strong> compiler script "<code class="file">gac</code>". Assuming IO in the standard location you can then say</p> <pre class="normal"> ./gac -o gap-static -p "-DIOSTATIC" -P "-static" ../../pkg/io/src/io.c </pre> <p>Then copy your "<code class="file">gap</code>" start script to, say, "<code class="file">gapbig</code>" and change the references to the <strong class="pkg">GAP</strong> binary to "<code class="file">gap-static</code>".</p> <p>If you want to install more than one package with a C-part like this package, you can still create a statically linked <strong class="pkg">GAP</strong> executable by combining all the compile and link options and all the .c files as in the ./gac command above. For the IO package, you have to add</p> <pre class="normal"> -DIOSTATIC </pre> <p>to the string of the -p option and the file</p> <pre class="normal"> ../../pkg/io/src/io.c </pre> <p>somewhere on the command line.</p> <p><a id="X17FB00ED21787027A3" name="X17FB00ED21787027A3"></a></p> <h4>2.2 <span class="Heading">Recompiling the documentation</span></h4> <p>Recompiling the documentation is possible by the command "<code class="file">gap makedoc.g</code>" in the <code class="file">io</code> directory. But this should not be necessary.</p> <div class="chlinkprevnextbot"> <a href="chap0.html">Top of Book</a> <a href="chap1.html">Previous Chapter</a> <a href="chap3.html">Next Chapter</a> </div> <div class="chlinkbot"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a> <a href="chap1.html">1</a> <a href="chap2.html">2</a> <a href="chap3.html">3</a> <a href="chap4.html">4</a> <a href="chap5.html">5</a> <a href="chap6.html">6</a> <a href="chap7.html">7</a> <a href="chap8.html">8</a> <a href="chap9.html">9</a> <a href="chapInd.html">Ind</a> </div> <hr /> <p class="foot">generated by <a href="http://www.math.rwth-aachen.de/~Frank.Luebeck/GAPDoc">GAPDoc2HTML</a></p> </body> </html>