<?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>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
91213ddcfbe7f54821d42c2d9e091326
>
files
>
1590
