<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>6. Installation</title><link rel="stylesheet" href="ecl.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The ECL manual"><link rel="up" href="pr01.html" title="Preface"><link rel="prev" href="pr01s05.html" title="5. Copyright of this manual"><link rel="next" href="pt01.html" title="Part I. Standards"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pr01s05.html">Prev</a> </td><th width="60%" align="center">Preface</th><td width="20%" align="right"> <a accesskey="n" href="pt01.html">Next</a></td></tr></table><hr></div><div class="section" title="6. Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="preface.installation"></a>6. Installation</h2></div></div></div><p>The following sections describe which machines are supported by <span class="application">ECL</span>,
how to build and install it on them. You should read at least <a class="xref" href="pr01s06.html#preface.platforms" title="6.1. Supported platforms">Section 6.1</a> and in particular <a class="xref" href="pr01s06.html#table.ports" title="Table 1. Supported platforms">Table 1</a>
which details the other sections containing installation instructions for
your platform.</p><div class="section" title="6.1. Supported platforms"><div class="titlepage"><div><div><h3 class="title"><a name="preface.platforms"></a>6.1. Supported platforms</h3></div></div></div><div class="table"><a name="table.ports"></a><p class="title"><b>Table 1. Supported platforms</b></p><div class="table-contents"><table summary="Supported platforms" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Architecture</th><th>Operating system</th><th>Notes</th><th>Tested<sup>[<a name="id640942" href="#ftn.id640942" class="footnote">a</a>]</sup></th><th>Read</th></tr></thead><tbody><tr><td>ix86 <sup>[<a name="note.x86" href="#ftn.note.x86" class="footnote">b</a>]</sup>
</td><td>Linux</td><td> </td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>x86</td><td>FreeBSD, OpenBSD</td><td> </td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a>,
<a class="xref" href="pr01s06.html#preface.bsd" title="6.3.4. OpenBSD and FreeBSD">Section 6.3.4</a></td></tr><tr><td>x86</td><td>NetBSD</td><td> </td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a>,
<a class="xref" href="pr01s06.html#preface.netbsd" title="6.3.3. NetBSD">Section 6.3.3</a></td></tr><tr><td>x86</td><td>Windows 2000, XP</td><td>Microsoft Visual C++ compiler</td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.msvc" title="6.3.1. Windows with Visual C++ compiler">Section 6.3.1</a></td></tr><tr><td>x86</td><td>Windows 2000, XP</td><td><a class="ulink" href="http://www.cygwin.com/" target="_top"><span class="application">Cygwin</span></a> tools</td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>x86</td><td>Windows 2000, XP</td><td><a class="ulink" href="http://mingw.sourceforge.net/" target="_top"><span class="application">Mingw</span></a> and Msys tools</td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>x86</td><td>OS X Tiger</td><td> </td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>PowerPC</td><td>OS X Tiger</td><td> </td><td>YES</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>x86_64
<sup>[<a name="note.x86_64" href="#ftn.note.x86_64" class="footnote">c</a>]</sup>
</td><td>Linux</td><td> </td><td>NO</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr><tr><td>Alpha</td><td>Linux</td><td> </td><td>NO</td><td><a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a></td></tr></tbody><tbody class="footnotes"><tr><td colspan="3"><div class="footnote"><p><sup>[<a name="ftn.id640942" href="#id640942" class="para">a</a>] </sup>YES means that a dedicated machine regularly builds and tests <span class="application">ECL</span> on this platform.</p></div><div class="footnote"><p><sup>[<a name="ftn.note.x86" href="#note.x86" class="para">b</a>] </sup>Intel 32 bit processors
(Pentium, Pentium II, Pentium 3, Pentium 4) and AMD
clones</p></div><div class="footnote"><p><sup>[<a name="ftn.note.x86_64" href="#note.x86_64" class="para">c</a>] </sup>AMD 64 bits and Intel EM64 extensions.</p></div></td></tr></tbody></table></div></div><br class="table-break"><p>In <a class="xref" href="pr01s06.html#table.ports" title="Table 1. Supported platforms">Table 1</a> we show the operating systems in
which ECL is known to run and where it is regularly tested. Note that ECL
might successfully build on other platforms, and that porting is relatively
easy. We regularly get reports on ECL being built on other platforms (ARM,
Motorola 68x, Sparc, etc), so the best thing is to try yourself.</p></div><div class="section" title="6.2. Autoconf based configuration"><div class="titlepage"><div><div><h3 class="title"><a name="preface.autoconf"></a>6.2. Autoconf based configuration</h3></div></div></div><p><span class="application">ECL</span>, like many other free programs, can be built and installed a GNU
tool called Autoconf. This is a set of automatically generated scripts that
detect the features of your machine, such as the compiler type, existing
libraries, desired installation path, and configures <span class="application">ECL</span> accordingly. The
following procedure describes how to build <span class="application">ECL</span> using this procedure and it
applies to all platforms except for the Windows ports.</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>Unpack the tar file</p><pre class="screen">$ gunzip -c ecl-0.9i.tgz | tar xf -</pre></li><li class="step" title="Step 2"><p>Choose a directory in which you will install <span class="application">ECL</span>. Following
the Unix covention we will use
<code class="filename">/usr/local</code></p></li><li class="step" title="Step 3"><p>Run the configuration file
</p><pre class="screen">$ cd ecl-0.9i
$ ./configure --prefix=/usr/local</pre><p>
If you are building under Solaris 9 you should replace the last line with
</p><pre class="screen">$ ./configure --enable-slow-config --with-system-gmp=no \
--prefix=/usr/local</pre><p>
By now you should have a directory with the name
<code class="filename">build</code> and a bunch of makefiles inside it.</p></li><li class="step" title="Step 4"><p>Use GNU make to begin building ECL. Normally this amounts to
invoking
</p><pre class="screen">$ make</pre><p>
from the command line.</p></li><li class="step" title="Step 5"><p>Install the program using
</p><pre class="screen">$ make install</pre><p>
</p></li><li class="step" title="Step 6"><p>Make sure the program is installed and ready to run
</p><pre class="screen">$ /usr/local/ecl
ECL (Embeddable Common-Lisp) 0.9i
Copyright (C) 1984 Taiichi Yuasa and Masami Hagiya
Copyright (C) 1993 Giuseppe Attardi
Copyright (C) 2000 Juan J. Garcia-Ripoll
ECL is free software, and you are welcome to redistribute it
under certain conditions; see file 'Copyright' for details.
Type :h for Help. Broken at EVAL.
> </pre><p>
</p></li></ol></div></div><div class="section" title="6.3. Platform specific instructions"><div class="titlepage"><div><div><h3 class="title"><a name="preface.osdep"></a>6.3. Platform specific instructions</h3></div></div></div><div class="section" title="6.3.1. Windows with Visual C++ compiler"><div class="titlepage"><div><div><h4 class="title"><a name="preface.msvc"></a>6.3.1. Windows with Visual C++ compiler</h4></div></div></div><p>If you have a commercial version of Microsoft Visual Studio, the
steps are simple:</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>Change to the <code class="code">msvc</code> directory.</p></li><li class="step" title="Step 2"><p>Run <code class="code">nmake</code> to build ECL.</p></li><li class="step" title="Step 3"><p>Run <code class="code">nmake install prefix=d:\Software\ECL</code>
where the <code class="code">prefix</code> is the directory where you want to install
ECL.</p></li><li class="step" title="Step 4"><p>Optionally, if you want to build a self-installing
executable, you can install <a class="ulink" href="http://nsis.sourceforge.net" target="_top">NSIS</a> and run <code class="code">nmake
windows-nsi</code>.</p></li></ol></div><p>If you want to build ECL using the free Microsoft Visual C++ Toolkit
2003, you should follow these before building ECL:</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>Download and install <a class="ulink" href="http://msdn.microsoft.com/visualc/vctoolkit2003/" target="_top">Microsoft Visual
C++ Toolkit</a>.</p></li><li class="step" title="Step 2"><p>Download and install the <a class="ulink" href="http://www.microsoft.com/msdownload/platformsdk/sdkupdate/" target="_top">Microsoft
Platform SDK</a></p></li><li class="step" title="Step 3"><p>Download NMAKE and install. There is an old version in
<a class="ulink" href="http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe" target="_top">
Microsoft's download page</a>.</p></li><li class="step" title="Step 4"><p>Download and install the .NET Framework SDK. Copy the
files msvcrt.lib an msvcrtd.lib from this toolkit to the directory where
the Visual C++ Toolkit keeps it libraries. Afterwards you can uninstall
the .NET SDK.</p></li><li class="step" title="Step 5"><p>Make sure that:</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 5.1"><p><code class="code">%PATH%</code> includes the directories <code class="code">bin</code> of
both the C++ Toolkit, NMAKE and the SDK.</p></li><li class="step" title="Step 5.2"><p><code class="code">%INCLUDE%</code> includes the directories
<code class="code">include</code> of both the C++ Toolkit and the SDK.</p></li><li class="step" title="Step 5.3"><p><code class="code">%LIB%</code>includes the directories <code class="code">lib</code> of
both the C++ Toolkit and the SDK.</p></li></ol></div></li></ol></div></div><div class="section" title="6.3.2. Windows with Mingw/Cygwin"><div class="titlepage"><div><div><h4 class="title"><a name="preface.mingw"></a>6.3.2. Windows with Mingw/Cygwin</h4></div></div></div><p></p></div><div class="section" title="6.3.3. NetBSD"><div class="titlepage"><div><div><h4 class="title"><a name="preface.netbsd"></a>6.3.3. NetBSD</h4></div></div></div><p>Before following the instructions in <a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a> you should install the following packages:
<span class="application">bash</span>, <span class="application">boehm-gc</span> and
<span class="application">gmp-4.1</span> or better. Additionally when
configuring, you should first export the environment variable
<span style="color: red"><variable>CONFIG_SHELL</variable></span> using <code class="code">setenv CONFIG_SHELL
/usr/pkg/bin/bash</code> or <code class="code">export
CONFIG_SHELL=/usr/pkg/bin</code>.</p></div><div class="section" title="6.3.4. OpenBSD and FreeBSD"><div class="titlepage"><div><div><h4 class="title"><a name="preface.bsd"></a>6.3.4. OpenBSD and FreeBSD</h4></div></div></div><p>Before following the instructions in <a class="xref" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Section 6.2</a> you should install the following packages:
<span class="application">boehm-gc</span> and <span class="application">gmp-4.1</span>
or better.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pr01s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pr01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="pt01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5. Copyright of this manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Part I. Standards</td></tr></table></div></body></html>
