Note: on Ubuntu 16.10 or newer you will need to run the configure program in a different manner.
CFLAGS=-no-pie ./configure <your configure options>
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, 4.2, 4.4 or later, but not Allegro 5
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.