<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>6. Installation</title><link rel="stylesheet" type="text/css" href="ecl.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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>Toolchain</th><th>Tested<sup>[<a name="id2931342" href="#ftn.id2931342" class="footnote">a</a>]</sup></th></tr></thead><tbody><tr><td>x86 <sup>[<a name="note.x86" href="#ftn.note.x86" class="footnote">b</a>]</sup> </td><td>Linux</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86_64<sup>[<a name="note.x86" href="#ftn.note.x86" class="footnote">c</a>]</sup></td><td>Linux</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>PPC</td><td>Linux</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>Itanium</td><td>Linux</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86</td><td>FreeBSD</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86</td><td><a class="link" href="pr01s06.html#preface.bsd" title="6.3.2. OpenBSD and NetBSD">OpenBSD</a></td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86</td><td><a class="link" href="pr01s06.html#preface.bsd" title="6.3.2. OpenBSD and NetBSD">NetBSD</a></td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86</td><td>Windows XP, Vista, 7</td><td><a class="link" href="pr01s06.html#preface.msvc" title="6.3.1. Microsoft compilers">Microsoft compilers</a></td><td>YES</td></tr><tr><td>x86</td><td>Windows XP, Vista, 7</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration"><a class="ulink" href="http://www.cygwin.com/" target="_top"><span class="application">Cygwin</span></a></a></td><td>YES</td></tr><tr><td>x86</td><td>Windows XP, Vista, 7</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration"><a class="ulink" href="http://mingw.sourceforge.net/" target="_top"><span class="application">Mingw</span></a> and Msys tools</a></td><td>YES</td></tr><tr><td>x86</td><td>OS X Tiger</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86_64</td><td>OS X Tiger</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86</td><td>Solaris</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>x86_64</td><td>Solaris</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr><tr><td>Sparc</td><td>Solaris</td><td><a class="link" href="pr01s06.html#preface.autoconf" title="6.2. Autoconf based configuration">Autoconf</a></td><td>YES</td></tr></tbody><tbody class="footnotes"><tr><td colspan="3"><div class="footnote"><p><sup>[<a id="ftn.id2931342" href="#id2931342" 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 id="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 id="ftn.note.x86" href="#note.x86" class="para">c</a>] </sup>AMD and Intel processors with 64 bit 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. Microsoft compilers"><div class="titlepage"><div><div><h4 class="title"><a name="preface.msvc"></a>6.3.1. Microsoft compilers</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 Studio Express 2010 or better, you should follow these before building ECL as sketched before:</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>Download and install <a class="ulink" href="http://www.microsoft.com/express/" target="_top">Microsoft Visual Studio C++ Compiler</a>.</p></li><li class="step" title="Step 2"><p>Download and install the <a class="ulink" href="http://msdn.microsoft.com/en-us/windows/bb980924" target="_top">Windows SDK</a></p></li><li class="step" title="Step 3"><p>Open the Windows SDK terminal, which will set up the appropriate paths and environment variables.</p></li></ol></div></div><div class="section" title="6.3.2. OpenBSD and NetBSD"><div class="titlepage"><div><div><h4 class="title"><a name="preface.bsd"></a>6.3.2. OpenBSD and 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">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>