How to install LinBox (from a distribution)


See also INSTALL.  Once the LinBox distribution has been downloaded from the LinBox download section ,

1. Unpack the distribution using tar command:

tar -xvzf linbox-X.X.X.tar.gz
2. Go to the newly-created linbox directory and run the script configure, optionally you may specify the LinBox installation directory or an optional package directory using prefixes:
> cd linbox
> ./configure [--prefix=<inst. dir.> --with-package=<location> --enable-feature]
Gmp is required (preferably compiled with the "--enable-cxx" option) and its location must be specified <gmp location> if not at a standard location such as /usr or /usr/local:
> ./configure --with-gmp= <gmp location> [...]
A source of BLAS (e.g. Fortran Goto or C Atlas) is also required and its location must be specified if not standard.
> ./configure --with-blas=-L<gotoblas location> -lgoto -lpthread [...]
> ./configure --with-blas= <atlas location> [...]
This sets up the library and runs  ./configure

3. Optional configurations

3.1. Where to put the include/ and lib/ directories:
--prefix= <chosen installation directory>
Ex:  ./configure --prefix= `pwd` will put the files within the current directory

3.2. The use of an optional package is switched on by specifying the directory where it can be found:

--with-package=<package_directory>

<package_directory> can be left blank if the package is installed in a standard directory (/usr or /usr/local)
Ex: ./configure --with-givaro will enable the use of Givaro library and assume it is installed in a standard directory

Available packages are the following:

Givaro (v3.2.6) --with-givaro= <givaro_directory> used for finite field arithmetic.
NTL --with-ntl= <ntl_directory> used for finite field, polynomial arithmetic.
Lidia --with-lidia= <lidia_directory> used for finite field arithmetic.
Saclib --with-saclib= <saclib_directory> not yet used
Maple (> v9) --enable-shared --with-maple= <maple-directory>  used to create an interface with Maple.
Doxygen --with-doxygen= <doxygen-path>  used to create the html reference manual.

Note:

the use of --with-default= <default_directory> can add a special directory to the default location of library

the use of --with-all specifies that all packages will be used

3.3. The use of special feature is switched on by calling the enable parameter:

--enable-feature
Ex: ./configure --enable-shared will turn on the build of a shared library

Available extra features are the following:

--enable-optimization turn on runtime optimization during the configuration
--enable-doc turn on the build of documentation via Doxygen.

3.4. Here is a full example:

./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
4.  Install the library:
>  make install

Copyright 1999-2007 The Linbox Group.