<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<!-- Copyright (C) 2005 LinBox team, part of LinBox, GNU LGPL, see COPYING
-->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.76 [en] (X11; U; SunOS 5.8 sun4u) [Netscape]">
<link href="doxygen.css" rel="stylesheet" type="text/css">
<title>linbox: Installation</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000">
<center>
<p><b><font size=+2>How to install LinBox (from a distribution)</font></b></center>
<p><br>
<blockquote>
See also <a href="INSTALL">INSTALL</a>. Once the LinBox
distribution has been downloaded from the <a href="http://www.linalg.org/download.html"> LinBox download section</a> ,
</blockquote>
<blockquote>
<p><b>1.</b>
<b>Unpack</b> the distribution using <tt>tar</tt> command:
<blockquote>
<tt>
tar -xvzf linbox-X.X.X.tar.gz
</tt>
</blockquote>
</blockquote>
<blockquote>
<b>2.</b> Go to the newly-created linbox directory and
run the script
<b>configure</b>.
<blockquote><tt>> cd linbox</tt></blockquote>
There are many options for configuring LinBox.
If you are not sure, just run
<blockquote><tt>> v;./configure --help </tt></blockquote>
You will find a very comprehensible list of all possible features you may enable/disable.
Basically, minimal LinBox only requires a working <a
href="https://forge.imag.fr/projects/givaro/">Givaro</a> and <a
href="http://linalg.org/projects/fflas-ffpack">Fflas-Ffpack</a>
installation. If they are not under the standard <tt>/usr</tt> or
<tt>/usr/local</tt> paths, you may enable them with
<tt>--with-givaro=<path/to/givaro></tt> and
<tt>--with-fflas-ffpack=<path/to/fflas-ffpack></tt> options.
<p>
<b> NOTE </b> :
If you have trouble installing LinBox and its dependancies, you can try the script :
<blockquote><tt>> v;sh auto-install.sh </tt></blockquote>
which will download the appropriate dependencies, compile and install everything.
Use <tt>--help</tt> for help on how to use this script.
</p>
<p> <b>3.</b> Optional configurations
<b>Available packages are the following:</b>
<br>
<br>
<table border="3" style="text-align: left; margin-left: 30pt;" cellpadding="5" cellspacing="5">
<tr>
<td> <a href="http://shoup.net/ntl/">NTL</a></td>
<td> <tt> --with-ntl= <ntl_directory></tt></td>
<td> used for finite field, polynomial arithmetic.</td>
</tr>
<tr>
<td> <a href="http://www.informatik.tu-darmstadt.de/TI/LiDIA/"> Lidia </a></td>
<td> <tt> --with-lidia= <lidia_directory></tt> </td>
<td> used for finite field arithmetic.</td>
</tr>
<tr>
<td> <a href="ftp://ftp.risc.uni-linz.ac.at/pub/saclib/"> Saclib </a></td>
<td> <tt> --with-saclib= <saclib_directory></td>
<td> not yet used </td>
</tr>
<tr>
<td> <a href="http://www.maplesoft.com/"> Maple (> v9) </a></td>
<td> <tt> --enable-shared --with-maple= <maple-directory> </tt></td>
<td> used to create an interface with Maple.</td>
</tr>
<tr>
<td> <a href="http://www.doxygen.org/"> Doxygen </a></td>
<td> <tt> --enable-doc </tt></td>
<td>used to create the html reference manual (nothing will be created otherwise).</td>
</tr>
<tr>
<td> <a href="http://www.cs.uwaterloo.ca/~astorjoh/iml.html"> IML </a></td>
<td> <tt> --with-iml= <IML-path> </tt></td>
<td>used for fast integer/rational linear algebra.</td>
</tr>
<tr>
<td> <a href="http://www.gnuplot.info/">gnuplot</a></td>
<td> <tt> -enable-benchmark </tt></td>
<td>used for creating plots in benchmarks.</td>
</tr>
</table>
<br>
Note:
<blockquote>
<p> the use of <tt> --with-default= <default_directory></tt> can add a special directory to the default location of library
<p> the use of <tt> --with-all</tt> specifies that all packages will be used
</blockquote>
<!-- <p><b> 3.4.</b> Here is a full example: -->
<!-- <blockquote> -->
<!-- <tt>./configure --prefix=/usr/local/soft/linbox-1.1 --with-givaro=/usr/local/soft/givaro-3.2.6 --with-ntl=/usr/local/soft/ntl-5.4 --with-gmp=/usr/local/soft/gmp-4.2.1 --with-blas="-L/usr/local/soft/GotoBLAS -lgoto -lpthread" --with-maple=/usr/local/soft/maple --enable-optimization --enable-shared --disable-static</tt> -->
<!-- </blockquote> -->
<!-- </blockquote> -->
<b>4. </b><b>Install</b> the library:
<blockquote><tt>> make </tt></blockquote>
<blockquote><tt>> make install</tt></blockquote>
<b>5. </b>Optional make targets:
<blockquote><tt>> make examples</tt></blockquote>
will compile the examples.
<blockquote><tt>> make check</tt></blockquote>
will check LinBox is up and running.
<blockquote><tt>> make fullcheck</tt></blockquote>
will perform additionnal checks to ensure LinBox is completely sane.
<blockquote><tt>> make benchmarks</tt></blockquote>
will benchmarks some LinBox functionnalities.
<br>
<br>
<b>6. Enjoy !</b> <small>(and report bugs, supply patches, ask for more functionnalities,... on the linbox mailing lists)</small>
</blockquote>
<hr WIDTH="100%">
<div align=right><font size=-1>Copyright 1999-2011 The Linbox Group.</font></div>
</body>
</html>
