(For installing Euphoria 3 on 64-bit FreeBSD see 'euphoria/doc/bsd64.doc').


How to run Euphoria 3.1.1 on 64-bit Linux
=========================================

Problem:

When you try to run Euphoria 3.1.1 on 64-bit Linux you may get the message:

   bash: ./exu: No such file or directory

This is because Euphoria 3.1.1 needs the 32-bit libraries for 64-bit Linux
system.


Solution:

So you have to install the 32-bit libraries...

On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell...:

To run Euphoria 3.1 you only need libc6:

   sudo apt-get install libc6-i386

Otherwise you can install most of the 32-bit libraries, for any case:

   sudo apt-get install ia32-libs-multiarch

If the above does not work, type:

   sudo apt-get install ia32-libs


Notes:

    ia32-libs-multiarch or ia32-libs are large files, since it lets you install
    any other 32-bit application on 64-bit Linux system (not just Euphoria).

    Euphoria 3.1.1 is a 32-bit programming language on all platforms:

        A 64-bit Windows platform supports 32-bit applications, such as
	Euphoria 3.1.1, natively.

        Euphoria 3.1.1 runs on 16-bit DOS in 32-bit protected mode, using a
	built-in DOS extender.

        On 64-bit Linux the user must install the 32-bit Linux libraries, as
	described above. If you are running a different Linux other then
	"Linux Mint", search the Internet for the command to install the
	32-bit libraries for your Linux.



For C programmers...

How to compile a c file into a 32-bit shared library,
on a 64-bit Linux (Ubuntu/Linux Mint), for Euphoria 3.1.1 open_dll():
=====================================================================

Problem:

When you try to compile 'euphoria/demo/linux/Mylib.c' into a shared library,
on a 64-bit Linux, with:

     gcc -shared Mylib.c -o mylib.so

you may get the following or a similar message:

   /usr/bin/ld: /tmp/cc1RfzVM.o: relocation R_X86_64_PC32 against
   symbol `extra' can not be used when making a shared object;
   recompile with -fPIC
   /usr/bin/ld: final link failed: Bad value
   collect2: error: ld returned 1 exit status

This is because gcc needs the 32-bit libraries for 64-bit Linux system.


Solution:

So you have to install the gcc 32-bit libraries...

On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell:


First install gcc libraries (if not already installed):

    sudo apt-get install build-essential

Install gcc 32-bit libraries:

    sudo apt-get install gcc-multilib


Then use the -m32 flag to compile your file into a shared library:

    gcc -m32 -shared Mylib.c -o mylib.so


Now you can run 'euphoria/demo/linux/mylib.exu' using mylib.so.

Shian.