General Information

RPCEmu should compile on a wide variety of Linux distributions and other UNIX/UNIXlike operating systems. It's dependancies are not particulaly large.

• GCC compiler
• pthread library
• Allegro game library, version 4.0 or later

The procedure for compiling is fairly simple

• Install project dependancies.
• Decompress the source.
• Run the ./configure script, optionally choosing to enable one or more of these compile-time features.

--enable-dynarec	Enable the Dynamic Recompiler (Just In Time compiler (JIT)). This provides up to a 5x speed increase over the Interpreted method (the default if dynarec is not selected). This is only available on host machines with x86 or AMD64/x64/em64t processers.
--enable-debug	Enable extra debugging information, mainly of use to developers.

• Compile the program using 'make'.
• Test run the program

Once compiled check the User Manual for more information.

An example compilation based on Ubuntu 10.04

This is an anotated example of how to install on a popular platform, but the commands will be identical, or nearly identical on a huge range of systems.

sudo synaptic




  (See Note -->)

tar xvfz rpcemu-<version>.tar.gz
cd rpcemu-<version>/src

./configure
  or (for example)
./configure --enable-dynarec --enable-debug

make

cd ..
./rpcemu

Install the project dependancies, this is the part that varies the most 
between Linux distributions and other OSes. Run the Ubuntu package 
manager (with root priveledges), and install the following packages (and 
their dependancies), 'liballegro4.2-dev'.

Return to running as a regular user (not root) to compile the source.

Decompress the Source


Choose the options you want (listed above) and this will prepare the 
program for compilation. 


Compile the program


Run the program, which will exit due to missing a ROM image, check here 
for more details. Install a ROM image, re-run and RISC OS should be 
running.