Mac OS X

Although there is currently no OS-X-hosted version of AROS, PC-native AROS can be cross compiled under OS X. There are several additional requirements for compiling AROS on this platform. Firstly, these software packages must be installed:

• XCode
• MacPorts

The following MacPort packages then need to be installed to complete the set of required software listed earlier:

• i386-elf-gcc
• netpbm
• cdrtools
• gawk
• py-pil
• wget
• autoconf (if using XCode 2.4 or earlier)

These can be installed with, for example:

> sudo port install i386-elf-gcc

You also need to create a dummy crt0.o file for use by configure scripts. Create the following file in a text editor and save it as crt0.c:

int _start()
{
}

Then compile and install it with:

> i386-elf-gcc -c crt0.c
> sudo cp crt0.o /opt/local/i386-elf/lib/

Lastly, there is a missing symbolic link that needs to be created:

> cd /opt/local/bin
> sudo ln -s i386-elf-gcc-3.4.3 i386-elf-gcc

Configuring

First of all, you need to run configure in the root of the AROS sources:

> cd AROS
> ./configure

You can specify several options to configure. The following options are available for all targets:

--enable-debug=LIST [default: none]

Enable different types of debug. Commas or whitespaces can be used to separate the items in the list. If no list is provided then all is assumed. If --enable-debug is not specified at all, none is the default. Available types:

none

Disables all debug types, and debugging in general.

all

Enables all debug types below.

stack

Enables stack debug.

mungwall

Enables mungwall debug.

modules

Enables modules debug.

Compiling

To start the compilation, simply run:

> make

IF this doesn't work after a SVN update, you can try:

> make clean
> rm -rf bin/
> ./configure {options}
> make

If you use FreeBSD or some other system that does not use GNU Make as the system make, then you should substitute the GNU Make command for the above. For example, under FreeBSD you must install the GNU Make port, then run:

> gmake

> make default-x11keymaptable

> make bootiso-pc-i386

Building several targets from the same source

If you intend to compile several different targets from one source tree, then you first have to go through the configuration step for each of your targets. You can add targets at any time you want. The last target specified to configure is the default target.

To select a specific target when building, simply run make like this:

> AROS_TARGET_ARCH=$ARCH AROS_TARGET_CPU=$CPU make

Where $ARCH is the architecture of the wanted build, and $CPU is the CPU. Eg., to build AROS/i386-pc you would run:

> AROS_TARGET_ARCH=pc AROS_TARGET_CPU=i386 make

If you are building several ports that use the same CPU, you only have to specify AROS_TARGET_ARCH as the CPU will stay the same.

After you`ve made "make" once, and some changes were made to the files, you can use quick compilation of changes using make <target-name>-quick command.

Compiling HowTos

This step-by-step guide will describe how to prepare the development environment and compile AROS on Ubuntu Linux 6.10 "Edgy Eft". Let's assume you have a CD image (iso) from ubuntu sites and have installed the system from it. Also you should tune it to make it acessing the Internet.

> sudo apt-get install subversion gcc-3.4 gawk bison flex netpbm autoconf automake1.4 libx11-dev libc6-dev

> sudo apt-get install localeconf
> sudo dpkg-reconfigure localeconf

> sudo locale-gen "en_US"
> sudo dpkg-reconfigure locales
> export LANG="en_US.ISO-8859-1"

> svn checkout https://svn.aros.org/svn/aros/trunk/AROS
> cd AROS
> svn checkout https://svn.aros.org/svn/aros/trunk/contrib

> export CC="gcc-3.4"
> ./configure

> make