Prerequisites

Ada compiler

The ANNEXI-STRAYLINE AURA reference implementation is very portable and has dependencies. The current beta release of AURA is targeted at FSF GCC’s Ada compiler (GNAT), with a recommended version of 10.3.0.

Note

Container Cursor Patch

For the recommended GCC 10.3.0, there happens to be a bug in the Ada standard library implementation of some container types. This bug impacts the functioning AURA, though not critically.

Without a patch for this bug, AURA will not be able to consistently avoid unnecessary recompilation.

The fix for this bug has been accepted into mainline GCC (but not GCC 10.3.0). The patch is compatible with the 10.3.0 codebase, and can be obtained from the official commit.

If using ANNEXI-STRAYLINE’s pre-built FSF GCC packages (see below), this patch has already been applied.

Pre-built Binary GCC Builds

ANNEXI-STRAYLINE maintains a number of pre-built binary tarball distributions of FSF GCC with Ada support (GNAT), among other packages. AURA only requires the base GCC build, and does not require gprbuild or any other AdaCore-maintained packages.

A list of prebuilt FSF GCC Ada compiler packages can be found here.

Warning

AURA by default builds an executable that is dynamically linked to the Ada runtime. It is therefore crucial that the Ada runtime shared libraries are available, typically though $LD_LIBRARY_PATH and/or $LD_RUN_PATH (Linux/UNIX).

For GCC, this path is as follows: (gcc installation prefix)/lib/gcc/(target triplet)/(gcc version)/adalib.

If using ANNEXI-STRAYLINE’s pre-built packages for GNAT-10.3.0 on Linux (x86_64), you should be adding the following path to $LD_LIBRARY_PATH and/or $LD_RUN_PATH: /opt/gcc-fsf-gnat/lib/gcc/x86_64-pc-linux-gnu/10.3.0/adalib

Note that unlike $LD_LIBRARY_PATH, $LD_RUN_PATH typically causes the shared library path to be hard-coded into the executable.

The AURA CLI options -static or -static-rt can be used to statically link the Ada runtime. See the build/run command for details.

Python

The target system should have Python 3 installed to permit the installation scripts to self-configure.

Note

If the command python does not invoke Python 3, it should be aliased to do so when running the build script.

Other Dependencies

Depending on the platform, other libraries and packages may need to be installed, and include:

  • iconv

  • binutils