You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
279 lines
7.5 KiB
279 lines
7.5 KiB
<HTML>
|
|
<HEAD>
|
|
<!-- Created by texi2html 1.56k from cln.texi on 28 August 2000 -->
|
|
|
|
<TITLE>CLN, a Class Library for Numbers - 2. Installation</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
Go to the <A HREF="cln_1.html">first</A>, <A HREF="cln_1.html">previous</A>, <A HREF="cln_3.html">next</A>, <A HREF="cln_13.html">last</A> section, <A HREF="cln_toc.html">table of contents</A>.
|
|
<P><HR><P>
|
|
|
|
|
|
<H1><A NAME="SEC2" HREF="cln_toc.html#TOC2">2. Installation</A></H1>
|
|
|
|
<P>
|
|
This section describes how to install the CLN package on your system.
|
|
|
|
|
|
|
|
|
|
<H2><A NAME="SEC3" HREF="cln_toc.html#TOC3">2.1 Prerequisites</A></H2>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC4" HREF="cln_toc.html#TOC4">2.1.1 C++ compiler</A></H3>
|
|
|
|
<P>
|
|
To build CLN, you need a C++ compiler.
|
|
Actually, you need GNU <CODE>g++ 2.90</CODE> or newer, the EGCS compilers will
|
|
do.
|
|
I recommend GNU <CODE>g++ 2.95</CODE> or newer.
|
|
|
|
|
|
<P>
|
|
The following C++ features are used:
|
|
classes, member functions, overloading of functions and operators,
|
|
constructors and destructors, inline, const, multiple inheritance,
|
|
templates and namespaces.
|
|
|
|
|
|
<P>
|
|
The following C++ features are not used:
|
|
<CODE>new</CODE>, <CODE>delete</CODE>, virtual inheritance, exceptions.
|
|
|
|
|
|
<P>
|
|
CLN relies on semi-automatic ordering of initializations
|
|
of static and global variables, a feature which I could
|
|
implement for GNU g++ only.
|
|
|
|
|
|
|
|
|
|
<H3><A NAME="SEC5" HREF="cln_toc.html#TOC5">2.1.2 Make utility</A></H3>
|
|
<P>
|
|
<A NAME="IDX4"></A>
|
|
|
|
|
|
<P>
|
|
To build CLN, you also need to have GNU <CODE>make</CODE> installed.
|
|
|
|
|
|
|
|
|
|
<H3><A NAME="SEC6" HREF="cln_toc.html#TOC6">2.1.3 Sed utility</A></H3>
|
|
<P>
|
|
<A NAME="IDX5"></A>
|
|
|
|
|
|
<P>
|
|
To build CLN on HP-UX, you also need to have GNU <CODE>sed</CODE> installed.
|
|
This is because the libtool script, which creates the CLN library, relies
|
|
on <CODE>sed</CODE>, and the vendor's <CODE>sed</CODE> utility on these systems is too
|
|
limited.
|
|
|
|
|
|
|
|
|
|
<H2><A NAME="SEC7" HREF="cln_toc.html#TOC7">2.2 Building the library</A></H2>
|
|
|
|
<P>
|
|
As with any autoconfiguring GNU software, installation is as easy as this:
|
|
|
|
|
|
|
|
<PRE>
|
|
$ ./configure
|
|
$ make
|
|
$ make check
|
|
</PRE>
|
|
|
|
<P>
|
|
If on your system, <SAMP>`make'</SAMP> is not GNU <CODE>make</CODE>, you have to use
|
|
<SAMP>`gmake'</SAMP> instead of <SAMP>`make'</SAMP> above.
|
|
|
|
|
|
<P>
|
|
The <CODE>configure</CODE> command checks out some features of your system and
|
|
C++ compiler and builds the <CODE>Makefile</CODE>s. The <CODE>make</CODE> command
|
|
builds the library. This step may take 4 hours on an average workstation.
|
|
The <CODE>make check</CODE> runs some test to check that no important subroutine
|
|
has been miscompiled.
|
|
|
|
|
|
<P>
|
|
The <CODE>configure</CODE> command accepts options. To get a summary of them, try
|
|
|
|
|
|
|
|
<PRE>
|
|
$ ./configure --help
|
|
</PRE>
|
|
|
|
<P>
|
|
Some of the options are explained in detail in the <SAMP>`INSTALL.generic'</SAMP> file.
|
|
|
|
|
|
<P>
|
|
You can specify the C compiler, the C++ compiler and their options through
|
|
the following environment variables when running <CODE>configure</CODE>:
|
|
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><CODE>CC</CODE>
|
|
<DD>
|
|
Specifies the C compiler.
|
|
|
|
<DT><CODE>CFLAGS</CODE>
|
|
<DD>
|
|
Flags to be given to the C compiler when compiling programs (not when linking).
|
|
|
|
<DT><CODE>CXX</CODE>
|
|
<DD>
|
|
Specifies the C++ compiler.
|
|
|
|
<DT><CODE>CXXFLAGS</CODE>
|
|
<DD>
|
|
Flags to be given to the C++ compiler when compiling programs (not when linking).
|
|
</DL>
|
|
|
|
<P>
|
|
Examples:
|
|
|
|
|
|
|
|
<PRE>
|
|
$ CC="gcc" CFLAGS="-O" CXX="g++" CXXFLAGS="-O" ./configure
|
|
$ CC="gcc -V egcs-2.91.60" CFLAGS="-O -g" \
|
|
CXX="g++ -V egcs-2.91.60" CXXFLAGS="-O -g" ./configure
|
|
$ CC="gcc -V 2.95.2" CFLAGS="-O2 -fno-exceptions" \
|
|
CXX="g++ -V 2.95.2" CFLAGS="-O2 -fno-exceptions" ./configure
|
|
</PRE>
|
|
|
|
<P>
|
|
Note that for these environment variables to take effect, you have to set
|
|
them (assuming a Bourne-compatible shell) on the same line as the
|
|
<CODE>configure</CODE> command. If you made the settings in earlier shell
|
|
commands, you have to <CODE>export</CODE> the environment variables before
|
|
calling <CODE>configure</CODE>. In a <CODE>csh</CODE> shell, you have to use the
|
|
<SAMP>`setenv'</SAMP> command for setting each of the environment variables.
|
|
|
|
|
|
<P>
|
|
Currently CLN works only with the GNU <CODE>g++</CODE> compiler, and only in
|
|
optimizing mode. So you should specify at least <CODE>-O</CODE> in the CXXFLAGS,
|
|
or no CXXFLAGS at all. (If CXXFLAGS is not set, CLN will use <CODE>-O</CODE>.)
|
|
|
|
|
|
<P>
|
|
If you use <CODE>g++</CODE> version 2.8.x or egcs-2.91.x (a.k.a. egcs-1.1) or
|
|
gcc-2.95.x, I recommend adding <SAMP>`-fno-exceptions'</SAMP> to the CXXFLAGS.
|
|
This will likely generate better code.
|
|
|
|
|
|
<P>
|
|
If you use <CODE>g++</CODE> version egcs-2.91.x (egcs-1.1) or gcc-2.95.x on Sparc,
|
|
add either <SAMP>`-O'</SAMP>, <SAMP>`-O1'</SAMP> or <SAMP>`-O2 -fno-schedule-insns'</SAMP> to the
|
|
CXXFLAGS. With full <SAMP>`-O2'</SAMP>, <CODE>g++</CODE> miscompiles the division routines.
|
|
Also, if you have <CODE>g++</CODE> version egcs-1.1.1 or older on Sparc, you must
|
|
specify <SAMP>`--disable-shared'</SAMP> because <CODE>g++</CODE> would miscompile parts of
|
|
the library.
|
|
|
|
|
|
<P>
|
|
By default, both a shared and a static library are built. You can build
|
|
CLN as a static (or shared) library only, by calling <CODE>configure</CODE> with
|
|
the option <SAMP>`--disable-shared'</SAMP> (or <SAMP>`--disable-static'</SAMP>). While
|
|
shared libraries are usually more convenient to use, they may not work
|
|
on all architectures. Try disabling them if you run into linker
|
|
problems. Also, they are generally somewhat slower than static
|
|
libraries so runtime-critical applications should be linked statically.
|
|
|
|
|
|
|
|
|
|
<H3><A NAME="SEC8" HREF="cln_toc.html#TOC8">2.2.1 Using the GNU MP Library</A></H3>
|
|
<P>
|
|
<A NAME="IDX6"></A>
|
|
|
|
|
|
<P>
|
|
Starting with version 1.1, CLN may be configured to make use of a
|
|
preinstalled <CODE>gmp</CODE> library. Please make sure that you have at
|
|
least <CODE>gmp</CODE> version 3.0 installed since earlier versions are
|
|
unsupported and likely not to work. Enabling this feature by calling
|
|
<CODE>configure</CODE> with the option <SAMP>`--with-gmp'</SAMP> is known to be quite
|
|
a boost for CLN's performance.
|
|
|
|
|
|
<P>
|
|
If you have installed the <CODE>gmp</CODE> library and its header file in
|
|
some place where your compiler cannot find it by default, you must help
|
|
<CODE>configure</CODE> by setting <CODE>CPPFLAGS</CODE> and <CODE>LDFLAGS</CODE>. Here is
|
|
an example:
|
|
|
|
|
|
|
|
<PRE>
|
|
$ CC="gcc" CFLAGS="-O2" CXX="g++" CXXFLAGS="-O2 -fno-exceptions" \
|
|
CPPFLAGS="-I/opt/gmp/include" LDFLAGS="-L/opt/gmp/lib" ./configure --with-gmp
|
|
</PRE>
|
|
|
|
|
|
|
|
<H2><A NAME="SEC9" HREF="cln_toc.html#TOC9">2.3 Installing the library</A></H2>
|
|
<P>
|
|
<A NAME="IDX7"></A>
|
|
|
|
|
|
<P>
|
|
As with any autoconfiguring GNU software, installation is as easy as this:
|
|
|
|
|
|
|
|
<PRE>
|
|
$ make install
|
|
</PRE>
|
|
|
|
<P>
|
|
The <SAMP>`make install'</SAMP> command installs the library and the include files
|
|
into public places (<TT>`/usr/local/lib/'</TT> and <TT>`/usr/local/include/'</TT>,
|
|
if you haven't specified a <CODE>--prefix</CODE> option to <CODE>configure</CODE>).
|
|
This step may require superuser privileges.
|
|
|
|
|
|
<P>
|
|
If you have already built the library and wish to install it, but didn't
|
|
specify <CODE>--prefix=...</CODE> at configure time, just re-run
|
|
<CODE>configure</CODE>, giving it the same options as the first time, plus
|
|
the <CODE>--prefix=...</CODE> option.
|
|
|
|
|
|
|
|
|
|
<H2><A NAME="SEC10" HREF="cln_toc.html#TOC10">2.4 Cleaning up</A></H2>
|
|
|
|
<P>
|
|
You can remove system-dependent files generated by <CODE>make</CODE> through
|
|
|
|
|
|
|
|
<PRE>
|
|
$ make clean
|
|
</PRE>
|
|
|
|
<P>
|
|
You can remove all files generated by <CODE>make</CODE>, thus reverting to a
|
|
virgin distribution of CLN, through
|
|
|
|
|
|
|
|
<PRE>
|
|
$ make distclean
|
|
</PRE>
|
|
|
|
<P><HR><P>
|
|
Go to the <A HREF="cln_1.html">first</A>, <A HREF="cln_1.html">previous</A>, <A HREF="cln_3.html">next</A>, <A HREF="cln_13.html">last</A> section, <A HREF="cln_toc.html">table of contents</A>.
|
|
</BODY>
|
|
</HTML>
|