Eagle Mode -
Install and Start

Copyright © 2008 Oliver Hamann. Homepage: http://eaglemode.sourceforge.net/

Contents

1 How to install Eagle Mode
2 How to start Eagle Mode
3 Special cases
      3.1 Proper installation to /usr
      3.2 FreeBSD
      3.3 Cygwin

1 How to install Eagle Mode

For installing Eagle Mode, first unpack the source package and cd into the unpacked directory. After that, the project has to be compiled (built) and then it can be installed. Here are the basic commands for doing that:

   perl make.pl build
   perl make.pl install

This would build the project using the GNU compiler, and it would install to a default directory (on UNIX-like systems it is /usr/local/eaglemode). There are some options you could give to the commands. For example, if you want to install to another directory, say something like:

   perl make.pl install dir=/opt/eaglemode

A full description of all options can be seen with:

   perl make.pl help

Hints:

2 How to start Eagle Mode

For starting Eagle Mode, go into the the directory where Eagle Mode has been installed, and run the file eaglemode.sh. Exception: Windows users have to run eaglemode.wsf instead.

If you wonder about the files in the bin directory: these executables need some special environment variables and cannot be run directly.

3 Special cases

3.1 Proper installation to /usr

Originally, Eagle Mode is designed for being installed in an own directory like /usr/local/eaglemode or /opt/eaglemode. But if you want to have it divided in /usr/bin, /usr/lib, /usr/share and so on, you could do it like in this example:

perl make.pl build continue=no
perl make.pl install dir=/usr/lib/eaglemode

cd /usr/lib/eaglemode
mv -T doc ../../share/doc/eaglemode
ln -s ../../share/doc/eaglemode doc
mv -T res ../../share/eaglemode
ln -s ../../share/eaglemode res
mv -T etc /etc/eaglemode
ln -s /etc/eaglemode etc

cd /usr/bin
ln -s ../lib/eaglemode/eaglemode.sh eaglemode

cd /usr/lib
ln -s eaglemode/lib/*.so .

cd /usr/include
ln -s ../lib/eaglemode/include/* .

3.2 FreeBSD

Before building Eagle Mode on FreeBSD, you should execute the following commands, otherwise certain plugins may fail to build.

CPATH=/usr/local/include
export CPATH
LIBRARY_PATH=/usr/local/lib
export LIBRARY_PATH

3.3 Cygwin

Rebase DLL's!

After installing Eagle Mode on Cygwin, and before starting it for the first time, you must rebase all Cygwin DLL's including those of Eagle Mode. Please get familiar with the rebaseall program. The basic steps are as follows (remember to replace the paths according to your installation):

Quit all programs, stop the "CYGWIN cygserver" service (if running), open a Windows Command box and type these commands:
# set PATH=c:\cygwin\bin
# ash
# bash
# ls -1 --indicator-style=none /usr/local/eaglemode/lib/*.dll > /tmp/extra.lst
(At this point you could add further non-standard DLL's to /tmp/extra.lst)
# cat /tmp/extra.lst
(Check that the Eagle Mode DLL's are shown by the above command)
# exit
(Back in ash, never do the following in bash or while any other Cygwin program is running)
# rebaseall -T /tmp/extra.lst -v

You have the choice: emX11 or emWnds

If you want Eagle Mode to use the Windows API directly instead of X11, set the environment variable EM_GUI_LIB=emWnds before starting. But note that the file manager commands require X11 in any case.

Flaws

 


Next Reading: General User Guide