<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>linbox: Configuring and Installing LinBox</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.4 -->
<script type="text/javascript">
function hasClass(ele,cls) {
return ele.className.match(new RegExp('(\\s|^)'+cls+'(\\s|$)'));
}
function addClass(ele,cls) {
if (!this.hasClass(ele,cls)) ele.className += " "+cls;
}
function removeClass(ele,cls) {
if (hasClass(ele,cls)) {
var reg = new RegExp('(\\s|^)'+cls+'(\\s|$)');
ele.className=ele.className.replace(reg,' ');
}
}
function toggleVisibility(linkObj) {
var base = linkObj.getAttribute('id');
var summary = document.getElementById(base + '-summary');
var content = document.getElementById(base + '-content');
var trigger = document.getElementById(base + '-trigger');
if ( hasClass(linkObj,'closed') ) {
summary.style.display = 'none';
content.style.display = 'block';
trigger.src = 'open.png';
removeClass(linkObj,'closed');
addClass(linkObj,'opened');
} else if ( hasClass(linkObj,'opened') ) {
summary.style.display = 'block';
content.style.display = 'none';
trigger.src = 'closed.png';
removeClass(linkObj,'opened');
addClass(linkObj,'closed');
}
return false;
}
</script>
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">linbox</div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="index.html">LinBox Symbolic Linear Algebra Software Library.</a> </li>
<li class="navelem"><a class="el" href="inst.html">Installing LinBox</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="headertitle">
<div class="title">Configuring and Installing <a class="el" href="namespace_lin_box.html" title="Namespace in which all linbox code resides.">LinBox</a> </div> </div>
</div>
<div class="contents">
<div class="textblock"><!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>
</div></div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Aug 30 2011 for linbox by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>
</body>
</html>
