Building on BSD, Linux, macOS, and other Unix Targets

Retro is well supported on BSD (tested on FreeBSD, NetBSD, OpenBSD), Linux, and macOS systems. It should build on any of these without issue.

Requirements

• c compiler & linker
• standard headers
• make


Process

For a standard 32-bit system:

Run make

This will build the toolchain and then the main retro executable.

Executables

In the bin/ directory, you should see the following:

retro retro-unu retro-muri retro-extend retro-embedimage retro-describe

Test The Build

You can conduct a quick test of the build by running bin/retro:

./bin/retro

Exit by typing bye and pressing enter.

Installation

You can install Retro globally on BSD systems (and possibly Linux) by doing:

doas make install

or:

sudo make install

Platform Specific Notes

Haiku

To build on Haiku, you may need to link with the network library. E.g.:

make LDFLAGS=-lnetwork

Issues

If you run into any build issues, please send details to crc@forth.works so I can work on addressing them as quickly as possible.