gerph/riscos-build repository overview

⁠Cross compiling environment using Docker

⁠Manual

A full manual with installation and usage instructions can be found here: https://robe.riscos.online/⁠

⁠Summary

The cross-compiling environment for RISC OS provides a way use RISC OS tools on non-RISC OS systems.

The intention is that the cross compiling tools work exactly as they would on RISC OS, taking RISC OS filenames, and producing RISC OS-specific files. This means that:

• All files on the command line are referred to with . directory separators.
• Filetypes are able to be used, with the ,xxx syntax.
• Environment variables are evaluated using the capitalised environment variable with $ replaced by _. The variables should hold native paths, not RISC OS paths, however.
• Path variables are handled like regular environment variables, except that the _PATH suffix is omitted; ie the environment variable C would be used to expand C:o.stubs.
• All object files are AOF, ALF, or ELF.
• All output files are AIF, ELF, Modules or Utilities.
• Within the cross-compiling environment, the built binaries are not executable - the environment only produces RISC OS executables, not linux executables. For an execution environment, see the Pyromaniac container.

⁠Installation

The easiest way to install the tools with the Docker container is to run the installation script, supplying a directory which is listed within the PATH, like this:

mkdir INSTALL_DIR
docker run --rm -v INSTALL_DIR:/riscos-built -e UID=$(id -u) gerph/riscos-build:VERSION install

For example, to install the latest version into /usr/local/bin you would use:

docker run --rm -v /usr/local/bin:/riscos-built -e UID=$(id -u) gerph/riscos-build:latest install

or to include the 64-bit tooling, use:

docker run --rm -v /usr/local/bin:/riscos-built -e UID=$(id -u) gerph/riscos-build:latest-64bit install

Once installed in this way, the tools can be invoked in the host system and will run within a Docker container.

Full help can be displayed with:

riscos-shell help